FX Rates and Pricing

Understanding Foreign Exchange (FX) rates and pricing is crucial when using our B2B Global Payment API. This documentation page provides comprehensive information on how we apply FX rates, how pricing works, and the factors that might influence the cost of your international transactions.


When processing a payment using Waza's B2B Global payment API a quote is required to be generated. A quote gives an estimate of the rate when making payment between a currency pair. e.g NGN/USD.

In a currency pair, the "base currency" is the currency you have, while the "quote currency" is the currency you want to receive. For example, in the pair NGN/USN, NGN is the base currency, and USD is the quote currency. Our API supports various base and quote currency combinations to accommodate your specific needs.

Generating A Quote

The Quotes API provides an endpoint that allows you to generate payment requirements for payments you want to make to your beneficiaries with Waza's API.

Example Request

curl --request POST \
     --url https://api.sandbox.waza.co/v2/quotes \
     --header 'accept: application/json' \
     --header 'waza-x-key: your-api-key' \
     --header 'content-type: application/json' \
     --data '
     "sendCurrency": "NGN",
     "receiveCurrency": "USD",
     "amount": "100000"

Example Response

A successful Quotes API call should return a similar response structure as seen below:

    "status": "success",
    "message": "Quote generated successfully.",
    "data": {
        "fxRate": 0.03272,
        "feeRate": {
            "feePercent": 1.5,
            "feeCap": 1500
        "sendCurrency": "NGN",
        "receiveCurrency": "USD",
        "dateGenerated": "2022-11-24T14:28:21.525Z",
        "sourceAmount": 100000,
        "destinationAmount": 3272,
        "feeAmount": 1500,
        "totalPayableAmount": 101500,
        "totalReceivableAmount": 3272



Please reach out to us at [email protected] to discuss pricing