Create Customer
The customers API is a KYC API for DeFi wallets. Onboard and verify your end-users, then link their wallet addresses so verified identity travels with their on-chain activity.
Create a customer and start KYC. Returns a hosted verification URL.
Authorizations
Stablepay API key. Include as Authorization: Bearer <key>.
Body
Your own unique identifier for the customer.
"user001"
individual, business "user@example.com"
"+254712345678"
ISO 3166-1 alpha-2.
"KE"
Optional key-value data. Do not include personal information.
Response
Customer created.
Prefixed ULID for this customer.
"cus_01KXG3R0X8DXTKB849FFFEPT7Y"
"user001"
individual, business One of none, pending, in_progress, review, approved, declined, expired, abandoned.
"approved"
1
"KE"
Hosted verification URL. Returned when a verification is started.
"https://verify.didit.me/session/XXXX"
The verified identity. Returned only with refresh=true.
Reasons why the customer isn't approved. This is surfaced to show your end-user why verification is stuck, declined, or needs action. Omitted when the customer is approved or in_progress. Returned only with refresh=true.

