All the relevant information for developers
Get all the information about integrating Saferpay
Competent, reliable, seamless
Integrating Saferpay only requires 5 steps
Step 1: Consultation
Before integrating Saferpay it is important to understand the contractual and technical options as well as in requirements to ensure an optimal integration right from the beginning.
There are two types of consultation that are important to consider. Our sales and technical colleagues will kindly assist you with your contractual and technical enquiries.
Step 2: Testing
Saferpay offers the possibility to test all interfaces beforehand on the Saferpay Test-Environment (Sandbox). You can create a test account which allows you to implement Saferpay into your system and perform test transactions with several payment simulators before going live.
Use the Saferpay Test-Environment to fully test your integration before going live:
You will receive all the required test data via email after successful registration.
After you have received your test account data via email there are two main ways to proceed depending on whether you are using a plugin as provided by our partner custom web (plugins *) or whether you use an individual custom integration (custom integration).
*The customweb plugins are free of charge for new clients (contact our sales team for further information)
Step 3: Integration into live system
- Live Saferpay username (eg. „e24xxxx001“) for the Saferpay Backoffice
- Live Saferpay Initial Password for the Saferpay Backoffice - This password will be only used once, you will be prompted to define a new password after your first login. Please make sure to use only the newly created password for future logins
- Live Customer Id - Your Customer Identification number
- Live Terminal Id(s) - The virtual terminal identification number on which the different payment methods are activated. Different terminals might have different PaymentMethods activated depending on your business needs. Different Terminals might also be used for different webshops, entities or services
3.1 Creating JSON API authentication credentials
For your system to successfully communicate with Saferpay API you need to create either a JSON API Basic Authentication Credentials or Client Certificates.
Use your Saferpay username and the corresponding password to login into the Saferpay Backoffice to create the JSON API credentials or client certificates.
After successful login, navigate to “Settings” and then either to “JSON API basic Authentication” or “JSON API client certificate”*.
Notice: The “JSON API client certificate” tab will only be visible if you have a Saferpay Business license.
JSON API Basic Authentication:
JSON API Client Certificates (Business License):
3.2 Switching your integration from test to live mode
After creating the JSON API credentials or a JSON API client certificate, you simply have to replace your test data with the live data.
3.3 Configuring third party payment methods
Make sure to configure third-party payment methods in case you want to integrate them with Saferpay. Please also take notice of the special features of these third-party payment methods.
These are the third-party Payment methods that need to be configured before they can be integrated with Saferpay:
Step 4: Testing of live integration
You should intensively test your live integration with real cards and payment details to verify the correct end-to-end set up and functionality.
Our Integration team will kindly assist you should you have any issues or any further questions regarding the integration.
Please provide your Customer ID or Terminal ID and a detailed description of the issues/error, when contacting our Integration Team. Also point out whether you are integrating on the test or live environment. The more detailed your description and provided data are, the better and quicker our team can assist you with finding a suitable solution.
Step 5: Go Live
After successfully intensively testing the live integration, you can officially go live.
In case you later encounter any issues with your already running system our Support-Team is at your disposal and will kindly assist you.
Please provide your Customer ID or Terminal ID and a detailed description of the issues/error, when contacting our Support Team. The more detailed your description and provided data are, the better and quicker our team can assist you with finding a suitable solution.