Kuenta Docs

Appearance

Actualizar firma TOTP con códigos de verificación​

PUT
/document/{document-id}/signature-totp/{signature-id}

Actualiza una solicitud de firma TOTP existente con los códigos de verificación recibidos por SMS o email.

Proceso de Verificación:

  1. El usuario recibe códigos TOTP por SMS/email
  2. Ingresa los códigos en la aplicación
  3. El sistema valida los códigos contra los generados
  4. Se completa la firma si la validación es exitosa

Validaciones de Seguridad:

  • Verificación de códigos temporales (180 segundos de validez)
  • Registro de contexto HTTP completo
  • Validación de identidad del firmante
  • Control de intentos de verificación

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

Parameters​

Path Parameters

document-id*

Identificador único del documento

Typestring
Required
Examplef47ac10b-58cc-4372-a567-0e02b2c3d479
formatuuid
signature-id*

Identificador único de la firma TOTP

Typestring
Required
Examplea1b2c3d4-e5f6-7890-abcd-ef1234567890
formatuuid

Request Body​

application/json
JSON
{
"code": "123456",
"emailCode": "789012",
"smsCode": "345678"
}

Responses​

Firma TOTP actualizada exitosamente
application/json
JSON
{
"status": "success",
"data": {
"signatureTOTP": {
"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"status": 3,
"verified": true,
"verifiedAt": "2024-01-15T10:35:00Z"
}
}
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI