Skip to main content
POST
https://api.stablepay.global
/
v2
/
users
/
{userId}
/
kyc
/
document
curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/document" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documentType": "passport",
    "s3Key": "kyc/user_123/passport/abc-def-ghi.pdf",
    "fileName": "passport_scan.pdf",
    "fileSize": 2048576,
    "mimeType": "application/pdf",
    "deviceId": "device_abc123"
  }'

{
  "success": true,
  "message": "Document uploaded successfully",
  "data": {
    "documentId": "doc_abc123def456",
    "documentType": "passport",
    "fileName": "passport_scan.pdf",
    "uploadedAt": "2024-01-15T10:35:00.000Z"
  }
}

​
Overview

After uploading a document to S3 using the presigned URL, call this endpoint to confirm the upload and save the document metadata.
This is step 2 of the document upload process. First, get a presigned URL from Upload Document.

​
Request Body

​
documentType
string
required
Type of document: passport, driving_license, aadhaar, or voter_id
​
s3Key
string
required
S3 object key returned from the upload-url endpoint
​
fileName
string
required
Original file name
​
fileSize
number
required
File size in bytes
​
mimeType
string
required
File MIME type
​
deviceId
string
required
Unique device identifier for FIU compliance

​
Response

​
success
boolean
Whether the document was confirmed successfully
​
message
string
Success or error message
​
data
object
curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/document" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "documentType": "passport",
    "s3Key": "kyc/user_123/passport/abc-def-ghi.pdf",
    "fileName": "passport_scan.pdf",
    "fileSize": 2048576,
    "mimeType": "application/pdf",
    "deviceId": "device_abc123"
  }'

{
  "success": true,
  "message": "Document uploaded successfully",
  "data": {
    "documentId": "doc_abc123def456",
    "documentType": "passport",
    "fileName": "passport_scan.pdf",
    "uploadedAt": "2024-01-15T10:35:00.000Z"
  }
}