Pular para o conteúdo 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"
}
Depois que um cliente tiver concluído todas as etapas de verificação de pré-requisito, chame este endpoint para gerar um link KYC e submetê-lo para revisão. Os links KYC são destinados principalmente a clientes empresariais — o SpherePay recomenda concluir o KYC individual diretamente através da API. A resposta retorna uma URL com tempo limitado para a qual você redireciona o cliente para quaisquer verificações de identidade restantes tratadas pelo provedor de verificação.
Antes de chamar este endpoint, certifique-se de que o cliente concluiu todas as etapas listadas no array required do seu objeto verificationProfiles[].criteria. Submeter um cliente com critérios pendentes resultará em um erro.

Autorizações

​
Authorization
string
header
obrigatório

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

Parâmetros de caminho

​
id
string
obrigatório

Customer ID

Exemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

Resposta

​
url
string
obrigatório

Hosted KYC URL

Exemplo:

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

​
expiresAt
string
obrigatório

ISO 8601 formatted date and time of the KYC URL expiration

Exemplo:

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

Última modificação em 18 de junho de 2026