YaqeenDocs
Back to Yaqeen

Help

Frequently asked questions

Short answers to common questions about holds, reasons, accounts, data and security, with a link to the page that owns each answer.

Each answer is short and links to the page that explains it in full. Last reviewed: 2026-11-19.

Holds and decisions#

Does Yaqeen hold money by itself?#

No. Yaqeen recommends a hold. A reviewer reads the reasons and approves or rejects it, with a note for a rejection. A payout is held only after approval. See How Yaqeen decides.

Can Yaqeen flag a store that did nothing wrong?#

Yes. No detector is perfect, so some ordinary payouts get flagged. A reviewer can reject a recommendation, and a merchant can appeal an approved hold. See How holds and appeals work.

Not on its own. A case groups holds that share an exact identifier, such as the same owner or the same bank account. Other shared details can add a reason for a reviewer to check. See How Yaqeen decides.

Can a merchant see why its payout is held?#

Yes, once a reviewer approves the hold. The merchant gets the reasons in Arabic and English, the appeal date and the documents that would help. Evidence about other parties is left out. See How reasons are written.

How long does a hold last?#

In the shipped policy, 8 days by default, within a range of 2 to 8. The appeal window is 14 days after approval. These are our assumptions, and an admin can change them. See Settings.

When do two people have to approve a hold?#

By default, when the payout is above 5,000 SAR, or when approved holds on one owner add up past 10,000 SAR in 24 hours. An admin can change both limits. See Second-person approval.

What happens if only one person can approve?#

The change runs at once, and the audit log records it. Without this rule, a one-person team could never change its own policy. See Second-person approval.

Accounts and keys#

How does someone recover a forgotten password?#

An admin issues a one-time reset link. It works once and ends after 60 minutes. The person chooses their own password, so the admin never sees it. See Roles.

Can an account be deleted?#

No. An account can be switched off, and a switched-off account cannot sign in. The last active admin cannot be switched off. See Roles.

What is the difference between a yq_live_ and a yq_test_ key?#

A yq_test_ key sees only your sandbox, a separate copy of your organization. A yq_live_ key sees your real data. Both are shown once and only a hash is stored. See Authentication.

Can an API key do everything an admin can?#

No. A key has scopes: read, decide, ingest, scim or mcp. No key can reach accounts, keys, webhooks, privacy requests, usage or sandboxes. See Authentication.

Claude and Codex#

Can our staff use Claude or Codex with Yaqeen?#

Yes. A reviewer or admin connects one over MCP and asks about holds, cases, appeals and payouts. It can only read, with twelve tools. It cannot decide a hold, add a note or change a rule. Merchant accounts cannot connect. See Connect Claude and Codex.

How does the sign-in work, and what does the client keep?#

The client sends the person to a Yaqeen page. They sign in with their own account and press Allow. Yaqeen gives the client an access token that lasts 60 minutes and a refresh token that lasts 30 days and works once. Yaqeen stores only hashes of them. The token works at the MCP address and nowhere else in the API. See Authentication.

Does what Claude or Codex reads leave Yaqeen?#

Yes. By default the result goes to the client's provider as the person could see it, with names and amounts. An admin can turn on redaction, which swaps names, usernames and contact values for placeholders, or switch MCP off for the whole organization. See AI and your data.

Can a script use MCP without a person clicking Allow?#

Yes, with an API key that has the mcp scope. That key reaches the MCP address and nothing else. See Connect Claude and Codex.

Data and security#

Do I send raw national IDs and bank accounts?#

No. Send keyed hashes. The API refuses a raw value with not_hashed, so Yaqeen never stores one. See Load your data.

Is the audit log tamper-proof?#

No. It is tamper-evident. Each line holds a hash of the line before it, and verification shows an edit or a removal. See How the audit chain works.

Does Yaqeen hold a security certification?#

No. The trust endpoints say plainly that none is held. The security page lists the controls in place.

Is there a screen to review holds?#

Yes. Reviewers and admins use the dashboard at /app. Everything it does is also in the API. See Review a hold.

Has Yaqeen been tested on real payments?#

Not yet. Yaqeen has been tested on generated data only. How it performs on your traffic is measured during a paid pilot. See Plans and pricing.

Up Down to moveEnter to openEsc to close