POST. El sistema valida los datos, habilita los métodos de pago configurados y retorna las credenciales del comercio en la misma respuesta.
Endpoint
| Ambiente | URL | Método |
|---|---|---|
| Desarrollo | https://gz9zkw23la.execute-api.us-east-1.amazonaws.com/dev/onboarding/merchant | POST |
| Producción | Por definir | POST |
Headers requeridos
| Campo | Valor | Obligatorio |
|---|---|---|
Content-Type | application/json | SI |
Authorization | Bearer <Access Token> | SI |
payment-facilitator-code | UUID del Facilitador de Pago | SI |
Operaciones soportadas
INSERT — Crear comercio
Registra un nuevo comercio. Retorna
client_id y client_secret en la respuesta.UPDATE — Actualizar comercio
Actualiza datos de un comercio existente usando su
merchant_code. No regenera credenciales ni permite modificar datos fiscales.Datos requeridos
Datos del comercio
Nombre, MCC, razón social y datos fiscales (RUC, tipo de documento, país).
Ubicación
País, ciudad, estado, código postal y dirección legal del comercio.
Contactos
Representante legal y contacto operativo — nombre, documento, cargo, email y teléfono.
Métodos de pago
Canal, código del método, monedas permitidas y marcas habilitadas (VISA, MSCD, etc.).
Consideraciones
Si algún método de pago falla durante el registro, el comercio se crea igualmente. Los métodos fallidos se reportan en el campo
payment_methods_failed de la respuesta.En operaciones
UPDATE, los datos fiscales (tax_information) no son modificables.Referencia técnica
Ver referencia en GitHub
Esquema JSON · Campos · Ejemplos INSERT y UPDATE · Colección Postman
Siguiente paso
Registro Masivo
Registra múltiples comercios en un solo archivo Excel.