How-to guide
Handle reserves and disputes
Decide a chargeback or dispute, close a reserve, and see what the store can see and answer.
This guide shows how to work with money that is held back from a store, and with the chargebacks and disputes that cause some of it. You need a reviewer or admin account. A merchant account sees its own side of this on a separate page, described at the end.
Two things, one screen#
A reserve is money held back from a store for a stated reason until a set date, from 1 to 365 days. It is one of three types. A set amount is held until its release date. A share of payouts is a part of each payout set aside for a period, and the amount shown is what was set aside. For a dispute is held while the dispute is open. A dispute is a chargeback or a dispute against one payout. Opening a dispute sets its amount aside as a reserve of its own and gives the store 10 days to answer, once, in its own words.
Open Held money in the menu. The screen has three tabs:
- Disputes to decide. Disputes that are open, answered or expired. An expired dispute is one the store did not answer in time. It still waits for you.
- Decided disputes. Disputes that were won or lost.
- Held money. Reserves. It opens on the ones held now, and a filter shows released and kept ones.
Three totals sit above the tabs: the money held back now, the disputes that wait for you, and the next date money goes back to a store. They count the rows the screen loaded, and a note says when a list has more.
Search finds a row by payout, store, reason, type or status. Two filters narrow a tab by stage and by type. On the disputes tab, Needs your decision shows disputes the store answered or let lapse, and Waiting for the store shows the ones still inside the answer window. Select a row to open its panel.
Decide a dispute#
- Open the Disputes to decide tab and select a dispute.
- Read the panel from the top. It shows the dispute amount, how much of the payout it covers, where the dispute stands (received, the store's answer, your decision), the reason, the store's answer if it wrote one, and the payout and store behind it, including what is already held from that store.
- Write a note for the record. It is required, and it goes to the audit log.
- Choose Store wins or Store loses. Each choice says what happens to the money. Confirm it. You can decide before the store answers. The panel says so.
Won releases the reserve held for the dispute. Lost applies that reserve to the loss and does not release it. A decision is final: a dispute that is already decided shows its note and no buttons.
Close a reserve#
- Open the Held money tab and select a reserve that is held now.
- Write a note, then choose Release to the store or Keep to cover a loss and confirm.
A reserve made for a dispute has no buttons. It closes when you decide its dispute. A reserve that ends on its date is released automatically the next day. You can also release it here.
What the store sees#
A merchant opens Held money under its own menu and sees:
- what is held back from each of its stores, why, the amount and the release date;
- each dispute against it, the date to answer by and your decision note once there is one.
For an open dispute the store sees a box to write its answer. It can answer once, before the date. After that, or after the date has passed, the box is gone and the dispute waits for you.
Not on this screen#
You cannot set a reserve or open a dispute from the screen. Both are in the API, POST /api/v1/reserves/ and POST /api/v1/reserves/disputes/, and in the assistant. A reserve above the approval limit waits for a second person, as described in Approve as a second person. The calls are in the API reference.