KYC Status
GET
/v1/kyc/statusOptionalReport the merchant's KYC decision. status ∈ none | pending | approved | rejected | suspended | expired. Payments are allowed only when status === "approved".
Authentication
Signature Pattern
HMAC-SHA256(secretKey, "{timestamp}\nGET\n/v1/kyc/status\n{sha256(\"\")}")| Header | Value | Description |
|---|---|---|
X-Api-Key | pk_live_a1b2c3d4e5f6g7h8 | Merchant public API key |
X-Signature | {hmac_sha256_hex} | Hex HMAC-SHA256 request signature |
X-Timestamp | 2026-04-13T10:00:00Z | ISO 8601 UTC request time (±5 min) |
Response Parameters
| Field | Type | Example |
|---|---|---|
status | string | "approved" |
decidedAt | string | "2026-04-10T09:00:00Z" |
sessionId | string | "f1c9a2e6-b4d4-e8a9-c1f2-a7b8c9d0e1f3" |
subjectId | string | "sbj_3c4d5e6f7081" |
Response Example
JSONResponse
{
"status": "approved",
"decidedAt": "2026-04-10T09:00:00Z",
"sessionId": "f1c9a2e6-b4d4-e8a9-c1f2-a7b8c9d0e1f3",
"subjectId": "sbj_3c4d5e6f7081"
}Status Codes
200Success
201Created
400Bad Request
401Unauthorized
404Not Found
429Rate Limited
Try itMock
GEThttps://api.pay.sandbox.kvell.group