Verificar Código OTP do Cliente para E-mail ou Telefone

Verify Verification Code

curl --request POST \
  --url https://api.spherepay.co/v2/customer/{id}/otp-verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email",
  "code": "123456"
}
'

{
  "customerId": "customer_f31121c389624d3697cbf3ea8830b7a4",
  "verifiedAt": "2026-03-09T20:46:31.305Z"
}

Verify Verification Code

curl --request POST \
  --url https://api.spherepay.co/v2/customer/{id}/otp-verify \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "type": "email",
  "code": "123456"
}
'

{
  "customerId": "customer_f31121c389624d3697cbf3ea8830b7a4",
  "verifiedAt": "2026-03-09T20:46:31.305Z"
}

Verifique um código OTP que foi previamente enviado ao endereço de e-mail ou número de telefone de um cliente pelo endpoint Enviar Código de Verificação. Uma resposta bem-sucedida confirma que o cliente controla o canal de contato especificado e avança seus critérios de verificação KYC. Se o código estiver expirado ou incorreto, envie um novo código e solicite que o cliente tente novamente.

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

string

obrigatório

Customer ID

Exemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

Corpo

application/json

type

enum<string>

obrigatório

Type of verification code

Opções disponíveis:

phone,

email

Exemplo:

"email"

code

string

obrigatório

Verification code

Required string length: 1 - 10

Exemplo:

"123456"

Resposta

customerId

string

obrigatório

Customer ID

Exemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

verifiedAt

string

obrigatório

ISO 8601 formatted date and time of the verification code verification

Exemplo:

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

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

Enviar Código de Verificação Aceitar Termos de Serviço

⌘I