Starknet: USDC On/OffRamp live.   Details →
Sphere Paysphere
Customer

Create KYC Link

POST
/v2/customer/{customer_id}/kyc-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]+$
typestring

The customer type of either individual or business.

Value in"individual" | "business"
firstNamestring

The first name of the customer.

lastNamestring

The last name of the customer.

emailstring

The email of the customer.

Formatemail

Response Body

curl -X POST "https://api.sandbox.spherepay.co/v2/customer/customer_1ab2c3d4/kyc-link" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "individual",
    "firstName": "Jane",
    "lastName": "Doe",
    "email": "janedoe123@gmail.com"
  }'

{
  "url": "https://in.sumsub.com/websdk/p/sbx_gq9t7z0Zf6agMcbn",
  "expiresAt": "2025-04-27T02:35:18.842Z"
}

{
  "ts": "2025-04-20T02:38:08.659Z",
  "error": {
    "general": "Bad Request Exception"
  }
}

{
  "ts": "2025-04-20T02:37:05.790Z",
  "error": {
    "general": "Customer not found"
  }
}