{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition"]},"type":"markdown"},"seo":{"title":"Authentication","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":"authentication","__idx":0},"children":["Authentication"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create inbound API credentials in the Unity Portal so your backend can open Payout Sessions."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payout Drop-in uses inbound API credentials on your backend only. The browser never receives the inbound token value. Your backend creates a payout session with HMAC signing, then passes the session response into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropIn.initialize()"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-open-inbound-calls","__idx":2},"children":["Step 1: Open inbound calls"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open inbound credentials like this:"]},{"$$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 a merchant group."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Inbound calls"]}," tab."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Client Id"]}," in the top-right corner."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-create-an-inbound-token","__idx":3},"children":["Step 2: Create an inbound token"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Create and store a token like this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["+ New token"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter an expiration period. For example, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["30"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]},". Your inbound token is created."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Copy both the token ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Id"]}," and ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Value"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store the client identifier and token value as environment variables on your server. Never hardcode them in your application or send them to the browser."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Rotate tokens according to your security policy."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-create-sessions-on-your-backend","__idx":4},"children":["Step 3: Create sessions on your backend"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use those credentials to create a session with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serviceType: \"PayoutDropIn\""]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionMethod.intent"]}," values of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payout"]}," for each method you enable. Sign the request with HMAC SHA256 using your token value."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Full request construction, headers, and examples are in the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/quickstart"},"children":["Web SDK quickstart"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/implementation"},"children":["Implementation"]}," guides."]}]}]},"headings":[{"value":"Authentication","id":"authentication","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Step 1: Open inbound calls","id":"step-1-open-inbound-calls","depth":2},{"value":"Step 2: Create an inbound token","id":"step-2-create-an-inbound-token","depth":2},{"value":"Step 3: Create sessions on your backend","id":"step-3-create-sessions-on-your-backend","depth":2}],"frontmatter":{"seo":{"title":"Authentication"}},"lastModified":"2026-11-11T13:55:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/drop-in/authentication","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}