
Orders > [Order] > Payment — deposit hold
Definition
A security deposit is an amount held to cover loss or damage during a rental.
A deposit hold is separate from the rental payment. The rental is paid as normal; the deposit sits alongside it as its own Payment object.
Where do I use it?
- Holding a damage deposit before a rental starts
- Capturing against the hold when an item is returned damaged or late
- Releasing the hold when an item is returned in good condition
How it works
When an order has an outstanding deposit and the customer paid by card, TWICE authorizes the hold off-session (without the customer present) using the saved card.Automatic reservation schedule
TWICE attempts the hold automatically in the run-up to the rental start, retrying periodically until it succeeds or the earliest rental start date passes.Reservation states
Authorization expiry
When a hold is successfully authorized (state: Reserved), the payment provider keeps it open for a limited window — typically around 7 days for Stripe. If you do not capture or release the hold within that window, the provider cancels it automatically. TWICE detects this via the provider’s webhook and records the hold as Expired on the Payments tab. This is distinct from a manual release, which shows as Cancelled.The Expired reservation state (above) and the Expired payment state are different things. The reservation state means the hold was never authorized. The payment state means a successfully authorized hold was not captured in time and the provider released it automatically.
Managing a deposit
Read where a deposit stands on the Deposit card, in the sidebar on the right of the order. The card shows only on an order that carries a deposit, with the deposit Total and a status chip:
Reserve a deposit from the Payment menu in the order’s top-right corner. Capture or release it from the menu on its Deposit Auth row, in the Deposit table on the order’s Payments tab.
Capture once. A capture, even of part of the hold, gives the rest back to the customer, and the row then offers neither Capture deposit nor Release deposit. A release cannot be undone, and the deposit cannot be reserved again on the same order, so Reserve deposit stays greyed out.
Charge damage or a late return from the deposit before you complete the order. Completing it releases every hold still in place and stops TWICE’s scheduled reservation attempts. TWICE prices neither damage nor a late return, so decide the amount yourself.
Capture deposit takes Refunds and deposit captures, which Owner, Admin and Manager hold. Release deposit takes Create and edit orders, which every built-in role holds, because releasing moves no money.
When a stored card is refused, the error notice gives the reason the card issuer returned, and the deposit stays Not reserved.
Save or update payment card, ticked when you send a checkout link, lets the customer enter another card in place of the stored one. Check the Deposit card after they have, and reserve again if it still reads Not reserved.
Return a deposit by releasing the hold, not by refunding the order. A deposit sits on its own balance and in its own Deposit table, so refunding an order payment never touches it. Once a deposit is captured, refund it from its Deposit Capture row the same way as a payment. See Refund an order.
Reserve a deposit, Capture a deposit and Release a deposit walk through each action.
Supported payment providers
Card-based deposit holds work with Stripe (available to all stores) and Adyen (enabled for selected merchants only). These return a reusable card reference after the first successful charge so the hold can be authorized off-session. Orders with a security deposit can also be checked out using manual payment methods (Pay on pickup, custom methods). In this case no automatic hold is placed — the deposit is recorded as a manual deposit and you manage it outside the payment provider (cash, ID card, bank transfer). Use the Reserve deposit action to record these deposits: with no card on file, the dialog says the deposit must be reserved outside of the system, and Mark as reserved logs it in TWICE while you take the cash, ID card, or bank transfer yourself.FAQs
The damage costs more than the deposit
The damage costs more than the deposit
A capture is capped at Available to capture, the amount still held, and you capture once. Capture the whole hold, then add a line item for the rest and collect it with a checkout link or a manual payment. A hold that expired or was released has nothing left to capture, so charge the whole amount that way.
A deposit reservation is already running for this order
A deposit reservation is already running for this order
TWICE’s own reservation schedule is placing the hold on that order at the same moment. Wait a little, then check the Deposit card before you try again: if it reads Reserved, the hold is in place and there is nothing more to do.
Related articles
Payments
Payment hierarchy, transactions, and refunds.
Order Lifecycle
How orders move through fulfillment.
Payment tab
Manage payments and deposits on an order.
Payments settings
Connect Stripe and manage payment providers.