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

# Payout corridors

> Country and corridor-specific payout requirements

Same API on both environments — build against test first, then go live by swapping the base URL and the key. [Environments and testing →](https://docs.cbpayapp.com/en/environment-testing.md)

## Examples by country

Every corridor with its exact `beneficiary`, the full request and the real
response. Rates (`fx_rate`) are illustrative — your account's rates from
`GET /v1/rates` always apply; the debit is the account-default balance equivalent plus
the fixed fee (when configured; `0.30` here).

### Beneficiary fields per corridor

| Country | Method | `beneficiary` fields |
| - | - | - |
| CL | `bank_transfer` | `name`, `tax_id` (RUT), `bank_code`, `account_type`, `account_number` |
| PE | `bank_transfer` | `name`, `account_number` (20-digit CCI) |
| PE | `yape` | `name`, `phone` (`51XXXXXXXXX`) |
| MX | `bank_transfer` | `name`, `account_type` (`clabe`/`debit_card`), `account_number` (+ `bank_code` for cards) |
| VE | `pago_movil` | `name` (first name + first last name, as on the ID), `phone`, `bank_code` (SUDEBAN), `document_value` |
| VE | `bank_transfer` | `name`, `account_number` (20 digits), `document_value` |
| BO | `bank_transfer` | `name`, `tax_id`, `bank_code`, `account_number` |
| CO | `breb` | `name`, `tax_id`/`document_value`, `document_type`, `phone`, `address`, `breb_key`, `breb_key_type` |
| BR | `pix` | `name`, `tax_id` + (`pix_key` and `pix_key_type`) or (`bank_code` ISPB, `branch_code`, `account_number`) |
| EC | `bank_transfer` | `name`, `document_value` (cédula), `sender_name`, `account_number` (+ `bank_code` and `account_type` for other banks) |
| EC | `deuna` | `name`, `document_value`, `sender_name`, `phone` (wallet mobile number) |
| EC | `cash_pickup` / `cnb` | `name`, `document_value`, `sender_name` — the beneficiary withdraws with their ID |
| PY | `bank_transfer` | `name` (max 35 chars), `tax_id`, `bank_code`, `account_number` |
| AR | `bank_transfer` | `name`, `tax_id` (11-digit CUIT/CUIL), `account_number` (22-digit CBU/CVU or bank alias; USD is CBU-only) |
| US | `ach` / `wire` / `swift` | `name`, `account_number`, `email`, `country_code` (any country), `address`, `city`, `postal_code` (+ `state` if `country_code` is `US`), `bank_name`, `bank_country` (`US` on `ach`/`wire`), `bank_code` (ABA routing for `ach`/`wire`, SWIFT BIC for `swift`; + `account_type` `CHECKING`/`SAVING` for `ach`) |

> [tab] Chile
>
> Bank transfer in CLP. Requires RUT, bank and account: the Chilean peso has no minor unit, so CLP payout amounts must be whole numbers (for example, `30000` or `30000.00`).
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "CL",
>     "currency": "CLP",
>     "method": "bank_transfer",
>     "amount": "100000",
>     "beneficiary": {
>       "name": "Pedro Soto Fuentes",
>       "tax_id": "12.345.678-5",
>       "bank_code": "012",
>       "account_type": "checking",
>       "account_number": "123456789"
>     },
>     "description": "Supplier payment",
>     "idempotency_key": "cl-prov-0091"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "b3e1…",
>   "country": "CL",
>   "currency": "CLP",
>   "method": "bank_transfer",
>   "local_amount": "100000",
>   "fx_rate": "925.69",
>   "usdt_amount": "108.027528",
>   "fee": "0.300000",
>   "total_debit": "108.327528",
>   "status": "processing",
>   "status_code": "",
>   "status_message": "",
>   "funds_debited": true,
>   "compliance_pending": false,
>   "bank_reference": ""
> }
> ```
>
> The banks catalog (`GET /v1/payouts/banks?country=CL`) lists the current `bank_code` values. `CL`/`CLP`/`bank_transfer` may be dispatched in grouped five-minute windows; `POST /v1/payouts` still returns `202` with `status: "processing"` and each payout keeps its final status and `payout_status_changed` webhook.

> [tab] Peru
>
> Two methods: bank transfer (interbank CCI) and **Yape** (to a phone
> number).
>
> ```bash bank_transfer (CCI) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "PE",
>     "currency": "PEN",
>     "method": "bank_transfer",
>     "amount": "1000.00",
>     "beneficiary": {
>       "name": "Rosa Alvarez Diaz",
>       "account_number": "00219300123456789012"
>     },
>     "idempotency_key": "pe-cci-3310"
>   }'
> ```
>
> ```bash yape (phone) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "PE",
>     "currency": "PEN",
>     "method": "yape",
>     "amount": "150.00",
>     "beneficiary": {
>       "name": "Luis Ramos Vega",
>       "phone": "51987654321"
>     },
>     "idempotency_key": "pe-yape-8874"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "c7a2…",
>   "country": "PE",
>   "currency": "PEN",
>   "method": "yape",
>   "local_amount": "150.00",
>   "fx_rate": "3.40",
>   "usdt_amount": "44.117648",
>   "fee": "0.300000",
>   "total_debit": "44.417648",
>   "status": "completed",
>   "bank_reference": "00761123456"
> }
> ```
>
> For `yape` the phone uses the `51XXXXXXXXX` format (11 digits with country
> code). The result is usually synchronous.

> [tab] Mexico
>
> SPEI in MXN, to a CLABE (18 digits) or a debit card:
>
> ```bash CLABE theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "MX",
>     "currency": "MXN",
>     "method": "bank_transfer",
>     "amount": "1500.00",
>     "beneficiary": {
>       "name": "Maria Lopez",
>       "account_type": "clabe",
>       "account_number": "012180001234567895"
>     },
>     "idempotency_key": "mx-clabe-8841"
>   }'
> ```
>
> ```bash Debit card theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "MX",
>     "currency": "MXN",
>     "method": "bank_transfer",
>     "amount": "800.00",
>     "beneficiary": {
>       "name": "Jorge Herrera",
>       "account_type": "debit_card",
>       "account_number": "4152313412341234",
>       "bank_code": "40012"
>     },
>     "idempotency_key": "mx-card-1102"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "0d4f…",
>   "country": "MX",
>   "currency": "MXN",
>   "method": "bank_transfer",
>   "local_amount": "1500.00",
>   "fx_rate": "17.50",
>   "usdt_amount": "85.714286",
>   "fee": "0.300000",
>   "total_debit": "86.014286",
>   "status": "processing",
>   "status_code": "",
>   "status_message": "",
>   "funds_debited": true,
>   "compliance_pending": false,
>   "bank_reference": ""
> }
> ```
>
> With a CLABE the destination bank derives from its leading digits; with a
> card, `bank_code` is required.

> [tab] Venezuela
>
> Two methods: **Pago Móvil** (name + phone + bank + ID) and bank transfer
> (20-digit account):
>
> ```bash pago_movil theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "VE",
>     "currency": "VES",
>     "method": "pago_movil",
>     "amount": "2000.00",
>     "beneficiary": {
>       "name": "Carmen Delgado",
>       "phone": "04141234567",
>       "bank_code": "0102",
>       "document_value": "V12345678"
>     },
>     "idempotency_key": "ve-pm-5567"
>   }'
> ```
>
> ```bash bank_transfer theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "VE",
>     "currency": "VES",
>     "method": "bank_transfer",
>     "amount": "5000.00",
>     "beneficiary": {
>       "name": "Carmen Delgado",
>       "account_number": "01020123456789012345",
>       "document_value": "V87654321"
>     },
>     "idempotency_key": "ve-bank-7810"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "e9b4…",
>   "country": "VE",
>   "currency": "VES",
>   "method": "pago_movil",
>   "local_amount": "2000.00",
>   "fx_rate": "666.00",
>   "usdt_amount": "3.003004",
>   "fee": "0.300000",
>   "total_debit": "3.303004",
>   "status": "completed",
>   "bank_reference": "00761123456"
> }
> ```
>
> `bank_code` uses SUDEBAN codes; for `bank_transfer` it can derive from the
> account's first 4 digits.

> [tab] Bolivia
>
> ACH transfer in BOB or USD (besides the [QR](https://docs.cbpayapp.com/en/guides/payout-special-cases.md#qr-payout)):
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "BO",
>     "currency": "BOB",
>     "method": "bank_transfer",
>     "amount": "1382.00",
>     "beneficiary": {
>       "name": "Juan Quispe Mamani",
>       "tax_id": "4567890",
>       "bank_code": "1016",
>       "account_number": "1234567890"
>     },
>     "idempotency_key": "bo-ach-2204"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "f2c8…",
>   "country": "BO",
>   "currency": "BOB",
>   "method": "bank_transfer",
>   "local_amount": "1382.00",
>   "fx_rate": "6.91",
>   "usdt_amount": "200.000000",
>   "fee": "0.300000",
>   "total_debit": "200.300000",
>   "status": "processing",
>   "status_code": "",
>   "status_message": "",
>   "funds_debited": true,
>   "compliance_pending": false,
>   "bank_reference": ""
> }
> ```
>
> For USD send `currency: "USD"` with the same structure. The organization's rail configuration decides which internal version handles Bolivia payouts; the choice is saved on the operation so later polling keeps using the right version, and responses and webhooks stay provider-agnostic.

