curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/declaration" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"occupation": "salaried",
"incomeRange": "10l_to_25l",
"isPep": false,
"declarationAccepted": true,
"deviceId": "device_abc123"
}'
{
"success": true,
"message": "Declaration submitted successfully",
"data": {
"declarationId": "decl_abc123def456",
"occupation": "salaried",
"incomeRange": "10l_to_25l",
"isPep": false,
"submittedAt": "2025-06-15T10:40:00.000Z"
}
}
{
"success": false,
"error": "KYC Rejected",
"message": "We cannot onboard Politically Exposed Persons (PEP) at this time",
"data": {
"declarationId": "decl_abc123def456",
"isPep": true,
"kycStatus": "rejected"
}
}
KYC
Submit KYC Declaration
Submit user’s KYC declaration including occupation, income range, and PEP status
POST
/
v2
/
users
/
{userId}
/
kyc
/
declaration
curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/declaration" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"occupation": "salaried",
"incomeRange": "10l_to_25l",
"isPep": false,
"declarationAccepted": true,
"deviceId": "device_abc123"
}'
{
"success": true,
"message": "Declaration submitted successfully",
"data": {
"declarationId": "decl_abc123def456",
"occupation": "salaried",
"incomeRange": "10l_to_25l",
"isPep": false,
"submittedAt": "2025-06-15T10:40:00.000Z"
}
}
{
"success": false,
"error": "KYC Rejected",
"message": "We cannot onboard Politically Exposed Persons (PEP) at this time",
"data": {
"declarationId": "decl_abc123def456",
"isPep": true,
"kycStatus": "rejected"
}
}
Overview
Submit the user’s declaration information as part of the extended KYC process. This includes occupation, income range, and Politically Exposed Person (PEP) status.If the user declares themselves as a Politically Exposed Person (PEP), their KYC will be automatically rejected.
Occupation Types
| Value | Description |
|---|---|
salaried | Salaried Employee |
self_employed | Self-Employed |
business | Business Owner |
professional | Professional (Doctor, Lawyer, etc.) |
student | Student |
retired | Retired |
homemaker | Homemaker |
unemployed | Unemployed |
other | Other (specify in occupationOther) |
Income Ranges (Annual)
| Value | Range (INR) |
|---|---|
below_5l | Below 5 Lakhs |
5l_to_10l | 5 - 10 Lakhs |
10l_to_25l | 10 - 25 Lakhs |
25l_to_50l | 25 - 50 Lakhs |
50l_to_1cr | 50 Lakhs - 1 Crore |
above_1cr | Above 1 Crore |
Request Body
string
required
User’s occupation type
string
Specify occupation if “other” is selected (max 100 characters)
string
required
User’s annual income range
boolean
required
Whether the user is a Politically Exposed Person
string
Additional PEP details if isPep is true (max 500 characters)
boolean
required
Must be
true - user accepts the declaration termsstring
Unique device identifier for FIU compliance
Response
boolean
Whether the declaration was submitted successfully
string
Success or error message
object
curl -X POST "https://api.stablepay.global/v2/users/{userId}/kyc/declaration" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"occupation": "salaried",
"incomeRange": "10l_to_25l",
"isPep": false,
"declarationAccepted": true,
"deviceId": "device_abc123"
}'
{
"success": true,
"message": "Declaration submitted successfully",
"data": {
"declarationId": "decl_abc123def456",
"occupation": "salaried",
"incomeRange": "10l_to_25l",
"isPep": false,
"submittedAt": "2025-06-15T10:40:00.000Z"
}
}
{
"success": false,
"error": "KYC Rejected",
"message": "We cannot onboard Politically Exposed Persons (PEP) at this time",
"data": {
"declarationId": "decl_abc123def456",
"isPep": true,
"kycStatus": "rejected"
}
}