> ## 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.

# Payouts a usuarios o proveedores

## Qué vas a construir

Desde tu cuenta Fintoc envías dinero a cualquier cuenta bancaria de un tercero en tiempo real —SPEI en México, TEF en Chile— y rastreas cada cambio de estado vía webhooks.

## Cuándo usarlo

* Desembolsos y reembolsos de préstamos.
* Payouts de marketplaces a vendedores.
* Retiros de wallets.
* Pagos a proveedores.

## Cómo funciona

```
1. Tu backend hace POST a /v2/transfers.
2. Fintoc envía la transferencia a SPEI (MX) o TEF (CL).
3. Se dispara un webhook: transfer.outbound.succeeded / .rejected / .failed.
4. Tu backend actualiza al usuario o la orden.
```

```mermaid theme={null}
sequenceDiagram
    autonumber
    participant You as Your backend
    participant Fintoc
    participant Rail as SPEI / TEF

    You->>Fintoc: POST /v2/transfers
    Fintoc-->>You: Transfer pending
    Fintoc->>Rail: Submit
    Rail-->>Fintoc: Settled / rejected
    Fintoc->>You: transfer.outbound.succeeded · .rejected · .failed
```

## Checklist de implementación

1. **Fondea la cuenta de origen.** Envía dinero desde la cuenta bancaria externa de tu empresa al `root_account_number` de tu cuenta Fintoc.
2. **Crea la transferencia.** Formato completo del request, ejemplos para MX y CL, campos de counterparty: [Enviar transferencias → Crear una transferencia](/es/docs/transfers/outbound-transfers).
3. **Maneja los webhooks.** Catálogo de eventos y semántica de estados: [Enviar transferencias → Monitorear el estado](/es/docs/transfers/outbound-transfers).
4. **(Opcional) Verifica primero el destino** si el Account Number fue ingresado por un usuario. Consulta [Verifica una CLABE antes del payout](/es/docs/transfers/transfers-use-cases/verify-a-clabe-before-paying-out).

## Un error común

Los webhooks pueden llegar en desorden. Siempre ramifica tu lógica en `data.status`, no en qué evento llegó primero. Consulta [Enviar transferencias → Monitorear el estado](/es/docs/transfers/outbound-transfers) para más detalles.