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.
Register a Merchant ID.
Sign in to the Apple Developer website and open Certificates, Identifiers & Profiles.
Select Identifiers > + > Merchant IDs, then click Continue.
Enter a description and an identifier beginning with merchant., for example merchant.com.examplecompany.
Click Continue > Register.
Retain the Merchant ID for the remaining processes and Portal configuration.
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
Open Keychain Access.
Select Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority.
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
Click Continue, choose a save location, and select RSA with a 2048-bit key.
Save the CSR as merchant_id.certSigningRequest.
In login > Keys, confirm that the private key appears under the specified Common Name.
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.
Download the certificate.
In Apple Developer, open Certificates, Identifiers & Profiles > Identifiers and filter by Merchant IDs.
Open the registered Merchant ID.
Under Apple Pay Merchant Identity Certificate, click Create Certificate.
Upload merchant_id.certSigningRequest.
Download the certificate as merchant_id.cer.
Produce the PEM files.
Follow the method used to create the CSR.
Method A: Keychain Access on Mac
Import merchant_id.cer into the login keychain on the original Mac.
Under My Certificates, locate the Merchant Identity Certificate and expand it. Confirm that its private key appears beneath it.
Select the certificate and its matching private key, then select File > Export Items.
Export as Personal Information Exchange (.p12), using the filename merchant-identity.p12.
Set an export password and retain it securely.
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
Check the certificate and key.
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 -sha256Both commands must finish without errors and return identical hash values.
Check the certificate details:
openssl x509 -in merchant_id.crt.pem -noout -subject -issuer -enddateConfirm that the subject contains the correct Merchant ID and the expiry date (notAfter) is in the future.
Record the expiry date for renewal.
Note
To upload the certificate and matching private key, see step 12 in Suite Catering | Getting Started.