> [tab] Brazil
>
> PIX by key (besides the [PIX QR](https://docs.cbpayapp.com/en/guides/payout-special-cases.md#qr-payout)):
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "BR",
>     "currency": "BRL",
>     "method": "pix",
>     "amount": "350.00",
>     "beneficiary": {
>       "name": "João da Silva",
>       "tax_id": "123.456.789-09",
>       "pix_key_type": "cpf",
>       "pix_key": "12345678909"
>     },
>     "idempotency_key": "br-pix-3321"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "a6d1…",
>   "country": "BR",
>   "currency": "BRL",
>   "method": "pix",
>   "local_amount": "350.00",
>   "fx_rate": "5.13",
>   "usdt_amount": "68.226121",
>   "fee": "0.300000",
>   "total_debit": "68.526121",
>   "status": "processing",
>   "status_code": "",
>   "status_message": "",
>   "funds_debited": true,
>   "compliance_pending": false,
>   "bank_reference": ""
> }
> ```
>
> `pix_key_type`: `cpf`, `cnpj`, `phone`, `email` or `evp` (random key).
>
> **PIX to account (no key)** — when the beneficiary does not have (or share)
> a PIX key, send their bank details; it arrives just as fast (same PIX rail,
> 24/7):
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "BR",
>     "currency": "BRL",
>     "method": "pix",
>     "amount": "350.00",
>     "beneficiary": {
>       "name": "Empresa Exemplo Ltda",
>       "tax_id": "19.385.062/0001-20",
>       "bank_code": "45678923",
>       "branch_code": "1",
>       "account_number": "765432",
>       "account_type": "CACC"
>     },
>     "idempotency_key": "br-pix-acct-3322"
>   }'
> ```
>
> * `bank_code` is the destination bank's **ISPB** (8 digits), `branch_code`
>   the agency, and `account_type` the account type (`CACC` checking —
>   default —, `SVGS` savings, `TRAN` payment account, `SLRY` salary).
> * The final status arrives through the `payout_status_changed` webhook
>   (continuous reconciliation against the rail); check on demand with
>   `GET /v1/payouts/{id}`.

> [tab] Ecuador
>
> Remittances in **USD** (1 to 100,000 per operation, up to 2 decimals) with
> four methods: bank transfer, the **DE UNA** wallet (by mobile number),
> **cash pickup** at a branch (`cash_pickup`) and cash at a **non-bank
> correspondent** (`cnb`). This is a remittance corridor: besides the
> beneficiary, the rail requires the **sender's** data (who originates the
> payment), sent flat inside the same `beneficiary` object with the
> `sender_*` prefix.
>
> ```bash bank_transfer (to account) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "EC",
>     "currency": "USD",
>     "method": "bank_transfer",
>     "amount": "250.00",
>     "beneficiary": {
>       "name": "Carlos Andrade Vera",
>       "document_value": "1712345678",
>       "account_number": "2203456789",
>       "sender_name": "Ana Torres Silva",
>       "sender_document_value": "V23456789",
>       "sender_country": "US"
>     },
>     "idempotency_key": "ec-bank-4471"
>   }'
> ```
>
> ```bash deuna (wallet) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "EC",
>     "currency": "USD",
>     "method": "deuna",
>     "amount": "80.00",
>     "beneficiary": {
>       "name": "Lucia Paredes Mora",
>       "document_value": "0923456781",
>       "phone": "0998765432",
>       "sender_name": "Ana Torres Silva"
>     },
>     "idempotency_key": "ec-deuna-5520"
>   }'
> ```
>
> ```bash cash_pickup (branch) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "EC",
>     "currency": "USD",
>     "method": "cash_pickup",
>     "amount": "120.00",
>     "beneficiary": {
>       "name": "Miguel Zambrano Loor",
>       "document_value": "1309876543",
>       "sender_name": "Ana Torres Silva"
>     },
>     "idempotency_key": "ec-cash-6612"
>   }'
> ```
>
> ```bash cnb (correspondent) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "EC",
>     "currency": "USD",
>     "method": "cnb",
>     "amount": "60.00",
>     "beneficiary": {
>       "name": "Rosa Cedeño Vera",
>       "document_value": "0801234567",
>       "sender_name": "Ana Torres Silva"
>     },
>     "idempotency_key": "ec-cnb-7703"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "9f3a…",
>   "country": "EC",
>   "currency": "USD",
>   "method": "bank_transfer",
>   "local_amount": "250.00",
>   "fx_rate": "1",
>   "usdt_amount": "250.000000",
>   "fee": "0.300000",
>   "total_debit": "250.300000",
>   "status": "processing",
>   "bank_reference": ""
> }
> ```
>
> * Ecuador is dollarized: the local currency IS the USD (`fx_rate: "1"`).
> * `document_value` is the beneficiary's cédula; `document_type` accepts
>   `IDCD` (national ID, default), `CCPT` (passport) or `TXID` (RUC).
> * On `bank_transfer`, omitting `bank_code` targets an account at the
>   corridor's issuing bank; for **another bank** send the `bank_code` from
>   the catalog (`GET /v1/payouts/banks?country=EC`) plus `account_type`
>   (`checking` or `savings`).
> * Optional structured names (`given_name`, `middle_name`,
>   `first_surname`, `second_surname` and their `sender_*` counterparts):
>   send them when you have them — they take precedence over the automatic
>   split of `name`.
> * The final status arrives via the `payout_status_changed` webhook (with
>   periodic reconciliation as backup).

