Install and switch on the app

  1. In the menu, under Configuration, click Plugins, find Deposits in the App Store and click Install.
  2. Open the app’s settings, titled “Security deposits”. If your payment set-up cannot take deposits, a message at the top says why.
  3. Switch on Ask for a security deposit on bookings.
  4. In Days after the return date before the deposit is released, enter how long the owner has to report a problem once the rental is over: from 0 to 30 days, 2 by default.
  5. Click Save Changes.

Choose which bookings ask for one

Under Which bookings ask for one, add one line per deposit:

  1. In Applies to, choose A category and its subcategories or One listing, then choose the Category or enter the Listing ID.
  2. In Amount, choose A fixed amount, in your marketplace’s currency, or A percentage of the booking.
  3. Enter the Value and click Save the deposit.

A listing’s own deposit wins over its category’s, and a subcategory’s over its parent’s. Remove takes a line away; bookings already paid keep their deposit.

How the money works

  1. At checkout, the renter sees the deposit under the total, with what will happen to their card. Nothing is charged.
  2. When the booking is paid, the deposit is held on the renter’s card if the rental ends within six days. Otherwise their card is saved, and the hold is placed a few days before the deposit is due back.
  3. When the rental is over, the owner receives an e-mail asking whether everything went well, with a link to report a problem.
  4. On the release date (the return date plus the days you chose), the deposit is given back on its own and the renter is told. A booking declined or cancelled gives it back as well.
  5. When you accept a claim, the awarded amount is taken from the deposit and transferred to the owner’s Stripe account, in full. The rest of the hold is given back to the renter.

Decide on a claim

The owner reports a problem from the link in their e-mail: what happened, the amount they claim (up to the deposit) and up to 6 photos. The deposit is then kept until you decide, and you receive an e-mail at the marketplace’s address (Settings › General, E-mail address).

  1. In the Deposits settings, click Deposit claims. When claims wait for you, the link becomes a button that counts them.
  2. The list shows each claim with its status: To decide, Accepted, Partly accepted, Declined or Payment to retry.
  3. Open a claim. The claim shows the order, the seller, the deposit, the amount claimed, what the seller says and their photos.
  4. Before deciding, hear the renter too: write to them from the order.
  5. Under Your decision, enter the Amount awarded to the seller, up to the amount claimed, and why in Why (shown to the seller). Click Award this amount, or Decline the claim to give the whole deposit back.

The order’s page in the admin panel shows a Security deposit card: its amount, where it stands, the claim, and the Seller’s claim page to send to an owner who lost the e-mail.

The eight e-mails of the app (to the owner, the renter and you) are edited like your other notifications, in Settings › Notifications.

What your users see

  • Renters see a Security deposit line at checkout, with “It is reserved on your card after payment, not charged.” or “Your card is saved for it after payment: nothing is charged.” They are told by e-mail when a claim is opened, when it is decided, and when the deposit goes back untouched.
  • Owners receive an e-mail when the rental is over, with a link to their claim page. That page shows the deposit, where it stands and the date to claim before; once a claim is filed, it shows the claim and your decision.

Edge cases and limits

  • Stripe Connect with Custom accounts only: Standard accounts and other payment providers cannot take deposits for now.
  • A booking paid on its own: the renter’s card is kept for the deposit only when the booking is the only order of its payment. Paid in a cart with other orders, the deposit cannot be secured, and the owner is told.
  • One claim per deposit: once a claim is filed, the owner cannot file another one for the same booking.
  • Holds last about a week: when a claim is still open shortly before the hold lapses, the amount claimed is taken and kept aside until you decide, and the renter is told. If you award less, the difference goes back to them.
  • A refused hold: if the renter’s bank refuses the hold, the card stays saved, and an awarded amount is charged to it.
  • A card that needs authentication: charging a saved card can be refused by a bank that asks the renter to confirm. The owner is then told that the amount could not be taken.
  • Another settlement currency: when your Stripe account settles in another currency than the one you sell in, the owner is paid in the settlement currency, at the rate of the renter’s payment.
  • Photos: JPEG, PNG or WebP, 8 MB each at most. Only you see them, not the renter.