Campos KYC en POST /orders/

El POST /orders/ admite una serie de campos opcionales con datos personales del cliente final. Enviarlos es útil para facturación, logística y para personalizar la experiencia de pago.

Campos personales del cliente

Campo	Tipo	Max	Descripción
full_name	string	48	Nombre completo.
email_client	email	128	Correo electrónico.
phone_number	string	15	Teléfono móvil.
nif	string	12	Identificación personal (DNI, RFC, CURP, etc.).
home_address	string	256	Dirección completa.
address_number	string	56	Número de calle / edificio.
address_additional	string	64	Info adicional (piso, puerta).
city	string	28	Ciudad.
province	string	28	Provincia / estado.
zip_code	string	12	Código postal.
country	string	2	ISO 3166-1 alpha-2 (por ejemplo MX, ES).

Todos son opcionales a nivel de schema. Úselos si su flujo lo requiere.

Nota

Para los controles AML/KYB del merchant, B4bit Pay opera como “actividad vulnerable” bajo la LFPIORPI (México). Los niveles de identificación del merchant se gestionan desde el dashboard; no es algo que se controle por API. Ver términos y condiciones.

Buenas prácticas

• No envíe datos sensibles que no necesite. Si solo le importa el email para enviar el recibo, no pase el domicilio.
• Valide en su lado antes de enviar: B4bit Pay aplica solo validaciones básicas de longitud y formato.
• No loguee estos campos en texto plano — son PII. Si necesita trazabilidad, loguee solo un hash.