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 cards

When 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 instalments

You 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 API

You can also manage billing events with the BillPro API. See Billing Events and Scheduled Payments.


Display billing events

  1. Open the order. See Display order details.
  2. 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 of an instalment order

The Billing Events tab


Manage billing events

  1. On the Billing Events tab, select one or more billing events.
  2. 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.

A scheduled billing event selected, with Execute Now, Reschedule and Skip available

Select a billing event to manage it

Billing event statusActions
ScheduledExecute Now, Reschedule, Skip
Soft-declinedRetry, Reschedule, Skip
Hard-declinedReschedule, Skip
CollectedRefund
Two or more not collectedMerge, 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:

  1. Select the soft-declined billing event.
  2. Click Retry, then confirm with Retry.
The Retry confirmation

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.

  1. Select the billing event and click Reschedule.
  2. Pick the new Date and change the Amount if needed.
  3. Click Reschedule.
The Reschedule pop-up with Date and Amount

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.
  1. Select one or more billing events and click Skip.
  2. Confirm with Skip. You can't undo this.
The Skip confirmation

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.

  1. Select the billing events to merge and click Merge.

    Two scheduled billing events selected, with Merge available

    Select billing events to merge

  2. Check the merged Amount. To charge a different amount, reschedule the merged billing event afterwards.

  3. Choose when to charge it: on the date of the last billing event, Process now, or Set new processing date.

  4. Click Merge.

    The Merge Payments pop-up

    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.

  1. Select the billing event and click Execute Now.
  2. Confirm with Execute Now.
The Execute Now confirmation

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.


Recommended reading

Refund payments

Did this page help you?