PayoutType

Definición Técnica

El PayoutType es un identificador que especifica el método exacto para realizar la dispersión de fondos a un beneficiario en las transacciones financieras. Es un campo fundamental en las solicitudes de creación de quotes y orders, ya que determina cómo se ejecutará el pago utilizando una plataforma o mecanismo de transferencia específico.

Aquí puedes ver todos los métodos de dispersión por país.

Uso del PayoutType en Solicitudes

En la Creación de un Quote

Al crear un quote, el PayoutType es utilizado para definir cómo se realizará la transferencia al beneficiario. Este campo se asigna a través del parámetro platformName, que indica el método de dispersión seleccionado. Esto asegura que el cálculo de la cotización sea preciso, tomando en cuenta las características y costos del método elegido.

Ejemplo de Solicitud POST para Crear un Quote

{
  "sourceCountry": "US",
  "sourceCurrency": "USD",
  "targetCountry": "VE",
  "targetCurrency": "VES",
  "amount": 1000,
  "payoutType": "BANK_TRANSFER",
  "amountType": "SOURCE"
}

En este ejemplo, el campo payoutType especifica que el método de dispersión es una transferencia bancaria (BANK_TRANSFER), lo que influye en la tasa de cambio y las tarifas aplicadas.

En la Creación de una Order

En el contexto de una order, el PayoutType asegura que la ejecución del pago se realice utilizando el método definido en el quote previamente creado. El PayoutType debe coincidir con el definido en la cotización para que la transacción se procese correctamente.

Ejemplo de Solicitud POST para Crear una Order

{
  "pogQuotationId": 90,
  "externalId": "order-12345",
  "senderNames": "John",
  "senderLastNames": "Doe",
  "beneficiaryNames": "Jane",
  "beneficiaryLastNames": "Smith",
  "payoutType": "BANK_TRANSFER",
  "paymentInstructions": {
    "bankName": "Banco Nacional",
    "accountNumber": "123456789"
  }
}

En este ejemplo, payoutType es esencial para determinar que la dispersión de fondos se realice mediante una transferencia bancaria, alineándose con el quote previamente establecido.

Importancia Técnica del PayoutType

• Consistencia en las Transacciones: El PayoutType asegura que tanto la cotización como la ejecución de la orden se realicen utilizando el mismo método de dispersión, evitando errores y discrepancias.
• Optimización del Flujo de Pago: Permite que la plataforma elija automáticamente las rutas de pago más eficientes y rentables según el método de dispersión especificado.
• Configuración Precisa de Tarifas y Límites: Al definir el PayoutType, se establecen las reglas de tarifas y límites que se aplican automáticamente durante la creación del quote y la order.

Consideraciones

• Correspondencia entre Quote y Order: El PayoutType utilizado en la order debe coincidir con el especificado en el quote para garantizar la validez de la transacción.
• Disponibilidad y Restricciones Regionales: Es crucial verificar que el PayoutType esté disponible en la región y para la moneda en cuestión, ya que esto afecta la viabilidad de la transacción.

El uso correcto del PayoutType es crítico para la precisión y eficiencia de las transacciones financieras dentro del ecosistema de dispersión de fondos.