What Happens When a Booking Payment Fails

When a client's card is declined on a paid booking, TidyCal holds their time slot for about four hours and emails them a link to finish paying, so a failed payment does not immediately cost you the booking.

Overview

A declined card used to end the booking outright. TidyCal now treats it as recoverable: the slot is held, your client is emailed a link that reopens checkout, and the slot is only released if the hold runs out unpaid. The feature is called Revenue recovery, it is on by default, and it is available on every plan.

What Detail
How long the slot is held About 4 hours from the moment the payment fails
Emails to your client Two — about 30 minutes after the decline, then about 2 hours later
Payment providers Stripe only
Plans All plans (Free, Individual Lifetime, Pro, Agency Lifetime)
Default On

Prerequisites

What Happens, Step by Step

From the moment your client's card is declined:

  1. The booking is kept and the slot stays blocked. Nobody else can book that time while the hold is running.
  2. The booking shows a Payment failed badge on your Bookings page.
  3. About 30 minutes later, your client gets an email titled "Complete your payment" with a link back to checkout. The delay is deliberate — most people who retry do so within minutes, in the same window, and an instant email would reach people who have already paid.
  4. About 2 hours after that, a reminder goes out — "Complete your payment" followed by the booking type name.
  5. If they pay, the booking confirms normally. Nothing else is needed from you.
  6. If the hold runs out unpaid, the slot is released and becomes bookable again.

The hold is measured from the failure, not from the booking. Repeated failed attempts do not extend it. If the appointment itself starts sooner than the hold would end, the hold stops at the start time instead.

What You See as the Host

TidyCal does not email you when a payment is declined. The booking simply appears on your Bookings page carrying a badge, and that badge is how you spot one:

  • Paid — payment completed, booking confirmed
  • Payment pending — no result from the payment yet
  • Payment failed — declined, and currently being held

If you see Payment failed, the slot is being held and your client has already been emailed a link — or will be, within about 30 minutes of the decline. There is nothing you need to do.

What Your Client Sees

The recovery email contains a link that reopens your booking page with their time already selected and their name and email already filled in, so it lands them straight on the payment step. The link creates a fresh payment attempt, which means an expired card or a one-off bank decline can simply be retried with different details.

The email also tells them how long they have, shown in their own timezone rather than yours.

Multi-date bookings. If your booking type sells a package or a set of sessions charged together, the whole set is one payment. Your client gets one email covering it, and the link carries every date — a package cannot be part-paid.

Turning the Hold Off

Go to Settings → Bookings and find the Revenue recovery card. The toggle is Hold the slot when a payment is declined.

TidyCal Settings Bookings page showing the Platform fee and Revenue recovery cards

  1. Open Settings → Bookings.
  2. Switch Hold the slot when a payment is declined off.
  3. Click Save changes.

With it off, a declined booking's slot is released straight away so other people can book it immediately. You keep the Payment failed badge either way; what changes is whether the slot waits.

Two things to know about this setting:

  • It is account-level, not per booking type. There is no way to hold slots for one booking type and not another.
  • On a team booking type it is the team owner's setting. An individual team member cannot opt their own bookings out of it.

Switching it off takes effect immediately for new declines. Bookings already being held are released on the next sweep rather than cancelled on the spot. For the rest of the Settings pages, see TidyCal Settings.

Limitations

  • Stripe only. A PayPal booking is only recorded once the payment succeeds, so there is no failed PayPal payment to recover.
  • Payments still settling are treated separately. Some methods — bank debits and buy-now-pay-later in particular — can take hours to return a result. Those have not failed, so they get a longer allowance than the four-hour hold before their slot is released. This stops TidyCal cancelling a booking out from under a payment that then succeeds.
  • Release notifications are limited. When a held slot is released, TidyCal emails your client ("Your booking was not confirmed") and you ("A booking was released because payment was not completed") only if the booking type uses approval before booking and you are on a paid plan. In every other case the slot is released quietly.

Troubleshooting

A slot is blocked by an unpaid booking and I want it back now

  • Cancel the booking from your Bookings page. That releases the slot immediately instead of waiting for the hold to expire.
  • To stop this happening again, switch off Hold the slot when a payment is declined in Settings → Bookings.

My client says they never got the email

  • The first email is sent about 30 minutes after the decline, not instantly — if the card was declined a few minutes ago, it has not been sent yet.
  • Ask them to check spam, and confirm the email address on the booking is correct.
  • Nothing is sent once the hold has expired. If it has, ask them to book again from your booking page.

The badge still says Payment failed after my client paid

  • Paying from the recovery link creates a new booking for the same slot and releases the held one, so check for a newer entry showing Paid before assuming the payment did not land.
  • Confirm the charge in your Stripe account. If Stripe shows it succeeded but TidyCal does not, contact support@tidycal.com with the booking and the Stripe payment reference.

The same client keeps getting declined

  • Repeated attempts do not extend the hold — it always runs from the first failure.
  • Declines come from their bank, not from TidyCal. Ask them to try a different card or payment method.
  • If you have enabled additional payment methods in Stripe, they can pick a different one from the same recovery link.

Frequently Asked Questions

Is this the same as a cancellation or no-show fee?

No. This is an unpaid booking being given a second chance — no money has changed hands. A cancellation or no-show fee is a separate charge you can configure for clients who cancel late or do not turn up.

My client's subscription payment failed. Is this the same thing?

No. This article is about a one-off booking payment. A failed subscription renewal is handled by Stripe, which retries on its own schedule and does not hold a booking slot.

Do I need to do anything when a payment fails?

No. The hold and both emails are automatic. The badge on your Bookings page is there so you know what is waiting, not because it needs action from you.

Which plan do I need?

None in particular — Revenue recovery works on every plan, including the Free Plan. You only need Stripe connected in order to take paid bookings at all.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Related Articles