Payouts

Un payout envía dinero en moneda local a una cuenta bancaria del país destino. El monto se convierte de moneda local a USDT con la tasa de tu cuenta (la de GET /v1/rates) y se debita usdt_amount + fee (el fijo, si está configurado) de tu saldo. Así se ve el ciclo completo, incluido qué pasa con tu saldo en cada paso:

1. Descubre los corredores disponibles

Los países, monedas y métodos disponibles los define CBPay. Consúltalos siempre por catálogo:

curl https://api.qbank.cl/platform/v1/payouts/methods \
  -H "Authorization: Bearer <token>"

{
  "items": [
    { "country": "CL", "currency": "CLP", "method": "bank_transfer" },
    { "country": "PE", "currency": "PEN", "method": "bank_transfer" },
    { "country": "PE", "currency": "PEN", "method": "yape" },
    { "country": "BO", "currency": "BOB", "method": "qr" }
  ],
  "meta": { "retrieved": 4 }
}

Corredores y métodos disponibles:

País	Moneda	Métodos
Chile	CLP	`bank_transfer`
Perú	PEN	`bank_transfer`, `yape`
México	MXN	`bank_transfer` (SPEI: CLABE o tarjeta de débito)
Venezuela	VES	`bank_transfer`, `pago_movil`
Bolivia	BOB / USD	`bank_transfer`, `qr` (ver Payout QR)
Brasil	BRL	`pix` (por llave o a cuenta), `qr` (QR PIX — ver Payout QR)
Ecuador	USD	`bank_transfer`, `deuna`, `cash_pickup`, `cnb`
Paraguay	PYG	`bank_transfer`
Argentina	ARS / USD	`bank_transfer` (CBU o CVU)
Colombia	COP	`bank_transfer` (montos enteros, sin decimales)
Estados Unidos	USD	`ach`, `wire`, `swift`

La disponibilidad puede variar; el catálogo (GET /v1/payouts/methods) es siempre la fuente de verdad. Si un país tiene un solo método, method es opcional. Todos los métodos se cobran igual: tu tasa + fijo. Para transferencias bancarias necesitas además el catálogo de bancos (de ahí sale el bank_code del beneficiario):

curl "https://api.qbank.cl/platform/v1/payouts/banks?country=CL" \
  -H "Authorization: Bearer <token>"

{
  "items": [
    { "code": "001", "name": "Banco de Chile" },
    { "code": "012", "name": "Banco del Estado de Chile" },
    { "code": "016", "name": "Banco de Crédito e Inversiones" }
  ],
  "meta": { "retrieved": 3 }
}

2. Crea el payout

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": "María López",
      "account_type": "clabe",
      "account_number": "012180001234567895"
    },
    "description": "Pago factura 8841",
    "idempotency_key": "factura-8841"
  }'

beneficiary es un objeto de pares clave/valor cuyos campos requeridos dependen del corredor (RUT y banco en Chile, CLABE en México, CCI en Perú, llave PIX en Brasil, etc.). El catálogo de métodos documenta los campos de cada uno.

Cada payout guarda al beneficiario como contacto automáticamente ("save_contact": false para no guardarlo). Para repetirle un pago sin re-tipear sus datos, envía "beneficiary_contact_id" en vez de beneficiary — se usa su beneficiario guardado más reciente para ese país y método (422 no_saved_destination si no tiene).

Respuesta 202 Accepted:

{
  "payout_id": "0d4f…",
  "account_id": "…",
  "idempotency_key": "factura-8841",
  "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",
  "settlement_asset": "USDT",
  "settlement_amount": "86.014286",
  "settlement_rate": "1",
  "status": "processing",
  "status_code": "",
  "status_message": "",
  "funds_debited": true,
  "compliance_pending": false,
  "bank_reference": "",
  "created_at": "2026-07-06T20:00:00Z"
}

En ese momento tu saldo ya refleja el débito: total_debit pasó de available a held (en el saldo del settlement_asset).

bank_reference — el id propio del banco para la transferencia. En US ACH, wire y SWIFT es la referencia CBF que vuelve de inmediato al crear (el payout sigue processing hasta que el banco confirma). En el resto de corredores queda vacio ("") hasta completed. Mientras el payout está en curso viene vacío (""); cuando el payout queda completed, lleva el id de transacción asignado por el banco/rail de destino. Es el valor que el beneficiario puede usar para cruzar el pago con su banco, y también aparece en el webhook payout_status_changed, el comprobante PDF, el export CSV de payouts y la cartola. Las respuestas, CSV, webhooks y comprobantes también incluyen uetr (UETR/SWIFT gpi) e imad (wire/ACH doméstico), vacíos hasta que el banco los reporte; usa el tracker público para el estado vivo y el mismo comprobante.

Pagar desde otro saldo (`settlement_asset`)

Por defecto el débito sale de USD; usa PUT /v1/settlement para cambiarlo. Para pagar una operación puntual desde otro saldo, agrega settlement_asset al request. Ejemplo: un payout de 100.000 CLP pagado desde el saldo BTC pasa por cuatro transformaciones, todas registradas en la respuesta:

CLP → USDT a tu tasa: 100000 / 950.25 = 105.235465 USDT.
+ comisión fija: 105.235465 + 0.30 = 105.535465 USDT (total_debit).
USDT → BTC al precio efectivo de settlement (settlement_rate 109029.34070000): 105.535465 / 109029.3407 = 0.00096795 BTC (redondeo hacia arriba al satoshi).
Débito y hold en BTC: settlement_amount 0.00096795 sale de tu saldo BTC; el beneficiario recibe sus 100.000 CLP igual que siempre.

{
  "country": "CL",
  "currency": "CLP",
  "local_amount": "100000",
  "fx_rate": "950.25",
  "usdt_amount": "105.235465",
  "fee": "0.300000",
  "total_debit": "105.535465",
  "settlement_asset": "BTC",
  "settlement_amount": "0.00096795",
  "settlement_rate": "109029.34070000",
  "status": "processing",
  "status_code": "",
  "status_message": "",
  "funds_debited": true,
  "compliance_pending": false,
  "bank_reference": ""
}

Si el payout falla, se reembolsa el settlement_amount exacto a tu saldo BTC — nunca se re-cotiza. Si el precio de ejecución de BTC/GOLD/SILVER/PLATINUM no está disponible en ese momento recibirás 503 pricing_unavailable, y los assets volátiles tienen un límite por operación (422 settlement_limit_exceeded; consúltalo en GET /v1/settlement). Para settlement BOB, MXN o ARS en la misma moneda, consulta Settlement de payouts fiat.

El screening técnico puede quedar pendiente

CBPay screenea al beneficiario antes de debitar tu saldo o llamar al core. Si el servicio de screening está temporalmente no disponible y la cola técnica de screening está disponible, el payout se persiste y el create responde 202 Accepted con el recurso en status: "pending":

{
  "payout_id": "0d4f…",
  "idempotency_key": "invoice-8841",
  "status": "pending",
  "status_code": "compliance_pending",
  "status_message": "",
  "funds_debited": false,
  "compliance_pending": true,
  "predebit_failure": false,
  "created_at": "2026-07-06T20:00:00Z",
  "updated_at": "2026-07-06T20:00:00Z"
}

Mientras está pendiente no hay débito, hold, asiento en el ledger, despacho al core ni receipt_url. El replay con la misma clave de idempotencia devuelve el mismo payout con idempotency_hit: true; nunca crea una segunda operación. Cuando el worker recibe process, el payout existente sigue el flujo normal de débito y despacho. Un hold válido entra al firewall transaccional. Un rejected posterior termina el payout en failed sin débito. Después de aceptar process, el mismo payout puede permanecer en status: "pending" mientras se reconcilian el débito y el despacho. La API y el webhook payout_status_changed exponen estos códigos de transición durables:

compliance_dispatch_pending: el screening pasó, existe el débito/hold y funds_debited: true, pero el despacho al core aún no terminó.
compliance_dispatching: el claim de despacho está en curso.
core_unreachable: el despacho o la liquidación local es ambiguo y espera conciliación; no crees un segundo payout.

Estas transiciones no son una operación nueva. Conserva la misma idempotency_key, lee el payout y espera el siguiente evento de estado. Cuando el payout termina, completed consume el hold y failed devuelve el débito exacto. Los eventos finales usan el camino durable e incluyen los campos normales del comprobante. La respuesta técnica compliance_check_unavailable sigue aplicando cuando el payout no se puede dejar en la cola pendiente y en los flujos que no tienen esta cola. No reemplaza los contratos actuales de validación, seguridad ni compliance_hold.

Un fallo antes del débito no es un reembolso

Si el screening o un control duro de compliance falla antes de iniciar el camino de débito, el mismo payout puede terminar failed con predebit_failure: true y funds_debited: false. La respuesta y su evento payout_status_changed omiten receipt_url, porque no hubo débito, hold ni comprobante que revertir. Es distinto de un failed posterior al débito, donde el débito exacto se reembolsa antes del evento terminal. Para conocer el origen de la tasa y las cotizaciones FIFO indicativas, revisa Orígenes de tasa de payouts y cotizaciones FIFO.

3. Recibe el estado final

Suscríbete al evento payout_status_changed (webhooks):

{
  "payout_id": "0d4f…",
  "account_id": "…",
  "country": "MX",
  "currency": "MXN",
  "local_amount": "1500.00",
  "usdt_amount": "85.714286",
  "total_debit": "86.014286",
  "status": "completed",
  "status_code": "",
  "status_message": "",
  "bank_reference": "00761123456"
}

completed: el dinero llegó; el hold se consume.
failed: se reembolsa el débito completo automáticamente (payout_refund en tu ledger).

status_message es el detalle opcional y normalizado que acompaña a status_code; puede venir vacío cuando el core no tiene un mensaje adicional. También puedes consultar en cualquier momento:

curl https://api.qbank.cl/platform/v1/payouts/0d4f… \
  -H "Authorization: Bearer <token>"

Estados del payout

Estado	Significado	¿Tu saldo?
`processing`	Aceptado y ejecutándose en el riel local	Débito retenido en `held`
`pending` + `compliance_pending: true`	El screening técnico del beneficiario espera antes de cualquier débito o despacho	Sin débito; `funds_debited: false`
`pending` + `compliance_dispatch_pending` / `compliance_dispatching` / `core_unreachable`	Screening aprobado; débito existente mientras espera despacho o conciliación	`funds_debited: true`; débito retenido
`completed`	El dinero llegó al beneficiario	Hold consumido — final
`failed` después del débito	El corredor lo rechazó o la ejecución falló después del débito	Reembolso automático completo (monto + comisión)
`failed` + `predebit_failure: true`	El screening o un control duro de compliance falló antes del débito	Sin débito; `funds_debited: false`, sin comprobante

Consulta e historial

Cada payout se puede leer individualmente y el listado acepta filtros:

# Un payout
curl https://api.qbank.cl/platform/v1/payouts/0d4f… \
  -H "Authorization: Bearer <token>"

# Historial con filtros: fechas, estado, país, método, búsqueda y paginación
curl "https://api.qbank.cl/platform/v1/payouts?from=2026-07-01&to=2026-07-08&status=failed&country=MX&method=bank_transfer&search=0d4f&page=1&page_size=50" \
  -H "Authorization: Bearer <token>"

{
  "page": 1,
  "page_size": 50,
  "payouts": [
    {
      "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": "failed",
      "status_code": "core_rejected",
      "status_message": "beneficiary account does not exist",
      "bank_reference": "",
      "created_at": "2026-07-06T20:00:00Z"
    }
  ]
}

from/to van en YYYY-MM-DD (zona horaria de tu organización, ambos inclusive); una fecha inválida responde 400 invalid_range. method filtra por el catálogo activo de payouts y search hace una coincidencia parcial sin distinguir mayúsculas/minúsculas sobre el ID del payout, la referencia bancaria o la clave de idempotencia.

Ejemplos por país

Cada corredor con su beneficiary exacto, el request completo y la respuesta real. Las tasas (fx_rate) son ilustrativas — siempre aplican las de tu cuenta en GET /v1/rates; el débito es usdt_amount + fee (fijo, si está configurado; aquí 0.30).

Campos del beneficiary por corredor

País	Método	Campos del `beneficiary`
CL	`bank_transfer`	`name`, `tax_id` (RUT), `bank_code`, `account_type`, `account_number`
PE	`bank_transfer`	`name`, `account_number` (CCI de 20 dígitos)
PE	`yape`	`name`, `phone` (`51XXXXXXXXX`)
MX	`bank_transfer`	`name`, `account_type` (`clabe`/`debit_card`), `account_number` (+ `bank_code` si es tarjeta)
VE	`pago_movil`	`name` (nombre + primer apellido, tal como en la cédula), `phone`, `bank_code` (SUDEBAN), `document_value`
VE	`bank_transfer`	`name`, `account_number` (20 dígitos), `document_value`
BO	`bank_transfer`	`name`, `tax_id`, `bank_code`, `account_number`
BR	`pix`	`name`, `tax_id` + (`pix_key` y `pix_key_type`) o (`bank_code` ISPB, `branch_code`, `account_number`)
EC	`bank_transfer`	`name`, `document_value` (cédula), `sender_name`, `account_number` (+ `bank_code` y `account_type` si es a otro banco)
EC	`deuna`	`name`, `document_value`, `sender_name`, `phone` (celular de la billetera)
EC	`cash_pickup` / `cnb`	`name`, `document_value`, `sender_name` — el beneficiario retira con su documento
PY	`bank_transfer`	`name` (≤35), `tax_id`, `bank_code`, `account_number`
AR	`bank_transfer`	`name`, `tax_id` (CUIT/CUIL de 11 dígitos), `account_number` (CBU/CVU de 22 dígitos o alias bancario; USD solo CBU)
US	`ach` / `wire` / `swift`	`name`, `account_number`, `email`, `country_code` (cualquier país), `address`, `city`, `postal_code` (+ `state` si `country_code` es `US`), `bank_name`, `bank_country` (`US` en `ach`/`wire`), `bank_code` (routing ABA para `ach`/`wire`, BIC SWIFT para `swift`; + `account_type` `CHECKING`/`SAVING` para `ach`)

