Conversions
A conversion exchanges one currency in your wallet for another at Payve's live rate. The source currency is debited and the destination currency is credited to your respective wallets simultaneously.
The conversion object
json
{
"id": "a1b2c3d4-...",
"publicId": "cnv_01j9abc789",
"status": "succeeded",
"sourceCurrency": "USD",
"sourceAmount": "100000",
"destinationCurrency": "NGN",
"destinationAmount": "16450000",
"rate": "1645.00",
"feeAmount": "0",
"merchantReference": "FX-SETTLE-001",
"createdAt": "2025-01-15T10: 00: 00Z"
}Fields
| Field | Type | Description |
|---|---|---|
sourceCurrency | string | Currency debited from your wallet |
sourceAmount | string | Amount deducted in minor units |
destinationCurrency | string | Currency credited to your wallet |
destinationAmount | string | Amount received in minor units |
rate | string | Exchange rate applied (1 source = rate destination) |
Statuses
| Status | Description |
|---|---|
pending | Accepted, awaiting rate lock |
processing | Rate locked, executing trade |
succeeded | Wallets updated |
failed | Trade could not be executed |
reversed | Funds returned to source wallet |
Get a quote
POST/v1/conversions/quote