Handle payment errors
DocsLimited
Last updated: Oct 24th, 2:31am
When a Zip payment fails, PayPal sends webhook notifications to inform your system of the failure.
- Listen for webhook events: Monitor the following webhooks for Zip payment failures:
PAYMENT.CAPTURE.DENIED: Payment capture failed after buyer approvalCHECKOUT.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 such as selecting a different payment method or retrying with Zip
Note: Zip sessions have different timeout periods by market. In the US, sessions expire after 10 minutes. In Australia, sessions have an extended timeout of 168 hours (7 days). If the buyer doesn't complete the payment within these windows, they'll be redirected to your cancel_url.