Multicurrency Payments

This is our product for payments between two different currencies either on your own accounts, or for outgoing and incoming payments. We support both a fully automated and a request-for-quote type of a workflow for payments.

The fully automated flow allows you to instruct payments in all of our supported currencies, where the foreign exchange conversion is completed as a part of your payment automatically when the payment is processed. This applies for both incoming and outgoing payments.

Multicurrency Payments RFQ

It is possible to request a foreign exchange quote upfront for a single payment using our Multicurrency Payments RFQ endpoint.

This quote is valid for 30 seconds at a time and can be attached to a payment instruction using the single payment instruction endpoint. The payment will then be processed using exactly this exchange rate.

The prerequisite for using instructing a payment with an exchange rate is that your execution date is today's date, and that you have pre-funded your debit account. Workflows where your debit account is not funded prior to the payment instruction are not supported for Multicurrency Payments RFQ, and will be processed with the prevailing exchange rate at the time of processing when your account has been funded.

In order to request an Multicurrency Payments quote, you only need to supply your intended debit currency, the credit (transfer) currency, the expected payment amount, and indicate whether the payment amount is in the debit or credit currency terms.

Below is an example request for requesting a quote to be used for a multicurrency payment where you are sending 17,500 DKK from your DKK account to a recipient in JPY:

//Our API will respond with an exchange rate which will be valid for 30 seconds
{  
  "quoteType": "Tradable",  
  "currencyPair": "JPYDKK",  
  "exchangeRate": 0.057962,  
  "quoteId": "416f5058-660f-4b2e-a62f-44d2b0e83fd8",  
  "expiryTime": "2021-10-08T14:04:01.2295277+00:00"  
}
 

You can then use the quoteId from the quote to instruct a single payment:

Other unrelated fields omitted for brevity

{
  "debtorAccount": {
    "account": "DK7189000000010504",
    "country": "DK",
    "financialInstitution": "SXPYDKKKXXX"
  },
  "currencyOfTransfer": "JPY",
  "amount": {
    "amount": "17500",
    "currency": "DKK"
  },
  "creditorAccount": {
    "account": "DK0989000000010359",
    "financialInstitution": "SXPYDKKKXXX",
    "country": "DK"
  },
  "fxQuoteId": "416f5058-660f-4b2e-a62f-44d2b0e83fd8"
}

Notice that the quote id is attached to the fxQuoteId field, and that all amounts and currencies match with the original request.

📘

RFQ for Bulk payments

Request for quote is currently not available for bulk payments

Multicurrency Payments RFQ - Table of Operations

When submitting a Multicurrency Payment and specifying a previously requested quote, the currency and the amount used must match in both requests.

For example, if your intention is to debit your DKK account by exactly 17.500 DKK, and convert it to a JPY amount, and send that JPY amount to your beneficiary, you must also use these parameters in your FX rate request. In your payment instruction, you should subsequently use DKK as the amount currency and 17.500 (or less) as the amount.

Conversely, if your intention is to send an exact amount of JPY to your beneficiary by debiting your DKK amount, you should use JPY as your amount currency in your FX rate request.

The possible combinations for the different fields are shown in the table below.

The 'X' amount is calculated using the prevailing FX rate