Judopay Documentation

Apple Pay™ for Mobile

Note

Apple Pay™ for Mobile only.

Apple Pay™ provides an easy and secure way to pay for physical goods and services such as groceries, clothing, tickets, and reservations in your iOS apps or on your website.

Using Touch ID, users can quickly and securely provide all their payment and shipping information to check out with a single touch.

 

Note

It is important to understand the difference between Apple Pay™ and an In-App Purchase.

Use Apple Pay™ to sell physical goods and services.

Use an In-App Purchase to sell virtual goods such as premium content for your app, and subscriptions for digital content.

For consumers, the Apple Pay™ experience starts with:

  1. Registering their payment and shipping information into the Wallet app on their Apple devices.

  2. Once registered, consumers can pay simply and securely using Touch ID to authenticate a transaction.

  3. Each transaction processed through Apple Pay™ is assigned a one-time payment number and a dynamic security code.

    1. This information is encrypted and used in place of credit or debit card details.

Effective implementations of Apple Pay™ can radically improve your payment process by allowing for a smoother ‘guest checkout’, while still capturing all the relevant information needed to fulfil a purchase, for example shipping information.

See the following integration guides to integrate Apple Pay™ for:

Apple Pay™ Set Up

Caution

Apple Pay™ is not supported on all Apple devices.

Before invoking any Apple Pay™ functionality within your app, test if it is supported on the device by performing these checks:

  • Use [PKPaymentAuthorizationViewController canMakePayments]

    Checks if the device supports Apple Pay™ and has it enabled.

    Queries both the device hardware and whether Apple Pay™ is enabled in the user’s region.

  • Use [PKPaymentAuthorizationViewController canMakePaymentsUsingNetworks]

    A more detailed check to query whether a user has a registered card with particular card schemes.

    Useful if you do not accept all card types.

Both methods are explained in the Apple developer documentation here.

Getting Your Apple Pay™ Account

System Requirements:

  • A compatible Apple device: iPhone 6 & 6 Plus | iPad Air 2 | iPad mini 3 | or newer

  • OS 8.1 or newer

  • Xcode 6.1 or newer

Create a Merchant ID

Tip

We recommend creating a Merchant ID for each Merchant (i.e. business) accepting payments within your app.

To set up your Apple Pay™ account:

Create a Merchant ID:

Apple Certificate

Step

Description

One.png

Access your Apple Developer Account.

Navigate to Certificates, Identifiers & Profiles.

Two.png

From the side menu, click Merchant IDs.

Three.png

In the iOS Merchant ID Settings screen, click the add button.

Four.png

Set your Merchant ID.

The identifier you enter should be a reverse DNS style identifier prefixed with the word.

Five.png

Click Done.

Create an Apple Pay™ Certificate

Pre-Requisite:

Request a Certificate Signing Request (CSR) file from Judopay.

When you’ve received your CSR, you can create your Apple Pay™ certificate.

To create your Apple Pay™ certificate:

Apple Pay Certificate

Step

Description

One.png

From the side menu, select either:

  • Certificates > All

  • Merchant ID

Two.png

The screen appears describing how to manually create your Certificate Signing Request (CSR).

As you’ve already obtained your CSR from Judopay, click Continue.

Three.png

You will be prompted to state if you are processing transactions outside the United States.

Select No.

Four.png

Click Continue.

Five.png

Click Choose File to upload the CSR file provided by Judopay.

Six.png

Click Generate.

Seven.png

The confirmation screen appears.

Your certificate is ready to download.

Click Download.

Eight.png

Click Done.

To complete your Apple Pay™ set-up send the certificate to Judopay.

Once received, we will add the certificate to your account and confirm it has been added.

Note

Apple Certificates expire just over two years after generation. For example a certificate generated on 13th May 2020 will expire on the 11th June 2021.

To generate a new certificate follow the steps above.

Set Up Apple Pay™ Entitlement

Apple Pay™ is built into the PassKit framework, which means you will need to configure the entitlement.

To set up the entitlement:

Apple Pay Entitlement

Step

Description

One.png

Select your build Target.

Two.png

Select Capabilities.

Three.png

Set the entitlement to Enabled.

Four.png

Add the Merchant ID created earlier to the app.

You may need to refresh the list.

Five.png

Open the entitlements file to confirm the Merchant ID has been added to your app.

 

Your account is now ready to process Apple Pay™ payments with Judopay.

Configure theMobile SDK to start making payments.

Apple Pay™ Button

Apple Pay™ allows the consumer to:

  • Bypass the standard checkout flow

  • Complete their payment with speed

Apple Pay Button

When integrating with Apple Pay™, it is recommended to consider when to introduce the Apple Pay™ button.

This can be:

  • On a single item product listing page

  • Within a basket page with multiple items

  • Both of the above scenarios

The Apple Pay™ button enables consumers to make a purchase from the specific page they are browsing. By tapping the Apple Pay™ button, the payment sheet is invoked to begin the checkout process.

For more information on the Apple Pay™ button, see Apple’s guidance of the PKPaymentButton Class Reference.