Pular para o conteúdo principal
POST
Solicitar verificação
Informa à Localpayment que o envio da documentação da entidade foi concluído e inicia a sua análise. A entidade passa de PENDING_KYC para IN_REVIEW. No caso de uma empresa, chame-o na empresa depois que seus documentos, arquivos e pessoas estiverem carregados e vinculados.
  • Sem corpo da requisição.
  • Somente a partir de PENDING_KYC. Chamá-lo novamente enquanto a entidade estiver IN_REVIEW retorna 409 INVALID_STATUS_TRANSITION.
  • A entidade precisa de pelo menos um arquivo enviado (422 NO_PROOFS_UPLOADED) e de seus dados mínimos de KYC (422 INCOMPLETE_KYC_DATA).
  • Enquanto a entidade estiver IN_REVIEW, ela fica bloqueada: você não pode editar seus dados, adicionar ou editar documentos, enviar ou excluir arquivos, nem vincular, alterar ou encerrar UBOs (409 ENTITY_IN_REVIEW).
  • Com verify, a sua parte do envio termina: não é necessário consultar o status da entidade depois.
  • Se a Localpayment devolver a entidade para PENDING_KYC para uma correção, corrija o que statusReason indicar e chame este endpoint novamente.
Os erros usam application/problem+json com um code estável. Catálogo completo: Entity Statuses and Error Codes.

Autorizações

Authorization
string
header
obrigatório

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Cabeçalhos

Authorization
string
obrigatório

Token de acesso Bearer para autenticação. Este token é obtido nos endpoints Obter token de acesso ou Renovar token de acesso. Sua conta de comerciante e o usuário que realiza a ação são identificados a partir dele.

Exemplo:

"Bearer <your_access_token>"

X-Correlation-ID
string

Identificador de rastreamento (UUID). Exibido na resposta; gerado pelo Localpayment se ausente.

Exemplo:

"0e8f6a2c-5b3d-4c1e-9a7f-6d5e4c3b2a10"

Parâmetros de caminho

entityId
string<uuid>
obrigatório

ID interno da entidade.

Exemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

Resposta

Aceito. A entidade passa para IN_REVIEW e fica bloqueada até que a Localpayment a resolva (trecho da entidade).

internalId
string<uuid>

Identificador da entidade na Localpayment. Use-o em todos os outros endpoints de Entities.

Exemplo:

"7c9e6679-7425-40de-944b-e07fc1f90ae7"

externalId
string

Seu identificador, conforme enviado.

Exemplo:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

type
enum<string>

PESSOA FÍSICA ou EMPRESA.

Opções disponíveis:
INDIVIDUAL,
COMPANY
Exemplo:

"COMPANY"

status
enum<string>

Status da entidade. Consulte Status da entidade e Códigos de erro.

Opções disponíveis:
PENDING_KYC,
IN_REVIEW,
ACTIVE,
REJECTED,
BLOCKED,
CLOSED
Exemplo:

"PENDING_KYC"

name
string
Exemplo:

"Example Company S.A."

lastname
string | null
birthdate
string<date> | null
gender
string | null
nationality
string | null
birthCountry
string | null
residenceCountry
string | null
occupation
string | null
isPep
boolean
Exemplo:

false

incorporationDate
string<date>
Exemplo:

"2020-01-15"

incorporationCountry
string
Exemplo:

"BRA"

website
string
Exemplo:

"https://www.example.com/new"

Exemplo:

"Jane Doe"

email
string
Exemplo:

"test@example.com"

phone
object
address
object
attributes
object
documentationStatus
enum<string>

NO_FILES, PARTIAL ou COMPLETE: indica se nenhum, alguns ou todos os documentos declarados possuem pelo menos um arquivo. Mede a presença de arquivos, não a aprovação.

Opções disponíveis:
NO_FILES,
PARTIAL,
COMPLETE
Exemplo:

"COMPLETE"

document
object

O documento principal com seu documentId (necessário para enviar arquivos), o status derivado e as proofs[] atuais.

documents
object[]

Os demais documentos declarados (o principal está apenas em document), com a mesma estrutura.

version
integer

Versão da entidade. Igual ao cabeçalho ETag; envie-o de volta como If-Match no PATCH.

Exemplo:

3

createdAt
string<date-time>

Carimbos de data/hora UTC ISO 8601.

Exemplo:

"2024-01-15T17:18:53Z"

updatedAt
string<date-time>

Carimbos de data/hora UTC ISO 8601.

Exemplo:

"2024-01-15T17:19:26Z"

customFieldSchemaVersion
integer

Versão do esquema de campos personalizados usado para validar atributos, ou nulo.

Exemplo:

9

uboCount
integer

Número de vínculos de UBO ativos. Apenas no detalhe de uma entidade COMPANY; null nos demais casos.

Exemplo:

2

uboRequirementMet
boolean

Verdadeiro quando uboCount for igual ou superior a 1. Apenas nos detalhes de uma EMPRESA.

Exemplo:

true

Última modificação em 10 de novembro de 2026