Multiple Currencies

In the simplest Paysafe.js scenario you would have a single merchant account handling a single currency. Once your merchant back-end server receives the single-use token from the client browser it passes it in a payment authorization request to the Card Payments API.

If, however, you want to process transactions in multiple currencies, you require multiple merchant accounts, which Paysafe Integration Support will create for you on request. When you process a transaction you have to choose the correct account to use with the currency involved. This requires that you keep a record of the currency:accountId mappings, and create a means of retrieving the account information. For example, when your payment page sends the single-use token to the merchant back-end it could also send the currency; an API endpoint receiving the data could then perform an accountId lookup before making the payment authorization request. Such an endpoint would need to be made secure to prevent unauthorized access.

A table of example currency:accountId mappings is shown below.

If 3DS is involved in a card transaction a 3DS enrollment check takes place before the tokenization request. The enrollment check also requires the accountId be supplied, so you will need to access your currency:accountId mappings during this step as well. You will need to create a separate secure endpoint on your merchant server that takes a currency parameter and returns the appropriate accountId for that currency.