{"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","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"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":["Learn how to fix common issues with the PayPal component."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"common-issues","__idx":1},"children":["Common issues"]},{"$$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":"th","attributes":{"data-label":"Next steps"},"children":["Next steps"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PayPal SDK not loading."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Console shows ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PayPal SDK not loaded"]},"."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check your internet connection."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify that the PayPal client ID is correct."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure that the script is loading from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://www.paypal.com/sdk/js"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Button not rendering."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The button doesn't appear in the container."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify that the container ID exists in the DOM."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that the container has proper dimensions."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure that the component is properly mounted."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Validation errors."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Receiving validation errors."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check that all required fields are provided."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify the email format for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["payeeEmailAddress"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure that currency codes are exactly 3 characters."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Validate the shipping address when using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SET_PROVIDED_ADDRESS"]},"."]}]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Funding source issues."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Certain funding sources aren't available."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Verify that the funding sources are supported (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypal"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["venmo"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paylater"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Check geographic restrictions. For example, Venmo is US-only."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Ensure proper configuration for ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["renderType"]}," in relation to the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["fundingSources"]},"."]}]}]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"debug-mode","__idx":2},"children":["Debug mode"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To get more detailed information about errors, enable the debug mode in your ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["paypalConfig"]},"."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"queryParams: {\n  debug: true\n}\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Debug mode increases script size and impacts performance. Use only for development."]}]}]},"headings":[{"value":"Troubleshooting","id":"troubleshooting","depth":1},{"value":"Common issues","id":"common-issues","depth":2},{"value":"Debug mode","id":"debug-mode","depth":2}],"frontmatter":{"seo":{"title":"Troubleshooting"}},"lastModified":"2026-02-26T12:14:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/checkout/components/web/paypal/troubleshooting","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}