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

  • 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 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.

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.

Did you find this page useful?