{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading"]},"type":"markdown"},"seo":{"title":"Compliance","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":"compliance","__idx":0},"children":["Compliance"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Learn about Apple Pay's implementation requirements and suggested best practices for Web applications."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"apple-pay-guidelines","__idx":1},"children":["Apple Pay guidelines"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Apple Pay component follows Apple's official guidelines for Web implementation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"button-design-guidelines","__idx":2},"children":["Button design guidelines"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uses only Apple-approved button styles and types."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Maintains proper button dimensions and aspect ratios."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supports all official button types (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["buy"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pay"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["donate"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["subscribe"]},", etc.)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Adheres to accessibility requirements including screen reader support."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payment-request-compliance","__idx":3},"children":["Payment request compliance"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implements Apple Pay JS API specification correctly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supports all required payment request fields."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validates data according to Apple's requirements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handles all supported payment networks."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"security-requirements","__idx":4},"children":["Security requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enforces HTTPS-only operation (required for Apple Pay JS)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implements proper merchant validation and domain verification."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Uses secure token handling through Apple Pay JS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Follows Apple's encryption standards."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"user-experience-guidelines","__idx":5},"children":["User experience guidelines"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provides clear error messages using web-native patterns."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handles all user interaction scenarios including cancellation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Maintains consistent behaviour across browsers and devices."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensures responsive design across screen sizes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"web-specific-requirements","__idx":6},"children":["Web-specific requirements"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"domain-and-ssl-requirements","__idx":7},"children":["Domain and SSL requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTPS required"]},": All Apple Pay implementations must use HTTPS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain verification"]},": Domain must be registered with Apple Developer Console."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SSL certificate"]},": Valid SSL certificate from recognised authority."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain association file"]},": Host at ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://yourdomain.com/.well-known/apple-developer-merchantid-domain-association"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"browser-compatibility","__idx":8},"children":["Browser compatibility"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Safari"]},": Safari 11.1+ on macOS 10.13.4+, Safari on iOS 11.2+."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device requirements"]},": Touch ID, Face ID, or passcode-enabled device."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Wallet setup"]},": User must have configured payment methods in Wallet app."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"compliance-checklist","__idx":9},"children":["Compliance checklist"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"technical-requirements","__idx":10},"children":["Technical requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTPS required"]},": Site runs on secure HTTPS connection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain verification"]},": Domain registered and verified with Apple Developer Console."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Valid merchant ID"]},": Apple Pay merchant ID properly configured."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Browser compatibility"]},": Tested on Safari and other supported browsers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apple Pay JS integration"]},": Proper ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ApplePaySession"]}," implementation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error handling"]},": Comprehensive error handling for all scenarios."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"security-and-compliance","__idx":11},"children":["Security and compliance"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SSL certificate"]},": Valid SSL certificate from recognised authority."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain association"]},": Apple developer domain association file properly hosted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token handling"]},": Secure handling of Apple Pay payment tokens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Data protection"]},": No storage of sensitive payment information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PCI compliance"]},": Maintains PCI DSS compliance standards."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"user-experience-requirements","__idx":12},"children":["User experience requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Button guidelines"]},": Uses Apple-approved button styles."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Clear messaging"]},": Clear error messages and user guidance."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Graceful fallbacks"]},": Handles Apple Pay unavailability gracefully."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsive design"]},": Works consistently across desktop and mobile."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accessibility"]},": Screen reader and keyboard navigation support."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"testing-and-validation","__idx":13},"children":["Testing and validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Device testing"]},": Tested on actual Apple devices with Apple Pay."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment testing"]},": End-to-end payment testing in sandbox environment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Error testing"]},": All error scenarios tested and handled properly."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Performance"]},": Fast loading and responsive user interface."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"apple-pay-review-process","__idx":14},"children":["Apple Pay review process"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before going live, ensure your implementation:"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"technical-validation","__idx":15},"children":["Technical validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment flows work correctly"]},": Test all payment scenarios including success, failure, and cancellation."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain verification"]},": Ensure domain association file is properly configured and accessible."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Browser compatibility"]},": Test across all supported browsers and devices."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"design-compliance","__idx":16},"children":["Design compliance"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Button appearance"]},": Uses Apple's standard button styles or approved custom implementations."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Payment sheet integration"]},": Seamless integration with Apple Pay JS payment sheet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsive design"]},": Works correctly across desktop, tablet, and mobile devices."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"security-validation","__idx":17},"children":["Security validation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTPS enforcement"]},": All pages with Apple Pay use HTTPS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Domain verification"]},": Domain properly registered with Apple Developer Console."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token processing"]},": Secure server-side processing of Apple Pay tokens."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":18},"children":["Best practices"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"implementation","__idx":19},"children":["Implementation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use Apple's official button styles for consistent user experience."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implement comprehensive error handling with user-friendly messages."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test thoroughly across browsers, devices, and screen sizes."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"security","__idx":20},"children":["Security"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Never log or store sensitive payment information."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate all payment tokens on your secure server."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep SSL certificates up to date."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"monitoring","__idx":21},"children":["Monitoring"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Track payment success and failure rates."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitor domain verification status."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Regularly test payment flows across browsers and devices."]}]}]},"headings":[{"value":"Compliance","id":"compliance","depth":1},{"value":"Apple Pay guidelines","id":"apple-pay-guidelines","depth":2},{"value":"Button design guidelines","id":"button-design-guidelines","depth":3},{"value":"Payment request compliance","id":"payment-request-compliance","depth":3},{"value":"Security requirements","id":"security-requirements","depth":3},{"value":"User experience guidelines","id":"user-experience-guidelines","depth":3},{"value":"Web-specific requirements","id":"web-specific-requirements","depth":2},{"value":"Domain and SSL requirements","id":"domain-and-ssl-requirements","depth":3},{"value":"Browser compatibility","id":"browser-compatibility","depth":3},{"value":"Compliance checklist","id":"compliance-checklist","depth":2},{"value":"Technical requirements","id":"technical-requirements","depth":3},{"value":"Security and compliance","id":"security-and-compliance","depth":3},{"value":"User experience requirements","id":"user-experience-requirements","depth":3},{"value":"Testing and validation","id":"testing-and-validation","depth":3},{"value":"Apple Pay review process","id":"apple-pay-review-process","depth":2},{"value":"Technical validation","id":"technical-validation","depth":3},{"value":"Design compliance","id":"design-compliance","depth":3},{"value":"Security validation","id":"security-validation","depth":3},{"value":"Best practices","id":"best-practices","depth":2},{"value":"Implementation","id":"implementation","depth":3},{"value":"Security","id":"security","depth":3},{"value":"Monitoring","id":"monitoring","depth":3}],"frontmatter":{"seo":{"title":"Compliance"}},"lastModified":"2026-03-24T15:21:03.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/checkout/components/web/apple-pay/compliance","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}