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.
Our technical colleagues will kindly assist you with your contractual and technical enquiries.
Contact our Integration Team for technical consultation on the different integration options that best suit your requirements.
Before contacting the Integration team first have a look at our API documentation to have a general understanding of the Saferpay JSON API.
If possible, please provide the integration team with a detailed description of your intention, requirements and use cases.
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 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.