attributes cuando creas o actualizas una entidad.
Requisitos previos
- Un esquema de campos personalizados acordado con tu gestor de cuenta y publicado por Localpayment.
- Un token de acceso de Stage. Consulta Obtener token de acceso.
Cómo funciona
- Sin esquema publicado:
attributesse acepta tal como se envía, y Obtener esquema de campos personalizados devuelve 404CUSTOM_FIELD_SCHEMA_NOT_FOUND. - Esquema publicado: la validación es estricta. Las claves desconocidas, las claves obligatorias ausentes, los tipos, longitudes, patrones y rangos incorrectos se rechazan con 400
CUSTOM_FIELDS_INVALID. Cada entidad registra elcustomFieldSchemaVersioncon el que fue validada. - Un esquema por comerciante se aplica tanto a
INDIVIDUALcomo aCOMPANY. Los campos que solo tienen sentido para empresas se definen como opcionales.
Tipos de campo
Las claves están en camelCase y comienzan con una letra minúscula (
^[a-z][a-zA-Z0-9_]{0,63}$). attributes puede pesar hasta 64 KB (413 PAYLOAD_TOO_LARGE).
Lee el esquema
Request
Response
?format=definition para obtener la lista de campos nativa.
Enviar los valores
Los valores se envían enattributes en Crear una entidad y Actualizar una entidad:
CUSTOM_FIELDS_INVALID, con una entrada por cada campo incorrecto en details:
attributes contra el esquema de tu lado antes de llamar a la API, y asocia cada entrada de details con tu formulario para que el usuario pueda corregir el valor.
Cambiar el esquema
Localpayment publica los cambios de esquema como una nueva versión. Las entidades existentes conservan sucustomFieldSchemaVersion, y las nuevas escrituras se validan contra la última versión publicada. Pide a tu gestor de cuenta que agregue, flexibilice o elimine campos.
Próximos pasos
Obtener esquema de campos personalizados
Formatos de respuesta y códigos de error.
Compartir información KYB a través de entidades
Los campos personalizados utilizados para los beneficiarios de la cuenta virtual.

