Pular para o conteúdo principal
Um documento é o conjunto de dados declarados (tipo e número). Uma prova é um arquivo que o comprova. Este guia mostra como adicionar documentos a uma entidade, fazer o upload de seus arquivos um a um, substituir ou remover arquivos e verificar se todos os documentos estão cobertos para que a entidade esteja pronta para revisão.

Pré-requisitos

  • Uma entidade criada com Criar uma entidade e o documentId de cada um de seus documentos.
  • Arquivos em JPG, PNG ou PDF, com até 10 MB cada.

Arquivos por documento

Um documento pode conter quantos arquivos você precisar. Cada arquivo tem um tipo: Um arquivo APPROVED não pode ser substituído (409 PROOF_APPROVED). Um arquivo enviado por engano pode ser removido com Excluir uma prova enquanto não estiver aprovado.

Passo a passo

  1. Declare o documento se a entidade ainda não o possuir, com Adicionar um documento. Mantenha o documentId dele.
  2. Faça o upload do arquivo com Fazer upload de uma prova: POST /api/entity/v1/documents/{docId}/proofs?proofType=FRONT como multipart/form-data, com uma parte chamada file.
  3. Verifique o upload: a resposta 201 deve mostrar sizeBytes maior que zero e o mimeType esperado.
  4. Repita para o verso (proofType=BACK) e para a selfie (proofType=SELFIE) do documento de identidade, e para cada um dos outros documentos.
  5. Verifique a cobertura com Obter Status KYC. documentationStatus deve ser COMPLETE para que a entidade esteja pronta para revisão.

Carregar um arquivo

Request
Response
Em Python, verifique o tamanho do arquivo armazenado e trate os erros de upload:

Verifique a cobertura

Status KYC assim que ambos os arquivos estiverem no local:

Leia os arquivos novamente

Obter uma prova retorna os metadados e um downloadUrl válido por 10 minutos. Baixar um arquivo de prova redireciona diretamente para ele. Ambos são auditados com o usuário presente no seu token de acesso.
O downloadUrl assinado concede acesso ao arquivo até que expire. Não o armazene nem o compartilhe com terceiros. Solicite um novo quando precisar do arquivo novamente.

Substitua um arquivo rejeitado

Quando a área de Conformidade rejeita uma prova, o documento passa a REJECTED e verificationReason explica o motivo:
Quando a entidade voltar para PENDING_KYC, faça o upload de um novo arquivo com o mesmo proofType. A prova rejeitada é substituída e o documento volta para PENDING. Quando as correções estiverem concluídas, chame Solicitar verificação novamente.

Editar um documento

Atualizar um documento altera o país emissor, as datas e os metadados. Qualquer alteração redefine as provas aprovadas do documento para PENDING. O tipo e o número são imutáveis: adicione um novo documento e exclua o antigo. O documento principal não pode ser excluído.

Erros comuns

Próximos passos

Acompanhe a revisão e corrija as rejeições

Siga as instruções da revisão e corrija o que a Localpayment solicitar.

Tipos de documentos e provas

Tipos de documentos e provas aceitos, e restrições de arquivo.
Última modificação em 10 de novembro de 2026