Skip to main content
POST

Autorizaciones

Authorization
string
header
requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Encabezados

Idempotency-Key
string

Alternativa al campo idempotency_key del body.

Cuerpo

application/json
currency
string
requerido
Ejemplo:

"USD"

type
enum<string>
requerido
Opciones disponibles:
TRANSFER,
WITHDRAW
sourceRequisit
object
requerido
destinationRequisit
object
requerido
amount
object
requerido
paymentType
string

EMPTY for TRANSFER; rail code (e.g. SEPA_CT) for WITHDRAW.

comment
string
source_virtual_iban_id
string<uuid>

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.

source_instrument_id
string<uuid>

Instrumento banking BO/BOB activo opcional para un payout QR.

beneficiary_type
enum<string>

Obligatorio para un retiro EUR por SEPA; usa individual para una persona o corporate para una empresa. Opcional para otros rieles bancarios.

Opciones disponibles:
individual,
corporate
beneficiary_given_name
string

Obligatorio para un beneficiario individual EUR por SEPA estructurado junto con beneficiary_first_surname; opcional para otros rieles bancarios.

beneficiary_first_surname
string

Obligatorio para un beneficiario individual EUR por SEPA estructurado junto con beneficiary_given_name; opcional para otros rieles bancarios.

beneficiary_middle_name
string

Segundo nombre opcional del beneficiario individual EUR por SEPA; opcional para otros rieles bancarios.

beneficiary_name
string

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.

idempotency_key
string

Respuesta

Replay idempotente de una operación existente (sin cobro nuevo).

The response is of type object.