Monitor billing exceptions
Use the Billing Exceptions view to check unsuccessfully collected billing events
Billing Exceptions lists every recurring payment that was declined, with a soft decline or a hard decline. Use it to see which payments need attention and to recover them.
Only recurring payments appear here. Declined initial payments and card registrations make the order Rejected. See Process rejected orders.
- On the navigation bar, go to Payments › Billing Exceptions.
- To narrow the list, click Filters, pick a date range, or Search. See the table below.
- To open the order, click its UID. To open the customer account, click the Name.
Billing exceptions
The cards at the top count all exceptions, hard declines, and exceptions with auto-retry on and off.
| Icon | Result | Notes |
|---|---|---|
| Soft declined | You can retry the payment. | |
| Hard declined | BillPro can't collect payments until the card is updated. When you update it, BillPro collects everything outstanding. |
Billing exception columns
| Column | Description |
|---|---|
| Executed on (UTC) | When BillPro last tried to collect the payment |
| UID | BillPro's ID for the order |
| SPID | BillPro's ID for the billing event |
| Name | The customer, with their organisation |
| Retry Count | How many automatic retries BillPro made, from 0 to 3. Manual retries don't count. |
| Auto Retry | Green if auto-retry is on for the order, grey if it's off. BillPro turns it off when all automatic retries are used. For subscriptions with auto-suspend on, the order then becomes Suspended. See Auto-retry billing events and Auto-suspend subscriptions at Configure BillPro with CardCorp. |
| Order Type | Instalment, Subscription or Metered |
| Amount | The amount that wasn't collected |
| Currency | The payment currency |
Billing exceptions and order status
| Result | Order status | What happened, and what to do |
|---|---|---|
| Soft declined | Active | The order was Failed, then BillPro collected a later payment. Earlier declined payments may still be outstanding. See Process active orders with failed billing events. |
| Soft declined | Failed | Retry the payment. With auto-retry on, BillPro retries it and keeps collecting later payments. See Process failed orders. |
| Soft declined | Suspended | A subscription used all its automatic retries with auto-suspend on. BillPro stops collecting until the card is updated. See Process suspended subscriptions. |
| Hard declined | Suspended | BillPro stops collecting, and you can't collect manually, until the card is updated. Then BillPro collects everything outstanding. See Update cards. |
Filter billing exceptions
| Filter | Description |
|---|---|
| Order Type | Single payment, Instalment, Subscription and Metered. Only recurring order types appear in this list. |
| Transaction Result | Soft Decline or Hard Decline |
| Currency | One or more currencies |
| Auto Retry | Active or Inactive |
| Date | When BillPro tried to collect the payment |
| Search | A customer name |
Updated about 1 month ago
Recommended reading
Manage failed and suspended orders, manage billing events, and update cards
Did this page help you?