Handling Failed Subscription Payments
Learn how HL Hunt handles failed subscription payments and retries charges on your behalf.
First Payment for a Subscription
When a Subscription is created, HL Hunt creates a first_charge_at field that tells you when the first payment will be attempted. This is based on whether the Subscription has a trial phase and when the start date of the Subscription is.
You can view the First Payment date in the Dashboard on the Subscriptions List Page for easy reference.
When HL Hunt attempts to debit the payment instrument associated with the Subscription, a Transfer resource will be created. The Transfer resource contains information about the state, payment instrument, and more.
Once a Subscription is created, you can view all its associated payments from the subscription details page in the Dashboard.
Subscription Payment Re-attempts (Dunning)
If the initial payment fails, HL Hunt will automatically retry the payment according to the following dunning schedule:
| Attempt | Timing |
|---|---|
| 1st retry | 1 day after the initial failure |
| 2nd retry | 3 days after the initial failure |
| 3rd retry | 8 days after the initial failure |
| 4th retry (final) | 15 days after the initial failure |
Important: If the final retry at 15 days fails, the subscription will be canceled automatically 19 days after the initial failure.
Revenue Recovery
In addition to automatic retries, HL Hunt provides a Revenue Recovery page where merchants can manually retry failed payments and manage at-risk subscriptions.
From the Revenue Recovery page, you can:
- View all subscriptions with failed payments.
- Manually retry a charge with one click.
- Update the payment instrument for the buyer.
- Cancel subscriptions that are no longer recoverable.
