Apple Pay Capabilities

PDF for offline use

Let us know how you feel about this

Translation Quality


0/250

last updated: 2017-03

Adding capabilities to an application often requires additional provisioning setup. This guide explains the setup needed for Apple Pay capabilities.

Apple Pay enables users to pay for physical goods via their iOS device. This section describes how to create all necessary components required for Apple pay in the Apple Developer Center.

Developer Center

When provisioning a new app through the developer center, there are three steps that need to be taken:

  1. Create a Merchant ID.
  2. Create an App ID with the Apply Pay capability and add the merchant to it.
  3. Generate a certificate for the Merchant ID.

The steps below will guide you through creating the above items:

Create Merchant ID

A Merchant ID is used to let Apple Pay know that you can accept payments, and is passed to PassKit’s PaymentRequest method and used in the Apple Pay entitlement:

  1. Browse to the Apple Developer Center and go to the Certificates, Identifier, and Profiles section:

    Developer Center Merchant ID selection

  2. Under Identifiers, select Merchant IDs, and then select the + to create a new merchant ID:

  3. Fill out the form, illustrated below, with a new description and identifier. The description makes the ID identifiable to you and can be changed later. The identifier must be unique to you, and it must start with the string merchant. Apple recommends that the identifier be in the following format: merchant.com.[Your-App-Name]:

    New Merchant ID details

  4. Confirm the details, and Register your ID: 

    Merchant ID confirmation

Create an App ID with the Apple Pay capability that includes the Merchant ID

  1. In the Developer Center click on App IDs under Identifiers:

    Select App ID in Developer Center

  2. Select the + button to add a new App ID:

    Add new App ID button

  3. Enter a Name for the App ID and give it an Explicit App ID:

    App ID details screen

  4. Under App Services, select Apple Pay:

    App Services Apple Pay

  5. Select Continue and then Register. Note that on the confirmation screen Apple Pay will display with Configurable selected, with a yellow symbol:

    Confirmation Screen for Apple Pay

  6. Return to the list of App IDs and select the one you have just created:

    Edit App ID

  7. Scroll down to the bottom of this expanded section and click Edit.

  8. Scroll down the list to Apple Pay and click the Edit button:

    Edit Apple Pay App ID details

  9. Select the Merchant ID to use with this App ID, and click Continue:

    Select Merchant ID to use for App ID

  10. Confirm the Merchant ID assignments, and press Assign:

    Confirmation Screen

This App ID can now be used to generate, or re-generate, a new provisioning profile.

Create a Certificate for your Merchant ID

A certificate is required by Apple to encrypt sensitive data associated with the transaction. Each Merchant ID created must have its own certificate.

To create a certificate, follow the steps below:

  1. Select the Merchant ID that was created above and press Edit:

    Edit Merchant ID dialog

  2. On the iOS Merchant ID Settings screen, click Create Certificate:

    Create payment processing certificate

  3. Answer the following question:

    address if payments will be processed exclusively in China

  4. At this point you will be prompted to create a certificate signing request:

    Creating a certificate signing request

    ⚠️

    If you are using a payment provider for Apple Pay, such a JudoPay or Stripe, they can provide you with a properly formatted CSR that you can use at this point. Information on requesting this is found on the JudoPay and Stripe sites. To create your own CSR, follow the steps 5-8 below. Once you have a CSR go to step 9.

  5. Open the Keychain Access application, and browse to Keychain Access > Certificate Assistant > Request a Certificate from a Certificate Authority:

    Create a CSR using keychain on a Mac

  6. Enter your email address, enter a name for the private key, leave CA Email Address empty, select the Save to Disk option, and select Let me specify key pair information:

    Certificate information dialog

  7. Save the CSR to a convenient location:

    Saving CSR to local machine

  8. In the Key Pair information screen, set Key Size to 256 bits and Algorithm to ECC and click Continue:

    Enter key pair information dialog

  9. On the Developer Center, click Continue to upload the CSR:

    Prepare to upload CSR to developer center

  10. Click Choose File… to select the CSR and press Continue to upload it to the developer portal:

    Upload CSR to developer center

  11. Once the certificate has been generated, download it and double click on it to install it to your keychain.

For more information on using Apple Pay, refer to the following guide:

Xamarin Workbook

If it's not already installed, install the Xamarin Workbooks app first. The workbook file should download automatically, but if it doesn't, just click to start the workbook download manually.