less than a minute read • Updated an hour ago
Configure past due amount settings
How to configure how Foxy handles past due amounts on subscriptions, including how they accumulate and when they are collected.
When a subscription fails to process, Foxy records a past due amount on the subscription equal to the missed payment. You can configure how that amount accumulates and when it is collected in your store’s advanced settings.
How to configure past due settings
Past due amount accumulation
You can choose how the past due amount is calculated when a subscription fails more than once:
Increased by the missed payment amount — each missed renewal adds to the total past due balance. For example, if a $20/month subscription fails three times, the past due amount will be $60.
Replaced with the latest missed payment amount — the past due balance is always equal to the most recent missed renewal only. Using the same example, the past due amount would remain $20 regardless of how many renewals have failed.
Charging past due amounts
The Charge past due amounts checkbox controls whether the past due balance is included when a subscription is processed.
Checked: The past due amount is included in automatic subscription processing and in the cart when a customer attempts to update their subscription via a sub_token link.
Unchecked: Any successful subscription payment — whether automatic or customer-initiated — will clear the past due amount without collecting it. Note that even when unchecked, you can still collect past due amounts by using the sub_restart=auto flag on sub_token links.
Requiring past due payment before modification or cancellation
By checking Prevent customer-initiated modification, replacement, and cancellation if past-due is present, customers will be required to pay any outstanding past due amount before they can:
Cancel their subscription via the cancel link in their receipt email
Replace their subscription using
sub_modify=replace
If this is enabled and a customer has a past due balance, they will not be able to use those links until the balance is cleared. You will need to either cancel or modify the subscription on their behalf through the admin, or clear the past due amount first by editing the subscription directly.
Notes
Past due amounts can be viewed and manually adjusted in the Foxy admin by going to Subscriptions, finding the subscription, and clicking Edit.
See Add a past due amount to a subscription for steps on manually adding a past due amount to a subscription.