YaqeenDocs
Back to Yaqeen

Explanation

How holds and appeals work

The life of a hold, from recommendation to release, and how a merchant can appeal.

A hold is a recommendation to keep one payout back. Nothing is held until a reviewer approves it. This page explains the four states of a hold, how an appeal works, and how holds are grouped into cases.

The states of a hold#

text
recommended  ->  approved  ->  released
     |
  rejected
  • Recommended. The detector or a rule found a reason. The hold has a score, reasons in Arabic and English, and the evidence behind each reason. The payout is not touched.
  • Approved. A reviewer decided to hold the payout. The payout status becomes held. A reviewer can hold part of the payout instead of all of it, but never more than the payout. The merchant is told and can appeal until the appeal date.
  • Released. The payout is paid. This happens when the hold period ends, when an appeal is accepted, or when a reviewer releases the hold with a note.
  • Rejected. A reviewer declined the recommendation. The payout is paid as usual and the merchant is told nothing, because the merchant never saw it.

Rejecting and releasing need a short note, so every decision has a stated reason and a named person. A payout can have only one open hold at a time. See Hold statuses for the exact values.

When a hold is released#

The policy sets the length. In the shipped policy a hold lasts 8 days by default, within a range of 2 to 8 days, and the appeal window is 14 days after approval. An admin can change them. Once a day, Yaqeen releases approved holds that have expired (their end date has passed), unless an appeal is still open. The audit log records that release as made by the system account.

Appeals#

A merchant files an appeal on an approved hold with a written statement of up to 1,000 characters. The merchant can attach up to five documents (PDF, JPEG or PNG, up to 10 MB each). Only one appeal can be open on a hold.

A reviewer accepts or rejects the appeal and must write a note. Accepting releases the hold. Rejecting keeps it in place. The merchant gets a message either way. Accepted appeals count as wrong holds in the monitoring numbers.

Disputes#

A dispute or chargeback sets its amount aside as a reserve and gives the merchant 10 days to answer once, in their own words. A reviewer decides won (the reserve is released) or lost (the reserve is applied) and writes a note.

Cases#

Holds that share an exact identifier join one case: the same owner, or the same bank account on the payout. When a new hold links two cases, they merge into the older one and keep their notes and conclusions.

Staff can assign a case, add notes and close it with a recorded conclusion: confirmed ring, false positive, benign shared identifier, or needs more information. A reviewer can record a conclusion only after every hold in the case is decided.

New stores#

Before a store's first payout, staff can run intake: submit an application, mark the papers received (the list depends on the business type), and approve. Approval creates the owner and the store. An application is due within 5 days.

Up Down to moveEnter to openEsc to close