submitKYC(claim_id)

Purpose

Allows users to submit identity verification documents for high-value wins.
Required for all prizes over $600 in compliance with legal and tax standards.

---

Endpoint

POST /api/submit-kyc/{claim_id}

---

Authorization

• Required Scope: user.verify
• Token: Bearer Token from user session

---

Parameters

Name	Type	Required	Description
claim_id	string	✅	Unique identifier for the user’s high-value claim

---

Request: Multipart File Upload

POST /api/submit-kyc/claim_001
Content-Type: multipart/form-data

Fields:
- document_front: image/png
- document_back: image/png (optional if single-sided ID)

---

Response: Success (200 OK)

{
  "claim_id": "claim_001",
  "status": "submitted",
  "review_eta": "2025-06-30T00:00:00Z"
}

---

Error States

HTTP Code	Error Key	Description
400	missing_documents	Required document(s) not attached
404	claim_not_found	The specified claim does not exist
409	already_submitted	Documents already submitted for this claim

---

Document Handling

• All documents are encrypted in transit and stored temporarily in secure cold storage.
• Documents are deleted after verification is complete unless audit hold is triggered.

---

Compliance Flow

• All claims > $600 require KYC prior to payout
• Rejected or expired documents return status via checkKYCStatus()
• Multiple submission attempts may trigger manual review