How does Orb handle failed automatic payments?

Last updated: August 28, 2024

When an automatic payment fails in Orb, the system takes several actions to manage the situation and keep you informed:

Automatic Retry Schedule

Orb automatically retries failed payments according to a predetermined schedule. This helps to recover payments that may have failed due to temporary issues, such as insufficient funds or temporary card declines.

Webhook Notifications

For each payment attempt and failure, Orb sends an invoice.payment_failed webhook. This allows you to:

  • Receive real-time notifications about payment failures

  • Integrate these events into your own systems for monitoring or custom actions

Accessing Webhook Information

To learn more about the invoice.payment_failed webhook and how to use it, visit the Orb Webhooks documentation.

Best Practices

To make the most of this feature:

  • Set up a webhook endpoint in your system to receive these notifications

  • Implement logic to handle failed payment notifications, such as alerting your finance team or triggering customer communication

  • Regularly review your webhook integration to ensure it's functioning correctly

By leveraging these automatic retries and webhook notifications, you can stay on top of payment issues and take timely action to resolve them.