Ir al contenido

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.

{
"bankCode": "341",
"branchCode": "0001",
"accountNumber": "123456-7",
"accountType": "CHECKING",
"holderName": "Maria Souza",
"holderDocument": "12345678900",
"amount": 5000,
"description": "Pago a proveedor",
"reference": "PAGO-20261005-0002"
}
CampoTipoRequeridoDescripción
bankCodestring✅Código del banco (ej: 341)
branchCodestring✅Agencia
accountNumberstring✅Número de cuenta
accountType"CHECKING" | "SAVINGS"✅Tipo de cuenta
holderNamestring✅Nombre del titular
holderDocumentstring✅CPF o CNPJ del titular
amountnumber✅Centavos, entero > 0, máximo 100.000.000 (R$ 1.000.000), además de los límites de tu tarifa
descriptionstring❌Descripción del pago
referencestring❌Tu referencia interna; vuelve en los webhooks como reference
{
"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.

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.

Los mismos que el pago a llave Pix; accountType fuera de CHECKING/SAVINGS → 400.