Transferencia bancaria en CLP. Requiere RUT, banco y cuenta: el peso chileno no tiene unidad menor, por lo que los montos de payouts CLP deben ser enteros (por ejemplo, 30000 o 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": "Pago proveedor",
    "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": ""
}

El catálogo de bancos (GET /v1/payouts/banks?country=CL) da los bank_code vigentes. CL/CLP/bank_transfer puede despacharse en ventanas agrupadas de cinco minutos; POST /v1/payouts sigue respondiendo 202 con status: "processing" y cada payout conserva su estado final y su webhook payout_status_changed.

Dos métodos: transferencia bancaria (CCI interbancario) y Yape (al número de teléfono).

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 Álvarez Díaz",
      "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"
}

En yape el teléfono va en formato 51XXXXXXXXX (11 dígitos con código de país). El resultado suele ser síncrono.

SPEI en MXN, a CLABE (18 dígitos) o a tarjeta de débito:

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": "María López",
      "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": ""
}

Con CLABE el banco destino se deriva de los primeros dígitos; con tarjeta es obligatorio bank_code.

Dos métodos: Pago Móvil (nombre + teléfono + banco + cédula) y transferencia bancaria (cuenta de 20 dígitos):

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 usa códigos SUDEBAN; en bank_transfer puede derivarse de los primeros 4 dígitos de la cuenta.

Transferencia ACH en BOB o USD (además del payout QR):

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": ""
}

Para USD envía currency: "USD" con la misma estructura. La configuración de riel de la organización decide qué versión interna atiende los payouts de Bolivia; la elección se guarda en la operación para que el sondeo posterior siga usando la versión correcta, y respuestas y webhooks se mantienen provider-agnostic.

PIX por llave (además del QR PIX):

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",
  "bank_reference": ""
}