> [tab] Paraguay
>
> Bank transfer in PYG:
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "PY",
>     "currency": "PYG",
>     "method": "bank_transfer",
>     "amount": "500000",
>     "beneficiary": {
>       "name": "Sofia Benitez",
>       "tax_id": "4123456",
>       "bank_code": "0011",
>       "account_number": "600123456"
>     },
>     "idempotency_key": "py-bank-9917"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "d4e7…",
>   "country": "PY",
>   "currency": "PYG",
>   "method": "bank_transfer",
>   "local_amount": "500000",
>   "fx_rate": "6055.76",
>   "usdt_amount": "82.566020",
>   "fee": "0.300000",
>   "total_debit": "82.866020",
>   "status": "processing",
>   "bank_reference": ""
> }
> ```
>
> `name` accepts up to 35 characters in this corridor.

> [tab] Argentina
>
> **Bank aliases**: for ARS and USD `bank_transfer`, `beneficiary.account_number` also accepts a bank alias from 6 to 20 letters/numbers/dots/hyphens, with at least one letter. A numeric-only value is treated as a CBU/CVU, not an alias. CBPay resolves a valid alias to its destination account before dispatch; the wire uses the resolved CBU. ARS can resolve to a CBU or CVU; USD remains CBU-to-CBU only. An alias that cannot be resolved is rejected without debiting the balance. The original alias remains available in the payout evidence for reconciliation.
> Bank transfer in **ARS** or **USD** to any 22-digit **CBU or CVU** (bank
> accounts and virtual wallets). No `bank_code` needed: the CBU/CVU
> identifies the bank on its own.
>
> ```bash ARS (CBU or CVU) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "AR",
>     "currency": "ARS",
>     "method": "bank_transfer",
>     "amount": "50000.00",
>     "beneficiary": {
>       "name": "Julieta Fernandez",
>       "tax_id": "27-23456789-1",
>       "account_number": "2850590940090418135201"
>     },
>     "idempotency_key": "ar-ars-3311"
>   }'
> ```
>
> ```bash USD (CBU only) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "AR",
>     "currency": "USD",
>     "method": "bank_transfer",
>     "amount": "100.00",
>     "beneficiary": {
>       "name": "Julieta Fernandez",
>       "tax_id": "27-23456789-1",
>       "account_number": "2850590940090418135201"
>     },
>     "idempotency_key": "ar-usd-3312"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "b7c1…",
>   "country": "AR",
>   "currency": "ARS",
>   "method": "bank_transfer",
>   "local_amount": "50000.00",
>   "fx_rate": "1250.00",
>   "usdt_amount": "40.000000",
>   "fee": "0.300000",
>   "total_debit": "40.300000",
>   "status": "completed",
>   "bank_reference": "00761123456"
> }
> ```
>
> * `tax_id` is the destination account holder's **CUIT/CUIL** (11 digits;
>   dashes are accepted and normalized).
> * **USD works bank-account-to-bank-account only (CBU)**: a CVU (virtual
>   wallet) does not support dollars — the payout is rejected before it is
>   sent.
> * Most payouts confirm in the same call (`status: "completed"`); if the
>   rail leaves it `processing`, the final state arrives via the
>   `payout_status_changed` webhook.
> * Exceptional: the rail can **reverse** an already-credited transfer (for
>   example, by order of the receiving bank). If that happens the payout
>   moves to `failed`, the debit is fully refunded and you receive the
>   `payout_status_changed` webhook.

> [tab] United States
>
> Payouts in **USD** to US bank accounts, with three methods:
>
> * **`ach`** — ACH transfer to a checking or savings account. Submitted for
>   **next-day** settlement.
> * **`wire`** — domestic wire transfer. Minimum **USD 25.00**.
> * **`swift`** — international USD wire via SWIFT. Minimum **USD 25.00**.
>   Planning estimates: **ACH, 24–48 business hours; wire/Fedwire, same business day (up to 24 hours); SWIFT, 24–48 business hours, potentially longer depending on the receiving bank.** Payouts remain `processing` until bank confirmation.
>
> The US banking rail requires the beneficiary's **complete identity and
> postal address on every transfer** — an incomplete beneficiary is rejected
> at creation (`422`, see below). The beneficiary's `country_code` is their
> **country of residence and can be ANY country** (for example, an ACH
> transfer to a US bank for a beneficiary living in Germany); what stays
> fixed is the **bank**: on `ach`/`wire` the receiving bank must be in the
> US (`bank_country: "US"`), while `swift` is international by design. The
> compliance floor (Cuba, Iran, North Korea and Syria) remains blocked for
> the beneficiary's country AND the bank's country. Required and optional
> fields:
>
> | Field | `ach` | `wire` | `swift` | Notes |
> | - | - | - | - | - |
> | `name` | required | required | required | Full legal name of the holder |
> | `account_number` | required | required | required | US bank account number |
> | `email` | required | required | required | The rail registers it for every beneficiary |
> | `country_code` | required | required | required | ISO-3166 alpha-2 of the **beneficiary's residence** — any country (not just `US`) |
> | `address`, `city`, `postal_code` | required | required | required | Full postal address of the beneficiary |
> | `state` | conditional | conditional | conditional | Required **only if `country_code` is `US`** (2-letter state code); optional otherwise |
> | `phone` | optional | optional | optional | Beneficiary contact phone |
> | `bank_name` | required | required | required | Receiving bank's name |
> | `bank_code` | required | required | required | **ABA routing number** (9 digits) for `ach`/`wire`; **SWIFT BIC** for `swift` |
> | `account_type` | required | — | — | `CHECKING` or `SAVING` |
> | `bank_country` | required (`US`) | required (`US`) | required | Receiving bank's country — **fixed to `US` on `ach`/`wire`**; any country on `swift` |
> | `bank_address`, `bank_city`, `bank_postal_code` | required | required | optional | Receiving bank's address block |
> | `bank_state` | required (US bank) | required (US bank) | optional | 2-letter state code of the receiving bank |
> | `bank_phone` | optional | optional | optional | Receiving bank's phone |
>
> There is no US banks catalog: `bank_code` is the beneficiary bank's own
> ABA routing number (ACH/wire) or SWIFT BIC (swift), which the beneficiary
> provides. To autodetect the bank while the sender types it, call
> `GET /v1/payouts/bank-directory/lookup` with the routing number or
> SWIFT/BIC — it resolves the bank name, city, state and address block from
> an embedded public bank directory, so you can prefill `bank_name` and the
> optional `bank_*` address fields. A `404 bank_not_found` simply means the
> code is not in the directory: keep the form manual.
>
> ```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl "https://api.qbank.cl/platform/v1/payouts/bank-directory/lookup?routing_number=021000021" \
>   -H "Authorization: Bearer <token>"
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "routing_number": "021000021",
>   "bank_name": "JPMORGAN CHASE",
>   "bank_city": "TAMPA",
>   "bank_state": "FL",
>   "bank_postal_code": "33610",
>   "bank_country": "US",
>   "bank_phone": "813-432-3700",
>   "source": "directory",
>   "directory_vintage": "fed_ach_2019"
> }
> ```
>
> ```bash ach theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "US",
>     "currency": "USD",
>     "method": "ach",
>     "amount": "250.00",
>     "beneficiary": {
>       "name": "John Carter",
>       "email": "john.carter@example.com",
>       "account_number": "123456789012",
>       "account_type": "CHECKING",
>       "country_code": "US",
>       "address": "1200 Brickell Ave",
>       "city": "Miami",
>       "state": "FL",
>       "postal_code": "33131",
>       "bank_name": "Example Bank",
>       "bank_code": "021000089",
>       "bank_address": "270 Park Ave",
>       "bank_city": "New York",
>       "bank_state": "NY",
>       "bank_postal_code": "10017",
>       "bank_country": "US"
>     },
>     "description": "Invoice 2210",
>     "idempotency_key": "us-ach-2210"
>   }'
> ```
>
> ```bash ach (beneficiary outside the US) theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "US",
>     "currency": "USD",
>     "method": "ach",
>     "amount": "250.00",
>     "beneficiary": {
>       "name": "Anna Becker",
>       "email": "anna.becker@example.com",
>       "account_number": "123456789012",
>       "account_type": "CHECKING",
>       "country_code": "DE",
>       "address": "Friedrichstrasse 100",
>       "city": "Berlin",
>       "postal_code": "10117",
>       "bank_name": "Example Bank",
>       "bank_code": "021000089",
>       "bank_address": "270 Park Ave",
>       "bank_city": "New York",
>       "bank_state": "NY",
>       "bank_postal_code": "10017",
>       "bank_country": "US"
>     },
>     "description": "Invoice 2210",
>     "idempotency_key": "us-ach-2210-de"
>   }'
> ```
>
> ```bash wire theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "US",
>     "currency": "USD",
>     "method": "wire",
>     "amount": "1000.00",
>     "beneficiary": {
>       "name": "John Carter",
>       "email": "john.carter@example.com",
>       "account_number": "123456789012",
>       "country_code": "US",
>       "address": "1200 Brickell Ave",
>       "city": "Miami",
>       "state": "FL",
>       "postal_code": "33131",
>       "bank_name": "Example Bank",
>       "bank_code": "021000089",
>       "bank_address": "270 Park Ave",
>       "bank_city": "New York",
>       "bank_state": "NY",
>       "bank_postal_code": "10017",
>       "bank_country": "US"
>     },
>     "description": "Invoice 2211",
>     "idempotency_key": "us-wire-2211"
>   }'
> ```
>
> ```bash swift theme={"theme":{"light":"github-light","dark":"github-dark"}}
> curl -X POST https://api.qbank.cl/platform/v1/payouts \
>   -H "Authorization: Bearer <token>" \
>   -H "Content-Type: application/json" \
>   -d '{
>     "country": "US",
>     "currency": "USD",
>     "method": "swift",
>     "amount": "1000.00",
>     "beneficiary": {
>       "name": "John Carter",
>       "email": "john.carter@example.com",
>       "account_number": "123456789012",
>       "country_code": "US",
>       "address": "1200 Brickell Ave",
>       "city": "Miami",
>       "state": "FL",
>       "postal_code": "33131",
>       "bank_name": "Example Bank",
>       "bank_code": "CHASUS33XXX",
>       "bank_country": "US"
>     },
>     "description": "Invoice 2212",
>     "idempotency_key": "us-swift-2212"
>   }'
> ```
>
> ```json theme={"theme":{"light":"github-light","dark":"github-dark"}}
> {
>   "payout_id": "c5f2…",
>   "country": "US",
>   "currency": "USD",
>   "method": "ach",
>   "local_amount": "250.00",
>   "fx_rate": "0.9980",
>   "usdt_amount": "250.501002",
>   "fee": "0.300000",
>   "total_debit": "250.801002",
>   "status": "processing",
>   "bank_reference": "CBF1234567890123"
> }
> ```
>
> * **US payouts stay `processing` until the bank confirms the manual payment.**
>   Create already returns the CBF in `bank_reference`. Listen to
>   `payout_status_changed` for `completed` or `failed` (refunded).
> * There is no extra AML/CFT hold of the beneficiary in this rail: the operator
>   pays by hand and the poller reconciles.
> * **Minimums**: `wire` and `swift` require at least **USD 25.00**; below
>   that the creation is rejected with `422` and `status_message`
>   `"…payouts require an amount of at least USD 25"`. ACH has no validated
>   minimum.
> * The rail asks for a **payment purpose declaration** on every transfer.
>   `purpose` is mandatory (21-value catalog — see below); the other
>   declarations default unless you override them per operation in `options`
>   (values up to 140 characters):
>
>   | `options` key | What it declares | Default |
>   | - | - | - |
>   | `purpose` | Payment purpose (mandatory catalog) | — (none; required) |
>   | `crypto_activity` | Whether the payment relates to crypto buy/sell activity (`Yes`/`No`) | `No` |
>   | `payment_gateway` | Deposit gateway declaration | rail default |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.