Skip to main content

Apply for Merchant Identity Certificate

SuiteSpot uses the Merchant Identity Certificate to authenticate the merchant with Apple. Apple Pay is available as a payment option only after the required setup and Portal configuration are complete.

  1. Register a Merchant ID.

    1. Sign in to the Apple Developer website and open Certificates, Identifiers & Profiles.

    2. Select Identifiers > + > Merchant IDs, then click Continue.

    3. Enter a description and an identifier beginning with merchant., for example merchant.com.examplecompany.

    4. Click Continue > Register.

    Retain the Merchant ID for the remaining processes and Portal configuration.

  2. Create a certificate signing request.

    A certificate signing request (CSR) contains the public key submitted to Apple. The matching private key remains on the computer.

    Choose one method.

    • Method A: Keychain Access on Mac

      1. Open Keychain Access.

      2. Select Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority.

      3. Complete the form:

        Field

        Setting

        User Email Address

        Work email address

        Common Name

        A distinctive name, for example Company Merchant Identity

        CA Email Address

        Leave blank

        Request is

        Saved to disk

        Let me specify key pair information

        Select this option

      4. Click Continue, choose a save location, and select RSA with a 2048-bit key.

      5. Save the CSR as merchant_id.certSigningRequest.

      6. In login > Keys, confirm that the private key appears under the specified Common Name.

      7. Retain this key.

    • Method B: OpenSSL

      Run the following command, replacing the example email address and Common Name:

      openssl req -new -newkey rsa:2048 -nodes -keyout merchant_id.key.pem -out merchant_id.certSigningRequest -subj "/emailAddress=admin@example.com/CN=Company Merchant Identity"

      This creates the CSR and its matching, unencrypted private key. Treat merchant_id.key.pem as a secret.

  3. Download the certificate.

    1. In Apple Developer, open Certificates, Identifiers & Profiles > Identifiers and filter by Merchant IDs.

    2. Open the registered Merchant ID.

    3. Under Apple Pay Merchant Identity Certificate, click Create Certificate.

    4. Upload merchant_id.certSigningRequest.

    5. Download the certificate as merchant_id.cer.

  4. Produce the PEM files.

    Follow the method used to create the CSR.

    • Method A: Keychain Access on Mac

      1. Import merchant_id.cer into the login keychain on the original Mac.

      2. Under My Certificates, locate the Merchant Identity Certificate and expand it. Confirm that its private key appears beneath it.

      3. Select the certificate and its matching private key, then select File > Export Items.

      4. Export as Personal Information Exchange (.p12), using the filename merchant-identity.p12.

      5. Set an export password and retain it securely.

      6. In Terminal, open the folder containing the .p12 and run:

        umask 077 openssl pkcs12 -legacy -in merchant-identity.p12 -clcerts -nokeys | openssl x509 -out merchant_id.crt.pem openssl pkcs12 -legacy -in merchant-identity.p12 -nocerts -nodes | openssl pkey -out merchant_id.key.pem

      Enter the export password when prompted.

      Note

      These commands use -legacy for compatibility with Keychain-exported files in OpenSSL 3. If the OpenSSL version reports an unknown option, remove -legacy.

    • Method B: OpenSSL

      The private key already exists. Convert the downloaded certificate:

      openssl x509 -inform DER -in merchant_id.cer -out merchant_id.crt.pem

    Both methods produce:

    File

    Portal File

    merchant_id.crt.pem

    Merchant Identity Certificate

    merchant_id.key.pem

    Merchant Identity Key

  5. Check the certificate and key.

    1. Run both commands:

      openssl pkey -in merchant_id.key.pem -pubout -outform DER | openssl dgst -sha256 openssl x509 -in merchant_id.crt.pem -pubkey -noout | openssl pkey -pubin -outform DER | openssl dgst -sha256

      Both commands must finish without errors and return identical hash values.

    2. Check the certificate details:

      openssl x509 -in merchant_id.crt.pem -noout -subject -issuer -enddate

      Confirm that the subject contains the correct Merchant ID and the expiry date (notAfter) is in the future.

    3. Record the expiry date for renewal.

Note

To upload the certificate and matching private key, see step 12 in Suite Catering | Getting Started.