Handle buyer errors

DocsCurrent

Last updated: Sept 18th, 5:30am

Handle buyer errors to provide a unique buyer experience.

Know before you code

  • These capabilities modify an existing checkout integration.
  • Complete the steps in Get started to get the following sandbox account information from the Developer Dashboard:
    • Your sandbox account login information
    • Your access token
  • These client-side and server-side integration capabilities use the following:

Handle errors

These procedures apply to standard and advanced integrations.

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 page
    4 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 buttons
      3} else {
      4 // show a fallback experience
      5}

      We use cookies to improve your experience on our site. May we use marketing cookies to show you personalized ads? Manage all cookies