
Billing Operations
Part of Subscription billing operations
Handling a subscription payment that fails
Identify the failed charge, decide whether its parcel is held, guide the customer and close the payment exception.
When a recurring charge fails, identify the affected delivery, apply its hold rule and give the customer a clear route to fix the payment.
One unsuccessful attempt does not establish that the subscription has ended or that its parcel should ship.
Identify what failed
Find the subscription, the intended charge, the delivery it was meant to fund, the attempt status and any order already created. Check whether the provider reports a payment-method problem, an authentication step, insufficient stock or another processing error. A generic “failed” status does not identify the cause.
In Shopify, use the attempt record to check associated transactions and errors; a successful attempt creates an order. The Shopify Subscriptions app also has separate settings for payment-method and insufficient-inventory failures. Other providers may expose different states or create an unpaid order earlier, so work from the records your actual system holds.
Decide what happens to the parcel
If the plan requires payment before dispatch and the parcel has not shipped, hold it outside the released packing list. Where supply before collection is permitted, record that policy and the specific decision. Check an existing order or export before releasing anything: its presence alone does not prove payment was collected.
Set a recovery window that fits the promised fulfilment timetable. Shopify Subscriptions lets merchants configure the number of retry attempts, the days between attempts, and a skip, pause or cancel action once attempts are exhausted.
Check the store's configuration before describing an automatic outcome. A payment recovered after the packing run may require a new dispatch expectation.
Give the customer an actionable notice
Name the affected delivery and say its charge was unsuccessful. State whether it is held and explain the next step available.
Direct the customer to the provider's supported route for updating payment details or completing authentication where applicable. Give a retry time only when it is known. Do not call an order cancelled while recovery remains open.
Support staff and customer messages should refer to the same delivery and current status, including a payment recovered after the first notice.
Close the exception once
After a successful retry, verify the collected payment and the order linked to the intended delivery before release.
If recovery fails, apply the plan's stated skip, pause, cancellation or manual-resolution rule, and explain its effect on the affected parcel and later charges. Record any refund against its payment and order.
At the next run, review unresolved attempts, recovered deliveries still held and parcels released without the payment their plan requires. Keep each case assigned until its payment and delivery outcomes are clear.



