SendR (Cross - Country Payments)

Learn the 5-step SendR cross-country payment workflow to discover supported currencies, collect payment requirements, upload documents, lock exchange rates, initiate transfers, and track payout status.

SendR is Leatherback’s high-precision engine for cross-currency disbursements. It enables a Merchant to debit a wallet in one currency (e.g., GBP) and credit a beneficiary in another (e.g., USD). This guide walks you through the 5-step workflow required to lock a rate and execute a global transfer.


info-circle

Subunit Precision

All amount fields in SendR requests and responses are integer subunits (e.g., 100000 = ₦1,000.00, 50000 = $500.00). Always send and interpret amounts in subunits.

Prerequisites

Before initiating a SendR Cross-Currency Payout:

  • Maintain a Payout Account in the Base Currency (sender currency) with Leatherback. Your account must hold sufficient balance in the sending currency.
  • Verify corridor support. The beneficiary's currency must be supported by Leatherback Payout. Use the currencies endpoint (Step 1) to confirm both your Base Currency and the target Quote Currency are available.

Workflow

The SendR Cross-Currency Payout follows a strict 5-step sequence. Each step produces an output required by the next.


Step 1 — Currency Discovery

Use the Get Supported Currencies endpoint to retrieve a list of active corridors and their corresponding ISO codes.


Step 2 — Payment Requirements

Before initiating a transfer, call the Get Payment Methods endpoint to determine the specific routing fields required for your destination.


Step 3 — Document Upload

For high-value transactions or regulated corridors, use the Upload Supporting Documents endpoint to provide the necessary compliance paperwork.


Step 4 — Rate Lock

Obtain a real-time exchange rate and a quote for your transaction using the Get Rate endpoint.


Step 5 — Initiation

Finalize the payout by calling the Initiate Fund Transfer endpoint with your locked rate and beneficiary details.

Tracking the Payout

After initiation, you can track the transaction details by querying the transaction status.


       {
         "rateId": "your-rate-id",
         "reference": "your-unique-reference",
         "senderCurrencyCode": "NGN",
         "description": "Testing Live SendR NGN",
         "amount": 800,
         "beneficiary": {
           "currencyCode": "USD",
           "countryCode": "GBR",
           "name": "TF Biz",
           "email": "[email protected]",
           "address": "house no T4",
           "paymentMethodType": "BicSwift",
           "paymentMethodValue": "CMFGUS33",
           "metaData": {
             "beneficiaryAccountNumber": "8817114858",
             "beneficiaryAccountName": "Ola Test",
             "intermediaryBankRoutingCode": "026073150"
           }
         }
       }