Prerequisites (Apple Pay)

Documentation Index

Fetch the complete documentation index at: https://docs.y.uno/llms.txt

Use this file to discover all available pages before exploring further.

• Apple Developer prerequisites: Create a merchant ID, generate and convert the required certificates/keys, and verify your merchant domains.
• Yuno Dashboard setup: Add the Apple Pay connection, set up routing, and enable Apple Pay in Checkout Builder.

​

Apple Pay certificate options

• Yuno: This option is for merchants who do not have an Apple Developer account or a mobile app (i.e., they are web-only). In these cases, you must register your domain via the API in order to use Yuno’s certificates. Use the following endpoints to manage your domain registration:
  • Register domain
  • Get domain
  • Delete domain
  • Domain webhooks
• Own: This option is for merchants who have an Apple Developer account and prefer to manage their own private keys. You generate and convert the certificates manually using Keychain Access and OpenSSL (Steps 2–9), then paste the PEM values into the Yuno Dashboard.
• Own — Yuno generates the CSRs: This option is for merchants who have an Apple Developer account but don’t want to generate private keys or run OpenSSL commands. Yuno generates the Certificate Signing Requests for you — you upload them to Apple and return the signed certificates.

​

Step 1: Register a merchant identifier

1. Log in to Apple Developer, go to Certificates, Identifiers & Profiles, then select Register a new identifier.
2. Choose Merchant IDs.
3. Enter a Description (e.g., Apple Pay Integration) and an Identifier in the format merchant.com.y.uno.YourBusinessName.

​

Own certificates (manual)

​

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

​

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

​

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, navigate to Certificate Assistant > Request a Certificate From a Certificate Authority, and enter:

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

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

​

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.

​

Own certificates with Yuno-generated CSRs

​

Step 1: Enter your Apple Merchant ID

​

Step 2: Generate the Payment Processing CSR

​

Step 3: Generate the Merchant Identity CSR

​

Step 4: Upload each .csr to Apple

1. Go to developer.apple.com → Certificates, Identifiers & Profiles.
2. Select your Merchant ID.
3. Under Apple Pay Payment Processing Certificate (first pass) or Apple Pay Merchant Identity Certificate (second pass), click Create Certificate.
4. When prompted, answer No to “Will payments… be processed exclusively in China mainland?”
5. Upload the .csr file when prompted.
6. Download the .cer file Apple gives you.

​

Step 5: Set up the Apple Pay connection

1. In Use certificates, select Own — Yuno generates the CSRs.
2. Pick your Merchant Identifier from the dropdown — pre-populated with the CSRs you generated.
3. Fill in Display Name and Domain Name.
4. Under Payment Processing Certificate → Apple-issued .cer file, click Choose file and select the .cer Apple issued for Payment Processing.
5. Under Merchant Identity Certificate → Apple-issued .cer file, click Choose file and select the .cer Apple issued for Merchant Identity.

​

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.

https://example.com/.well-known/apple-developer-merchantid-domain-association

​

Step 11: Apple Pay Dashboard connection

1. Log in to your Yuno Dashboard.
2. Navigate to the Connections section.
3. Locate and select the Apple Pay option and click Connect.
4. Provide a Name for the connection, select Apple Pay as Payment method, and in the Use certificates dropdown, select the option that matches your setup:
   • Yuno or Own (manual): paste the PEM values you generated in the previous steps.
   • Own — Yuno generates the CSRs: select this option and upload the .cer files issued by Apple as described in the Own certificates with Yuno-generated CSRs section.
5. Click Next, configure set up costs (optional) and accounts in the following two steps.
6. Click Save. Apple Pay will be added to your connections.

​

Step 12: Configure Dashboard routing

1. In the Yuno Dashboard, navigate to the Routing section.
2. Find the Apple Pay connection. If you have not created a route for Apple Pay yet, it will be on the Not published tab.
3. Set up a new route by pressing Setup on your Apple Pay module (or View if the route is published) and then clicking on Create new route. Give the connection a name and click Save.
4. Add conditions to specify how payments should be routed through Apple Pay.
5. Add Apple Pay as the payment processor for this route to ensure that payments meeting the defined conditions are processed through Apple Pay.
6. Publish the route once all configurations are defined.

​

Step 13: Enable Apple Pay in Checkout Builder

1. In the Yuno Dashboard, navigate to the Checkout Builder section.
2. Locate the available Payment methods and enable Apple Pay. Click the three dots next to each method for additional options.
3. Click Publish settings to make Apple Pay available as a payment option for all transactions that meet the defined routing criteria.

​

Next steps

• SDK Integration: one-time and recurring
• Direct integration: one-time and recurring