pix_key_type: cpf, cnpj, phone, email o evp (llave aleatoria).PIX a cuenta (sin llave) — si el beneficiario no tiene o no entrega su llave PIX, envía sus datos bancarios; llega igual de rápido (mismo riel PIX, 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_code es el ISPB del banco destino (8 dígitos), branch_code la agencia y account_type el tipo de cuenta (CACC corriente — default —, SVGS ahorro, TRAN cuenta de pago, SLRY salario).
El estado final llega por el webhook payout_status_changed (conciliación continua contra el rail); consulta puntual con GET /v1/payouts/{id}.

Remesas en USD (1 a 10.000 por operación, máx. 2 decimales) con cuatro métodos: transferencia bancaria, billetera DE UNA (por celular), retiro en ventanilla (cash_pickup) y retiro en corresponsal no bancario (cnb). Es un corredor de remesas: además del beneficiario, el rail exige los datos del ordenante (quien envía), que van planos dentro del mismo beneficiary con prefijo sender_*.

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 está dolarizado: la moneda local ES el USD (fx_rate: "1").
document_value es la cédula del beneficiario; document_type acepta IDCD (cédula, default), CCPT (pasaporte) o TXID (RUC).
En bank_transfer, si omites bank_code la cuenta es del banco emisor del corredor; para otro banco envía el bank_code del catálogo (GET /v1/payouts/banks?country=EC) más account_type (checking o savings).
Nombres estructurados opcionales (given_name, middle_name, first_surname, second_surname y sus pares sender_*): si los tienes, envíalos — mandan sobre la separación automática de name.
El estado final llega por webhook payout_status_changed (con conciliación periódica de respaldo).

Transferencia bancaria en 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": "Sofía Benítez",
      "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 acepta hasta 35 caracteres en este corredor.

Alias bancarios: en bank_transfer ARS y USD, beneficiary.account_number también acepta un alias de 6 a 20 letras/números/puntos/guiones, con al menos una letra. Un valor solo numérico se trata como CBU/CVU, no como alias. CBPay resuelve un alias válido a la cuenta destino antes de despachar; el wire usa el CBU resuelto. ARS puede resolver a CBU o CVU; USD sigue siendo solo CBU a CBU. Un alias que no puede resolverse se rechaza sin debitar el saldo. El alias original queda disponible en la evidencia del payout.Transferencia bancaria en ARS o USD a cualquier CBU o CVU de 22 dígitos (cuentas bancarias y billeteras virtuales). No necesitas bank_code: el CBU/CVU identifica el banco por sí solo.

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_id es el CUIT/CUIL del titular de la cuenta destino (11 dígitos; los guiones se aceptan y se normalizan).
USD opera solo de cuenta bancaria a cuenta bancaria (CBU): una CVU (billetera virtual) no admite dólares — el payout se rechaza antes de enviarse.
La mayoría de los payouts se confirma en la misma llamada (status: "completed"); si el rail queda en processing, el estado final llega por webhook payout_status_changed.
Excepcional: el rail puede reversar una transferencia ya acreditada (por ejemplo, por orden del banco receptor). Si ocurre, el payout pasa a failed, el débito se reembolsa completo y recibes el webhook payout_status_changed.

Payouts en USD a cuentas bancarias de EE. UU., con tres métodos:

ach — transferencia ACH a cuenta corriente o de ahorro. Se envía con liquidación al día siguiente.
wire — transferencia wire doméstica. Mínimo USD 25.00.
swift — wire internacional en USD vía SWIFT. Mínimo USD 25.00.

El riel bancario de EE. UU. exige la identidad y dirección postal completas del beneficiario en cada transferencia — un beneficiario incompleto se rechaza al crear (422, ver abajo). El beneficiario puede vivir en cualquier país: country_code es libre (por ejemplo, un ACH a un banco de EE. UU. para un beneficiario que vive en Alemania). Lo que sigue fijo es el banco receptor: en ach/wire debe ser un banco de EE. UU. (bank_country: "US" — el riel doméstico no paga a bancos fuera de EE. UU.); en swift el banco puede ser de cualquier país. Las jurisdicciones del Anexo B (CU/IR/KP/SY) siguen bloqueadas para el país del beneficiario y del banco (422 prohibited_country). Campos requeridos y opcionales:

Campo	`ach`	`wire`	`swift`	Notas
`name`	requerido	requerido	requerido	Nombre legal completo del titular
`account_number`	requerido	requerido	requerido	Número de cuenta bancaria
`email`	requerido	requerido	requerido	El riel lo registra para cada beneficiario
`country_code`	requerido	requerido	requerido	ISO-3166 alpha-2 de residencia del beneficiario — cualquier país (no solo `US`)
`address`, `city`, `postal_code`	requerido	requerido	requerido	Dirección postal completa del beneficiario (sin validación de formato ZIP fuera de EE. UU.)
`state`	condicional	condicional	condicional	Requerido solo si `country_code` es `US` (código de estado de 2 letras); opcional en el resto
`phone`	opcional	opcional	opcional	Teléfono de contacto del beneficiario
`bank_name`	requerido	requerido	requerido	Nombre del banco receptor
`bank_country`	requerido (`US`)	requerido (`US`)	requerido	País del banco receptor — fijo en `US` para `ach`/`wire`; cualquier país en `swift`
`bank_code`	requerido	requerido	requerido	Routing number ABA (9 dígitos) para `ach`/`wire`; BIC SWIFT para `swift`
`account_type`	requerido	—	—	`CHECKING` o `SAVING`
`bank_address`, `bank_city`, `bank_postal_code`	requerido	requerido	opcional	Dirección del banco receptor — en `swift` el riel la deriva del BIC
`bank_state`	requerido (banco US)	requerido (banco US)	opcional	Estado del banco cuando `bank_country` es `US`
`bank_phone`	opcional	opcional	opcional	Teléfono del banco receptor

No hay catálogo de bancos de EE. UU.: el bank_code es el propio routing ABA del banco del beneficiario (ACH/wire) o su BIC SWIFT (swift), dato que entrega el beneficiario. Para autodetectar el banco mientras el pagador lo escribe, llama GET /v1/payouts/bank-directory/lookup con el routing number o el SWIFT/BIC — resuelve el nombre del banco, ciudad, estado y bloque de dirección desde un directorio bancario público embebido, así puedes pre-llenar bank_name y los campos opcionales bank_*. Un 404 bank_not_found solo significa que el código no está en el directorio: el formulario sigue 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": "500 Main Street",
      "bank_city": "New York",
      "bank_state": "NY",
      "bank_postal_code": "10001",
      "bank_country": "US"
    },
    "description": "Factura 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 Schmidt",
      "email": "anna.schmidt@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": "500 Main Street",
      "bank_city": "New York",
      "bank_state": "NY",
      "bank_postal_code": "10001",
      "bank_country": "US"
    },
    "description": "Factura 2215",
    "idempotency_key": "us-ach-2215"
  }'

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": "500 Main Street",
      "bank_city": "New York",
      "bank_state": "NY",
      "bank_postal_code": "10001",
      "bank_country": "US"
    },
    "description": "Factura 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": "Factura 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"
}

