Peach Payments

<form action="https://test.docs.oppwa.com/tutorials/integration-guide/fast-checkout#applePayCallbackFunction" class="paymentWidgets" data-brands="APPLEPAY"></form>

<script src="https://test.oppwa.com/v1/paymentWidgets.js"></script>

wpwlOptions.createCheckout = function() {
    // Call your server to create a checkout
    return $.post("https://your.server")
    .then(function(response) {
        // Assume that your server returned the response containing checkoutId
        return response.checkoutId;
    });
};

Adding Apple Pay with the Mobile SDK

Before you begin adding Apple Pay using the Mobile SDK, you need an Apple Development Account. Once you have created an account, you will then need to apply for the Apple Developer Program. Once done, complete the following steps:

1. Configure your environment

2. Add Apple Pay to Your iOS App Using the Mobile SDK

Configure your Environment

1. Create a Merchant ID

2. Register and Verify Your Domain 

3. Accept the Apple Pay Terms and Conditions as the Apple Developer account holder

4. Send an email to [email protected] with APPLE PAY - YOUR COMPANY NAME in the subject to request an integration call to finalise the configuration process. (adding your Apple Pay Merchant Identity Certificate and Payment Processing Certificate)

5. Integrate with XCode 

For a more detailed explanation of the steps outlined above, please refer to the official Apple Pay documentation here.

Once completing the steps above, your app should be ready to accept Apple Pay using our Mobile SDK.

Adding Apple Pay to Your iOS App Using the Mobile SDK

You are able to add the Apple Pay button to both our ready to use checkout screens and your own custom checkout screens in your iOS apps.

For a detailed explanation of how to add Apple Pay to Your iOS App Using the Mobile SDK, please click here.

Adding Apple Pay on the Web

You are able to add Apple Pay for Web to your website by using the Peach Payments Server-to-Server API. In order to enable Apple Pay for Web, you need an Apple Development Account. Once you have created an account, you will then need to apply for the Apple Developer Program. Once done, complete the following steps:

1. Configure your environment

2. Check for browser support

3. Create an Apple Pay payment session 

4. Display the payment sheet on the device

5. Handle the onvalidatemerchant callback

6. Handle the onpaymentauthorized callback

Configure Your Environment 

In order to integrate Apple Pay with Apple Pay on the Web, you will need to configure your environment by completing the following steps:

1. Create a Merchant ID

2. Register and Verify Your Domain 

3. Generate an Apple Pay Merchant Identity Certificate

4. Send an email to [email protected] with APPLE PAY - YOUR COMPANY NAME in the subject to request an integration call to finalise the configuration process (adding your Apple Pay Payment Processing Certificate)

Check for Browser Support 

Before showing the Apple Pay Button on your checkout page, you need to ensure that the device is capable of making Apple Pay payments and a card has been provisioned for Apple Pay.

Use the ApplePaySession.canMakePaymentsWithActiveCard method in order to validate both of those requirements. 

Create an Apple Pay Session

On the web, the Apple Pay payment process is managed by the ApplePaySession object. A new ApplePaySession should only be created when a customer explicitly asks to make a payment, for example, inside an onclick event. If a new ApplePaySession object is not requested when a customer explicitly requests a payment, a JavaScript exception is thrown.

Display the payment sheet on the device

To display the payment sheet on the device, call the ApplePaySession object’s begin method. This method is responsible for starting the merchant validation process. 

JavaScript

session.begin();

Testing Apple Pay

You are able to conveniently test your CopyandPay, Apple Pay on the Web and Checkout implementations using the Apple Pay sandbox environment. You are able to create as many test accounts as you would like using App Store Connect. Click here to find out how to create a sandbox tester account. 

A tester logs into a test account on their supported Apple device, and adds a test card to their Apple Pay wallet. A list of test cards can be found on Apple’s website. If the tester clicks the Apple Pay button on a checkout page, a payment sheet in test mode will appear. The tester is then able to go through the payment flow. 

Note: If you are using Checkout, please contact support to obtain your Apple Pay Merchant ID.

Brand Guidelines for Apple Pay

Apple requires all merchants who wish to use Apple Pay on the Web to follow certain brand guidelines when integrating Apple Pay with their websites.

All information regarding the Apple brand guidelines is readily available on the official Apple website. The Apple Pay marketing guidelines can be found here.

Customising the Apple Pay Button

If you are integrating Apple Pay using CopyandPay or Server-to-Server, you are able to customise your Apple Pay button using Apple Pay’s own CSS templates.

Additionally, if you are using CopyandPay, you can use the widget customisation options to customise the look and feel of your CopyandPay payment form. 

Please refer to the official Apple Pay brand guidelines when customising your Apple Pay button.

Terms and Conditions

Please note that Apple Pay is only available to merchants who meet Apple's acceptable use guidelines. Before integrating with Apple Pay, Merchants need to agree to the Apple Pay terms.