Prerequisites (Apple Pay)
To integrate Apple Pay into the Yuno solution, you must complete some steps covered on this page. Follow the steps described below before configuring Apple Pay in the Yuno Dashboard.
Step 1: Register a merchant identifier
In the Apple Developer dashboard:
- Log in to Apple Developer.
- Go to Certificates, Identifiers & Profiles, then select Register a new identifier.
- Choose Merchant IDs and click Continue.

- Enter a Description (e.g.,
Apple Pay Integration
) and an Identifier in the formatmerchant.com.y.uno.YourBusinessName
.

- Click Continue and follow the steps to register.
Step 2: Generate a payment processing certificate
- Create a new directory (e.g.,
Downloads/ApplePayFiles
) to store the certificate files. - Open Keychain Access on your Mac.
- Go to Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority.

-
Fill out the form:
- Email Address: your email address
- Common Name: a name for the certificate (e.g.,
John Doe ProcessingCertificate
) - CA Email Address: leave blank
- Select Saved to disk
- Check Let me specify key pair information
-
Click Continue, then save the file as
CertificateSigningRequestPaymentProcessingCertificate.certSigningRequest
in your working directory. -
When prompted for key pair settings, use:
- Key Type: Elliptic Curve (EC)
- Key Size: 256-bit
- Algorithm: ECDSA
-
Click Continue to generate the CSR.
Step 3: Retrieve and convert the payment processing certificate
- Go to the Apple Developer Merchant ID list.
- Select your Merchant ID and click Create Certificate under Apple Pay Payment Processing Certificate.

- When prompted, answer No to "Will payments... be processed exclusively in China mainland?"
- Upload the file
CertificateSigningRequestPaymentProcessingCertificate.certSigningRequest
. - Download the signed certificate as
apple_pay.cer
and save it to your directory.

- Convert the certificate to PEM format:
openssl x509 -inform DER -in apple_pay.cer -out apple_pay.pem
Step 4: Export the private key
- In Keychain Access, find the key you created (e.g.,
John Doe ProcessingCertificate
). - Right-click and choose Export.
- Export the key as a
.p12
file (e.g.,JohnDoeProcessingCertificate.p12
) and save it to your working directory. - Set a strong password (you’ll use it in the next step).
- Convert the
.p12
to a PEM-format private key:
openssl pkcs12 -in JohnDoeProcessingCertificate.p12 -nocerts -nodes | sed -ne '/-BEGIN PRIVATE KEY-/,/-END PRIVATE KEY-/p' > ProcessingCertificatePrivateKey.pem
The private key will be stored in ProcessingCertificatePrivateKey.pem
.
Step 5: Upload the certificate and key to Yuno
- Open the Yuno Dashboard > Connections > Apple Pay > Connect
- Enter the contents of
ProcessingCertificatePrivateKey.pem
to the Payment processing key field. - Enter the contents of
apple_pay.pem
into the Payment processing certificate field.

Step 6: Generate a merchant identity certificate
-
Open Keychain Access and navigate to Certificate Assistant > Request a Certificate From a Certificate Authority.
-
Enter:
- Email Address: your email
- Common Name: e.g.,
John Doe MerchantIdentityCertificate
- Leave CA Email Address blank
- Select Saved to disk
-
Save as
CertificateSigningRequestMerchantIdentityCertificate.certSigningRequest
.
Step 7: Retrieve and convert the merchant identity certificate
- Go to the Apple Developer Merchant ID list.
- Select your Merchant ID and click Create Certificate under Apple Pay Merchant Identity Certificate.
- Upload the
CertificateSigningRequestMerchantIdentityCertificate.certSigningRequest
file. - Download the signed certificate as
merchant_id.cer
and save it. - Convert it to PEM:
openssl x509 -inform DER -in merchant_id.cer -out merchant_id.pem
Step 8: Export the merchant identity private key
- In Keychain Access, find the certificate created in step 6, e.g.
John Doe MerchantIdentityCertificate
. - Right-click and export as
JohnDoeMerchantIdentityCertificate.p12
. - Set a strong password.
- Convert the private key to PEM:
openssl pkcs12 -in JohnDoeMerchantIdentityCertificate.p12 -nocerts -nodes | sed -ne '/-BEGIN PRIVATE KEY-/,/-END PRIVATE KEY-/p' > MerchantIdentityCertificatePrivateKey.pem
The private key will be available as MerchantIdentityCertificatePrivateKey.pem
.
Step 9: Upload the merchant identity certificate and key
- Return to your Apple Pay connection in the Yuno Dashboard.
- Copy the contents of
MerchantIdentityCertificatePrivateKey.pem
and paste them into the Merchant Identity key field. - Paste the contents of
merchant_id.pem
into the Merchant Identity certificate field.

Step 10: Register your merchant domains
- Go to Apple Developer Merchant ID list.
- Select your Merchant ID and click Add Domain under Merchant Domains.
- Enter the domain (e.g.,
demo.y.uno
) and click Save.
Note: You must also host Apple’sapple-developer-merchantid-domain-association
file at:https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association
Third-party browser integration (iOS 18+)
Since iOS 18, Apple Pay can be offered in third-party browsers such as Google Chrome.
Key requirements
- Users must have iOS 18 or higher on their iPhone
- Apple Pay works in browsers like Google Chrome, not just Safari
- This expands payment options for customers who prefer alternative browsers
When implementing Apple Pay, ensure your integration supports both Safari and third-party browser flows to maximize payment conversion.
Once all steps are complete, your Apple Pay integration with Yuno is ready. You can now proceed with:
Updated 4 days ago