Skip to main content
Requests must be signed with HMAC-SHA256. See Authentication and conventions.
  • Give the returned H5Link to the person, who opens it in a mobile browser and completes the face scan. H5Link is valid for about 2–3 minutes; use it right after creation.
  • When verification ends, the browser is redirected to CallbackURL. The authoritative result comes from GetVisualValidateResult.
  • Each BytedToken can be verified only once and is valid for 30 minutes. A successful verification creates a new real-person asset group. See Real-person assets for the full flow.

​
Request parameters

​
string
required
HTTP(S) URL the browser is redirected to when verification ends.
​
string
Pass default or omit.

​
Response parameters

​
string
Session token used to query the verification result.
​
string
URL of the face verification page.
​
string
The redirect URL passed in the request.