Integrate With Route

Curlec Route can split payments between third parties, sellers or bank accounts. Integrate Curlec Route by following these steps:

Prerequisites

Create a Curlec account.
Log in to the Curlec Dashboard and
generate the API keys
. You need to use these keys while using our APIs and Checkout.
Add Linked Accounts by contacting the
Support team
.

1. Build Integration

Follow these steps to create Linked Accounts and transfer funds to them.

Step 1.1 Create Linked Accounts

To transfer funds to various third parties, sellers, bank accounts or vendors, you should add them as Linked Accounts. When you add a Linked Account, you gain complete visibility and control of all the fund movements, such as transfers, reversals and refunds for each of your Linked Accounts.

You should contact

Support team

to create Linked Accounts.

Step 1.2 Transfer Funds to Linked Accounts

After you create Linked Accounts, you can start transferring funds to them. You can Transfer funds using the following methods:

Orders

You can set up Transfers at the time of order creation. The Transfer is automatically created and settled to the respective Linked Accounts after the payment is captured and the order is paid.
Payments

You can initiate a Transfer from the received payments.
Direct Transfer

You can Transfer funds to Linked Accounts directly from your account balance using Direct Transfers.

Requirements to initiate a transfer:

Maintain sufficient funds to successfully process the transfer to the Linked Account.
You can only transfer the captured payments.
You can create more than one transfer on a payment_id. However, the total transfer amount (payment amount + fee) should not exceed the captured payment amount.
You cannot request a transfer on payment once a refund has been initiated.

2. Test Integration

After completing the integration, you can simulate a test transfer in the test mode using the

Transfer via Payment

Direct Transfer

methods from the Curlec Dashboard.

Watch Out!

Transfers via orders can only be done using

APIs

3. Follow Go-live Checklist

Consider the following steps before taking your integration live.

Switch Test API Keys With Live API Keys

After confirming your integration is working successfully, you can take the integration live by switching the Test Mode API Keys with the Live Mode Keys.
You can create live Transfers to Linked Accounts created in the Test Mode.

Set up Curlec Webhooks

to configure and receive notifications when a specific event occurs. When one of these events is triggered, we send an HTTP POST payload in JSON to the webhook's configured URL.

You can subscribe to these

Route webhook events

Appendix

This section provides information about business type, category, sub-category, KYC requirements and their possible values.

Business Type

The following table lists the supported Business Types:

Business Category

The following table lists the possible values for Business Category:

Business Sub-Category

The following table lists the possible values for Business Sub-Category:

Supported Banks

The following table lists the supported banks and their codes: