Skip to main content
Face Verification Link
curl --request POST \
  --url https://api.spherepay.co/v2/customer/{id}/face-verification-link \
  --header 'Authorization: Bearer <token>'
{
  "url": "https://in.sumsub.com/websdk/p/sbx_uq30ag1ov7oHZhmx",
  "expiresAt": "2026-03-09T20:46:31.305Z"
}
Generate a Sumsub face liveness verification link for an individual customer. This endpoint is part of the Sphere-Managed KYC onboarding model, where SpherePay hosts the liveness check experience. After calling this endpoint, redirect your customer to the returned url so they can complete the face liveness check in their browser. The link expires at the time indicated by expiresAt — generate a new one if it has expired before the customer completes verification.
This endpoint is only required in the Sphere-Managed onboarding model. If you are using the Platform-Managed model, upload a liveness report document directly via the document upload endpoint instead.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Customer ID

Example:

"customer_f31121c389624d3697cbf3ea8830b7a4"

Response

​
url
string
required

Hosted face verification URL

Example:

"https://in.sumsub.com/websdk/p/sbx_uq30ag1ov7oHZhmx"

​
expiresAt
string
required

ISO 8601 formatted date and time of the face verification URL expiration

Example:

"2026-03-09T20:46:31.305Z"

Last modified on June 18, 2026