Contents

Managing merchant IDs and Payment Processing certificates

Create and update certificates so your app uses Apple Pay and Wallet.

Overview

Managing your merchant Identifier (ID) and Payment Processing certificates keeps the Apple Pay service active in your app. To set up your Apple developer account and Xcode to implement Apple Pay in your apps, complete three steps:

  • Create a merchant ID.

  • Create a Payment Processing certificate. To learn more about certificates for Apple Pay and Wallet, see Configure Apple Pay.

  • Enable Apple Pay in Xcode. To learn more see, Setting up Apple Pay Once you set up Apple Pay in your apps, you then can replace Payment Processing certificates as they near their expiration date — 25 months after you create them. To learn more, see Maintaining Your Environment.

Create a merchant ID

A merchant ID uniquely identifies you to Apple Pay as a merchant who is able to accept payments. A merchant ID never expires, and you can use the same one for multiple apps.

To create a merchant ID, use Create a merchant ID.

Here’s an example payload:

"data": {
        "type": "merchantIds",
        "attributes": {
            "identifier": "com.myapp.merchant1",
            "name": "MyMerchantName"
        }
    }
}

Create Payment Processing certificate

To create a certificate to use with Apple Pay, use Create a Certificate.

Here’s an example payload:

{
  "data": {
    "type": "certificates",
    "attributes": {
        "certificateType": "APPLE_PAY",
        "csrContent" : "<PEM-CSR-Content>"
    },
    "relationships": {
      "merchantId": {
        "data": {
          "type": "merchantIds",
          "id": "1234567890"
        }
      }
    }
  }
}

Rotate a Payment Processing certificate

Use one of three options to replace a payment-processing certificate nearing its 25-month expiration date. Each option takes into account that you can have more than one payment processing certificate, but only one can be activated for use at any time:

Expire and create

Let the existing Payment Process certificate expire. Then create a new Payment Processing certificate using Create a Certificate. The created certificate automatically has the activated key set to TRUE.

Create then revoke

Create a new Payment Processing certificate using Create a Certificate. Revoke the existing certificate nearing expiration by using Revoke a Certificate. The new Payment Processing certificate automatically has the activated key set to TRUE.

Create and activate

Create a new Payment Processing certificate using Create a Certificate. Then explicitly “activate” the new certificate using Modify a certificate.

See Also

Managing merchant IDs