Skip to main content

​
POST /client/verification/start

Starts a Signicat PictureID verification for the authenticated client. Returns a captureUrl the user must open to scan their document and take a selfie. Authentication: Client Token (Authorization header)

​
Request

POST https://api.assetpay.gg/client/verification/start
Content-Type: application/json
Authorization: CLIENT_TOKEN

{
  "email": "user@example.com"
}

​
Body Parameters

ParameterTypeRequiredDescription
emailstringNoEmail associated with the user. Recommended — required later for multi-account linking via /client/verification/link.

​
Response

{
  "requestId": "...",
  "success": true,
  "data": {
    "captureUrl": "https://capture.signicat.com/...",
    "dossierId": "dossier-uuid"
  }
}
Open captureUrl in the user’s browser or webview. After they complete the capture, AssetPay receives a webhook from Signicat and updates the client’s verificationLevel.

​
Limits

  • Only one active process per user. A new call within 30 minutes of an unfinished process returns VERIFICATION_IN_PROGRESS.
  • Already-verified clients (verificationLevel >= 1) get VERIFICATION_ALREADY_VERIFIED.

​
Errors

CodeKeyWhen
2300VERIFICATION_NOT_AVAILABLESignicat credentials not configured for this environment
2301VERIFICATION_ALREADY_VERIFIEDClient is already at level 1
2302VERIFICATION_IN_PROGRESSAn active process exists from the last 30 minutes
1102INVALID_TOKENClient token is invalid or expired