- REST APIs
- Welcome
- Card Payments
- 3D Secure 2
- Vault
- Getting Started
- Using the API
- Typical API Calls
- Verify That the Service Is Accessible
- Create a Profile for a Customer
- Add an Address to a Profile
- Add a Card to a Profile
- Add a Bank Account to a Profile
- Create an Apple Pay Single-Use Token
- Create a Google Pay Single-Use Token
- Create a Mobile Single-Use Token
- Create a Direct Debit Single-Use Token
- Process a Transaction Using a Payment Token
- API Reference
- Test and Go Live
- Direct Debit
- Apple Pay
- Google Pay
- Alternate Payments
- Reports API
- ISV Reports
- Platforms
- Overview
- Accounts API V1
- Getting Started
- Using the API
- Typical API Calls
- Verify That the Service Is Accessible
- Create a New Merchant
- Create a New Merchant Account
- Create a New User
- Add an Address
- Create a Business Owner
- Add a Business Owner Address
- Add a Business Owner Identity Document
- Add a Merchant Bank Account
- Accept Our Terms and Conditions
- Activate the New Merchant Account
- Validate the Bank Account
- Enable Webhooks to Receive Application Statuses
- Test and Go Live
- Subaccounts
- Applications API
- Split Payouts
- Balance Transfers
- Paysafe Payments API
- Paysafe Checkout
- Paysafe JS
- Payments API
- Bad Bin API
- Reference Information
- SDKs
- Mobile SDKs
- Additional Documentation
- Resources and Support
- Shopping Carts
- Classic APIs
- Glossary
Multiple Currencies
In the simplest Paysafe Checkout 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, Direct Debit API, or Alternate Payments API, depending on what the customer selected at the checkout.
If, however, you want to process transactions in multiple currencies or multiple payment methods, 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 and payment method involved. This requires that you keep a record of the currency:accountId and payment method: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 and payment method; 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.
Currency | Account ID |
---|---|
GBP | 1001127760 |
EUR | 1001124870 |
USD | 1001113750 |
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.
- for Direct Debit: USD, CAD
- for Interac: CAD only