Effortless customer verification now available   View changelog →
Sphere Paysphere
Onboarding

Create KYC Link

Create a KYC link for a business customer. KYC links should only be used for businesses. For individual customers, it is recommended to use the API directly without going through the KYC link.

POST
/v2/customer/{id}/kyc-link

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idstring

Customer ID

Response Body

curl -X POST "https://api.spherepay.co/v2/customer/customer_66c4168d418a410eae282b83883bdc39/kyc-link"
{
  "url": "https://in.sumsub.com/websdk/p/sbx_uq30ag1ov7oHZhmx",
  "expiresAt": "2025-11-21T07:10:54.598Z"
}

{
  "status": 400,
  "detail": "Invalid request parameters",
  "code": "address/invalid",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 404,
  "detail": "Resource not found",
  "code": "resource/not-found",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c"
}

{
  "status": 422,
  "detail": "Validation failed",
  "code": "validation/failed",
  "correlationId": "28c61e885c6e5eaa78c1a2183a9b883c",
  "errors": [
    {
      "detail": "Invalid email format",
      "pointer": "/email"
    },
    {
      "detail": "Name is required",
      "pointer": "/name"
    }
  ]
}