COMPANY, cada persona es una entidad de tipo INDIVIDUAL (los propietarios se vinculan a la empresa como UBO) y cada documento es un documento declarado con sus archivos. Los ejemplos usan una empresa ficticia registrada en Brasil.
Requisitos previos
- Este flujo se aplica a las Cuentas virtuales en Brasil.
- Un token de acceso de etapa. Consulta Obtener token de acceso.
- Un esquema de campos personalizados publicado para tu comerciante con los campos KYB. Consulta Campos personalizados.
- La información y los documentos de la empresa, sus propietarios y su representante legal. Consulta los Requisitos KYB para Beneficiarios de Cuentas Virtuales.
Flujo
Representante legal. Créalo como un
INDIVIDUAL (su documento de identidad puede ser el documento principal) y vincúlalo a la empresa con Vincular un UBO: ownershipPercentage: 0 y controlRole: LEGAL_REPRESENTATIVE. Si el representante legal también es propietario, vincúlalo una sola vez, con su porcentaje y controlRole: LEGAL_REPRESENTATIVE.Paso a paso
Ejecuta las llamadas siguientes en este orden. Conserva cadainternalId y documentId que devuelva la API. Los ejemplos envían solo lo mínimo.
- Lee el esquema de tus campos personalizados.
GET /api/entity/v1/custom-fields/schema devuelve los atributos que acepta tu cuenta. Extracto con el perfil comercial:
- Crear la empresa
POST /api/entity/v1/entities. El número de identificación fiscal es el documento principal, y el perfil comercial va en attributes:
Request
Response
documentId y sin archivos, lo cual es lo esperado: no los necesitas.
- Declara los documentos de la empresa y sube sus archivos.
Declara cada documento con POST /api/entity/v1/entities/{companyId}/documents. El documento de constitución lleva el número de registro en id (en Brasil, el CNPJ):
POST /api/entity/v1/documents/{documentId}/proofs por archivo, con proofType=DOCUMENT y el archivo. Respuesta (extracto):
B2C, el comprobante de titularidad:
- Crea cada persona
Un INDIVIDUAL por cada propietario y para el representante legal, con POST /api/entity/v1/entities. El documento de identidad puede ser el documento principal:
Request
Response
- Carga el documento de identidad de cada persona
El anverso y el reverso van al mismo documento: POST /api/entity/v1/documents/{documentId}/proofs con proofType=FRONT, y luego con proofType=BACK (pasaporte: solo FRONT). Extracto de GET /api/entity/v1/documents/{documentId}/proofs después de ambas cargas:
- Vincula a cada persona con la empresa
Un POST /api/entity/v1/entities/{companyId}/ubos por persona. Jane Doe posee el 60 % y además es la representante legal:
Request
Response
GET /api/entity/v1/entities/{companyId}/ubos lista ambos:
internalId de la empresa: identifica al beneficiario en Localpayment.
- Notifica a Localpayment que la carga se ha completado.
Cuando la empresa, sus documentos y todas las personas estén cargados y vinculados, llama a POST /api/entity/v1/entities/{companyId}/verify sobre la empresa (Solicitar verificación). Esto informa a Localpayment de que la carga de la documentación está completa. La respuesta es 202 Accepted (extracto):
IN_REVIEW, queda bloqueada (409 ENTITY_IN_REVIEW). Con verify termina tu parte de la carga: no necesitas consultar el estado de la entidad después.
Lista de verificación
- Cada documento que tú declaraste (constitución de la empresa, origen de los fondos, documentos de identidad) tiene su archivo. Un documento de identificación fiscal principal no necesita archivo.
- Cada propietario está vinculado a la empresa con su
ownershipPercentage, y el representante legal concontrolRole: LEGAL_REPRESENTATIVE. attributes.businessProfileestá establecido en la empresa.- Una vez cargado todo, llamaste a
verifysobre la empresa. - Los números de identificación fiscal contienen solo dígitos, y los nombres coinciden exactamente con los documentos.
- Todos los archivos son PDF, PNG, JPG o JPEG y pesan menos de 10 MB.
Una vez completada la lista de verificación, Localpayment revisa la empresa y a cada persona, e indica si hay algo que corregir. Consulta Seguimiento de la revisión y Corrección de rechazos.
Próximos pasos
Realiza el seguimiento de las revisiones y corrige los rechazos.
Sigue las instrucciones de la revisión y corrige lo que te pida Localpayment.
Gestionar UBO
Actualizar o eliminar los enlaces del propietario.

