> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.recurrente.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.recurrente.com/_mcp/server.

# 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](/referencia-api/api-reference/customers/create-customer)
   (`POST /api/customers`) y guarda el `id` de la respuesta.
2. Envía ese ID como `customer_id` al
   [crear un checkout](/referencia-api/api-reference/checkouts/create-checkout).
3. Para consultar sus checkouts, usa
   [Listar checkouts](/referencia-api/api-reference/checkouts/list-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:

   ```http
   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](/referencia-api/api-reference/users/create-user) sigue
disponible por enlace directo para mantener integraciones anteriores.