Kuenta Docs

Appearance

Reenviar OTP de asistencia​

POST
/entities/{entityid}/assistances/{assistanceid}/otp

Reenvía el código TOTP al cliente por el canal especificado.

Funcionalidad:

  • Genera un nuevo código TOTP para la solicitud
  • Envía el código por el canal especificado (sms/email/voice)
  • Registra el envío en los logs de auditoría
  • Respeta los períodos de cooldown configurados

Canales disponibles:

  • sms: Envío por mensaje de texto
  • email: Envío por correo electrónico
  • voice: Envío por llamada de voz

Restricciones:

  • La solicitud debe estar en estado sent o pending
  • No debe haber violaciones de cooldown
  • El canal debe estar disponible para la entidad

Authorizations​

test

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://test-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
stage

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://stage-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
demo

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://demo-api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones
or
prod

OAuth 2.0 Client Credentials Grant (RFC 6749 §4.4).
Utilice este flow para autenticación de aplicación-a-aplicación sin intervención del usuario.
Ideal para servicios backend y integración entre sistemas.

clientCredentials Flow
Token URLhttps://api.kuenta.co/v1/oauth/token
Scopes:
  • *Acceso completo (administrador)
  • users:readLectura de usuarios
  • users:writeEscritura de usuarios
  • users.info:writeEscritura de información de usuarios
  • clients:readLectura de clientes OAuth
  • clients:writeEscritura de clientes OAuth
  • verifications:writeEscritura de verificaciones
  • passwords:writeEscritura de contraseñas
  • keys:readLectura de claves
  • settings:readLectura de configuraciones
  • settings:writeEscritura de configuraciones

Parameters​

Path Parameters

entityid*

ID de la entidad objetivo

Typestring
Required
Example123e4567-e89b-12d3-a456-426614174000
formatuuid
assistanceid*

ID de la solicitud de asistencia

Typestring
Required
ExampleASST1757606617468264000

Request Body​

application/json
JSON
{
"channel": "string"
}

Responses​

OTP reenviado con información detallada del envío
application/json
JSON
{
"status": "success",
"data": {
"otpLog": {
"id": "763b7ece-b4ae-4f1e-ba2e-b6ed450e99fa",
"channel": "sms",
"sentAt": "2025-09-22T14:00:00Z",
"deliveryStatus": "sent",
"attemptNumber": 2,
"isCooldownViolation": false,
"cooldownRemaining": 0,
"processingTimeMs": 1250,
"maskedPhone": "+57***1234"
}
}
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI