Handle errors

DocsLimited

Last updated: Aug 26th, 1:52am

When a Pix payment fails, PayPal sends webhook notifications to inform your system of the failure.

  • Listen for webhook events: Monitor the following webhooks for Pix payment failures:
    • PAYMENT.CAPTURE.DENIED: Payment capture failed after buyer approval
    • CHECKOUT.ORDER.DECLINED: Order declined during payment processing
  • Extract failure details: Check the reason for failure in the webhook payload
  • Display appropriate message: Show localized error message to the user
  • Offer next steps: Provide options like generating a new QR code for expired QR codes