Paysafe Request Overview
Currently, only Apple Pay is supported.
- Complies with PCI SAQ-A
- Simple integration, very similar to Paysafe Checkout , Paysafe.js and the w3 Payment Request API
- Fully "white label", with no indication to your customers that Paysafe is handling the payment
- No redirection from the merchant web site required
If your OS and browser comply with Apple Pay prerequisites (an iOS or macOS device with Safari, and an Apple sandbox account) an example of Paysafe Request in action will be displayed below. If you do not meet these prerequisites, a message to that effect is displayed instead. The example does not make a real payment, and no money is transferred.
The token returned can then be used to make a payment using the Card Payments API.
Before you begin, you need to obtain your standard server-to-server API key and a single-use token-generating API key from the merchant back office.
The obtain a single-use token-generating key:
- SIGN UP to get a test account, if you haven't already done so.
- Login to the test back office. Sign in with the username and password you used when signing up for the test account. You should now see the API key page.
- In the Single-Use Token area, click the Create button.
- You will receive a security token by email. Enter this token and click Next.
The Single-Use Token area in the API key page updates to show the username and password for the single-use token API key.
- If you haven't already done so, take a copy of the user name and password for the Server to Server API key as well. You will need this (and your account ID in your signup email) for taking payments with the generated tokens.
Paysafe Request uses the Base64-encoded version of the single-use token API key constructed by concatenating the user name and password separated by a colon and Base64 encoding the result. You can use a site like https://www.base64encode.org/ to do the base 64 encoding. See authentication for more details.
Getting an Apple Pay Merchant Identity Certificate
To configure Paysafe Request, your Paysafe back-office account needs both an Apple Pay Payment Processing Certificate (used to encrypt the sensitive transaction data), and a Merchant Identity Certificate, which is used to set up a web session with the Apple server to handle the encrypted data.
Before you create an Apple Pay Merchant Identity Certificate you must have a single-use-token API Key.
Follow the steps below to create a Merchant Identity Certificate; this procedure assumes that you already have a Paysafe merchant account and an Apple Developer account.
If you do not have a Paysafe merchant account, please contact Paysafe technical support.
Go to the Paysafe merchant back office and in the Apple Pay settings, click Add Merchant Identity Certificate.
Generate a Certificate Signing Request (CSR) by clicking Generate CSR.
Go to the Apple Developer Portal and, using the CSR file created in the first step (in the Downloads folder), for your Apple Merchant ID create an Apple Pay Merchant Identity certificate and then Download it.
In the merchant back office, click Next.
In the merchant back office, choose and then upload the newly created Apple Pay Merchant Identity Certificate.
You will receive confirmation that the Apple Pay Certificate was uploaded successfully in the back office, and your certificates will be displayed; for example: