docs: sync from backend 19f7eb9, frontend 60ee6fb — Task #10 AML screening

06 - Usage/Admin Guide.md

@@ -190,9 +190,9 @@ If you see repeat disputes against the same seller (or repeat frivolous disputes
 **Dashboard → Payment → List** shows all payments with filters by status, provider, network, time range.
 
 Watch for:
-- **Stuck payments** (pending > 1h) — SHKeeper webhook may have failed; check logs.
-- **Failed webhooks** — SHKeeper retried but signature didn't verify; see [[Payment API]].
-- **Missing tx hashes** on completed payments — run the repair script (see §6.3).
+- **Stuck payments** (pending > 1h) — Request Network webhook/reconciliation may not have completed; check webhook logs and derived-destination balances.
+- **Failed webhooks** — Request Network signature verification or payload validation failed; see [[Payment API]] and [[Request Network Integration Constraints]].
+- **Missing tx hashes** on completed payments — use the payment console or reconciliation job to fetch and verify the on-chain transaction before any release.
 
 ### 6.2 Manual payout
 
@@ -202,18 +202,18 @@ For sellers who can't access self-service or for one-off ops:
 2. Fields: recipient address, amount, token (USDT…), network (BSC…), reference, description.
 3. Submit → ts-node script also exists at `backend/manual-payout-test.ts` for local testing.
 
-Behind the scenes this calls SHKeeper's payout endpoint. See [[Payout Flow]].
+Behind the scenes this should create a release/refund instruction and ledger entry, then route signing through the configured custody signer. See [[Payout Flow]] and [[PRD - Decentralized Custody and Smart-Contract Escrow Roadmap]].
 
 ### 6.3 Fix missing transaction hashes
 
-Some completed payments may lack the on-chain tx hash (webhook race, partial confirmation). Run:
+Some completed payments may lack the on-chain tx hash (webhook race, callback delay, or partial reconciliation). Prefer the admin payment console or Request Network reconciliation tooling. For older SHKeeper records only, use the historical repair script:
 
 ```bash
 cd /Users/mojtabaheidari/code/backend
 node fix-transaction-hashes.js
 ```
 
-The script polls SHKeeper for each affected invoice and patches `transactionHash` + `blockchain.transactionHash` in MongoDB.
+The legacy script polls SHKeeper for each affected historical invoice and patches `transactionHash` + `blockchain.transactionHash` in MongoDB. Do not use it for new Request Network payments.
 
 See [[Scripts]] for the full inventory.