The KycDocument object
Represents an uploaded KYC document. Contains information about the document and its verification status.
Fields
| Field | Type | Description |
|---|---|---|
id REQUIRED | string | Unique identifier for the document |
merchantId REQUIRED | string | ID of the merchant who uploaded the document |
type REQUIRED | KycDocumentType | Type of document KycDocumentType |
fileName REQUIRED | string | Original filename |
fileSize REQUIRED | number | File size in bytes |
mimeType REQUIRED | string | MIME type of the file |
status REQUIRED | 'pending'| 'approved'| 'rejected' | Verification status |
rejectionReason OPTIONAL | string | Reason for rejection (if rejected) |
uploadedAt REQUIRED | string | ISO 8601 timestamp when the document was uploaded |
reviewedAt OPTIONAL | string | ISO 8601 timestamp when the document was reviewed |
Example
{
"id": "obj_1a2b3c",
"merchantId": "merchant_1a2b3c",
"type": "id_card",
"fileName": "string",
"fileSize": 1,
"mimeType": "string",
"status": "pending",
"rejectionReason": "string",
"uploadedAt": "2026-01-15T09:30:00Z"
}