{
"quoteId": "9d1c5f6a-4b2e-4d31-9f7a-1c2b3d4e5f60",
"status": "awaiting_payment",
"source": "XOF",
"destination": "USDT",
"amount": "20000",
"totalSourceAmount": "12250000",
"totalDestinationAmount": "20000",
"fee": "1500",
"mode": "test",
"ttl": 900,
"externalReference": "cli_be2828cf-5004-4694-8a79-47538573985b",
"metadata": {
"mobileMoneyPayIn": {
"provider": "MTN_CI",
"phoneNumber": "2250700000000",
"attemptReference": "mm_5f2a91c4e7b8",
"authorizationMode": "otp",
"status": "INPROGRESS",
"message": "Enter the code sent to your phone",
"expiresAt": "2026-09-15T12:34:56Z"
}
}
}{
"code": "INVALID_CURRENCY",
"message": "Invalid source currency. Supported: NGN, GHS",
"details": {}
}Accept Quote
Finalize and accept a specific quote by providing the settlement destination details (Bank or Blockchain) and, optionally, a mobile money payment method to fund the trade.
{
"quoteId": "9d1c5f6a-4b2e-4d31-9f7a-1c2b3d4e5f60",
"status": "awaiting_payment",
"source": "XOF",
"destination": "USDT",
"amount": "20000",
"totalSourceAmount": "12250000",
"totalDestinationAmount": "20000",
"fee": "1500",
"mode": "test",
"ttl": 900,
"externalReference": "cli_be2828cf-5004-4694-8a79-47538573985b",
"metadata": {
"mobileMoneyPayIn": {
"provider": "MTN_CI",
"phoneNumber": "2250700000000",
"attemptReference": "mm_5f2a91c4e7b8",
"authorizationMode": "otp",
"status": "INPROGRESS",
"message": "Enter the code sent to your phone",
"expiresAt": "2026-09-15T12:34:56Z"
}
}
}{
"code": "INVALID_CURRENCY",
"message": "Invalid source currency. Supported: NGN, GHS",
"details": {}
}Authorizations
API key authentication using Bearer token
Path Parameters
The unique quote identifier of the order to be accepted.
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Body
The unique pool account identifier of the order to be accepted.
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
The unique balance identifier to fund or settle the trade against.
Settlement destination details for the trade (Bank or Blockchain). See destination schema for bank/blockchain-specific fields.
Show child attributes
Show child attributes
Funds the trade by mobile money. If omitted, the quote is funded by virtual account (default behavior).
Show child attributes
Show child attributes
Response
Quote accepted successfully
Unique quote identifier
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
Quote status
pending, awaiting_payment, completed, expired, cancelled "pending"
Source currency
"NGN"
Destination currency
"USDT"
Blockchain network
"BASE"
Requested amount
50000
Total amount in source currency
50000
Total amount in destination currency
31.65
Client identifier
Operating mode
live, sandbox "live"
Time to live in seconds
300
Show child attributes
Show child attributes
Show child attributes
Show child attributes
Metadata for chat-based quote negotiation
Show child attributes
Show child attributes
Was this page helpful?