Apple Pay Onboarding — Aurus
This guide covers the onboarding procedure for enabling Apple Pay with the Aurus payment gateway. It includes generating the required Apple Pay certificates, converting them into the formats required by Aurus, and securely delivering the certificate artifacts to Aurus.
Note: Successful completion of these steps is a prerequisite for routing Apple Pay transactions through PAR Pay to Aurus.
Scope: This document is limited to gateway onboarding. Apple Pay flow orchestration and API integration with PAR Pay are covered in the Apple Pay Integration with PAR Pay guide.
Certificate Overview
Apple Pay onboarding with Aurus requires two distinct certificate types, each serving a specific purpose:
| Certificate | Purpose |
|---|---|
| Payment Processing Certificate | Used by Aurus to decrypt the Apple Pay payment token received during a transaction. |
| Merchant Identity Certificate | Used by Aurus to authenticate the merchant with Apple during merchant validation, create Apple Pay merchant sessions, and perform domain verification. |
Both certificates are mandatory for Apple Pay enablement.
Apple Merchant Identifier
An Apple Merchant Identifier must be created and approved in the Apple Developer Portal before generating any Apple Pay certificates. For example, merchant.com.yourname.store.
Important: This Merchant ID must be used exactly as the Common Name (CN) in all Apple Pay certificate CSRs.
Certificate Requirements for Aurus
Aurus requires:
- The Payment Processing Certificate to decrypt Apple Pay payment tokens.
- The Merchant Identity Certificate to authenticate the merchant and obtain Apple Pay merchant sessions.
Each certificate must be generated using the correct cryptographic algorithm and uploaded under the correct Merchant ID.
Generate Payment Processing Certificate
The business generates encryption material used by Aurus to decrypt Apple Pay payment payloads.
Generate PEM-formatted EC Private Key
openssl ecparam -name prime256v1 -genkey -noout -out <file_name>.key
Note: Replace
<file_name>with your preferred filename. For example,payment_processing.key.
Generate Certificate Signing Request (CSR)
openssl req -new -key <file_name>.key -out <file_name>.csr
Note: Replace <file_name> with your preferred filename. For example, payment_processing.key. <file_name>.key is the private key and <file_name>.csr is the Certificate Signing Request (CSR).
CSR Prompt Guidelines
- Common Name (CN): Type your Merchant ID (for example,
merchant.com.yourname.store) - Email: Corporate email address.
- Password: Set a password.
- Other fields: Optional
Upload Certificate Signing Request (CSR) to Apple Developer Portal
Upload the certificate signing request (CSR) using the following navigation path:
- Sign in to Apple Developer Portal.
- Navigate to Certificates, Identifiers & Profiles.
- Open Identifiers > Merchant IDs.
- Select your Merchant ID (e.g.,
merchant.com.yourname.store). - Choose Apple Pay Payment Processing Certificate.
- Upload the payment processing CSR (certificate signing request) file (
<file_name>.csr). - Download the generated Payment Processing Certificate file (
<file_name>.cer).
Convert Downloaded Certificate to PKCS#12 Format
openssl pkcs12 -export -inkey <file_name>.key -in <file_name>.cer -out <file_name>.p12
Note: Replace
<file_name>with your preferred filename.<file_name>.key is the private key,<file_name>.cer is the Apple-issued Payment Processing Certificate, and<file_name>.p12 is a PKCS#12 file that packages the certificate and its matching private key into a single file.
When OpenSSL prompts you to set a password, set and securely store the export password (e.g., PaymentProcessingCertPassword). The example PaymentProcessingCertPassword is just a placeholder to illustrate what kind of value it is. Choose a strong, unique password of your own.
Generate Merchant Identity Certificate
Generate credentials used by Aurus to authenticate the merchant and obtain Apple Pay merchant sessions.
Generate RSA Private Key
openssl genrsa -out <file_name>.key 2048
Note: Replace
<file_name>with your preferred filename. For example,merchant_identity_rsa_2048.
Generate Certificate Signing Request (CSR)
openssl req -new -key <file_name>.key -out <file_name>.csr
Note: Replace
<file_name>with your preferred filename. For example,merchant_identity_rsa_2048.
Certificate Signing Request (CSR) Prompt Guidelines
- Common Name (CN): Type your Merchant ID (for example,
merchant.com.yourname.store) - Other fields: Informational only
Upload Certificate Signing Request (CSR) to Apple Developer Portal
Upload the CSR using the following navigation path:
- Sign in to Apple Developer Portal
- Navigate to Certificates, Identifiers & Profiles.
- Open Identifiers > Merchant IDs.
- Select your Merchant ID (e.g.,
merchant.com.yourname.store). - Choose Apple Pay > Create Certificate.
- Select Apple Pay Merchant Identity Certificate.
- Upload the generated Merchant Identity CSR (certificate signing request) file (
<file_name>.csr). - Download the generated Merchant Identity Certificate (
<file_name>.cer).
Convert Merchant Identity Certificate to PKCS#12 Format
openssl pkcs12 -export -inkey <file_name>.key -in <file_name>.cer -out <file_name>.p12
Note: Replace
<file_name>with your preferred filename. For example,merchant_identity_rsa_2048.key. <file_name>.key is the private key,<file_name>.cer is the Apple-issued Merchant Identity Certificate, and<file_name>.p12 is a PKCS#12 file that packages the certificate and its matching private key into a single file.
When OpenSSL prompts you to set a password, set and securely store the export password (e.g., MerchantIdentityCertPassword). The example MerchantIdentityCertPassword is just a placeholder to illustrate what kind of value it is. Choose a strong, unique password of your own.
Deliverables to Aurus
Once both Apple Pay certificates have been generated and converted, the following artifacts must be securely delivered to Aurus:
| Artifact | Purpose |
|---|---|
| Apple Merchant ID | Identifies the merchant for Apple Pay processing. |
<file_name>.p12 |
Payment Processing certificate and private key used by Aurus to decrypt Apple Pay payment tokens |
| Payment Processing Certificate Password | Password protecting the Payment Processing PKCS#12 file |
<file_name>.p12 |
Merchant Identity certificate and private key used by Aurus for merchant validation and Apple Pay merchant session creation |
| Merchant Identity Certificate Password | Password protecting the Merchant Identity PKCS#12 file |
Note: Certificate passwords must never be shared via email or ticketing systems. Share them only through an approved secure communication channel.
Certificate Summary
| Certificate | Used For | Required by Aurus |
|---|---|---|
| Payment Processing Certificate | Decrypting Apple Pay payment tokens | Yes |
| Merchant Identity Certificate | Merchant validation and Apple Pay merchant session creation | Yes |
Installing OpenSSL (Prerequisite)
OpenSSL is required to generate Apple Pay cryptographic materials.
Windows
- Download: Win32/Win64 OpenSSL Installer for Windows
- Select: Win64 OpenSSL v3.x Light
- Installation options:
- Copy DLLs → Windows System Directory
- Add to PATH → Yes
Verify installation:
openssl version
macOS
brew install openssl
echo 'export PATH="/opt/homebrew/opt/openssl@3/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
openssl version
Linux (Ubuntu / Debian)
sudo apt update
sudo apt install openssl -y
openssl version