Payouts

POST /api/payout is a single endpoint that routes to one of five payout types based on the fromCurrency / toCurrency pair you send. Tradevu treats USDT and USDC as crypto; everything else (NGN, USD, EUR, GBP, KES, UGX, GHS, CAD, XOF, XAF) is fiat.

`fromCurrency`	`toCurrency`	Payout type	Destination
Fiat	Same fiat	Same-currency fiat	Bank account
Crypto	Same crypto	Same-currency crypto	Wallet address
Crypto	Different crypto	Crypto-to-crypto	Wallet address
Crypto	Fiat	Crypto-to-fiat	Bank account
Fiat	Different fiat/crypto	Cross-currency	Bank account

Before every payout, Tradevu checks that your wallet balance in fromCurrency covers amount, and — for anything other than a same-currency payout — that you’ve supplied a valid rateKey. Fetch one from the quote endpoint first.

Common fields

Every payout requires:

string

required

Amount to send, in fromCurrency units.

string

required

Source wallet currency to debit.

string

required

Destination currency.

string

required

Transfer narration.

string

required

A unique ID you generate for this payout attempt — returned back to you and useful for support lookups.

string

Required whenever fromCurrency differs from toCurrency. Obtain it from GET /api/qoutes/:fromCurrency/:toCurrency/:amount.

Same-currency fiat

Bank details are required whenever the destination is fiat.

{
  "amount": "50000",
  "fromCurrency": "NGN",
  "toCurrency": "NGN",
  "narration": "Vendor payment",
  "sessionId": "payout-9931",
  "accountNumber": "0123456789",
  "accountName": "Jane Doe",
  "bankName": "GTBank",
  "bankCode": "058"
}

bankCode is required for NGN, KES, and UGX destinations. For CAD use transitNumber + institutionNumber instead of bankCode; for GBP add sortCode; for EUR/GBP add swiftCode. See the payout schema for the full field matrix.

Same-currency crypto

{
  "amount": "250",
  "fromCurrency": "USDT",
  "toCurrency": "USDT",
  "narration": "Contractor payment",
  "sessionId": "payout-9932",
  "address": "0xAbC123...",
  "network": "polygon"
}

Crypto-to-crypto (swap)

Requires network for both sides:

{
  "amount": "100",
  "fromCurrency": "USDT",
  "toCurrency": "USDC",
  "narration": "Swap",
  "sessionId": "payout-9933",
  "rateKey": "eyJhbGciOi...",
  "address": "0xAbC123...",
  "fromNetwork": "polygon",
  "toNetwork": "base"
}

Crypto-to-fiat

Debit a crypto wallet, pay out to a bank account:

{
  "amount": "100",
  "fromCurrency": "USDC",
  "toCurrency": "NGN",
  "narration": "Off-ramp payout",
  "sessionId": "payout-9934",
  "rateKey": "eyJhbGciOi...",
  "fromNetwork": "base",
  "accountNumber": "0123456789",
  "accountName": "Jane Doe",
  "bankName": "GTBank",
  "bankCode": "058"
}

Cross-currency (fiat to fiat/crypto)

{
  "amount": "500",
  "fromCurrency": "USD",
  "toCurrency": "NGN",
  "narration": "Supplier payment",
  "sessionId": "payout-9935",
  "rateKey": "eyJhbGciOi...",
  "accountNumber": "0123456789",
  "accountName": "Jane Doe",
  "bankName": "GTBank",
  "bankCode": "058"
}

Response

All payout types return the same envelope:

{
  "message": "Payout successful",
  "sessionId": "payout-9935"
}

There is currently no dedicated “get payout status” endpoint on the API — sessionId is your durable reference for reconciliation and support inquiries. Payout completion isn’t pushed to your webhook either; that channel currently covers collections only.

Verifying bank details before paying out

Use POST /api/resolve-bank to confirm an account number/bank code resolves to the expected account name before you submit the payout — this catches typos before money moves.

curl -X POST https://api.tradevu.co/v1/api/resolve-bank \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
        "accountNumber": "0123456789",
        "bankCode": "058",
        "fromCurrency": "NGN"
      }'

Pair it with GET /api/bank-list/:fromCurrency/:toCurrency to populate a bank picker in your UI.

Full endpoint reference

See exact request/response schemas, including every conditional field.

Get Started

Guides

Common fields

Same-currency fiat

Same-currency crypto

Crypto-to-crypto (swap)

Crypto-to-fiat

Cross-currency (fiat to fiat/crypto)

Response

Verifying bank details before paying out

Full endpoint reference

​Common fields

​Same-currency fiat

​Same-currency crypto

​Crypto-to-crypto (swap)

​Crypto-to-fiat

​Cross-currency (fiat to fiat/crypto)

​Response

​Verifying bank details before paying out

Full endpoint reference

Common fields

Same-currency fiat

Same-currency crypto

Crypto-to-crypto (swap)

Crypto-to-fiat

Cross-currency (fiat to fiat/crypto)

Response

Verifying bank details before paying out