Skip to main content
POST
https://api.stablepay.global
/
v2
/
users
Create User
curl --request POST \
  --url https://api.stablepay.global/v2/users \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "mobile": "<string>",
  "email": "<string>",
  "externalId": "<string>",
  "deviceId": "<string>"
}
'
{
  "success": true,
  "data": {
    "userId": "usr_abc123def456",
    "depositAddresses": {
      "evm": "0x742d35Cc6634C0532925a3b844Bc9e7595f3A123",
      "solana": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
    },
    "kycStatus": "pending"
  }
}

​
Create User

Creates a new user and generates their unique deposit addresses for receiving stablecoins.
​
name
string
required
Full name of the user
​
mobile
string
required
Mobile number with country code (e.g., +919876543210)
​
email
string
Email address (optional)
​
externalId
string
Your internal user ID for reference
​
deviceId
string
required
Device fingerprint/ID for FIU compliance. Must be captured from the client device.

​
Request

curl -X POST https://api.stablepay.global/v2/users \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Rahul Kumar",
    "mobile": "+919876543210",
    "email": "[email protected]",
    "externalId": "user_123",
    "deviceId": "device-fingerprint-12345"
  }'

​
Response

{
  "success": true,
  "data": {
    "userId": "usr_abc123def456",
    "depositAddresses": {
      "evm": "0x742d35Cc6634C0532925a3b844Bc9e7595f3A123",
      "solana": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
    },
    "kycStatus": "pending"
  }
}
The evm address works for all EVM chains: Polygon, Ethereum, Arbitrum, and Base. The solana address is only returned if Solana is enabled for your account.

​
Next Steps

After creating a user, complete KYC verification using the KYC APIs:
  1. Verify Aadhaar via DigiLocker
  2. Verify PAN
  3. Verify Bank Account

​
Errors

CodeDescription
USER_EXISTSMobile number already registered for this partner
INVALID_MOBILEInvalid mobile number format
WALLET_SERVICE_UNAVAILABLEWallet service temporarily unavailable
{
  "success": true,
  "data": {
    "userId": "usr_abc123def456",
    "depositAddresses": {
      "evm": "0x742d35Cc6634C0532925a3b844Bc9e7595f3A123",
      "solana": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU"
    },
    "kycStatus": "pending"
  }
}