{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-guides/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["sub-heading","admonition"]},"type":"markdown"},"seo":{"title":"Troubleshooting","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":"troubleshooting","__idx":0},"children":["Troubleshooting"]},{"$$mdtype":"Tag","name":"SubHeading","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Diagnose and fix common Payout Drop-in integration issues."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most production issues fall into four categories:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Session or site configuration:"]}," Wrong service, environment, or funding types (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1700"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Shopper context:"]}," Missing or wrong shopper ID; instruments not loaded."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Instrument eligibility:"]}," No tokens, expired tokens, blacklists, inactive PayPal link."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Submission failures:"]}," Provider or payout API errors (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]},")."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use browser DevTools network tabs to inspect session-scoped SDK calls. Correlate ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionId"]}," with your backend logs. Never log ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hmacKey"]},", inbound API tokens, or full wallet JWTs in client logs."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-diagnostics","__idx":2},"children":["Quick diagnostics"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Start with these checks when Drop-in misbehaves:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import { PayoutDropIn } from '@pxpio/web-components-sdk';\n\nfunction diagnosePayoutDropIn(sessionData: any, config: any) {\n  console.group('Payout Drop-in diagnostics');\n\n  console.log('SDK imported:', typeof PayoutDropIn !== 'undefined');\n\n  const container = document.getElementById('payout-drop-in-container');\n  console.log('Container exists:', !!container);\n  console.log('Container visible:', container ? container.offsetParent !== null : false);\n\n  console.log('Session ID:', sessionData?.sessionId ? 'Present' : 'Missing');\n  console.log('HMAC key:', sessionData?.hmacKey ? 'Present' : 'Missing');\n  console.log('Allowed funding types:', sessionData?.allowedFundingTypes);\n  console.log('Cards field present:', sessionData?.allowedFundingTypes?.cards != null);\n  console.log('Environment:', config?.environment);\n  console.log('Owner ID:', config?.ownerId);\n  console.log('Protocol:', location.protocol);\n\n  console.groupEnd();\n}\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Card requires ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]}," to be present on the session (including an empty array). ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cardSchemes"]}," alone doesn't enable card."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-issues","__idx":3},"children":["Common issues"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"no-payout-methods-are-shown","__idx":4},"children":["No payout methods are shown"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," The container loads (or shows loading then an empty UI), but no withdrawal method appears."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes and fixes:"]},{"$$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":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session doesn't allow card, PayPal, Apple Pay, or Google Pay"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes"]},". For card, ensure ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["cards"]}," is present."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}," missing or returns an empty ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Require authentication and return a real shopper ID so tokens and PayPal can load."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shopper has no eligible stored instruments"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vault plain cards, link PayPal, or store Apple Pay or Google Pay device tokens for the test shopper."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All instruments excluded by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig"]}," blacklists"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Temporarily remove blacklists to isolate filtering."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Token or PayPal lookup failed silently"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Methods can hide without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},". Inspect network calls for active tokens and wallet associations."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Site configuration missing or wrong environment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expect ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1700"]},". Enable Payout Drop-in and match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["test"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["live"]}," to the site."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to identify:"]}]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1700"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Inspect session JSON: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Confirm the shopper ID matches vault records."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call the token vault API from your backend with the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerId"]}," and shopper ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Review PayPal wallet association for an active PayPal recipient."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Temporarily remove blacklists."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/how-it-works"},"children":["How it works"]}," and the method guides: ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/card"},"children":["Card"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/paypal"},"children":["PayPal"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/apple-pay"},"children":["Apple Pay"]},", ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/google-pay"},"children":["Google Pay"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"configuration-not-found--sdk1700-","__idx":5},"children":["Configuration not found (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1700"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," Error mentions failed payout Drop-in configuration retrieval; container may show an error shell."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes and fixes:"]},{"$$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":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payout Drop-in not enabled for the site"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Activate the Payout Drop-in service for the site. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/activation"},"children":["Activation"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wrong environment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Match ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment: 'test'"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["'live'"]}," to the site and credentials."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Invalid or expired ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sessionId"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hmacKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Create a fresh payout session and retry ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network failure calling configurations"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check the network tab for non-2xx on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["api/v1/payout-dropin/configurations"]},"."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"no-payout-methods-for-session--sdk1701-","__idx":6},"children":["No payout methods for session (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," Explicit error that no payout methods are available after mount."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes and fixes:"]},{"$$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":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session allows methods but every method fails instrument resolution"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use the same fixes as ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"#no-payout-methods-are-shown"},"children":["No payout methods are shown"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card allowed but no plain-card tokens"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vault non-device plain-card tokens for the shopper."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wallets allowed but no matching device tokens"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vault Apple Pay or Google Pay tokens with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["panType: Device"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal allowed but association inactive or missing"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Complete linking; confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["activeStatus: Active"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["recipientWallet: Paypal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["All remaining methods blacklisted"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Adjust ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig"]}," blacklists."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]}," as expected when deliberately testing an empty vault."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-paypal-method-is-missing","__idx":7},"children":["The PayPal method is missing"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," PayPal is enabled on the session, but the accordion has no PayPal entry."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes and fixes:"]},{"$$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":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.wallets.paypal"]}," absent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Enable PayPal on the payout session."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No shopper ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Implement ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}," with the authenticated shopper ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Association missing, inactive, or wrong recipient wallet"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Link PayPal for the shopper; confirm ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Active"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Paypal"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig.paypal.blacklistedPayerId"]}," matches the linked payer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Remove or correct the blacklist."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lookup failed"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal is hidden without necessarily calling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},". Retry with a known-good association."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Don't log the raw wallet-association JWT in production. See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/paypal"},"children":["PayPal"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"card-apple-pay-or-google-pay-missing-while-paypal-works","__idx":8},"children":["Card, Apple Pay, or Google Pay missing while PayPal works"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," PayPal renders, but card-on-file methods don't."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes and fixes:"]},{"$$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":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card funding not present on the session"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Include ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["No matching device tokens for Apple Pay or Google Pay"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Vault tokens with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["walletType: ApplePay"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GooglePay"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["panType: Device"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Tokens already expired"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Expired tokens are filtered out of the list. Re-vault a valid instrument. For tokens still in date, shoppers can edit expiry in the list UI where allowed."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Wrong instrument type for the method"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Plain cards appear under card. Device wallet tokens appear under Apple Pay or Google Pay only."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Blacklists hide the only remaining tokens"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Check ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["methodConfig.card"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applePay"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["googlePay"]}," blacklists."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"payout-submission-fails--sdk1703-","__idx":9},"children":["Payout submission fails (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]},")"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," Shopper submits; ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]}," runs instead of ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes and fixes:"]},{"$$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":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Instrument no longer valid at the provider"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask the shopper to choose another method, or re-link or re-vault."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Payout API business rule, such as example limits or destination eligibility"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix eligibility on the server before retrying."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount or currency mismatch vs session"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Align session creation and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Provider temporary outage"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Offer retry after checking backend state."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["How to identify:"]}," Log ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ErrorCode"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["message"]},", and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["details"]},". Search your backend by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionId"]},". Both card-on-file failure and PayPal initiation failure can use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]},": don't branch on the code alone."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Before encouraging another attempt, confirm no successful payout already exists for that ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["merchantTransactionId"]},". See ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/guides/payout/drop-in/web/error-handling"},"children":["Error handling"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"authentication-or-authorisation-failure-on-card-on-file-submit","__idx":10},"children":["Authentication or authorisation failure on card-on-file submit"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," Card, Apple Pay, or Google Pay submit fails with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1114"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1115"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These codes are uncommon on the standard Payout Drop-in path. Payout intent skips the Unity 3-D Secure authentication flow, so shoppers typically won't see them during stored-instrument withdrawals. If they do 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":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Typical meaning"},"children":["Typical meaning"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What to try"},"children":["What to try"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1114"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authentication failed or authentication context was missing."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ask the shopper to retry or choose another method."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1115"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Authorisation evaluation didn't allow the payout to proceed."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Retry later or offer another method; verify backend state first."]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"session-or-initialisation-errors","__idx":11},"children":["Session or initialisation errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["initialize()"]}," throws, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]}," rejects before the UI renders."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Common causes and fixes:"]},{"$$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":"Cause"},"children":["Cause"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Solution"},"children":["Solution"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing required config (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["environment"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["session"]},", transaction data, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onSuccess"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validate the config object before calling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["initialize()"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Missing ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["sessionId"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["hmacKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fix the session payload from your backend (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0103"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK0104"]}," style throws)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]}," rejects"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]}," rejects without calling ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onError"]},": show a login prompt."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Container ID mismatch or element not in the DOM"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ensure the element exists before ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]},"; IDs are case-sensitive."]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Wrap both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["initialize()"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["try"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["catch"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"duplicate-ui-after-navigation","__idx":12},"children":["Duplicate UI after navigation"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Symptoms:"]}," Multiple accordions or repeated handlers after route changes."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Cause:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["create()"]}," called again without ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destroy()"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Solution:"]}," In SPA frameworks, call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["destroy()"]}," in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["useEffect"]}," cleanup or on route leave before remounting."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"debugging-checklist","__idx":13},"children":["Debugging checklist"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Work through these checks before escalating:"]},{"$$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":"Check"},"children":["Check"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Action"},"children":["Action"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["serviceType"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Must be ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayoutDropIn"]}," when creating the session."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Session intents"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Payout"]}," for enabled methods."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Amount and currency"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Match the backend session and frontend ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["transactionData"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Shopper ID"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["From your authenticated session via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["onGetShopper"]},"."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ownerId"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The merchant group ID used for the token vault."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Environment"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["test"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["live"]},", consistent with credentials and site."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Card funding"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allowedFundingTypes.cards"]}," present when Card should appear."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Network"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Configurations, active-tokens, and PayPal wallet-association calls."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Errors"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Look for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1700"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1701"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1703"]},", uncommon ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1114"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SDK1115"]},", and mount exceptions."]}]}]}]}]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"Quick diagnostics","id":"quick-diagnostics","depth":2},{"value":"Common issues","id":"common-issues","depth":2},{"value":"No payout methods are shown","id":"no-payout-methods-are-shown","depth":3},{"value":"Configuration not found ( SDK1700 )","id":"configuration-not-found--sdk1700-","depth":3},{"value":"No payout methods for session ( SDK1701 )","id":"no-payout-methods-for-session--sdk1701-","depth":3},{"value":"The PayPal method is missing","id":"the-paypal-method-is-missing","depth":3},{"value":"Card, Apple Pay, or Google Pay missing while PayPal works","id":"card-apple-pay-or-google-pay-missing-while-paypal-works","depth":3},{"value":"Payout submission fails ( SDK1703 )","id":"payout-submission-fails--sdk1703-","depth":3},{"value":"Authentication or authorisation failure on card-on-file submit","id":"authentication-or-authorisation-failure-on-card-on-file-submit","depth":3},{"value":"Session or initialisation errors","id":"session-or-initialisation-errors","depth":3},{"value":"Duplicate UI after navigation","id":"duplicate-ui-after-navigation","depth":3},{"value":"Debugging checklist","id":"debugging-checklist","depth":2}],"frontmatter":{"seo":{"title":"Troubleshooting"}},"lastModified":"2026-11-11T15:26:26.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/payout/drop-in/web/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}