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

> Envía payouts desde tu Account de Fintoc a cuentas bancarias de terceros por SPEI en México o TEF en Chile, y sigue cada cambio de estado con webhooks.

## Qué vas a construir

Envía dinero desde tu `Account` de Fintoc a la cuenta bancaria de un tercero y rastrea cada cambio de estado mediante webhooks. En México, los payouts usan el riel del Sistema de Pagos Electrónicos Interbancarios (SPEI). En Chile, los payouts usan el riel de Transferencia Electrónica de Fondos (TEF). El tiempo de liquidación depende del riel.

## Cuándo usarlo

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

## Cómo funciona

```text theme={null}
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

Completa estos pasos para enviar un payout:

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/guides/transfers/outbound-transfers).
3. **Maneja los webhooks.** Catálogo de eventos y semántica de estados: [Enviar transferencias → Monitorear el estado](/es/guides/transfers/outbound-transfers).
4. **Verifica primero el destino (opcional).** Si tu cliente ingresó el número de cuenta bancaria estandarizado de México (CLABE), consulta [Verifica una CLABE antes del payout](/es/guides/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/guides/transfers/outbound-transfers) para más detalles.