Skip to main content
POST
Pedir un código OTP

Autorizaciones

Authorization
string
header
requerido

JWT de sesión (de register/login) o llave de API (pk_...). X-API-Key: <token> se acepta como header alternativo.

Cuerpo

application/json
action
enum<string>
requerido
Opciones disponibles:
login,
payout,
crypto_withdrawal,
transfer,
banking_operation,
card_reveal,
api_key_create,
member_add,
phone_change
channel
enum<string>

Canal de envío opcional. Si se omite, el servidor lo resuelve desde las preferencias OTP del miembro, con el default de la org como respaldo. El valor se normaliza sin importar mayúsculas.

Opciones disponibles:
sms,
whatsapp,
email,
totp

Respuesta

Desafío creado; el código va en camino. El channel resuelto y su destino enmascarado (phone) llegan en el cuerpo.

challenge_id
string<uuid>
account_id
string<uuid>
action
enum<string>
Opciones disponibles:
login,
payout,
crypto_withdrawal,
transfer,
banking_operation,
card_reveal,
api_key_create,
member_add,
phone_change
channel
enum<string>
Opciones disponibles:
sms,
whatsapp,
email,
totp
phone
string

Destino enmascarado al que viajó el código (teléfono o email), o authenticator_app para TOTP.

status
enum<string>
Opciones disponibles:
pending,
verified,
consumed,
expired
created_at
string<date-time>
expires_at
string<date-time>
verified_at
string<date-time>
consumed_at
string<date-time>