SendR Payout
This is simply a cross currency payout where a Merchant pays a beneficiary account in a currency different from the Payout account. A cross-currency payout refers to the entire transactions chain which results in the debiting of an account in one currency and the crediting the equivalent amount into an account in another currency.
The following are the stages involved in the SendR process:
Panel | ||
---|---|---|
| ||
Step 1: Call Public/payout/Rate Endpoint |
This is used to retrieve rate utilized during conversion btw two currency pairs. The Merchants simply pass the Base Account currency, Base Amount & Quote currency to the endpoint. The response shows the credit Amount equivalent to be credited to the destination Account (Beneficiary) and also the applied rate.
...
· Merchant must maintain an Account in the Base (From) currency with Leatherback
· To currency must be part of currencies supported by Leatherback Payout (This can be checked using the endpoint Disbursement/Currencies/Beneficiaries: below)
· Merchant must have Accounts maintained with Leatherback in the sender’s Currency before such process can be successful
Panel | ||
---|---|---|
| ||
Step 2: Call Initiate Transaction Endpoint |
To initiate the Payout transaction, Gather the transaction details as shown on the Request payload, Pass Rate Id from Response in endpoint 1, set reference Id or we generate it for you.
To get Metadata for a specific currency, call the Beneficiary Requirement endpoint by passing the Beneficiary Currency Code
and Beneficiary Country code
Panel | ||
---|---|---|
| ||
Step 3: Call Beneficiary Requirement Endpoint |
This endpoint helps to retrieve Metadata specific to a currency. Pass Beneficiary Currency Code
and Beneficiary Country code
. Example If you want to retrieve meta data for an account in USD domiciled in the local country (United states), you pass Beneficiary Currency Code
= USD and Beneficiary Country code
=USA and for USD domiciliary Account opened outside the local country. E,g USD Accounts opened in Nigeria will have Beneficiary Currency Code
= USD and Beneficiary Country code
=NGA
Panel | ||
---|---|---|
| ||
Step 4: Call Disbursement/Currencies/Merchant Endpoint |
This allows a merchant to determine the different Payout Accounts currency he has with Leatherback that he can transfer from.
Example: If the endpoint in 4 returns (USD, NGN, GBP, CAD, EUR) and End point in step 5 returns (NGN, GHS, INR, USD), This means the Beneficiary can only receive funds in the currencies (NGN, GHS, INR, USD, JPY) Only
Panel | ||
---|---|---|
| ||
Step 5: Disbursement/Currencies/Beneficiaries |
This shows the Currencies a Merchant can transfer to (NGN,GHS, INR,USD),
Panel | ||
---|---|---|
| ||
Step 6: Disbursement/Currencies/ |
Consolidation of distinct currencies in 4 & 5 (NGN, GHS, INR, USD, JPY, GBP, CAD, EUR). Call this endpoint to retrieve this unique set
Webhook: Ensure your Webhook URL is configured on the Dev portal Dashboard (see guide here).
...