Convert

Converts an amount from one currency wallet to another using the platform exchange rate. Completes synchronously — debit and credit post atomically.

customerId

*String

ID of the customer.

channel

*String

Channel — use "WALLET".

fromCurrency

*String

Currency to convert from.

toCurrency

*String

Currency to convert to.

amount

*Number

Amount in fromCurrency to convert.

fromProvider

String

Provider backing the source wallet. Omit to auto-use the richest wallet that covers the amount.

toProvider

String

Provider backing the target wallet. Omit to reuse fromProvider, falling back to any active wallet in toCurrency.

POST

/ v2/wallet/convert

Endpoint URL(TEXT)

https://api.sandbox.switch.tulupay.com/v2/wallet/convert

https://api.sandbox.switch.tulupay.com/v2/wallet/convert

Request Body

{
  "customerId": "cus_ada",
  "channel": "WALLET",
  "fromCurrency": "USD",
  "toCurrency": "NGN",
  "amount": 100
}

{
  "customerId": "cus_ada",
  "channel": "WALLET",
  "fromCurrency": "USD",
  "toCurrency": "NGN",
  "amount": 100
}

Response(JSON)

// Click 'Try now' to see the response