FX quotes and rates

Before creating a cross-border payment, you'll typically want to check the exchange rate and get a quote that shows the payer exactly how much they'll pay. Nexpay provides two endpoints for this: the FX Rate API for quick rate lookups, and the Quotes API for detailed quotes with fee breakdowns per settlement method.

Before you start

You will need:

• A valid API key to authenticate your requests.
• A payee id (for quotes) — use the Payees API to create or retrieve one.

Checking the exchange rate

To get the current exchange rate between two currencies, use the FX Rate API. This is useful for displaying indicative rates before the payer commits to a payment.

try {
  const response = await fetch('https://api.nexpay.com/v2/fx-rate', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'ApiKey your-api-key-here',
    },
    body: JSON.stringify({
      "fromCurrency": "USD",
      "toCurrency": "AUD",
      "amount": 1000
    }),
  });

  if (response.ok) {
    const data = await response.json();

    console.log(data);
  } else {
    throw new Error(`Request failed with status: ${response.status}`);
  }
} catch (error) {
  console.error(error);
}

The response includes the current rate for the currency pair:

{
  "rate": 1.0251,
  "fromCurrency": "USD",
  "toCurrency": "AUD"
}

FX Rate fields

Creating a quote

While the FX Rate API gives you a quick rate check, the Quotes API provides a full breakdown with fees and multiple settlement method options. Use quotes when you're ready to show the payer their final costs.

To create a quote, you need to specify the payee, amount, currency, and transaction type:

try {
  const response = await fetch('https://api.nexpay.com/v2/quotes', {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      'Authorization': 'ApiKey your-api-key-here',
    },
    body: JSON.stringify({
      "payeeId": 42,
      "amount": 5000,
      "currencyCode": "AUD",
      "transactionType": "provider"
    }),
  });

  if (response.ok) {
    const data = await response.json();

    console.log(data);
  } else {
    throw new Error(`Request failed with status: ${response.status}`);
  }
} catch (error) {
  console.error(error);
}

The response includes an array of variants — one for each available settlement method — so the payer can compare options:

{
  "id": "a1b2c3d4",
  "expiresAt": "2026-04-06T11:00:00.000Z",
  "variants": [
    {
      "settlementMethod": "dmt",
      "settlementChannel": "checkout",
      "payerRate": 1.0251,
      "fromCurrency": "USD",
      "fromAmount": 5125.5,
      "toCurrency": "AUD",
      "toAmount": 5000,
      "fee": 25.5,
      "totalAmount": 5151.0
    },
    {
      "settlementMethod": "bank-transfer",
      "settlementChannel": "volt",
      "payerRate": 1.0198,
      "fromCurrency": "USD",
      "fromAmount": 5099.0,
      "toCurrency": "AUD",
      "toAmount": 5000,
      "fee": 15.0,
      "totalAmount": 5114.0
    }
  ]
}

Quote request fields

Transaction types

Understanding quote variants

Each variant in the response represents a different way the payer can send money. The fields in each variant are:

Retrieving a quote

You can retrieve a previously created quote by its id:

try {
  const response = await fetch('https://api.nexpay.com/v2/quotes/a1b2c3d4', {
    method: 'GET',
    headers: {
      'Authorization': 'ApiKey your-api-key-here',
    },
  });

  if (response.ok) {
    const data = await response.json();

    console.log(data);
  } else {
    throw new Error(`Request failed with status: ${response.status}`);
  }
} catch (error) {
  console.error(error);
}

Things to know

• Quotes have an expiry time (expiresAt). Always check this before using a quote to create a payment — using an expired quote will return a [QOT0001] error.
• Different settlement methods may have different rates and fees. Present all variants to the payer so they can choose the best option.
• The amount in the quote request is the amount the payee receives (destination amount), not what the payer sends.
• If the currency pair is unavailable, the API will return a [QOT0003] error. Use the FX Rate API to check supported pairs first.
• FX rates fluctuate — always create a fresh quote close to when the payer is ready to pay.