Order

Definición Técnica

Una Order es la solicitud formal para ejecutar una transacción financiera basada en los términos establecidos por un Quote previamente generado. En el flujo de transacciones, la Order es el paso final que confirma y procesa la dispersión de fondos al beneficiario utilizando los métodos especificados.

Uso de la Order en Solicitudes

Creación de una Order

La creación de una Order se basa en los detalles proporcionados por un Quote. Es esencial que el Quote utilizado para generar la Order siga siendo válido y que sus términos no hayan cambiado para garantizar la coherencia en la transacción.

Ejemplo de Solicitud POST para Crear una Order

{
  "pogQuotationId": 90,
  "externalId": "fdsf",
  "senderNames": "Alice",
  "senderLastNames": "Brown",
  "senderEmail": "alicebrown@example.com",
  "senderPhone": "+13456789012",
  "senderDocumentId": "123456789",
  "senderDocumentType": "cc",
  "senderCountry": "CO",
  "sourceCountry": "CO",
  "beneficiaryNames": "test",
  "beneficiaryLastNames": "test",
  "beneficiaryEmail": "test@example.com",
  "beneficiaryPhone": "+13000000000",
  "beneficiaryDocumentId": "12345678",
  "beneficiaryDocumentType": "cc",
  "paymentInstructions": {
    "bankName": "BANCOLOMBIA_CO",
    "accountNumber": "123",
    "phoneNumber": "3005556666"
  },
  "paymentPurpose": "Ayuda Familiar"
}

En este ejemplo:

• pogQuotationId: Vincula la Order al Quote previamente generado, asegurando que la transacción se ejecute bajo las condiciones acordadas.
• payoutType: Define el método de dispersión de fondos que se utilizará para transferir el dinero al beneficiario.
• paymentInstructions: Contiene los detalles específicos del beneficiario y el método de pago, como el nombre del banco y el número de cuenta.

Importancia de la Order en el Proceso de Dispersión

La Order convierte los términos de un Quote en una acción ejecutable, desencadenando la transferencia de fondos al beneficiario. Esta es la etapa final en el proceso de transacción y debe ser precisa para evitar errores o discrepancias.

Consideraciones Técnicas

• Correspondencia con el Quote: Es crucial que la Order esté vinculada al Quote correcto para mantener la integridad de la transacción. Cualquier modificación en el Quote después de la creación de la Order puede invalidar la transacción.
• Validación de Datos: Todos los datos proporcionados en la Order deben coincidir con los términos establecidos en el Quote, incluyendo el monto, la moneda y el método de dispersión.
• Estado de la Transacción: El estado de la Order refleja el progreso de la transacción, desde su creación hasta su confirmación o falla.