Route APIs

API-wise Integration Checklist for Route

Create Transfers from Orders

• Ensure the currency is in MYR when creating an order ID.
• Ensure orders created have the partial_payment parameter set to 0. Transfers will only occur if the orders are paid and the payments move to the captured state.
• Ensure to pass the Linked Account id while creating an order.
• Ensure the amount passed in the transfers object is not greater than the order amount.
• If the amount passed in the transfers object is less than the main amount, the balance will automatically move to the Curlec nodal account.
  Example:
  Base amount = RM1000
  Amount in transfers object = RM750
  Balance amount = RM250 will be automatically added to the main Curlec nodal account.
• Once the payment has been successfully made, verify the

  Payment Signature

  at your backend.
• You can use

  Fetch Transfer for an Order

  API for reconciliation.
• You can also

  subscribe to Webhooks

  and set up the transfer.processed Webhook event.

Create Transfers from Payments

• Use

  Fetch a Payment by ID

  API to confirm the payment status before running the

  Transfers

  API.

• Ensure the payment is in the captured state.

• Ensure the amount does not exceed the initial payment amount.

• Ensure the amount you want to transfer to a Linked Account is less than the initial amount.

  Watch Out!

  You must subtract fees to calculate the amount allowed to be transferred.

Direct Transfers

• Ensure the nodal account has sufficient balance for the amount to be transferred.
• Ensure the amount that needs to be transferred is correct as there is no maker-checker facility after creating the transfer.
• Ensure the currency is in MYR.

List of Transfers APIs

The table below provides the list of various Transfers APIs and their brief description:

Related Information

• Route

• Linked Accounts

• Reports