Handle buyer checkout errors
Last updated: Mar 2nd, 1:37am
Use onError
callbacks and alternate checkout pages to handle buyer checkout errors.
Know before you code
Complete a standard checkout integration
Integrate PayPal standard checkout before configuring buyer checkout errors.
Modify your checkout integration
- PayPal JavaScript SDK
- Orders REST API — Create order endpoint
Explore PayPal APIs with Postman
You can use Postman to explore and test PayPal APIs. Learn more in our Postman guide.
Buyer checkout error
If an error prevents buyer checkout, alert the user that an error has occurred with the buttons using the onError
callback.
1paypal.Buttons({2 onError: function(err) {3 // For example, redirect to a specific error page4 window.location.href = "/your-error-page-here";5 }6}).render('#paypal-button-container');
This error handler is a catch-all. Errors at this point are not expected to be handled beyond showing a generic error message or page.
Script not loading error
If null pointer errors prevent the script from loading, provide a different checkout experience.
1if (window.paypal && window.paypal.Buttons) {2 // render the buttons3} else {4 // show a fallback experience5}