Pré-requisitos
- Uma entidade com seus documentos e arquivos carregados. Consulte Carregar Documentos e Comprovantes.
- Para uma empresa, cada proprietário vinculado e com seus próprios documentos e arquivos. Consulte Gerenciar Beneficiários Finais.
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éCOMPLETEem 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,
verifyretorna 422NO_PROOFS_UPLOADED.
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_KYCcom o motivo emstatusReason, e cada arquivo rejeitado traz seu próprioverificationReason. Faça o upload de um substituto com o mesmoproofType, ou corrija os dados, e depois chame Request Verification novamente. - Rejeitada: a entidade passa a
REJECTEDe o motivo fica no histórico de status. Uma entidadeREJECTEDnão pode ser enviada novamente: registre uma nova entidade com um novoexternalId, ou entre em contato com seu gerente de conta.
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. BLOCKEDe o retorno paraACTIVEsã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.

