curl --request POST \
--url https://staging.api.mavapay.co/api/v1/quote \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"amount": "500000",
"sourceCurrency": "NGNKOBO",
"targetCurrency": "BTCSAT",
"paymentMethod": "BANKTRANSFER",
"paymentCurrency": "NGNKOBO",
"customerReference": "order-1234567890",
"autopayout": false
}
'{
"status": "ok",
"data": {
"id": "53a87b44-2ecc-4106-8297-f1fd15d010a9",
"exchangeRate": 1,
"usdToTargetCurrencyRate": 0.00000917325600278523,
"sourceCurrency": "NGNKOBO",
"targetCurrency": "BTCSAT",
"transactionFeesInSourceCurrency": 4624,
"transactionFeesInTargetCurrency": 25,
"amountInSourceCurrency": 844540,
"amountInTargetCurrency": 5000,
"paymentMethod": "BANKTRANSFER",
"expiry": "2025-09-01T12:52:08.215Z",
"isValid": true,
"invoice": "",
"hash": "68b594a09a16ac0012ae3414",
"totalAmountInSourceCurrency": 844540,
"customerInternalFee": 0,
"bankName": "GLOBUS BANK",
"ngnBankAccountNumber": "3242273802",
"ngnAccountName": "Mava Digital Solutions Limited",
"ngnBankCode": "000027",
"estimatedRoutingFee": 0,
"orderId": "43477-4306"
}
}{
"message": "<string>",
"status": "error"
}Quote
Create a quote
Create a quote for a given currency
POST
/
quote
curl --request POST \
--url https://staging.api.mavapay.co/api/v1/quote \
--header 'Content-Type: application/json' \
--header 'X-API-KEY: <api-key>' \
--data '
{
"amount": "500000",
"sourceCurrency": "NGNKOBO",
"targetCurrency": "BTCSAT",
"paymentMethod": "BANKTRANSFER",
"paymentCurrency": "NGNKOBO",
"customerReference": "order-1234567890",
"autopayout": false
}
'{
"status": "ok",
"data": {
"id": "53a87b44-2ecc-4106-8297-f1fd15d010a9",
"exchangeRate": 1,
"usdToTargetCurrencyRate": 0.00000917325600278523,
"sourceCurrency": "NGNKOBO",
"targetCurrency": "BTCSAT",
"transactionFeesInSourceCurrency": 4624,
"transactionFeesInTargetCurrency": 25,
"amountInSourceCurrency": 844540,
"amountInTargetCurrency": 5000,
"paymentMethod": "BANKTRANSFER",
"expiry": "2025-09-01T12:52:08.215Z",
"isValid": true,
"invoice": "",
"hash": "68b594a09a16ac0012ae3414",
"totalAmountInSourceCurrency": 844540,
"customerInternalFee": 0,
"bankName": "GLOBUS BANK",
"ngnBankAccountNumber": "3242273802",
"ngnAccountName": "Mava Digital Solutions Limited",
"ngnBankCode": "000027",
"estimatedRoutingFee": 0,
"orderId": "43477-4306"
}
}{
"message": "<string>",
"status": "error"
}Authorizations
ApiKeyAuthbearerAuth
Body
application/json
The amount in the target currency in its lowest denomination. e.g '500000' for 5000.00 NGN
Example:
1000
The source currency for the quote
Available options:
BTCSAT, NGNKOBO The local currency to convert the source currency to
Available options:
NGNKOBO, KESCENT, ZARCENT, GHSPESEWA, BTCSAT The payment method for the quote
Available options:
LIGHTNING, BANKTRANSFER Currency the amount is denominated in. Must be either sourceCurrency or targetCurrency. Determines what the 'amount' field represents. Example: if buying BTC with NGN and paymentCurrency is 'NGNKOBO', amount is in Naira; if 'BTCSAT', amount is in Bitcoin.
Available options:
NGNKOBO, BTCSAT, KESCENT, ZARCENT, GHSPESEWA Your unique identifier for the quote
Example:
"order-1234567890"
Example:
false
- NGN Beneficiary
- KES Beneficiary
- GHS Beneficiary
- ZAR Beneficiary
- BTC Beneficiary
Show child attributes
Show child attributes