Apple Pay Integration Guide

Introduction

Apple Pay transactions are credit card transactions in which card information is tokenised and encrypted by Apple in the form of payment tokens. 

Certificates

It is possible to use your own certificates or Qashpay's certificates. Using our certificates is recommended as:

• It is easier and faster to integrate.
• Apple developer account is not required.
• You do not need to worry about expiring certificates. We will re-new them for you.

Creating Your Own Certificate

Before using Apple Pay, you will need to set up a key pair and a certificate. The steps are as follows:

1. In Apple Developer, under Certificates, Identifiers & Profiles, create a Merchant ID.

2. Request Apple Pay keys and CSR from the Qashpay team via our live chat.

3. Back in Apple Developer, select your Merchant ID and choose certificate. Upload the CSR file from Qashpay here.

4. Ensure that the certificate is activated, then download the certificate and return it to the Qashpay team.

5. Keep an eye on the renewal date and send to Qashpay near renewal.

Supported Integrations

• COPYandPAY (hosted checkout) – full Apple Pay documentation link.
• Server-to-Server

COPYandPAY

Loading the Apple Pay button via our COPYandPAY payment widget is just like loading any other brand in COPYandPAY. In step 2, APPLEPAY must be specified as a brand.

<form action="{shopperResultUrl}" class="paymentWidgets" data-brands="VISA MASTER APPLEPAY"></form>

You can modify the Apple Pay payment sheet behaviour by using wpwlOptions.applePay. The full list opf parameters are listed here.

Server-to-Server

There are two possibilities for server-to-server Google Pay integration

• With the encrypted payment token, or
• with decrypted card information.

With the Encrypted Payment Token

Send the following parameters together with other parameters in a server-to-server call:

paymentBrand=APPLEPAY
applePay.paymentToken={ ... }

With Decrypted Card Information

In this case, you do not set up a certificate with us. Follow the Apple Pay's documentation to do the decryption yourself and send the decrypted card information with the usual card API.

paymentBrand=APPLEPAY
card.number=4200000000000000
card.expiryMonth=05
card.expiryYear=2027
threeDSecure.verificationId=ABiKYvXjhcB7AAc+K04XAoABFA==
threeDSecure.eci=07
applePay.source=web

Support

Qashpay are on hand to help with any issues you may have with your ApplePay integration. Please get in touch via our help centre live chat, or via email at support@qashpay.com.