Payout type

El payout type especifica el mecanismo para dispersar los fondos a un beneficiario. Se define mediante payout_method.type al solicitar un Quote, y determina qué payment instructions debe incluir la Order resultante.

{
  "destination": {
    "country": "VE",
    "currency": "VES",
    "payout_method": { "type": "P2P_PHONE_TRANSFER" }
  }
}

Tipos disponibles

payout_method.type es un enum cerrado con exactamente dos valores:

Tipo	Qué es	Grupo de payment instructions
BANK_TRANSFER	Un depósito en la cuenta bancaria del beneficiario.	payment_instructions.bank_account (bank_name, number, type)
P2P_PHONE_TRANSFER	Una transferencia P2P vinculada al teléfono del beneficiario.	payment_instructions.bank_phone_account (bank_name, phone_number, document_id opcional)

Cualquier otro valor se rechaza con un 400 en la validación, antes de que la request llegue al motor de cotizaciones.

Importancia técnica

• Correspondencia Quote ↔ Order — el payout type usado para crear la order debe coincidir con el usado en el quote, porque determina las payment instructions requeridas.
• Campos requeridos — cada payout type determina qué payment instructions debe incluir la order.
• Tarifas y límites — el payout type es parte del corredor que determina las tarifas aplicables y los límites operacionales.