Troubleshooting

Learn how to fix common issues with the PayPal component.

Common issues

Issue	Description	Next steps
PayPal SDK not loading.	Console shows `PayPal SDK not loaded`.	Check your internet connection. Verify that the PayPal client ID is correct. Ensure that the script is loading from `https://www.paypal.com/sdk/js`.
Button not rendering.	The button doesn't appear in the container.	Verify that the container ID exists in the DOM. Check that the container has proper dimensions. Ensure that the component is properly mounted.
Validation errors.	Receiving validation errors.	Check that all required fields are provided. Verify the email format for `payeeEmailAddress`. Ensure that currency codes are exactly 3 characters. Validate the shipping address when using `SET_PROVIDED_ADDRESS`.
Funding source issues.	Certain funding sources aren't available.	Verify that the funding sources are supported (`paypal`, `venmo`, `paylater`). Check geographic restrictions. For example, Venmo is US-only. Ensure proper configuration for `renderType` in relation to the `fundingSources`.

To get more detailed information about errors, enable the debug mode in your paypalConfig.

queryParams: {
  debug: true
}

Debug mode increases script size and impacts performance. Use only for development.