Skip to content
Last updated

LeanX payment API

Send cross-border payouts to bank accounts from a pre-funded USD, USDT or USDC balance. You fund your balance, request a quote, send the payment, and track it until it succeeds. We handle conversion and delivery.

Which version?

  • v3 (current). Build new integrations here. v3 is enabled per organisation. Ask us to switch it on.
  • v2 (maintenance). Supported, with no sunset date. Stay on it if you already use it.

How a payment works

StepCallWhy
1. Check your balanceGET /v3/balanceMake sure you can fund the payout
2. Check the beneficiary (India)POST /v3/validate_accountConfirm the account exists before paying
3. Check for a duplicateGET /v3/payments/{external_id}?external=trueA 404 means no payment with this external_id exists (it has not been sent to the server)
4. Get a quotePOST /v3/quoteFixes the rate for 15 minutes; one payment per quote
5. Send the paymentPOST /v3/paymentSend the quote's amount_destination as amount
6. Track itGET /v3/events or GET /v3/payments/{id}Release funds to your customer only on succeeded

v2 uses the same steps under /v2. See How a payment works for the details.

Environments

EnvironmentBase URL
Sandboxhttps://api.leanxtest.me
Productionhttps://api.leanx.me

Credentials are issued per environment. The token's aud and iss must both be the base URL of the environment you call.