feat(settlement): add receipt handling and detail view for settlements

2026-06-25 17:34:39 +03:30
parent 71edc772c8
commit 694ee28787
11 changed files with 484 additions and 3 deletions
@@ -1052,3 +1052,27 @@ Reject a pending request. **Permission:** `ROLE_ADMIN`
  ]
 }
 ```
+
+### GET `/api/v1/admin/settlement/{uuid}`
+
+جزئیات یک درخواست تسویه (برای صفحه‌ی `/admin/settlements/{uuid}`). **Permission:** `ROLE_ADMIN`
+
+**Response `200`:**
+```json
+{
+  "success": true,
+  "data": {
+    "uuid": "...",
+    "representation_name": "نماینده یزد",
+    "representation_mobile": "09390036732",
+    "amount": 500000,
+    "status": "pending",
+    "bank_card": "6037...", "bank_name": "ملت", "bank_iban": "IR...", "bank_owner": "...",
+    "reject_reason": null,
+    "requested_at": "2026-06-24T...", "processed_at": null
+  }
+}
+```
+تأیید/رد از طریق `POST /api/v1/settlement/{uuid}/approve|reject` (در `docs/api/settlement.md`).
+
+**Errors:** `NOT_FOUND` (404) — درخواست یافت نشد.