Skip to navigation

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

  1. Envía el email a Crear cliente (POST /api/customers) y guarda el id de la respuesta.
  2. Envía ese ID como customer_id al crear un checkout.
  3. 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.

  1. Crea los nuevos registros como clientes. Cambia POST /api/users por POST /api/customers y guarda el id del Customer. No reemplaces el prefijo de un ID de User: son objetos distintos.

  2. Busca el cliente de un User existente. Si ya guardas un user_id, consulta en la misma cuenta y ambiente:

    GET /api/customers/lookup?user_id=us_...

    lookup ocupa el parámetro de ruta; cuando envías user_id, ese parámetro no se usa para buscar.

  3. Guarda el ID del cliente. Usa el id de la respuesta. Si no existe un cliente accesible, este endpoint responde 401; créalo con su email usando POST /api/customers.

  4. Usa Customer en tus checkouts. Envía el customer_id guardado para crear y listar checkouts. Si envías también user_id, customer_id tiene 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.