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:

1. Log in to Apple Developer.
2. Go to Certificates, Identifiers & Profiles, then select Register a new identifier.
3. Choose Merchant IDs and click Continue.

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

5. Click Continue and follow the steps to register.

Step 2: Generate a payment processing certificate

1. Create a new directory (e.g., Downloads/ApplePayFiles) to store the certificate files.
2. Open Keychain Access on your Mac.
3. Go to Keychain Access > Certificate Assistant > Request a Certificate From a Certificate Authority.

4. 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

5. Click Continue, then save the file as CertificateSigningRequestPaymentProcessingCertificate.certSigningRequest in your working directory.

6. When prompted for key pair settings, use:

   • Key Type: Elliptic Curve (EC)
   • Key Size: 256-bit
   • Algorithm: ECDSA

7. Click Continue to generate the CSR.

Step 3: Retrieve and convert the payment processing certificate

1. Go to the Apple Developer Merchant ID list.
2. Select your Merchant ID and click Create Certificate under Apple Pay Payment Processing Certificate.

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

6. Convert the certificate to PEM format:

openssl x509 -inform DER -in apple_pay.cer -out apple_pay.pem

Step 4: Export the private key

1. In Keychain Access, find the key you created (e.g., John Doe ProcessingCertificate).
2. Right-click and choose Export.
3. Export the key as a .p12 file (e.g., JohnDoeProcessingCertificate.p12) and save it to your working directory.
4. Set a strong password (you’ll use it in the next step).
5. 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

1. Open the Yuno Dashboard > Connections > Apple Pay > Connect
2. Enter the contents of ProcessingCertificatePrivateKey.pem to the Payment processing key field.
3. Enter the contents of apple_pay.pem into the Payment processing certificate field.

Step 6: Generate a merchant identity certificate

1. Open Keychain Access and navigate to Certificate Assistant > Request a Certificate From a Certificate Authority.

2. Enter:

   • Email Address: your email
   • Common Name: e.g., John Doe MerchantIdentityCertificate
   • Leave CA Email Address blank
   • Select Saved to disk

3. Save as CertificateSigningRequestMerchantIdentityCertificate.certSigningRequest.

Step 7: Retrieve and convert the merchant identity certificate

1. Go to the Apple Developer Merchant ID list.
2. Select your Merchant ID and click Create Certificate under Apple Pay Merchant Identity Certificate.
3. Upload the CertificateSigningRequestMerchantIdentityCertificate.certSigningRequest file.
4. Download the signed certificate as merchant_id.cer and save it.
5. Convert it to PEM:

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

Step 8: Export the merchant identity private key

1. In Keychain Access, find the certificate created in step 6, e.g. John Doe MerchantIdentityCertificate.
2. Right-click and export as JohnDoeMerchantIdentityCertificate.p12.
3. Set a strong password.
4. 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

1. Return to your Apple Pay connection in the Yuno Dashboard.
2. Copy the contents of MerchantIdentityCertificatePrivateKey.pem and paste them into the Merchant Identity key field.
3. Paste the contents of merchant_id.pem into the Merchant Identity certificate field.

Step 10: Register your merchant domains

1. Go to Apple Developer Merchant ID list.
2. Select your Merchant ID and click Add Domain under Merchant Domains.
3. Enter the domain (e.g., demo.y.uno) and click Save.

⚠️

Note: You must also host Apple’s apple-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:

• SDK Integration
• Direct Integration