Clientes y migración desde User
Usa Customer para identificar a quien le cobras. El cliente pertenece a tu comercio: la misma persona puede tener un Customer diferente en cada comercio. User es la identidad compartida que Recurrente mantiene internamente; no necesitas crearla por separado.
Crear y usar un cliente
- Envía el email a Crear cliente
(
POST /api/customers) y guarda elidde la respuesta. - Envía ese ID como
customer_idal crear un checkout. - Para consultar sus checkouts, usa
Listar checkouts
con
customer_id. Puedes combinarlo con los filtros de fecha y paginación.
Si Ana compra en tu tienda y en otro comercio, guarda el ID que devuelve tu propia
cuenta. El Customer del otro comercio no identifica a Ana dentro de tu tienda.
Si operas cuentas conectadas, usa el mismo X-ACCOUNT-ID al crear el cliente,
crear el checkout y consultar sus checkouts. Conserva también el ambiente de la llave.
Migrar una integración que usa User
POST /api/users y los campos user_id existentes siguen funcionando por
compatibilidad.
-
Crea los nuevos registros como clientes. Cambia
POST /api/usersporPOST /api/customersy guarda eliddel Customer. No reemplaces el prefijo de un ID de User: son objetos distintos. -
Busca el cliente de un User existente. Si ya guardas un
user_id, consulta en la misma cuenta y ambiente:lookupocupa el parámetro de ruta; cuando envíasuser_id, ese parámetro no se usa para buscar. -
Guarda el ID del cliente. Usa el
idde la respuesta. Si no existe un cliente accesible, este endpoint responde401; créalo con su email usandoPOST /api/customers. -
Usa Customer en tus checkouts. Envía el
customer_idguardado para crear y listar checkouts. Si envías tambiénuser_id,customer_idtiene prioridad.
El filtro por cliente también incluye checkouts antiguos que solo guardaron su
usuario, pero no los de otra cuenta ni los de otro ambiente. Un customer_id
desconocido o ajeno responde 404; un valor vacío o no escalar responde 400.
La referencia de User sigue disponible por enlace directo para mantener integraciones anteriores.

