PaymentsUpdated 11/6/2026

Update a Guest's Card on File

Every confirmed booking Haven takes payment for has a card page, where the guest adds a card or swaps the one on file for a different one. The guest can get there on their own, you can send them there, and Haven sends them there automatically when a deposit hold fails on their card.

The card on file is what Haven uses for the stay's refundable deposit hold, for add-ons the guest requests, for price changes after a date or guest-count change (charged as you confirm the change while your Charge card for changes setting is on; with it off the guest gets a payment link unless you choose the card in Review charges — see Modify a Reservation), and, on a reservation you moved to Haven from another system, for the scheduled balance.

On a stay the guest pays you directly (Manual Payments), the card is only ever charged for extras the guest buys or add-on requests you approve, never for the stay's own payments or a price change. Those guests are offered the card row only when Ask guests who pay you directly to keep a card on file is on (Payouts → Manual payments), when you ask them for one, or when a card or deposit hold is already on the stay.

When to Use It

  • The guest's card expired, was lost, or was replaced by their bank.
  • A deposit hold could not be placed on the card.
  • The guest wants a different card used for the hold or for add-ons.
  • A booking has no card on file yet and now needs one.

How the Guest Changes Their Card

The guest opens their card page one of three ways:

  • From their guest portal. Signed in, they tap the Reservation card and then Payment card, next to Calendar and Receipt.
  • From an add-on. In the guest portal, on an add-on that needs your approval, Use a different card sits under the line that names the card to be charged.
  • From a link you or Haven sent. The link opens the page directly, with no sign-in.

On the page the guest sees their stay, the card on file (brand, last four digits and expiry), and the deposit hold if the stay has one. They tick an authorization that states exactly what the card may be used for, then save a card on a Stripe-hosted form. Saving a card charges nothing. Once the card is saved, the guest is taken back to their guest portal, where the reservation sheet confirms the new card by its last four digits.

How to Ask a Guest for a New Card

Open the reservation. Under the listing photo, with the stay's payment and details, Card on file shows the card and two actions:

  1. Ask for a new card (Ask for a card when there is none yet) emails the guest a secure link to their card page. You can add a short note, which appears in the email. A line is added to the reservation's message thread so you can see it was sent. The row then shows Asked on with the date you asked, and turns to Card updated with the date once the guest saves one.
  2. Copy link copies the same link, for you to text or send in your own message.

The email is Request for a new card under Communication → Message automations → Whenever this happens, where you can reword it or switch it off. While it is off, Ask for a new card sends no email and records no request; it tells you so, and you use Copy link instead.

The link keeps working until 60 days after checkout.

What Happens When the Card Changes

The new card replaces the old one everywhere the stay uses a card:

The stay has…What happens
A deposit hold not yet placedIt will be placed on the new card.
A deposit hold that failed on the old cardIt goes back in line and Haven places it on the new card, usually within minutes.
A deposit hold already placedHaven places the hold on the new card first, then releases the one on the old card.
Add-on requests waiting for your approvalThey are charged to the new card when you approve.
A scheduled balance (moved reservations)It is charged to the new card. A balance that was waiting on the guest goes back in line right away.

A hold that is already released, claimed, waived, or collected outside Haven is never touched.

If the new card will not carry the hold, the hold stays on the guest's previous card and nothing is lost. The guest is told on the page, the Card on file row on the reservation says the hold is still on the previous card, and the guest can try another card.

Two holds for a few days. After a hold moves, the guest's bank may show the old hold as pending until it clears. That is the bank's timing; the old hold is released at the moment of the move.

A note is added to the reservation's message thread whenever the guest changes their card.

When a Deposit Hold Fails

If Haven cannot place the hold after four attempts, it stops trying that card. Then:

  • You get the Refundable hold couldn't be placed email.
  • On a booking made through Haven, the guest gets an email with a link to change their card. The Card on file row shows the date it was sent.
  • As soon as the guest saves a different card, the hold is placed on it.

You can edit or turn off the guest's email in Communication → Message automations → Security deposit, on the step The hold cannot be placed on the card. With it off, use Ask for a new card yourself.

What It Does Not Cover

  • Airbnb, Vrbo, Booking.com and PMS-synced stays. Those guests put a card on file through the guest portal's deposit task. A declined hold reopens that task. See Security Deposits.
  • Unpaid bookings. A guest who has not paid yet pays through the payment link. See Send a Payment Link.
  • Hosts who collect outside Stripe. There is no card on file to change.
  • The stay's own payments when the guest pays you directly. Those stay manual: Haven never moves them onto the card.
  • Co-guests. Only the guest who booked can change the stay's card.

New to Haven?

Everything in this guide, done for you

Haven is the direct booking platform these guides are written for — a branded site, secure payments, and guest relationships you own. Build yours free.

See how Haven works

Free to build · No credit card · Private until you publish