{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","tabs","tab","icon","admonition"]},"type":"markdown"},"seo":{"title":"Apple Pay onboarding","description":"Transform your commerce with PXP's unified platform—seamless payments, real-time insights, and global growth in one powerful integration.","lang":"en-UK","siteUrl":"https://developer.pxp.io","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"apple-pay-onboarding","__idx":0},"children":["Apple Pay onboarding"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Set up your merchant ID and certificates, so you can start accepting Apple Pay."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can use either:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your Apple developer account, if you already have an account and want to manage your own certificates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["PXP's account, if you don't have an Apple Developer account and/or don't want to manage certificates yourself."]}]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"div","attributes":{"label":"Use PXP's Apple Pay account","disable":false},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant setup > Sites"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a site."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Services"]}," tab, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," next to ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Apple Pay service"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register account"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use PXP's Apple Pay Account"]},", then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register ID"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"Icon","attributes":{"name":"download","size":"1em","color":"currentColor"},"children":[]}," Domain verification file"]}," and save the file locally."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload the file to your domain, at the following path: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://{your-domain}/.well-known/apple-developer-merchantid-domain-association"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Back in the Unity Portal, enter your domain name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register domain"]}," to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Once your domain is verified, your list of domains is updated and your Apple Pay setup with PXP is complete."]}]},{"$$mdtype":"Tag","name":"div","attributes":{"label":"Use your developer account","disable":false},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-1-create-a-merchant-account-and-merchant-id","__idx":1},"children":["Step 1: Create a merchant account and merchant ID"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Log in to your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.apple.com/account/","target":"_blank"},"children":["Apple Developer Account"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificates, Identifiers & Profiles"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Identifiers"]},", then click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," button."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Merchant IDs"]}," as the identifier type, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter a description and a merchant ID in the format: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchant.com.mycompany.mystore"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]}," then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register"]}," to confirm."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your list of identifiers is updated to include your new merchant ID. Copy this to your clipboard."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-2-download-the-csr-from-the-unity-portal","__idx":2},"children":["Step 2: Download the CSR from the Unity Portal"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Merchant setup > Sites"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select a site."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Services"]}," tab, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," next to ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Apple Pay service"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register account"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use my Apple Developer Account"]},", then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Provider authorisation settings"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your Apple merchant ID and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Register ID"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download CSR file"]}," and save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".csr"]}," file locally."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-3-create-a-mechant-identity-certificate-pem","__idx":3},"children":["Step 3: Create a mechant identity certificate (.PEM)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.apple.com/account/","target":"_blank"},"children":["Apple Developer Account"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificates, Identifiers & Profiles"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificates"]},", then click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," button."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Apple Pay Merchant Identity Certificate"]},", then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select the merchant ID you created earlier, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload the CSR file you downloaded from the Unity Portal, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},". Your certificate is generated"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Download"]}," and save the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cer"]}," file locally."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Convert it to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".p12"]}," format:",{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Double-click on the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cer"]}," file to open it in Keychain Assistant."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Right-click to export."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save this ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".p12"]}," file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Skip the password."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your system password to authenticate and complete the export processing."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Export your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".p12"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".pem"]}," via openSSL command:",{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"% openssl pkcs12 -in <filename>.p12 -out <filename>.pem -nodes  \n"},"children":[]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", upload this file under ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Merchant identity certificate (.PEM)"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"step-4-create-a-payment-processing-certificate-cer","__idx":4},"children":["Step 4: Create a payment processing certificate (.CER)"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://developer.apple.com/account/","target":"_blank"},"children":["Apple Developer Account"]},", go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificates, Identifiers & Profiles"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Go to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Certificates"]},", then click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+"]}," button."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Under Apple Pay, choose ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payment Processing Certificate"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your Merchant ID, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Upload the same CSR file from the Unity Portal, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Continue"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Download the generated ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":[".cer"]}," file."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://portal.pxp.io","target":"_blank"},"children":["Unity Portal"]},", upload this file under ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payment processing certificate (.CER)"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After both certificates are uploaded, your Apple Pay setup with PXP is complete."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Any future merchant ID changes require re-uploading new certificates."]}]}]}]}]},"headings":[{"value":"Apple Pay onboarding","id":"apple-pay-onboarding","depth":1},{"value":"Step 1: Create a merchant account and merchant ID","id":"step-1-create-a-merchant-account-and-merchant-id","depth":3},{"value":"Step 2: Download the CSR from the Unity Portal","id":"step-2-download-the-csr-from-the-unity-portal","depth":3},{"value":"Step 3: Create a mechant identity certificate (.PEM)","id":"step-3-create-a-mechant-identity-certificate-pem","depth":3},{"value":"Step 4: Create a payment processing certificate (.CER)","id":"step-4-create-a-payment-processing-certificate-cer","depth":3}],"frontmatter":{"seo":{"title":"Apple Pay onboarding"}},"lastModified":"2026-06-09T12:45:02.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/checkout/components/ios/apple-pay/onboarding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}