Skip to main content

​
Base URL

https://api.stablepay.global/v2

​
Authentication

All endpoints require Bearer token authentication: 
Authorization: Bearer pk_live_your_api_key

​
Response Format

All responses follow this structure: 
{
  "success": true,
  "data": { ... }
}
Error responses: 
{
  "error": "Error Type",
  "message": "Description",
  "code": "ERROR_CODE"
}

​
Endpoints

​
Users

MethodEndpointDescription
POST/usersCreate a new user
GET/users/:idGet user details
GET/usersList users

​
Verification

MethodEndpointDescription
POST/users/:id/verify/mobile/sendSend mobile OTP
POST/users/:id/verify/mobile/confirmVerify mobile OTP
POST/users/:id/verify/email/sendSend email OTP
POST/users/:id/verify/email/confirmVerify email OTP
GET/users/:id/verify/statusGet verification status

​
KYC

MethodEndpointDescription
POST/users/:id/kyc/pan/verifyVerify PAN
POST/users/:id/kyc/digilocker/initInitialize DigiLocker (Aadhaar)
GET/users/:id/kyc/digilocker/statusCheck DigiLocker status
POST/users/:id/kyc/bank/verifyVerify bank account
POST/users/:id/kyc/upi/verifyVerify UPI
POST/users/:id/kyc/face/initInitialize face liveness
POST/users/:id/kyc/face/verifyVerify face liveness
GET/users/:id/kyc/statusGet KYC status
GET/users/:id/kyc/extended-statusGet extended KYC status
POST/users/:id/kyc/profileSubmit user profile
POST/users/:id/kyc/declarationSubmit declaration

​
Transactions

MethodEndpointDescription
POST/transactionsCreate transaction
POST/transactions/prefundedCreate prefunded transaction
GET/transactions/:idGet transaction
GET/transactionsList transactions
POST/transactions/:id/cancelCancel pending transaction
GET/quotesGet exchange rate quote
GET/quotes/rateGet current exchange rate info

​
Account

MethodEndpointDescription
GET/accountGet account info
GET/account/statsGet account stats
GET/account/usageGet usage breakdown
GET/account/activityGet recent activity
GET/account/developer-feeGet developer fee settings
PUT/account/developer-feeUpdate developer fee

​
Webhooks

MethodEndpointDescription
GET/webhooksList webhook events
GET/webhooks/:idGet webhook event details
GET/webhooks/logsGet webhook delivery logs
POST/webhooks/:id/retryRetry failed webhook

​
Pagination

List endpoints support pagination: 
?page=1&limit=20
Response includes: 
{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 100,
    "totalPages": 5
  }
}