{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition"]},"type":"markdown"},"seo":{"title":"Branding and appearance configuration","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":"branding-and-appearance-configuration","__idx":0},"children":["Branding and appearance configuration"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Configure your Drop-in's look and feel in the Unity Portal."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"before-you-start","__idx":1},"children":["Before you start"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Activate the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payout Drop-in service"]}," and enable at least one payout method. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/activation"},"children":["Activation"]}," and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/payout-methods"},"children":["Payout methods"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1-go-to-the-branding--appearance-page","__idx":2},"children":["Step 1: Go to the Branding & appearance page"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Open branding for the site:"]},{"$$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":"em","attributes":{},"children":["Services"]}," tab, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]}," next to ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payout Drop-in service"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Branding & appearance"]},". The page opens."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2-configure-the-design","__idx":3},"children":["Step 2: Configure the design"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Design"]}," section, configure the visual style for the withdrawal accordion:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Font family:"]}," The font to apply to Drop-in text."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Adjust component size:"]}," The scale applied to Drop-in components."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Accent colour:"]}," The colour for interactive elements."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Body text:"]}," The colour for general text."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Container background colour:"]}," The colour for the accordion background."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Button text colour:"]}," The colour for button text."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Button background colour:"]}," The colour for the button background."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shape:"]}," The button shape (for example square or rounded)."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prefer portal branding over custom CSS on the merchant page so method panels stay consistent."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Drop-in loads branding from the payout Drop-in configuration API when it mounts (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GET /api/v1/payout-dropin/configurations"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-3-configure-the-payout-method-ordering","__idx":4},"children":["Step 3: Configure the payout method ordering"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To use this feature, you need to have ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/payout-methods"},"children":["enabled at least one payout method"]},"."]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payment method ordering"]}," section, choose an order mode:",{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Dynamic:"]}," Order methods using the portal's dynamic ordering options when those are enabled for the site."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Manual:"]}," Drag methods into the order shoppers should see."]}]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Save your changes."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When site configuration includes a manual order, Drop-in applies that order to the methods that remain after session and instrument filtering. Otherwise it uses the SDK default order. For the methods covered in these guides, that relative order is card, Apple Pay, Google Pay, then PayPal. Other enabled methods can appear in the default list between or after those entries."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Method order in the portal only affects methods that are enabled and still eligible for the shopper. Hidden or empty methods don't leave gaps you need to handle in frontend code."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-4-save-your-configuration","__idx":5},"children":["Step 4: Save your configuration"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you're done with your changes, click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," in the top right to confirm them. They'll be applied to subsequent Drop-in mounts for that site."]}]},"headings":[{"value":"Branding and appearance configuration","id":"branding-and-appearance-configuration","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Step 1: Go to the Branding & appearance page","id":"step-1-go-to-the-branding--appearance-page","depth":2},{"value":"Step 2: Configure the design","id":"step-2-configure-the-design","depth":2},{"value":"Step 3: Configure the payout method ordering","id":"step-3-configure-the-payout-method-ordering","depth":2},{"value":"Step 4: Save your configuration","id":"step-4-save-your-configuration","depth":2}],"frontmatter":{"seo":{"title":"Branding and appearance configuration"}},"lastModified":"2026-11-11T13:55:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/drop-in/branding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}