{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition","required"]},"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 Paze implementation requirements and suggested best practices for Web applications."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Paze component follows Paze's digital wallet SDK guidelines for Web implementation. This page outlines key requirements for compliance with Paze branding, security, and data handling standards."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For complete Paze compliance requirements, refer to your Paze merchant agreement and Paze's digital wallet SDK documentation provided during onboarding."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"technical-requirements","__idx":2},"children":["Technical requirements"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"domain-and-ssl","__idx":3},"children":["Domain and SSL"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["HTTPS required:"]}," All Paze implementations must use HTTPS. Localhost is exempt for development."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Valid SSL certificate:"]}," Must have a valid SSL certificate from a recognised authority."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Site URL:"]}," The SDK passes your page URL to Paze during initialisation for merchant verification."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"browser-compatibility","__idx":4},"children":["Browser compatibility"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Chrome:"]}," Chrome 80+ on all platforms."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Safari:"]}," Safari 13.1+ on macOS and iOS."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Firefox:"]}," Firefox 75+ on all platforms."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edge:"]}," Edge 80+ on Windows and macOS."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"currency-and-region","__idx":5},"children":["Currency and region"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["USD only:"]}," Paze currently supports USD transactions exclusively."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["US shoppers:"]}," Identity validation requires US phone numbers in E.164 format."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Card networks:"]}," Visa, Mastercard, and Discover are supported."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paze-account","__idx":6},"children":["Paze account"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID:"]}," Valid Paze client ID configured in the Unity Portal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Profile ID:"]}," Optional profile ID if provided by Paze."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Environment matching:"]}," Use UAT credentials with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment: 'test'"]}," and production credentials with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment: 'live'"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"button-branding-requirements","__idx":7},"children":["Button branding requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The component renders Paze's official ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<paze-button>"]}," web component. Use only the supported style values:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Requirement"},"children":["Requirement"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Equal prominence"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Paze button presented with equal prominence to other payment methods."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approved colours"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only use supported colour values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["white"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["whitewithoutline"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["midnightblack"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pazeblue"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approved shapes"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only use supported shape values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["default"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["rectangle"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pill"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Approved labels"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Only use supported label values: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["checkout"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["check out with"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Donate with"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Native button element"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Do not replace the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<paze-button>"]}," with a custom-styled alternative."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Responsive design"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Button scales appropriately on all devices."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"Required","attributes":{},"children":[]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"security-and-data-handling","__idx":8},"children":["Security and data handling"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"security-requirements","__idx":9},"children":["Security requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Never store raw card numbers, cryptograms, or network tokens in client-side storage."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate all decrypted token data on your secure server before fulfilling orders."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implement proper error handling and logging without exposing sensitive payment data."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep SSL certificates up to date."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use HMAC authentication for all backend API calls."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"data-handling-requirements","__idx":10},"children":["Data handling requirements"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only collect identity data required for presentment (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["emailAddress"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["phoneNumber"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Comply with applicable privacy regulations (CCPA, state privacy laws, etc.)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Handle ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["securedPayload"]}," and decrypted token data only on your backend."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify transaction results on your backend before order fulfilment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Do not log full ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["securedPayload"]}," values or network tokens in production."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"backend-verification","__idx":11},"children":["Backend verification"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Always verify payment results on your backend. Frontend callbacks can be manipulated and should not be the sole basis for order fulfilment."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After a successful payment:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Retrieve the transaction status from the PXP API using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["systemTransactionId"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the amount and currency match your order."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Only then fulfil the order or grant access to digital goods."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"fraud-controls","__idx":12},"children":["Fraud controls"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"address-verification-avs","__idx":13},"children":["Address verification (AVS)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When enabling AVS (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["performAVS: true"]},"):"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["billingPreference: \"ALL\""]}," so Paze returns a billing address."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AVS data is included automatically in the transaction request from the decrypted payload."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["AVS results should inform — not replace — your broader fraud strategy."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"kount-risk-screening","__idx":14},"children":["Kount risk screening"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pass device and session data through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPreAuthorisation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["kountDisabled: true"]}," on SDK initialisation only if your fraud strategy doesn't require Kount."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review Kount screening results before fulfilling high-value orders."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"best-practices","__idx":15},"children":["Best practices"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"implementation","__idx":16},"children":["Implementation"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use the official ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<paze-button>"]}," element with approved colour, shape, and label values."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Present the Paze button with equal prominence to other payment methods."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Choose ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["static"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["dynamic"]}," presentment based on whether you can supply shopper identity at render time."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Implement comprehensive error handling with clear, user-friendly messages."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Test thoroughly in UAT before switching to live credentials."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"security","__idx":17},"children":["Security"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Never log or store raw card numbers, cryptograms, or network tokens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate decrypted token data and verify transaction results on your backend before order fulfilment."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Keep SSL certificates up to date."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"monitoring","__idx":18},"children":["Monitoring"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Track payment success and failure rates using ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/web/paze/analytics"},"children":["analytics events"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Monitor button visibility with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onPresentmentResolved"]}," in dynamic presentment mode."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Regularly test payment flows across supported browsers and devices."]}]}]},"headings":[{"value":"Compliance","id":"compliance","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Technical requirements","id":"technical-requirements","depth":2},{"value":"Domain and SSL","id":"domain-and-ssl","depth":3},{"value":"Browser compatibility","id":"browser-compatibility","depth":3},{"value":"Currency and region","id":"currency-and-region","depth":3},{"value":"Paze account","id":"paze-account","depth":3},{"value":"Button branding requirements","id":"button-branding-requirements","depth":2},{"value":"Security and data handling","id":"security-and-data-handling","depth":2},{"value":"Security requirements","id":"security-requirements","depth":3},{"value":"Data handling requirements","id":"data-handling-requirements","depth":3},{"value":"Backend verification","id":"backend-verification","depth":3},{"value":"Fraud controls","id":"fraud-controls","depth":2},{"value":"Address verification (AVS)","id":"address-verification-avs","depth":3},{"value":"Kount risk screening","id":"kount-risk-screening","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-06-22T13:33:11.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/checkout/components/web/paze/compliance","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}