Los payouts US quedan processing hasta que el banco confirma el pago manual. El create ya devuelve el CBF en bank_reference. Escucha payout_status_changed para completed o failed (reembolsado).
En este riel no hay un hold AML extra del beneficiario: el operador paga a mano y el poller reconcilia.
Mínimos: wire y swift exigen al menos USD 25.00; bajo eso la creación se rechaza con 422 y status_message "…payouts require an amount of at least USD 25". ACH no tiene mínimo validado.

El riel pide una declaración de propósito del pago en cada transferencia. purpose es obligatorio (catálogo de 21 valores — ver abajo); las otras declaraciones usan su default salvo que las sobreescribas por operación en options (valores de hasta 140 caracteres):

Clave de `options`	Qué declara	Default
`purpose`	Propósito del pago (catálogo obligatorio)	— (ninguno; requerido)
`crypto_activity`	Si el pago se relaciona con compra/venta de cripto (`Yes`/`No`)	`No`
`payment_gateway`	Declaración de gateway de depósito	default del riel

SEPA Instant en EUR

Consulta la guía dedicada de payouts SEPA Instant para la única fila de enrutamiento Europa (EU)/EUR/sepa; el país real del beneficiario sale del IBAN. Los IBAN GB fallan rápido con HTTP 400 antes del despacho; SEPA Credit Transfer para GB es alcance futuro.

Documento de respaldo obligatorio en transferencias USD

TODA transferencia saliente en USD por rail bancario (ach, wire o swift) exige un documento de respaldo (factura o recibo) adjunto — es un requisito del banco procesador y aplica a cualquier corredor USD, no solo al de EE. UU. (por ejemplo, también a un SWIFT internacional como PY/USD/swift).

Sube el documento

Envía el archivo con POST /v1/payouts/documents: binario crudo un PDF (application/pdf, hasta 50 MB) y el nombre en el query param name. La interfaz actual de payouts US/USD acepta solo PDF.

curl -X POST "https://api.qbank.cl/platform/v1/payouts/documents?name=factura-2210.pdf" \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/pdf" \
  --data-binary "@factura-2210.pdf"

{
  "document_key": "payout-docs/9f1c…/org/…/3c2e…"
}

Pásalo al crear el payout

El document_key viaja en options.supporting_document_key. En ach/wire puedes agregar options.document_reference_number (número de factura o referencia del documento) — se envía al banco.

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": { "…": "…" },
    "options": {
      "supporting_document_key": "payout-docs/9f1c…/org/…/3c2e…",
      "document_reference_number": "INV-2210"
    },
    "idempotency_key": "us-ach-2210"
  }'

Un payout USD por rail bancario creado sin el documento se rechaza al crear con 400 supporting_document_required (sin débito).
Una key subida por otra cuenta se rechaza con 400 invalid_document_key.
La document_key queda almacenada: si el create falla por otra causa, la reutilizas en el reintento — no necesitas re-subir el archivo.

Payout QR

Pagar un QR de cobro (Bolivia, PIX de Brasil) ahora tiene su propia guía:

Payout QR

Escanea el QR gratis, muestra a tu usuario los datos del destinatario y confirma el pago en una segunda llamada — se cobra como un payout normal.

Errores frecuentes

