Manage billing events
Manage scheduled payments for orders with recurring payments
For each scheduled payment, BillPro creates a billing event. A billing event has a scheduled date and time, a unique ID (the SPID), and a status.
- For a new instalment order, BillPro creates the billing events for every instalment.
- For a subscription, BillPro creates one billing event at a time, for the next billing cycle.
- For a metered order, you add billing events as you need them.
Update cardsWhen you update the card on an order, BillPro tries to collect every outstanding payment. To collect them later, skip them, or merge and reschedule them, before you update the card.
Billing events for instalmentsYou can't add billing events to an instalment order. Check that you still collect the right total when you change billing events. To collect an extra payment, create a separate single payment order.
Manage billing events with the APIYou can also manage billing events with the BillPro API. See Billing Events and Scheduled Payments.
Display billing events
- Open the order. See Display order details.
- Click the Billing Events tab.
The tab lists every billing event, with its amount, SPID, status, Retry Count, and scheduled and executed dates. Expand a row to see its transactions: debits, retries and refunds. To see every transaction across your orders, open Payments › All Processed. See Display all processed transactions.

The Billing Events tab
Manage billing events
- On the Billing Events tab, select one or more billing events.
- Click an action above the table: Execute Now, Retry, Merge, Reschedule, Skip or Refund.
Only the actions that fit your selection are available. For example, selecting a scheduled billing event enables Execute Now, Reschedule and Skip.

Select a billing event to manage it
| Billing event status | Actions |
|---|---|
| Scheduled | Execute Now, Reschedule, Skip |
| Soft-declined | Retry, Reschedule, Skip |
| Hard-declined | Reschedule, Skip |
| Collected | Refund |
| Two or more not collected | Merge, Skip |
For each status, see Billing event status.
Amounts of billing events
- To change the amount of a billing event, reschedule it and keep the same date.
- To charge nothing, skip the billing event, or refund it in full.
Retry a billing event
You can retry a soft-declined billing event up to 15 times within 30 days of the decline. A card problem can clear up on its own, for example when the customer adds funds. To check whether a payment was soft-declined, see Declined transactions.
BillPro emails the customer when a payment is declined. The email has a payment link to update their card. If you're in touch with the customer, you can also ask them to use it.
To retry with the same card:
- Select the soft-declined billing event.
- Click Retry, then confirm with Retry.

Retry a billing event
If the payment is approved, the order becomes Active again and BillPro stops the automatic retries. See Auto-retry billing events.
Reschedule a billing event
Reschedule a billing event to change its date, its amount, or both. It can be Scheduled, Soft-declined or Hard-declined.
- Select the billing event and click Reschedule.
- Pick the new Date and change the Amount if needed.
- Click Reschedule.

Reschedule a billing event
By default, BillPro emails the customer about the change. See Payment rescheduled and skipped and merged.
Skip billing events
Skipping a billing event cancels it: BillPro won't collect it. It can be Scheduled, Soft-declined or Hard-declined. BillPro subtracts skipped amounts from the order total.
- On a subscription, BillPro schedules the next billing event after you skip one.
- On an instalment order, you can't add billing events, so check that you still collect the right total.
- Select one or more billing events and click Skip.
- Confirm with Skip. You can't undo this.

Skip a billing event
Skipped billing events show a fast-forward icon. The Summary tab shows the total as Skipped Amount. By default, BillPro emails the customer. See Payment rescheduled and skipped and merged.
Merge billing events
Merge combines two or more billing events into one. They can be Scheduled, Soft-declined or Hard-declined.
-
Select the billing events to merge and click Merge.

Select billing events to merge
-
Check the merged Amount. To charge a different amount, reschedule the merged billing event afterwards.
-
Choose when to charge it: on the date of the last billing event, Process now, or Set new processing date.
-
Click Merge.

Merge billing events
The original billing events get the Merged status. The new billing event is Scheduled. By default, BillPro emails the customer. See Payment rescheduled and skipped and merged.
Execute a billing event now
You can collect a scheduled billing event before its date. The rest of the schedule stays the same.
- Select the billing event and click Execute Now.
- Confirm with Execute Now.

Collect a billing event now
BillPro charges the card on the order. If the payment is soft-declined, automatic retries count from the billing event's original date.
Updated 13 days ago