Payment instructions

Las payment instructions llevan los detalles necesarios para entregar los fondos al beneficiario. Se proveen en destination.payment_instructions al crear la order.

Se manda exactamente uno de los dos grupos:

Grupo	Para	Payout type
bank_account	Un depósito en la cuenta bancaria del beneficiario	BANK_TRANSFER
bank_phone_account	Una transferencia P2P asociada a un teléfono	P2P_PHONE_TRANSFER

Mandar ninguno, o los dos, se rechaza con 422 B2B_BENEFICIARY_INVALID.

El método de payout nunca se envía: se infiere de cuál de los dos grupos mandas, y tiene que coincidir con el payout type de la quotation que la order ejecuta.

bank_account

{
  "destination": {
    "payment_instructions": {
      "bank_account": {
        "bank_name": "BANCO_BANESCO_VE",
        "number": "01340055351055017659",
        "type": "CHECKING"
      }
    }
  }
}

Campo	Tipo	Requerido	Descripción
bank_name	enum	sí	El nombre API del banco, del catálogo cerrado — "BANCO_BANESCO_VE", no "Banesco". Ver entidades bancarias.
number	string	sí	Número de cuenta del beneficiario.
type	enum	sí	CHECKING, SAVINGS, CORRIENTE o AHORRO.
bank_display_name	string	—	Read-only. Las lecturas devuelven aquí el nombre comercial del banco. No lo mandes: la API rechaza campos desconocidos con 400.

bank_phone_account

{
  "destination": {
    "payment_instructions": {
      "bank_phone_account": {
        "bank_name": "BANCO_BANESCO_VE",
        "phone_number": "+584121234567",
        "document_id": "87654321"
      }
    }
  }
}

Campo	Tipo	Requerido	Descripción
bank_name	enum	sí	El mismo catálogo que arriba — el nombre API, nunca el comercial.
phone_number	string	sí	Teléfono del beneficiario en E.164 (+584121234567).
document_id	string	no	Documento del beneficiario. Si se omite se usa destination.receiver.document.id — el beneficiario P2P es la misma persona, no tiene sentido mandarlo dos veces.
bank_display_name	string	—	Read-only, igual que arriba — nunca se envía.

nota

bank_name es un catálogo cerrado en los dos grupos: un valor fuera de él se rechaza con 400. El catálogo es por país — ver entidades bancarias.