Before You Start
This guide is for developers who want to integrate with the Paysafe payment platform and use the Paysafe Card Payments API to process debit and credit card payments.
Prerequisites
- To use the Paysafe Card Payments API you must be PCI-DSS compliant to level SAQ-D.
- Before you start integrating, be sure to apply for the accounts you need to test your integration.
- This guide assumes that you have developer-level knowledge of REST-based APIs, which you use to connect to the Paysafe platform.
Using the REST API
- API calls use the REST architecture. All requests and responses use the JSON (JavaScript Object Notation) format.
- Test API calls can be sent to the Paysafe platform using cURL. Alternatively, you can use a graphical browser-based REST client tool such as Postman or the Advanced Rest Client. An example is provided in the section on REST architecture.
- All API requests must be made over HTTPS. Calls made over plain HTTP will fail.
- API requests without authentication will fail.
Cardholder Authentication
Merchants trading in regions where cardholder authentication (3D Secure) is used, such as the UK and Europe, should implement the 3D Secure 2 API. This will ensure that cardholders enrolled in the scheme are authenticated with their card issuer before either:
- Requesting authorization and settlement using the Card Payments API
- Storing customer card details using the Customer Vault API
Failure to implement the API may increase both:
- The number of declined transactions
- The risk of chargebacks
For more information, see 3D Secure 2.
The Payment Card Industry (PCI) imposes strict regulations related to the handling and storage of customer payment method details by merchants and service providers, as part of the industry's Data Security Standards (DSS) for online payments. Merchants accepting online payments must conform to the PCI DSS. For more information, see PCI DSS Compliance.
To download a French version of this guide in PDF, click here.