Saltar al contenido principal
Esta guía te muestra cómo registrar una persona y una empresa con Crear una entidad. La entidad se crea sin archivos. Los subirás en el siguiente paso, Subir documentos y comprobantes.

Requisitos previos

  • Un token de acceso de Stage. Consulta Obtener token de acceso.
  • El tipo de entidad: INDIVIDUAL para una persona natural, COMPANY para una entidad legal.
  • El documento de identificación. Para una persona: el identificador fiscal (CPF, CUIT, RFC, CURP) o un documento de identidad (DNI, PASSPORT, CC). Para una empresa: el número de identificación fiscal (CNPJ, CUIT, RFC, RUC, NIT). Se convierte en el documento principal.
  • Un externalId estable: tu propia referencia, única por comerciante.
  • Si Localpayment configuró campos personalizados para tu comerciante, consulta el esquema. Consulta Campos personalizados.

¿Qué documentos declarar?

Un documento es un identificador que contiene tantos archivos como necesites, como el anverso, el reverso y la selfie de un documento de identidad. Envía el documento de identificación en document cuando crees la entidad: se convierte en el documento principal. Declara todos los demás documentos con Agregar un documento. El par type + id debe ser único en tu comerciante. La lista completa de valores se encuentra en Tipos de documentos y pruebas.

Datos mínimos

Si faltan los datos KYC obligatorios, se devuelve el código 422 INCOMPLETE_KYC_DATA.

Crea una persona

Request
Response
La respuesta es 201 Creado con el encabezado ETag: "0". Mantener internalId (la entidad) y document.documentId (el documento principal). Los siguientes pasos necesitan ambos.

Crear una empresa

Una empresa con su número de identificación fiscal como documento principal, una dirección con líneas adicionales y campos personalizados:

Gestiona los errores en tu integración

Errores comunes

Ejemplo de error de validación de campos personalizados:
Un número de identificación fiscal (CPF, CNPJ, CUIT, RFC) es un documento, no un campo de la entidad. Envíalo en document. Los códigos de país deben ser ISO 3166-1 alfa-3 (BRA, no BR).

Próximos pasos

Subir documentos y comprobantes

Adjunta los archivos que respalden cada documento declarado.

Crear una referencia de entidad

Todos los campos de solicitud, campos de respuesta y códigos de error.
Última modificación el 10 de noviembre de 2026