Saltar al contenido principal
Create KYC Link
curl --request POST \
  --url https://api.spherepay.co/v2/customer/{id}/kyc-link \
  --header 'Authorization: Bearer <token>'
{
  "url": "https://in.sumsub.com/websdk/p/sbx_uq30ag1ov7oHZhmx",
  "expiresAt": "2026-03-09T21:46:31.305Z"
}
Una vez que un cliente ha satisfecho todos los pasos de verificación previos requeridos, llama a este endpoint para generar un link KYC y enviarlo para revisión. Los links KYC están destinados principalmente a clientes empresariales — SpherePay recomienda completar el KYC individual directamente a través de la API. La respuesta devuelve una URL con tiempo limitado a la que rediriges al cliente para cualquier verificación de identidad restante manejada por el proveedor de verificación.
Antes de llamar a este endpoint, asegúrate de que el cliente ha completado todos los pasos listados en el array required de su objeto verificationProfiles[].criteria. Enviar un cliente con criterios pendientes resultará en un error.

Autorizaciones

​
Authorization
string
header
requerido

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

Parámetros de ruta

​
id
string
requerido

Customer ID

Ejemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

Respuesta

​
url
string
requerido

Hosted KYC URL

Ejemplo:

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

​
expiresAt
string
requerido

ISO 8601 formatted date and time of the KYC URL expiration

Ejemplo:

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

Última modificación el 18 de junio de 2026