{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","platform-tabs","platform-tab","tabs","tab","admonition"]},"type":"markdown"},"seo":{"title":"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":"onboarding","__idx":0},"children":["Onboarding"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Prepare payout method accounts and returning shoppers before you mount Drop-in."]}]},{"$$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, make sure that you have activated the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payout Drop-in"]}," service and any relevant payout method services in the Unity Portal. For more information, see our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/activation"},"children":["Activation"]}," guide."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Payout Drop-in shows only methods the session allows and for which the shopper already has an eligible stored instrument (or linked PayPal account). It doesn't collect a new card Primary Account Number (PAN) for first-time vaulting on the withdrawal page."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"complete-the-onboarding-process","__idx":2},"children":["Complete the onboarding process"]},{"$$mdtype":"Tag","name":"PlatformTabs","attributes":{},"children":[{"$$mdtype":"Tag","name":"PlatformTab","attributes":{"icon":"credit-card","iconType":"solid","label":"Card"},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"card","__idx":3},"children":["Card"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card in Drop-in uses vaulted plain-card tokens for the authenticated shopper."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Activate the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Card service"]}," and ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payout Drop-in service"]}," for the site. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/activation"},"children":["Activation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable card under Payout Drop-in in the payout method configuration. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/payout-methods"},"children":["Payout methods"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Store eligible plain-card tokens for returning shoppers through your programme's pay-in or tokenisation flows before they reach withdrawal."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pass the merchant group ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerId"]}," and a shopper ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}," so Drop-in can load active tokens."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card appears only when the payout session includes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]}," (including an empty array). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSchemes"]}," alone doesn't enable card. Device wallet tokens (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walletType"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ApplePay"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GooglePay"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["panType"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Device"]},") appear under Apple Pay or Google Pay instead."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Token Vault concepts, see our ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/token-vault/how-it-works"},"children":["Token Vault"]}," guide. For Drop-in card behaviour, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/card"},"children":["Card"]},"."]}]},{"$$mdtype":"Tag","name":"PlatformTab","attributes":{"icon":"paypal","iconType":"brands","label":"PayPal"},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paypal","__idx":4},"children":["PayPal"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connect your PayPal Business account so Drop-in can pay out to linked shopper accounts, then ensure each shopper has an active wallet association."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"connect-your-paypal-business-account","__idx":5},"children":["Connect your PayPal Business account"]},{"$$mdtype":"Tag","name":"Tabs","attributes":{"size":"medium"},"children":[{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Log in with an existing account","disable":false},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"target":"_blank","href":"https://portal.pxp.io/"},"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":"strong","attributes":{},"children":["Services"]}," tab, find the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["PayPal service"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PayPal account"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect PayPal account"]},". A PayPal pop-up opens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your credentials, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Next"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Agree and Continue"]},". A confirmation message is displayed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Return to PXP"]}," to go back to the Unity Portal."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your connection is successful, a success message is displayed and your connection details are visible."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your connection is unsuccessful, a warning is displayed. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#troubleshooting"},"children":["troubleshooting"]}," section below for more information."]}]},{"$$mdtype":"Tag","name":"TabItemFragment","attributes":{"label":"Create a new account","disable":false},"children":[{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["In the ",{"$$mdtype":"Tag","name":"a","attributes":{"target":"_blank","href":"https://portal.pxp.io"},"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":"strong","attributes":{},"children":["Services"]}," tab, find the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["PayPal service"]}," and click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Edit"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PayPal account"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Connect PayPal account"]},". A PayPal pop-up opens."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create An Account"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enter your legal name, email address, and a password, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Create Account"]}," to confirm."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Add your business and personal information, then click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submit"]},". A confirmation message is displayed."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Return to PXP"]}," to go back to the Unity Portal."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your connection is successful, a success message is displayed and your connection details are visible."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If your connection is unsuccessful, a warning is displayed. See the ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#troubleshooting"},"children":["troubleshooting"]}," section below for more information."]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":4,"id":"prepare-linked-shoppers","__idx":6},"children":["Prepare linked shoppers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The stored PayPal panel needs an active PayPal wallet association for the shopper (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activeStatus: Active"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientWallet: Paypal"]},"), established through your programme's PayPal linking flow."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you test:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prepare a test shopper that already has an active association."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Create a Payout Session with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.wallets.paypal"]}," enabled and PayPal intent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payout"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the PayPal accordion shows the linked email and submit reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," or a clear payout error."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Drop-in PayPal behaviour, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/paypal"},"children":["PayPal"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"troubleshooting","__idx":7},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["If there are any issues with the connection to your PayPal account, then a warning is displayed at the top of the screen."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These connection warnings can appear:"]},{"$$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":"Issue"},"children":["Issue"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Primary email confirmed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This error indicates that you haven't confirmed your primary email address on the PayPal website. To fix it, go to your ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"https://paypal.com/businessprofile/settings","target":"_blank"},"children":["PayPal settings"]},". Once you've confirmed your email address, refresh the Unity Portal to view your updated onboarding status."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payouts receivable"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["This error indicates that your PayPal account isn't eligible to send payouts yet. For example, due to missing compliance checks or country restrictions. To fix it, follow the steps in the PayPal message or contact PayPal customer support."]}]}]}]}]}]},{"$$mdtype":"Tag","name":"PlatformTab","attributes":{"icon":"apple-pay","iconType":"brands","label":"Apple Pay"},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"apple-pay","__idx":8},"children":["Apple Pay"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Apple Pay in Drop-in uses vaulted Apple Pay device tokens for the authenticated shopper (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walletType: ApplePay"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["panType: Device"]},")."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Activate the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Apple Pay service"]}," and ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payout Drop-in service"]}," for the site. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/activation"},"children":["Activation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable Apple Pay under Payout Drop-in in the payout method configuration. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/payout-methods"},"children":["Payout methods"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete Apple Pay merchant setup for your programme so device tokens can be vaulted through your supported pay-in or wallet onboarding flow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pass the merchant group ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerId"]}," and a shopper ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}," so Drop-in can load matching device tokens."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you test, use a shopper that already has a non-expired Apple Pay device token in the environment you target (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["test"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["live"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Drop-in Apple Pay behaviour, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/apple-pay"},"children":["Apple Pay"]},"."]}]},{"$$mdtype":"Tag","name":"PlatformTab","attributes":{"icon":"google-pay","iconType":"brands","label":"Google Pay"},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"google-pay","__idx":9},"children":["Google Pay"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Google Pay in Drop-in uses vaulted Google Pay device tokens for the authenticated shopper (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walletType: GooglePay"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["panType: Device"]},")."]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Activate the ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Google Pay service"]}," and ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["Payout Drop-in service"]}," for the site. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/activation"},"children":["Activation"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Enable Google Pay under Payout Drop-in in the payout method configuration. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/payout-methods"},"children":["Payout methods"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Complete Google Pay merchant setup for your programme so device tokens can be vaulted through your supported pay-in or wallet onboarding flow."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Pass the merchant group ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerId"]}," and a shopper ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}," so Drop-in can load matching device tokens."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When you test, use a shopper that already has a non-expired Google Pay device token in the environment you target (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["test"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["live"]},")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Drop-in Google Pay behaviour, see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/google-pay"},"children":["Google Pay"]},"."]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"Session and filtering still apply"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A method allowed on the payout session isn't enough. Drop-in also needs an eligible instrument after expiry, wallet-type, and blacklist filtering. Plan an empty-state test where the shopper has no eligible instruments to confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]}," handling. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/how-it-works"},"children":["How it works"]},"."]}]}]},"headings":[{"value":"Onboarding","id":"onboarding","depth":1},{"value":"Before you start","id":"before-you-start","depth":2},{"value":"Complete the onboarding process","id":"complete-the-onboarding-process","depth":2},{"value":"Card","id":"card","depth":3},{"value":"PayPal","id":"paypal","depth":3},{"value":"Connect your PayPal Business account","id":"connect-your-paypal-business-account","depth":4},{"value":"Prepare linked shoppers","id":"prepare-linked-shoppers","depth":4},{"value":"Troubleshooting","id":"troubleshooting","depth":3},{"value":"Apple Pay","id":"apple-pay","depth":3},{"value":"Google Pay","id":"google-pay","depth":3}],"frontmatter":{"seo":{"title":"Onboarding"}},"lastModified":"2026-11-11T13:55:54.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/drop-in/onboarding","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}