Handle buyer errors

Handle payer errors to provide a unique payer experience.

Know before you code

Buyer checkout error

If an error prevents buyer checkout, alert the user that an error has occurred with the buttons using the onError callback:

paypal
  .Buttons({
    onError: function (err) {
      // For example, redirect to a specific error page
      window.location.href = "/your-error-page-here";
    },
  })
  .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:

if (window.paypal && window.paypal.Buttons) {
  // render the buttons
} else {
  // show a fallback experience
}