Skip to main content
POST
https://api.stablepay.global
/
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": "2024-01-15T10:40:00.000Z"
  }
}

​
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

ValueDescription
salariedSalaried Employee
self_employedSelf-Employed
businessBusiness Owner
professionalProfessional (Doctor, Lawyer, etc.)
studentStudent
retiredRetired
homemakerHomemaker
unemployedUnemployed
otherOther (specify in occupationOther)

​
Income Ranges (Annual)

ValueRange (INR)
below_5lBelow 5 Lakhs
5l_to_10l5 - 10 Lakhs
10l_to_25l10 - 25 Lakhs
25l_to_50l25 - 50 Lakhs
50l_to_1cr50 Lakhs - 1 Crore
above_1crAbove 1 Crore

​
Request Body

​
occupation
string
required
User’s occupation type
​
occupationOther
string
Specify occupation if “other” is selected (max 100 characters)
​
incomeRange
string
required
User’s annual income range
​
isPep
boolean
required
Whether the user is a Politically Exposed Person
​
pepDetails
string
Additional PEP details if isPep is true (max 500 characters)
​
declarationAccepted
boolean
required
Must be true - user accepts the declaration terms
​
deviceId
string
required
Unique device identifier for FIU compliance

​
Response

​
success
boolean
Whether the declaration was submitted successfully
​
message
string
Success or error message
​
data
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": "2024-01-15T10:40:00.000Z"
  }
}