HTTP	`error`	Qué hacer
400	`idempotency_key_required`	Envía la clave en body o header
400	`beneficiary_required`	Incluye el objeto `beneficiary`
400	`supporting_document_required`	La transferencia USD por rail bancario exige el documento de respaldo — súbelo con `POST /v1/payouts/documents` y pásalo en `options.supporting_document_key`
400	`invalid_document_key`	La `supporting_document_key` no pertenece a tu cuenta — sube el documento con tu propia sesión
402	`insufficient_funds`	Fondea la cuenta; el payout no se creó
403	`account_blocked`	La cuenta no está activa; contacta al equipo de CBPay
403	`service_disabled`	Payouts no está habilitado para tu cuenta — ver servicios
403	`compliance_hold`	El payout fue retenido por los controles de cumplimiento de la plataforma y NO se creó (sin débito). Por política no se informa la razón exacta — contacta a soporte con el timestamp; ver errores
422	`currency_not_supported`	No hay tasa FX para esa moneda
422	(payout con `status: failed`)	El corredor rechazó los datos; el débito ya fue reembolsado — corrige `beneficiary` y reintenta con clave nueva
503	`channel_unavailable`	El canal de pago está temporalmente no disponible; reintenta más tarde con la MISMA `idempotency_key`
503	`compliance_check_unavailable`	No se pudo evaluar compliance ni dejar el payout en la cola técnica de screening; reintenta con la misma idempotency key. Si la cola está disponible, el create devuelve `202` con `status: pending`

Rechazo inmediato vs fallo posterior

Si el procesador rechaza el payout al crearlo, recibes 422 con el objeto en status: failed y el reembolso ya aplicado. Si falla después (por ejemplo, cuenta destino inexistente detectada por el banco), te llega el webhook con status: failed y el reembolso automático en ese momento.

Cómo leer `status_code` en un payout fallido

`status_code`	Significado	Acción
`core_rejected`	El procesador rechazó la operación al crearla (datos del beneficiario inválidos, corredor no disponible)	Lee `status_message`, corrige y crea un payout nuevo con clave nueva
`counterparty_rejected`	El riel bancario rechazó al beneficiario mismo (corredor US/USD)	Revisa la identidad y dirección del beneficiario con el titular y crea un payout nuevo con clave nueva
`channel_unavailable`	El canal de pago quedó temporalmente no disponible	Reintenta más tarde; el reembolso (si hubo débito) ya está aplicado
otro código	Rechazo posterior del riel bancario (p. ej. cuenta destino cerrada)	Igual: corrige los datos y crea una operación nueva
(vacío)	Fallo genérico del corredor	Revisa `status_message`; si no es claro, contacta soporte con el `payout_id`

En todos los casos el reembolso ya está aplicado — verifícalo con la entrada payout_refund en movimientos.

Un payout en processing no se puede cancelar por API: el rail ya lo tiene. Espera el estado final por webhook o GET — llega siempre, con reembolso automático si falla.

FAQ

¿Cuándo se debita mi saldo?

Al crear: el payout debita y retiene los fondos de inmediato. Si el payout falla, el monto exacto debitado (comisión incluida) se reembolsa automáticamente.

¿Puedo cancelar un payout en processing?

No — una vez despachado al riel se resuelve solo a completed o failed. Suscríbete a payout_status_changed para el estado final.

¿Qué tasa FX usa mi payout?

La tasa cotizada al crear (devuelta como fx_rate), congelada para esa operación. Tu spread acordado ya viene dentro de la tasa.

¿Puedo pagar desde un saldo distinto de USDT?

Sí — fija un default por cuenta (PUT /v1/settlement) o sobreescribe por payout con settlement_asset (USDC, BTC, GOLD). Los reembolsos devuelven el monto liquidado exacto, jamás se re-cotizan.

¿Qué significa status: pending con compliance_pending: true?

El screening del beneficiario no está disponible temporalmente, pero CBPay persistió el payout en su cola técnica de screening. No se debitó saldo, no existe hold ni asiento en el ledger, no se llamó al core y todavía no hay receipt_url. El replay con la misma idempotency key devuelve el mismo recurso. Espera el evento payout_status_changed o consulta el payout: continuará con process, entrará al firewall con un hold válido o terminará failed sin débito si el resultado es rejected.

¿Qué significa compliance_hold (403)?

El beneficiario no pasó el screening de compliance: el payout no se creó y tu idempotency_key no se consumió. Revisa los datos del beneficiario o contacta a tu equipo CBPay.

¿Cómo reintento sin riesgo tras un timeout o 5xx?

Reintenta con la misma idempotency_key: recibes el payout original (idempotency_hit: true) — jamás un duplicado. Una clave nueva es un payout nuevo e independiente.

