Saltar al contenido principal
Esta guía muestra, llamada por llamada y con solicitudes y respuestas, cómo enviar la información indicada en los Requisitos KYB para Beneficiarios de Cuentas Virtuales mediante la API de Entidades. Dónde va cada elemento en Entidades se indica en la columna Cómo enviarlo de esa página. En resumen: la empresa es una entidad de tipo 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

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 cada internalId y documentId que devuelva la API. Los ejemplos envían solo lo mínimo.

  1. 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:

  1. 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
La respuesta es 201 Created (extracto). El documento principal se devuelve con su documentId y sin archivos, lo cual es lo esperado: no los necesitas.

  1. 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):
Luego envía un POST /api/entity/v1/documents/{documentId}/proofs por archivo, con proofType=DOCUMENT y el archivo. Respuesta (extracto):
Declara y carga de la misma forma los documentos del origen de los fondos y, para B2C, el comprobante de titularidad:

  1. 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
La respuesta es 201 Created (extracto).

  1. 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:
Un POST /api/entity/v1/entities/{companyId}/ubos por persona. Jane Doe posee el 60 % y además es la representante legal:
Request
Response
John Doe posee el 40 %, con el rol en mayúsculas:
GET /api/entity/v1/entities/{companyId}/ubos lista ambos:
Conserva el internalId de la empresa: identifica al beneficiario en Localpayment.

  1. 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):
Mientras la empresa está en 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 con controlRole: LEGAL_REPRESENTATIVE.
  • attributes.businessProfile está establecido en la empresa.
  • Una vez cargado todo, llamaste a verify sobre 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.
Última modificación el 10 de noviembre de 2026