Order

---

Technical Definition

An Order is the formal request to execute a financial transaction based on the terms established by a previously generated Quote. In the transaction flow, the Order is the final step that confirms and processes the disbursement of funds to the beneficiary using the specified methods.

---

Using the Order in Requests

Creating an Order

The creation of an Order is based on the details provided by a Quote. It is essential that the Quote used to generate the Order is still valid and that its terms have not changed to ensure consistency in the transaction.

Example of a POST Request to Create an 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": "Family Support"
}

In this example:

• pogQuotationId: Links the Order to the previously generated Quote, ensuring the transaction is executed under the agreed conditions.
• payoutType: Defines the disbursement method to transfer the funds to the beneficiary.
• paymentInstructions: Contains the beneficiary details and payment method, such as bank name and account number.

---

Importance of the Order in the Disbursement Process

The Order turns the terms of a Quote into an executable action, triggering the transfer of funds to the beneficiary. This is the final stage in the transaction process and must be accurate to avoid errors or discrepancies.

Technical Considerations

› Matching with the Quote:	It is crucial that the Order is linked to the correct Quote to maintain transaction integrity. Any modification to the Quote after creating the Order may invalidate the transaction.
› Data Validation:	All data provided in the Order must match the terms set in the Quote, including amount, currency, and disbursement method.
› Transaction Status:	The Order status reflects the progress of the transaction, from creation to confirmation or failure.

---

Important:

The Quote is a key component in the fund disbursement process, ensuring transparency and accuracy of the transaction terms before it is definitively executed.