Judopay Documentation

Apple Pay™ for Mobile


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.



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


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


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




Access your Apple Developer Account.

Navigate to Certificates, Identifiers & Profiles.


From the side menu, click Merchant IDs.


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


Set your Merchant ID.

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


Click Done.

Create an Apple Pay™ Certificate


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




From the side menu, select either:

  • Certificates > All

  • Merchant ID


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

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


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

Select No.


Click Continue.


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


Click Generate.


The confirmation screen appears.

Your certificate is ready to download.

Click Download.


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.


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




Select your build Target.


Select Capabilities.


Set the entitlement to Enabled.


Add the Merchant ID created earlier to the app.

You may need to refresh the list.


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.