{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition"]},"type":"markdown"},"seo":{"title":"Paze 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"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"paze-onboarding","__idx":0},"children":["Paze onboarding"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure Paze in the Unity Portal and connect your merchant account."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If you haven't already, complete ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/android/install"},"children":["Install the Android SDK"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/activate"},"children":["Activation"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You'll also need an existing Paze client ID, provided by Paze."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-ensure-paze-is-enabled-at-the-merchant-group-level","__idx":2},"children":["Step 1: Ensure Paze is enabled at the merchant group level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Paze must be enabled for your merchant group before it can be configured on individual sites."]},{"$$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 > Merchant groups"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Select your merchant group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Services"]}," tab, find ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Paze service"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If Paze isn't listed, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Add service"]}," and select ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Paze"]},"."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-get-your-pxp-api-credentials","__idx":3},"children":["Step 2: Get your PXP API credentials"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Your backend needs API credentials to create checkout sessions with HMAC authentication. If you haven't created a token yet, follow ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/android/install#step-3-get-your-api-credentials"},"children":["Step 3"]}," of the Android SDK installation guide."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Never expose your token value or HMAC credentials in your Android app. Session creation must happen on your backend."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-configure-paze-on-your-site","__idx":4},"children":["Step 3: Configure Paze on your site"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Register your Paze client ID against the site where you'll accept Paze payments."]},{"$$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 the site you want to enable Paze for."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Services"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Find ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Paze service"]}," and switch the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Active"]}," toggle to on. If Paze isn't listed, enable it at the merchant group level first (",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#step-1-ensure-paze-is-enabled-at-the-merchant-group-level"},"children":["Step 1"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},", then ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Paze Account Settings"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Client ID"]}," as provided by Paze."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Optionally, enter a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Profile ID"]}," (if provided by Paze). If you only have a client ID, you can leave this field blank."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," in the top right."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-verify-session-configuration","__idx":5},"children":["Step 4: Verify session configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["After saving your Paze account settings, create a test session from your backend and confirm that Paze is included in the response. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"USD\""]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["amounts.currencyCode"]}," in the session request. Re-create the session after portal changes; sessions created before Paze was enabled won't include wallet settings."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the full Sessions API and HMAC signing flow, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/android/install#step-4-get-the-session-data"},"children":["Step 4"]}," of the Android SDK installation guide."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When Paze is enabled for your site, the sessions API returns Paze wallet settings similar to:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"sessionId\": \"c5f0799b-0839-43ce-abc5-5b462a98f250\",\n  \"hmacKey\": \"904bc42395d4af634e2fd48ee8c2c7f52955a1da97a3aa3d82957ff12980a7bb\",\n  \"encryptionKey\": \"20d175a669ad3f8c195c9c283fc86155\",\n  \"allowedFundingTypes\": {\n    \"wallets\": {\n      \"paze\": {\n        \"clientId\": \"your-paze-client-id\",\n        \"profileId\": \"optional-profile-id\",\n        \"merchantCategoryCode\": \"5812\"\n      }\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantCategoryCode"]}," is present in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.wallets.paze"]}," in your session response. The SDK checks it when calling Paze complete after checkout; if missing, it throws ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1202A"]},". The full session response also includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["data"]}," (required for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SessionConfig"]},") — see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/android/install#step-4-get-the-session-data"},"children":["Step 4"]}," of the Android SDK installation guide."]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.wallets.paze"]}," is missing from the session, the Paze button fails presentment with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1202"]}," when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Content()"]}," is composed."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["session.allowedFundingTypes.wallets.paze.clientId"]}," is missing or empty at presentment, the SDK throws ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1202"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/android/paze/troubleshooting#portal-and-session-setup"},"children":["Portal and session setup"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When initialising the SDK, pass ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.wallets.paze"]}," from this session response into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SessionConfig"]},", set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData.currency"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"USD\""]},", and set ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData.entryType"]}," to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EntryType.Ecom"]},". For SDK initialisation and component integration, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/checkout/components/android/paze/implementation"},"children":["Paze implementation"]},"."]}]},"headings":[{"value":"Paze onboarding","id":"paze-onboarding","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Step 1: Ensure Paze is enabled at the merchant group level","id":"step-1-ensure-paze-is-enabled-at-the-merchant-group-level","depth":2},{"value":"Step 2: Get your PXP API credentials","id":"step-2-get-your-pxp-api-credentials","depth":2},{"value":"Step 3: Configure Paze on your site","id":"step-3-configure-paze-on-your-site","depth":2},{"value":"Step 4: Verify session configuration","id":"step-4-verify-session-configuration","depth":2}],"frontmatter":{"seo":{"title":"Paze onboarding"}},"lastModified":"2026-07-01T15:11:56.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/checkout/components/android/paze/onboarding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}