Troubleshooting

Learn how to fix common issues with 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.

Debug mode

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.