Help for owners
My PayPal subscriptions are failing to bill or getting suspended
Short answer
A PayPal subscription is suspended automatically when consecutive payments fail up to the threshold set on its plan, and it only recovers through PayPal's own recovery or a reactivation. Failed payments also raise events your site must handle. Look at the subscription's status and failed payment count first.
Does this sound like your situation?
- Subscribers say they were not charged or were charged once and then stopped.
- Subscriptions show as suspended and I did not suspend them.
- Customers still have access although their payment failed.
- A new subscriber was never billed the first charge.
- My records and PayPal disagree about who is subscribed.
Why does this happen?
Repeated failures suspend the subscription
The plan holds a payment failure threshold, the number of failures before the subscription is suspended. PayPal's example: with a threshold of 2, the subscription becomes suspended if two consecutive payments fail. The subscription also keeps a count of consecutive failures that resets after a successful payment.
Confirmed by developer.paypal.com
A subscription has a lifecycle
Its status can be approval pending, approved, active, suspended, cancelled or expired. PayPal's API has calls to suspend, cancel and activate a subscription, so the status tells you where it stands.
Confirmed by developer.paypal.com
The setup payment can fail on its own
If the initial setup payment fails, the plan decides what happens: the subscription either continues or is cancelled. A plan set to cancel will drop buyers whose first charge fails.
Confirmed by developer.paypal.com
Outstanding amounts can be billed later
A plan can be set to bill the outstanding amount in the next billing cycle. If it is not, a missed charge is not caught up.
Confirmed by developer.paypal.com
Your site learns through events
PayPal sends events when a subscription is created, activated, suspended or cancelled, and when a payment fails. If your listener misses them, your member list drifts from PayPal's.
Confirmed by developer.paypal.com
What can I do about it today?
- Take one affected subscriberLook up their subscription in PayPal and note its status and any failed payment information.
- Do not cancel and recreate in a hurryA replacement subscription has to be approved by the buyer again, and a mix-up could bill them twice. Check the status first.
- Write to the customer, not around themIf their payment keeps failing, ask them to check the payment method in their own PayPal account. Never ask for passwords or card numbers.
- Compare access with paymentList who has access to your product without an active subscription, and who is active but locked out.
- Ask your developer about the plan settingsAsk for the plan's failure threshold, the setup fee failure action and the outstanding-balance setting.
- Check events are being receivedSee whether PayPal's delivery record shows failed deliveries.
When should I bring someone in?
- Many subscriptions are suspended or failing at once.
- Access and billing disagree and members are being locked out wrongly.
- Nobody knows how the plan was configured.
How do I handle it?
- List the statesI read your subscriptions from PayPal's API and count them by status and failed count.
- Read the plansI check each plan's failure threshold, setup fee action and outstanding amount setting against PayPal's reference.
- Fix event handlingI make your site follow the activated, suspended, cancelled and payment-failed events, safely repeatable.
- Decide grace rules with youHow long a member keeps access after a failure is your business decision. I build whichever rule you choose.
- Repair and verifyI align member records to PayPal's statuses with a log, and test in a sandbox before changing live behaviour.
The price depends on what I find, so I quote in writing after a short discovery call. Tell me what is happening and I reply within 24 hours.
What do owners ask about this?
Why was a subscription suspended?
The plan's failure threshold is the number of consecutive failures before suspension. Check the subscription's failed payment count.
Can a suspended subscription be reactivated?
PayPal's API has calls to suspend, cancel and activate subscriptions. Whether reactivation is right depends on why payments failed.
Does PayPal retry failed payments?
PayPal's subscriptions page lists automatic payment recovery for failed payments. The details are not given there, so I cannot state a schedule.
Will my site know?
Only if it listens for PayPal's subscription events.
Sources
How was this page made?
I drafted this page with AI assistance from the official documents listed under Sources. Found a mistake? Tell me.