Search Overlay

Testing Instructions


The Paysafe Test environment can be used to test websites or applications without running transactions through the Production (live) processing platform. Payment transactions (e.g., credit card or Direct Debit) processed in the Test environment are not sent to the banking network, but through a simulator. Depending on the information provided with the transaction request, the simulator returns either a successful (approved) or failed (declined) response.

With the Paysafe API you can test the following:

  • Verify support for all the operation types that you require.
  • Review all common errors as well as errors that may occur for each operation, and ensure your application can handle them.
  • Verify the lengths and format for all attributes you send.

The Card Payments API also enables you to simulate specific responses by using special values for the amount, cvv and street request parameters.

Applying for a Test Account

You can apply for a Test account by clicking the SIGN UP button.

Your Test account will provide you with access to a Test version of the Paysafe Merchant Back Office, where you can view the status of your Test transactions. Once logged in to the Back Office you should also retrieve your Account Number (choose Accounts and copy it from the Account column) and your API Key User name and Password (choose Settings > API Key); the password is also available Base64 encoded.

The default Test account can be used for processing Visa and Mastercard card payments (using the Card Payments, Customer Vault, Hosted Payments, and 3D Secure APIs). Special card numbers are available for testing these APIs and for use with Paysafe.js.

Do not use real card numbers or other payment instrument details in the Merchant test environment as it is not compliant with Payment Card Industry Data Security Standards (PCI-DSS), and does not protect cardholder/payee information. Any upload of real cardholder data is strictly prohibited, as described in the Terms of Use.

You will need to open separate accounts for Direct Debit payments (one account for each Direct Debit method you want to support: SEPA, EFT, BACS, and ACH) and one account for each of the Alternate Payment methods supported by Paysafe that you want to use (e.g., SOFORT and BOKU). Also, if you want to test payments in a different supported currency then you will need additional accounts for each payment method/currency combination; for example, SEPA Direct Debit EUR, BACS Direct Debit GBP, Card Payments EUR, and Card Payments GBP. Contact Integration Support with your requirements and they will create the accounts for you.

NOTE: All your accounts can be set up to use the same API key. Please contact Customer Support for more information.

Multiple accounts are summarized in the following image:

Test API endpoint

The API endpoint to use for Test transactions is:

For example:

Using Currencies with Test Accounts

Developer Center test accounts support processing and settlement in the following currencies:

  • CAD – Canadian Dollar
  • GBP – British Pound
  • EUR – Euro
  • USD – US Dollar

Paysafe can process and settle in the following currencies:

  • AUD
  • CAD
  • CHF
  • DKK
  • EUR
  • GBP
  • HKD
  • NOK
  • NZD
  • PLN
  • RUB
  • SEK
  • SGD
  • TRY
  • ZAR

If you want to process in one currency and settle in another, contact Paysafe Integration Support.

Paysafe supports payments using all major card brands. However the Developer Center test account only supports American Express, Maestro, Mastercard, Visa, and Visa Electron. Contact Integration Support if you wish to enable other brands for your test account.

Overriding the default currency

You can override the default processing currency by specifying in your API request the currency code of the currency to be used for processing the transaction (using the currencyCode parameter). For example:

"amount": 10098,
"currencyCode" : "CAD",

For a list of currencies and the corresponding codes, see Currency Codes.

This request will fail if you do not have a merchant account which supports this currency and payment method. Paysafe integration support set up a mapping between the currency and an account which supports this currency.

If you have multiple merchant accounts with the same currency, you will need to supply an additional parameter, the merchantAccount, which acts in the same way as the account_id in the other REST APIs, to select the correct account as follows:

"amount": 10098,
"currencyCode" : "CAD",
"extendedOptions" : [{
"key" : "merchantAccount",
"value" : "10036215"

Test and Production Accounts

Test accounts enable you to process API transactions that mirror the functionality on the Production environment. Once you are satisfied with your integration to the Test environment, you will need to repeat any configuration changes made to your Test account on the Production account. Keep a record of any changes requested and carried out.

You will need to use different API endpoints and authentication credentials to connect to the Paysafe Production environment.

For details, see Going Live.