Pular para o conteúdo principal
Quando a entidade tiver seus dados e arquivos, você solicita a revisão com Request Verification; você nunca a aprova. A área de Compliance da Localpayment decide sobre cada arquivo e sobre a entidade. Você não precisa aguardar o resultado nem consultar a entidade periodicamente. Quando algo precisa mudar, a Compliance informa o que e por quê, você corrige e solicita a verificação novamente. Se quiser acompanhar o resultado, use Get KYC Status e Get Status History.

Pré-requisitos

Quem faz o quê?

Você não precisa consultar a entidade periodicamente. Webhooks de mudança de status não estão disponíveis para Entities; se quiser acompanhar a revisão, chame Get KYC Status em um intervalo razoável, por exemplo, a cada poucos minutos enquanto a entidade estiver IN_REVIEW.

Antes da revisão

  • Todo documento tem seus arquivos: documentationStatus é COMPLETE em Get KYC Status.
  • Em uma empresa, cada proprietário está vinculado e possui seus próprios documentos e arquivos.
  • Pelo menos um arquivo foi carregado; caso contrário, verify retorna 422 NO_PROOFS_UPLOADED.
Enquanto a entidade está IN_REVIEW, ela fica bloqueada: você não pode editar seus dados, adicionar ou editar documentos, carregar ou excluir arquivos, nem vincular, alterar ou encerrar UBOs (409 ENTITY_IN_REVIEW).

Leia o status KYC

Enquanto a entidade está IN_REVIEW, depois que a Compliance aprovou ambos os arquivos:
Se quiser acompanhar a revisão, um loop de polling em Python:

Possíveis resultados

  • Aprovada: a entidade passa a ACTIVE.
  • Correção solicitada: a entidade volta para PENDING_KYC com o motivo em statusReason, e cada arquivo rejeitado traz seu próprio verificationReason. Faça o upload de um substituto com o mesmo proofType, ou corrija os dados, e depois chame Request Verification novamente.
  • Rejeitada: a entidade passa a REJECTED e o motivo fica no histórico de status. Uma entidade REJECTED não pode ser enviada novamente: registre uma nova entidade com um novo externalId, ou entre em contato com seu gerente de conta.
Histórico de status após a aprovação, com cada alteração, quem a fez e por quê:

Regras para lembrar

  • Você solicita a revisão com verify; aprovar ou rejeitar é feito somente pela Localpayment.
  • Editar os dados da entidade após a aprovação não altera a revisão registrada. Editar um documento redefine seus arquivos aprovados para PENDING, e eles são revisados novamente.
  • BLOCKED e o retorno para ACTIVE são decididos pela área de Compliance. Você os vê no histórico de status com o respectivo motivo.

Próximos passos

Gerenciar Beneficiários Finais

Para empresas: vincule os beneficiários finais.

Status das entidades e códigos de erro

Todos os status, transições e códigos de erro.
Última modificação em 10 de novembro de 2026