How to Manage Security Deposits

For amenities that collect a security deposit, the booking drawer's Payment & Refunds tab includes a Manage Deposit section for handling how the deposit gets disposed of once the booking is over.

Who can use it: Requires amenity_bookings_update; deposit reversal and refund-adjacent actions require process_refunds.

Send a deposit link (deferred deposits)

If the amenity is set up for deferred deposit collection, the deposit isn't charged at booking time, it's collected later via a link sent to the resident ahead of the booking start (the amenity's configured lead time). From the drawer you can trigger Send Deposit Link to send or resend that link.

The deferred-deposit chip and send-link action:

Keep the deposit

Click Keep Deposit and enter a reason. If the resident caused damage or violated policy, you can keep the deposit instead of returning it. A reason is required to complete this action, so it's documented for later reference.

The Keep Deposit dialog with required reason:

Reverse a Keep Deposit decision

If a deposit was kept in error, use Reverse Keep to undo the decision.

Mark deposit returned (outside Stripe)

If you returned the deposit to the resident by some means outside of Stripe (e.g. cash, check, or a separate transfer), use Mark Deposit Returned to record that it was handled, without processing another Stripe refund.

Upload evidence photos

When keeping or documenting a deposit disposition, you can upload evidence photos (e.g. of damage) to support the decision and keep a visual record attached to the booking.

Deposit action buttons together:

See "How to cancel, refund, or void a booking" for general refund actions, and "Overview: Managing Amenity Bookings" for the Deposits Outstanding filter that surfaces bookings awaiting deposit action.