Examples by country
Every corridor with its exactbeneficiary, 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) |
- Chile
- Peru
- Mexico
- Venezuela
- Bolivia
- Brazil
- Ecuador
- Paraguay
- Argentina
- United States
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, The banks catalog (
30000 or 30000.00).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"
}'
{
"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": ""
}
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.Two methods: bank transfer (interbank CCI) and Yape (to a phone
number).For
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"
}'
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"
}'
{
"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"
}
yape the phone uses the 51XXXXXXXXX format (11 digits with country
code). The result is usually synchronous.SPEI in MXN, to a CLABE (18 digits) or a debit card:With a CLABE the destination bank derives from its leading digits; with a
card,
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"
}'
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"
}'
{
"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": ""
}
bank_code is required.Two methods: Pago Móvil (name + phone + bank + ID) and bank transfer
(20-digit account):
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"
}'
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"
}'
{
"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.ACH transfer in BOB or USD (besides the QR):For USD send
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"
}'
{
"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": ""
}
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.PIX by key (besides the PIX QR):
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"
}'
{
"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):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_codeis the destination bank’s ISPB (8 digits),branch_codethe agency, andaccount_typethe account type (CACCchecking — default —,SVGSsavings,TRANpayment account,SLRYsalary).- The final status arrives through the
payout_status_changedwebhook (continuous reconciliation against the rail); check on demand withGET /v1/payouts/{id}.
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.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"
}'
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"
}'
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"
}'
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"
}'
{
"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_valueis the beneficiary’s cédula;document_typeacceptsIDCD(national ID, default),CCPT(passport) orTXID(RUC).- On
bank_transfer, omittingbank_codetargets an account at the corridor’s issuing bank; for another bank send thebank_codefrom the catalog (GET /v1/payouts/banks?country=EC) plusaccount_type(checkingorsavings). - Optional structured names (
given_name,middle_name,first_surname,second_surnameand theirsender_*counterparts): send them when you have them — they take precedence over the automatic split ofname. - The final status arrives via the
payout_status_changedwebhook (with periodic reconciliation as backup).
Bank transfer in PYG:
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"
}'
{
"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.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.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"
}'
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"
}'
{
"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_idis 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 itprocessing, the final state arrives via thepayout_status_changedwebhook. - 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 thepayout_status_changedwebhook.
Payouts in USD to US bank accounts, with three methods:
There is no US banks catalog:
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 remainprocessinguntil bank confirmation.
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 |
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.curl "https://api.qbank.cl/platform/v1/payouts/bank-directory/lookup?routing_number=021000021" \
-H "Authorization: Bearer <token>"
{
"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"
}
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"
}'
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"
}'
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"
}'
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"
}'
{
"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
processinguntil the bank confirms the manual payment. Create already returns the CBF inbank_reference. Listen topayout_status_changedforcompletedorfailed(refunded). - There is no extra AML/CFT hold of the beneficiary in this rail: the operator pays by hand and the poller reconciles.
-
Minimums:
wireandswiftrequire at least USD 25.00; below that the creation is rejected with422andstatus_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.
purposeis mandatory (21-value catalog — see below); the other declarations default unless you override them per operation inoptions(values up to 140 characters):optionskeyWhat it declares Default purposePayment purpose (mandatory catalog) — (none; required) crypto_activityWhether the payment relates to crypto buy/sell activity ( Yes/No)Nopayment_gatewayDeposit gateway declaration rail default