Pré-requisitos
- Um token de acesso do ambiente Stage. Consulte Obter token de acesso.
- O tipo de entidade:
INDIVIDUALpara uma pessoa natural,COMPANYpara uma pessoa jurídica. - O documento de identificação. Para uma pessoa: o número de identificação fiscal (
CPF,CUIT,RFC,CURP) ou um documento de identidade (DNI,PASSPORT,CC). Para uma empresa: o número de identificação fiscal (CNPJ,CUIT,RFC,RUC,NIT). Ele se torna o documento principal. - Um
externalIdestável: sua própria referência, exclusiva por comerciante. - Se a Localpayment configurou campos personalizados para o seu comerciante, consulte o esquema. Veja Campos Personalizados.
Quais documentos declarar?
Um documento é uma identificação que contém quantos arquivos você precisar, como a frente, o verso e uma selfie de um documento de identidade. Envie o documento de identificação emdocument ao criar a entidade, ela se torna o documento principal. Declare todos os outros documentos com Adicionar um Documento. O par type + id deve ser único em seu estabelecimento.
A lista completa de valores encontra-se em Tipos de Documento e Prova.
Dados mínimos
A ausência de dados KYC obrigatórios retorna o código 422
INCOMPLETE_KYC_DATA.
Criar uma pessoa
Request
Response
ETag: "0".
Manter internalId (a entidade) e document.documentId (o documento principal). Os próximos passos exigem ambos.
Crie uma empresa
Uma empresa com seu número de identificação fiscal como documento principal, um endereço com linhas adicionais e campos personalizados:Lide com erros na sua integração.
Erros comuns
Exemplo de erro de validação de campos personalizados:
Próximos passos
Carregar documentos e comprovativos
Anexe os arquivos que comprovam cada documento declarado.
Criar uma referência de entidade
Todos os campos de solicitação, campos de resposta e códigos de erro.

