{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"idempotency_hit": true
}{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"banking_fee": "2.000000",
"banking_fee_asset": "BANK_EUR"
}{
"error": "idempotency_key_required",
"message": "provide idempotency_key (body or Idempotency-Key header)"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "insufficient_funds",
"message": "account balance is not enough for this operation"
}{
"error": "no_banking_customer",
"message": "create your banking customer first (POST /v1/banking/customer)"
}{
"error": "funding_account_required",
"message": "an active EUR funding account is required to send to Europe"
}{
"error": {
"code": "banking_request_failed",
"message": "request rejected"
}
}Enviar un pago bancario
Ejecuta un TRANSFER (entre tus propias cuentas bancarias) o WITHDRAW (a un beneficiario registrado). Requiere clave de idempotencia; reintentos con la misma clave devuelven la operación original sin volver a cobrar. Se cobra la comisión fija banking_operation; se reembolsa si el corredor rechaza. El estado final llega por el webhook banking_operation_status_changed. Para un retiro EUR por SEPA, los campos beneficiary_* de nivel superior entregan la identidad estructurada del beneficiario usada para construir el payee del proveedor. Son opcionales para otros rieles bancarios; si un destino EU-SEPA no tiene una identidad de payee utilizable, la API devuelve 400 invalid_payload.
{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"idempotency_hit": true
}{
"operation_id": "7e8a9b0c-1d2e-3f4a-5b6c-7d8e9f0a1b2c",
"provider_id": "BNK-OP-90213",
"status": "pending",
"idempotency_key": "platform:9b1deb4d:acme-payment-0071",
"data": {
"type": "WITHDRAW",
"paymentType": "SEPA_CT"
},
"banking_fee": "2.000000",
"banking_fee_asset": "BANK_EUR"
}{
"error": "idempotency_key_required",
"message": "provide idempotency_key (body or Idempotency-Key header)"
}{
"error": "unauthorized",
"message": "invalid or missing credentials"
}{
"error": "insufficient_funds",
"message": "account balance is not enough for this operation"
}{
"error": "no_banking_customer",
"message": "create your banking customer first (POST /v1/banking/customer)"
}{
"error": "funding_account_required",
"message": "an active EUR funding account is required to send to Europe"
}{
"error": {
"code": "banking_request_failed",
"message": "request rejected"
}
}Autorizaciones
JWT de sesión (de register/login) o llave de API (pk_...).
X-API-Key: <token> se acepta como header alternativo.
Encabezados
Alternativa al campo idempotency_key del body.
Cuerpo
"USD"
TRANSFER, WITHDRAW Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Show child attributes
EMPTY for TRANSFER; rail code (e.g. SEPA_CT) for WITHDRAW.
IBAN virtual banking_eur activo opcional que financia un retiro Banking EUR por SEPA. Omítelo solo con una fuente activa; varias fuentes requieren este UUID. La plataforma estampa payer desde el registrant del vIBAN.
Instrumento banking BO/BOB activo opcional para un payout QR.
Obligatorio para un retiro EUR por SEPA; usa individual para una persona o corporate para una empresa. Opcional para otros rieles bancarios.
individual, corporate Obligatorio para un beneficiario individual EUR por SEPA estructurado junto con beneficiary_first_surname; opcional para otros rieles bancarios.
Obligatorio para un beneficiario individual EUR por SEPA estructurado junto con beneficiary_given_name; opcional para otros rieles bancarios.
Segundo nombre opcional del beneficiario individual EUR por SEPA; opcional para otros rieles bancarios.
Razón social obligatoria para un beneficiario corporativo EUR por SEPA; también se acepta un valor de varias palabras como fallback de compatibilidad para personas. Opcional para otros rieles bancarios.
Respuesta
Replay idempotente de una operación existente (sin cobro nuevo).
The response is of type object.