Pago a datos bancarios
POST /v1/br/payout/pix/bank
Envía dinero usando los datos bancarios del beneficiario, para cuando no tiene (o no conoces) su llave Pix. Mismas reglas que el pago a llave Pix: idempotencia obligatoria, retención de saldo y límites.
Request body
Sección titulada «Request body»{ "bankCode": "341", "branchCode": "0001", "accountNumber": "123456-7", "accountType": "CHECKING", "holderName": "Maria Souza", "holderDocument": "12345678900", "amount": 5000, "description": "Pago a proveedor", "reference": "PAGO-20261005-0002"}| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
bankCode | string | ✅ | Código del banco (ej: 341) |
branchCode | string | ✅ | Agencia |
accountNumber | string | ✅ | Número de cuenta |
accountType | "CHECKING" | "SAVINGS" | ✅ | Tipo de cuenta |
holderName | string | ✅ | Nombre del titular |
holderDocument | string | ✅ | CPF o CNPJ del titular |
amount | number | ✅ | Centavos, entero > 0, máximo 100.000.000 (R$ 1.000.000), además de los límites de tu tarifa |
description | string | ❌ | Descripción del pago |
reference | string | ❌ | Tu referencia interna; vuelve en los webhooks como reference |
Response 201 Created
Sección titulada «Response 201 Created»{ "txId": "c3d4e5f6-a7b8-4c9d-8e1f-2a3b4c5d6e7f", "status": "PROCESSING", "amount": 5000, "feeCharged": 200, "totalDebit": 5200, "currency": "BRL"}Igual que el pago a llave Pix, pero sin estimatedCompletion.
El resultado final llega por webhook (payout.completed o payout.failed). Para consultar el estado: Estado del pago.
Response 202 Accepted
Sección titulada «Response 202 Accepted»Si la red Pix no confirma a tiempo, recibes 202 con status: PENDING: el pago pudo haber salido y no debe tratarse como fallido. Mismo cuerpo y mismas reglas que el pago a llave Pix.
Errores
Sección titulada «Errores»Los mismos que el pago a llave Pix; accountType fuera de CHECKING/SAVINGS → 400.