Handle a failed or past-due payment

Find clients whose payment failed, understand the 7-day grace period, and get them paying again.

Who can do this
Owners and team admins
Where in Strix
Client cockpit, Team settings, People

When a client’s renewal payment fails, Stripe retries it and the client keeps access for a 7-day grace period. Your job is to help them fix their card before the grace period ends.

Steps

  1. Find the client. Look for:
    • The Past due badge at the top of their client page, and a count on their Billing tab.
    • Failed in their Billing ledger or Payments list.
    • “clients need billing attention” under Settings > Billing.
    • The “Payment failed for (client name)” email, sent to the people chosen for Payment failed under Team settings > Notifications. To start, that’s everyone whose permission group can see Billing.
    • The Payment failed alert in the same people’s app inbox. The alert leaves the inbox once the payment goes through.
    • Both wait for Stripe’s retry, which often goes through: a renewal alerts from its 2nd failed attempt. A payment Stripe won’t retry, such as a no-show fee or a renewal the client’s bank needs them to confirm, alerts on its first. The client’s own email still goes out on every failed attempt.
  2. Open the client’s Billing tab. Click View details in Billing details to see the payment status. Open Technical details under Subscription to see First failed and Grace ends.
  3. Get a working card on file:
    • Ask the client to update their card from Payment method in the Strix app menu,
    • Send them a link: on the Support tab, click Send change card link and choose email, SMS or both, or
    • With the client’s permission, click Replace card under Card on file and enter the new card.
  4. Stripe uses the new card for its next retry of the unpaid bill.

What happens next

  • Strix emails the client each time a payment fails, Stripe’s retries included, with the amount, what it was for and how to update their card. Change or switch off that email, and the staff alert, under Automations > Built into Strix: Payment failed: tell the client and Payment failed: tell staff.
  • The payment failed email says when Stripe will retry. During the grace period the client keeps access.
  • If payment succeeds, the client goes back to normal automatically.
  • If it’s still unpaid after 7 days, the client’s billing is suspended and the services included in their plan are turned off. A later successful payment restores them.
  • A suspended client also can’t book until they pay. The Block access when a membership is suspended system automation does this, and the block lifts by itself once that membership’s payment goes through. Until then, staff see it on the client’s page and can Unblock it with a note. To also stop them starting a workout, or to let them keep booking, change or pause that automation under Automations > Built into Strix.
  • To follow up beyond those, such as on the third failed attempt, build an automation on A payment fails, A membership is suspended after a failed payment or A failed payment is recovered.
  • To stop someone booking sooner, add a Block access step with the Payment reason to an automation on A payment fails. The block lifts by itself once their payment goes through. Under Existing bookings, keep the sessions they already booked, or cancel the upcoming ones with their credits returned and no fees. Under Notify, pick who hears when the block starts and lifts; the client’s notice has a button to update their card.

Good to know

  • Sometimes the client’s bank needs them to confirm the payment. The email then says Stripe won’t retry on its own, and includes an Open payment page button. Share that page with the client.
  • If Stripe won’t retry and no bank confirmation is needed, ask the client to update their card or contact them directly.
  • You can’t pause a client while they’re past due. Fix the payment first, or cancel the subscription.
  • A declined session pack or one-off card charge collects nothing and doesn’t affect the subscription. Try again after the card is updated, or send a payment link.
  • Trainers can see the Past due badge but only the owner and team admins can change billing.

Last updated

All help articles