Fees and Amounts

For further information on the types of fees in Nexus, see Fees.

Get maximum payment amount for a specified Country

Returns the maximum payment amount for a specified country, based on the countryCode and currencyCode provided. (Currency code is required because some countries use 2 currencies in parallel.)

get

/countries/{countryCode}/currencies/{currencyCode}/max-amounts

Path parameters

countryCodestringrequired

2-letter country code of the requested country.

Example: SG

currencyCodestringrequired

3-letter currency code.

Example: SGD

Responses

application/json

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/countries/{countryCode}/currencies/{currencyCode}/max-amounts'

200

404

200

[
  {
    "clearingSystemId": "SGDFAST",
    "maxAmount": "200000"
  }
]

Successful response

Get Fees and Interbank Settlement Amounts

Retrieves the various fees and amounts based on specified parameters. Information can be used in the pacs.008 payment instruction.

get

/fees-and-amounts/{sourceCurrency}//{destinationCurrency}//{amountCurrency}//{amount}//{exchangeRate}

Path parameters

sourceCurrencystringrequired

The source currency code.

Example: SGD

destinationCurrencystringrequired

The destination currency code.

Example: MYR

amountCurrencystringrequired

The currency of the specified amount.

Example: SGD

amountnumberrequired

The amount in the specified amount currency. If the amount is defined in the Source Currency, this amount must be the amount AFTER the Source PSP has made any deduction. (This is the Interbank Settlement Amount that must be transferred to the FXP's account at the Source SAP). If the amount is defined in the Destination Currency, this must be the Creditor Agent Amount that will be credited to the recipient's account.

Example: 100

exchangeRatenumberrequired

The exchange rate from the source to destination currency.This information must be taken from (a) a quote provided by Nexus, or (b) the Source PSP's own exchange rate (when the Source PSP manages their own FX.).

Example: 3.5

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/fees-and-amounts/{sourceCurrency}/{destinationCurrency}/{amountCurrency}/{amount}/{exchangeRate}'

200

200

{
  "debtorAgent": {
    "interbankSettlementAmount": {
      "amount": 100,
      "currency": "SGD"
    },
    "nexusSchemeFee": {
      "amount": 0.5,
      "currency": "SGD"
    }
  },
  "creditorAgent": {
    "creditorAccountAmount": 347.76,
    "interbankSettlementAmount": {
      "amount": 350,
      "currency": "MYR"
    },
    "chargesAmount": {
      "amount": 2.24,
      "currency": "MYR"
    }
  }
}

Successful response

---

Get Nexus Scheme Fee Formula

Returns the Nexus Scheme Fee Formula (paid by the Source IPS to the Nexus Scheme) in a specified Source Currency, denominated in the Source Currency

get

/fee-formulas/nexus-scheme-fee/{countryCode}//{currencyCode}

Path parameters

countryCodestringrequired

The country code of the SOURCE Country.

Example: SG

currencyCodestringrequired

The 3-letter currency code

Example: SGD

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/fee-formulas/nexus-scheme-fee/{countryCode}/{currencyCode}'

200

200

{
  "countryCode": "SG",
  "currency": "SGD",
  "nominalFeeAmount": "0.50",
  "percentageFeeAsRatio": 0.001
}

Successful response

---

Get Creditor Agent Fee Formula

Returns the Creditor Agent (Destination PSP) Fee FORMULA for a specified Destination Country, denominated in the Destination Currency.

get

/fee-formulas/creditor-agent-fee/{countryCode}//{currencyCode}

Path parameters

countryCodestringrequired

The 2-letter country code of the DESTINATION Country.

Example: MY

currencyCodestringrequired

The 3-letter currency code of the DESTINATION Country.

Example: MYR

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'http://localhost:3000/fee-formulas/creditor-agent-fee/{countryCode}/{currencyCode}'

200

200

{
  "countryCode": "MY",
  "percentageFee": 0.1,
  "nominalFee": {
    "amount": "2.22",
    "currency": "MYR"
  }
}

Successful response