Por que mi payout US ACH/wire/SWIFT sigue processing?

Los payouts del riel bancario US los paga el operador a mano. El create ya trae el CBF en bank_reference y queda processing hasta que el banco confirma. Escucha payout_status_changed para el estado final; un fallo reembolsa el debito solo.

Para errores de payouts y la secuencia de reintento 422 destination_recently_rejected, consulta Errores y Protección ante rechazo del destino.

Propósito y validación de pagos US/USD

En payouts bancarios US/USD (ach, wire y swift), options.purpose es obligatorio. La API acepta la etiqueta visible o su código, sin distinguir mayúsculas. El catálogo aceptado es:

Etiqueta visible	Código aceptado
Asset Purchase	`Asset_Purchase`
Contract Payment	`Contract_Payment`
Dividends	`Dividends`
Education Payment	`Education_Payment`
Gift/Donation	`Gift_Donation`
Investment Purchase	`Investment_Purchase`
Invoice Payment	`Invoice_Payment`
Loan Payments	`Loan_Payments`
Materials Purchase	`Materials_Purchase`
Mortgage Payments	`Mortgage_Payments`
Payroll	`Payroll`
Personal/Family Payment	`Personal_Family_Payment`
Professional Service Payments	`Professional_Service_Payments`
Reimbursements	`Reimbursements`
Remittance	`Remittance`
Rent/Utility Payments	`Rent_Utility_Payments`
Savings	`Savings`
Settlement (Trade)	`Settlement_Trade`
Tax Payments	`Tax_Payments`
Treasury Movement	`Treasury_Movement`
Other (describe below)	`Other`

options.purpose_detail es obligatorio solo cuando purpose es Other y acepta hasta 140 caracteres. Se rechaza con cualquier otro propósito. Crear sin purpose ahora responde 400 purpose_required: es un cambio incompatible para clientes que dependían del antiguo default Invoice_Payment. beneficiary.account_type es obligatorio tanto para ach como para wire y debe ser checking o savings (sin distinguir mayúsculas). swift no usa este campo. Para wire y swift, montos menores a USD 25 responden 422 amount_below_minimum. Países del beneficiario o banco del Anexo B (CU, IR, KP, SY) responden 422 prohibited_country. Estas validaciones ocurren antes de debitar. Los errores normalizados son invalid_beneficiary, invalid_amount, amount_below_minimum, prohibited_country, purpose_required, invalid_options y supporting_document_required. Revisa message para corregir el campo exacto. No repitas una solicitud rechazada sin cambios; ante timeout o 5xx, reutiliza la misma clave de idempotencia.

Comenzar

Conceptos

Flujos de integración

Productos

Integración

Recursos

1. Descubre los corredores disponibles

2. Crea el payout

Pagar desde otro saldo (`settlement_asset`)

El screening técnico puede quedar pendiente

Un fallo antes del débito no es un reembolso

3. Recibe el estado final

Estados del payout

Consulta e historial

Ejemplos por país

Campos del beneficiary por corredor

SEPA Instant en EUR

Documento de respaldo obligatorio en transferencias USD

Payout QR

Payout QR

Errores frecuentes

Rechazo inmediato vs fallo posterior

Cómo leer `status_code` en un payout fallido

FAQ

Propósito y validación de pagos US/USD

​1. Descubre los corredores disponibles

​2. Crea el payout

​Pagar desde otro saldo (settlement_asset)

​El screening técnico puede quedar pendiente

​Un fallo antes del débito no es un reembolso

​3. Recibe el estado final

​Estados del payout

​Consulta e historial

​Ejemplos por país

​Campos del beneficiary por corredor

​SEPA Instant en EUR

​Documento de respaldo obligatorio en transferencias USD

​Payout QR

Payout QR

​Errores frecuentes

​Rechazo inmediato vs fallo posterior

​Cómo leer status_code en un payout fallido

​FAQ

​Propósito y validación de pagos US/USD

1. Descubre los corredores disponibles

2. Crea el payout

Pagar desde otro saldo (`settlement_asset`)

El screening técnico puede quedar pendiente

Un fallo antes del débito no es un reembolso

3. Recibe el estado final

Estados del payout

Consulta e historial

Ejemplos por país

Campos del beneficiary por corredor

SEPA Instant en EUR

Documento de respaldo obligatorio en transferencias USD

Payout QR

Errores frecuentes

Rechazo inmediato vs fallo posterior

Cómo leer `status_code` en un payout fallido

FAQ

Propósito y validación de pagos US/USD