{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","endpoint","json-example"]},"type":"markdown"},"seo":{"title":"PayPal","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":["openapi"],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"paypal","__idx":0},"children":["PayPal"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Withdraw funds to a linked PayPal account using a stored wallet association."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal in Payout Drop-in is a stored-account flow. When the payout session allows PayPal and the authenticated shopper has an active PayPal wallet association, Drop-in shows the linked email and submits the payout to the linked payer ID. The panel uses that linked association; it doesn't run a PayPal login or OAuth popup."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"key-benefits","__idx":2},"children":["Key benefits"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This method gives you:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Stored relationship:"]}," Uses a PayPal account already linked for the shopper."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Simple panel UX:"]}," Shows the linked email (with optional mask toggle) and a submit control."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unified outcomes:"]}," Uses Drop-in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["SDK-driven submit:"]}," The stored panel approves and submits without an extra merchant confirmation step in the UI."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Branding:"]}," Panel styling comes from your payout site configuration."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-works","__idx":3},"children":["How it works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The flow works like this:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Your payout session allows PayPal under ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.wallets.paypal"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["You return a shopper ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Drop-in looks up the PayPal wallet association for that shopper."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The association must be active and for the PayPal recipient wallet."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If eligible, PayPal appears in the accordion with the linked email and a submit control."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["The shopper submits; payout initiation completes with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This panel doesn't call Drop-in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBeforeSubmit"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmit"]},". There is no Drop-in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onCancel"]}," for the PayPal stored panel. Drive loading and outcome UI from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},". If every method is filtered out, Drop-in reports ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"session-requirements","__idx":4},"children":["Session requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal must be allowed on the payout session through ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.wallets.paypal"]},". The SDK treats PayPal as eligible for lookup when the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypal"]}," object is present. Values such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantId"]}," may appear on that object when PayPal is enabled for the site; this panel uses the linked wallet association only."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example session fragment:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n  \"allowedFundingTypes\": {\n    \"wallets\": {\n      \"paypal\": {}\n    }\n  }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData.amount"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData.currency"]}," to the payout session amounts. Create the session with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serviceType: \"PayoutDropIn\""]}," and PayPal intent ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payout"]}," on your backend (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/implementation"},"children":["Implementation"]},")."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"shopper-and-account-requirements","__idx":5},"children":["Shopper and account requirements"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PayPal appears only when these shopper and account checks pass:"]},{"$$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":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The authenticated shopper ID used for wallet association lookup. Without it, PayPal can't resolve a linked account."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Active association"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The lookup must return ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activeStatus"]}," of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Recipient wallet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The association ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientWallet"]}," must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blacklist"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal is hidden when ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig.paypal.blacklistedPayerId"]}," matches the linked ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payerId"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Association lookup uses:"]},{"$$mdtype":"Tag","name":"Endpoint","attributes":{"method":"GET"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["/v1/paypal/wallet-associations/{shopperId}?walletType=Paypal"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The response body is a compact JWT string. The SDK decodes the payload client-side. PayPal appears only when the association is active for the PayPal recipient wallet and the linked ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payerId"]}," isn't blacklisted."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The SDK uses a successful association response to show the linked email and submit to the stored payer ID. Lookup failures or inactive associations hide PayPal without necessarily calling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Showing PayPal in Drop-in doesn't authorise the payout. Confirm amount, destination, and eligibility on your backend before treating the withdrawal as complete."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"configuration","__idx":6},"children":["Configuration"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"blacklist-a-linked-payer","__idx":7},"children":["Blacklist a linked payer"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["blacklistedPayerId"]}," to hide PayPal when the linked payer matches:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import type { PayoutDropInMethodConfig } from '@pxpio/web-components-sdk';\n\nconst methodConfig: PayoutDropInMethodConfig = {\n  paypal: {\n    blacklistedPayerId: '<PAYPAL_PAYER_ID>',\n  },\n};\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When the linked account's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payerId"]}," matches, PayPal is treated as unavailable. Blacklisting hides the method in the accordion. When closed-loop enforcement is active, the same blacklist value is also sent on the closed-loop allocation request. Confirm payout eligibility on your backend."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"localisation","__idx":8},"children":["Localisation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Override the accordion label:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"localisation: {\n  payoutDropIn: {\n    paypalLabel: 'PayPal',\n  },\n},\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"paypalconfig","__idx":9},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalConfig"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Drop-in merges linked account data into ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalConfig.payoutConfig"]},":"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalWallet.email"]},": Shown on the receiver field and sent as the payout receiver email."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalWallet.payerId"]},": Submitted as the payout receiver."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["proceedPayoutWithSdk: true"]},": SDK-driven submit for the stored panel."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["You can pass additional ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalConfig"]}," where the shared Web SDK config supports it. The stored panel overlays wallet details from the association response."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"stored-panel-receiver-data","__idx":10},"children":["Stored panel receiver data"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For the stored-account panel, Drop-in overlays association data into the payout path:"]},{"$$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":"Value"},"children":["Value"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Use"},"children":["Use"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Linked email"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The linked email shown on the receiver field and sent as the payout receiver email."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Linked payer ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The linked payer ID submitted as the payout receiver."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"implementation","__idx":11},"children":["Implementation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The following example initialises Drop-in for a PayPal payout. Drive loading UI from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},", because ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onBeforeSubmit"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSubmit"]}," aren't called for this panel:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import {\n  PayoutDropIn,\n  type PayoutDropInSubmitResult,\n} from '@pxpio/web-components-sdk';\nimport type { BaseSdkException } from '@pxpio/web-components-sdk';\n\nconst payoutDropIn = PayoutDropIn.initialize({\n  environment: 'test',\n  session: sessionData,\n  ownerId: 'YOUR-MERCHANT-GROUP-ID',\n  transactionData: {\n    currency: 'USD',\n    amount: 75,\n    entryType: 'Ecom',\n    merchantTransactionId: crypto.randomUUID(),\n    merchantTransactionDate: () => new Date().toISOString(),\n  },\n  onGetShopper: async () => ({ id: 'shopper-with-linked-paypal' }),\n  onSuccess: async (result: PayoutDropInSubmitResult) => {\n    showLoading(false);\n    console.log('PayPal payout submitted', result.systemTransactionId);\n    console.log('Payout method', result.payoutMethod);\n    await verifyPayoutOnBackend(result);\n  },\n  onError: (error: BaseSdkException) => {\n    showLoading(false);\n    console.error(error.ErrorCode, error.message);\n  },\n});\n\nawait payoutDropIn.create('payout-drop-in-container');\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"success-and-verification","__idx":12},"children":["Success and verification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On success, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," receives a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropInSubmitResult"]}," with at least:"]},{"$$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":"Property"},"children":["Property"]},{"$$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":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["systemTransactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The PXP system transaction ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Your merchant transaction ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payoutMethod"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The payment method used. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]}," in this instance."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," as submission acknowledgement. Verify the transaction with your webhook handler or a server-side lookup before updating the shopper's withdrawal status."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A successful PayPal payout merchant webhook looks like this:"]},{"$$mdtype":"Tag","name":"JsonExample","attributes":{"json":{"eventDate":"2025-12-16T07:37:11.1613200Z","eventCategory":"transaction","eventData":{"state":"Authorised","amount":{"transaction":100,"currencyCode":"USD"},"transactionMethod":"Payout","merchant":"merchant-1","site":"site-1","merchantTransactionDate":"2025-12-16T07:37:11.1613200Z","merchantTransactionId":"PAYOUT_001","systemTransactionId":"787ebfee-c0ce-497a-82c3-265d1bf19b0c","providerTransactionId":"PAYPAL_PAYOUT_ITEM_ID","fundingData":{"paypal":{"paymentSource":"Paypal"}}}},"errors":[]},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/quickstart"},"children":["Quickstart"]}," for the end-to-end session and reconciliation pattern, and ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/get-started/manage-webhooks"},"children":["Manage webhooks"]}," for subscription and signature validation."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"error-handling","__idx":13},"children":["Error handling"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These codes are the ones you're most likely to see on the PayPal path:"]},{"$$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":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Typical PayPal context"},"children":["Typical PayPal context"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No payout methods remain. For example, PayPal was the only candidate and the association was missing, inactive, or blacklisted."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal payout initiation failed (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutInitiationFailedException"]},"). Inspect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]},"; correlate with backend transaction state."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," handling for PayPal submission failures:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"onError: (error: BaseSdkException) => {\n  if (error.ErrorCode === 'SDK1703') {\n    showMessage(\n      'PayPal could not complete this withdrawal. Please try again or choose another method.'\n    );\n    return;\n  }\n\n  showMessage(\n    'We could not complete your withdrawal. Please try again or contact support.'\n  );\n},\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/error-handling"},"children":["Error handling"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"testing","__idx":14},"children":["Testing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validate the path with these steps:"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment: 'test'"]}," with sandbox credentials."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prepare a test shopper that already has an active PayPal wallet association (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientWallet: Paypal"]},") using your programme's linking and sandbox procedures."]},{"$$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 appears, the linked email renders, and submit reaches ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]}," or a clear ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the transaction on your backend before treating the withdrawal as complete."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/testing"},"children":["Testing"]},"."]}]},"headings":[{"value":"PayPal","id":"paypal","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Key benefits","id":"key-benefits","depth":3},{"value":"How it works","id":"how-it-works","depth":2},{"value":"Session requirements","id":"session-requirements","depth":2},{"value":"Shopper and account requirements","id":"shopper-and-account-requirements","depth":2},{"value":"Configuration","id":"configuration","depth":2},{"value":"Blacklist a linked payer","id":"blacklist-a-linked-payer","depth":3},{"value":"Localisation","id":"localisation","depth":3},{"value":"paypalConfig","id":"paypalconfig","depth":3},{"value":"Stored panel receiver data","id":"stored-panel-receiver-data","depth":3},{"value":"Implementation","id":"implementation","depth":2},{"value":"Success and verification","id":"success-and-verification","depth":2},{"value":"Error handling","id":"error-handling","depth":2},{"value":"Testing","id":"testing","depth":2}],"frontmatter":{"seo":{"title":"PayPal"}},"lastModified":"2026-11-12T15:20:37.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/drop-in/web/paypal","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}