Effortless customer verification now available   View changelog
Sphere Paysphere
Onboarding

Face Verification Link

Generates a face verification link for a customer.

POST
/v2/customer/{customer_id}/face-verification-link
AuthorizationBearer <token>

JWT Bearer token authentication

In: header

Path Parameters

customer_idstring

The customer's unique ID generated by SpherePay upon customer creation.

Match^customer_[a-z0-9]+$

Response Body

curl -X POST "https://api.sandbox.spherepay.co/v2/customer/customer_1ab2c3d4/face-verification-link"

{
  "url": "https://sumsub.com/websdk/p/sbx_12345678-abcd-efgh-ijkl-123456789012",
  "expiresAt": "2025-05-23T23:59:59Z"
}

{
  "ts": "2025-04-20T00:09:16.870Z",
  "error": {
    "information": [
      "Required"
    ]
  }
}

{
  "ts": "2025-04-20T00:09:16.870Z",
  "error": {
    "general": "{{information}} Not Found"
  }
}