> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Payins en Account Numbers dedicados

## Qué vas a construir

Cada cliente (o cada orden) recibe su propio Account Number (CLABE en México). Cuando llega dinero a ese Account Number, Fintoc te envía un webhook con la `metadata` que adjuntaste cuando lo creaste, para que sepas al instante qué cliente pagó, sin necesidad de parsear estados de cuenta ni cruzar montos.

## Cuándo usarlo

* Cuotas de créditos, primas de seguros, suscripciones SaaS.
* Cualquier flujo con clientes identificables que te pagan de manera recurrente.
* Marketplaces donde cada comprador necesita un lugar estable para depositar.

## Cómo funciona

```
1. Tu backend crea un Account Number con metadata.customer_id.
2. Fintoc devuelve un Account Number.
3. Tu cliente envía una Transferencia a ese Account Number.
4. Fintoc dispara transfer.inbound.succeeded con tu metadata adjunta.
5. Tu backend marca la factura como pagada.
```

```mermaid theme={null}
sequenceDiagram
    autonumber
    participant You as Your backend
    participant Fintoc
    participant Customer

    You->>Fintoc: Create Account Number (with metadata.customer_id)
    Fintoc-->>You: Account Number 738969…
    You-->>Customer: Show this Account Number on the invoice
    Customer->>Fintoc: SPEI/TEF to that Account Number
    Fintoc->>You: transfer.inbound.succeeded (includes your metadata)
    You->>You: Mark invoice paid
```

## ¿Una CLABE por cliente o una por orden?

|                   | Una por cliente                          | Una por orden                        |
| ----------------- | ---------------------------------------- | ------------------------------------ |
| CLABEs necesarias | `# de clientes`                          | `# de órdenes abiertas`              |
| Conciliación      | Cruzar por cliente y luego por monto     | Uno a uno. La más sólida.            |
| Limpieza          | Eliminar cuando el cliente se da de baja | Eliminar cuando la orden esté pagada |

Ambos patrones están soportados. Una por orden es el modelo de conciliación más sólido: deshabilita o elimina la CLABE en cuanto se pague la orden para prevenir pagos dobles.

## Checklist de implementación

1. **Crea el Account Number** con metadata. Consulta [Recibir transferencias → Crear un Account Number](/es/docs/transfers/inbound-transfers).
2. **Maneja el webhook.** Suscríbete a `transfer.inbound.succeeded`; lee `data.account_number.metadata`. Referencia del payload: [Recibir transferencias → Payload de webhook](/es/docs/transfers/inbound-transfers).
3. **Refuerza con reglas de negocio.** Configura `options.min_amount` / `max_amount` para rechazar automáticamente montos incorrectos, y deshabilita la CLABE después del pago. Consulta [Agrega lógica a los Account Numbers](/es/docs/transfers/inbound-transfers/add-logic-to-clabes).
4. **Limpia los Account Numbers que no uses** a medida que los clientes se dan de baja o se cierran las órdenes. Consulta [Administra tus Account Numbers](/es/docs/transfers/inbound-transfers/manage-your-clabes). Puedes tener hasta 1,000,000 de Account Numbers. Si has creado Account Numbers que ya no usas, deshabilítalos o elimínalos. Los Account Numbers obsoletos siguen aceptando transferencias, lo que puede contaminar tu conciliación y tus estados de cuenta.