Verificar un Código OTP del Cliente para Correo o Teléfono

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"
}

Verifica un código OTP que fue enviado previamente al correo electrónico o número de teléfono de un cliente vía el endpoint Enviar Código de Verificación. Una respuesta exitosa confirma que el cliente controla el canal de contacto especificado y avanza sus criterios de verificación KYC. Si el código ha expirado o es incorrecto, envía un nuevo código y solicita al cliente que intente de nuevo.

Autorizaciones

Authorization

string

header

requerido

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

Parámetros de ruta

string

requerido

Customer ID

Ejemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

Cuerpo

application/json

type

enum<string>

requerido

Type of verification code

Opciones disponibles:

phone,

email

Ejemplo:

"email"

code

string

requerido

Verification code

Required string length: 1 - 10

Ejemplo:

"123456"

Respuesta

customerId

string

requerido

Customer ID

Ejemplo:

"customer_f31121c389624d3697cbf3ea8830b7a4"

verifiedAt

string

requerido

ISO 8601 formatted date and time of the verification code verification

Ejemplo:

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

Última modificación el 18 de junio de 2026

Enviar Código de Verificación Aceptar Términos de Servicio

⌘I