Kuenta Docs

Appearance

Crear solicitud de firma SMS/Email para documento​

POST
/document/{document-id}/signature-sms-email

Crea una nueva solicitud de firma utilizando códigos hash enviados por SMS y email.

Diferencia con TOTP:

  • Utiliza códigos hash en lugar de códigos temporales
  • Envío simultáneo por SMS y email
  • Validación mediante hash de seguridad

Flujo del Proceso:

  1. El sistema genera códigos hash únicos
  2. Se envían códigos por SMS y email simultáneamente
  3. El firmante debe validar ambos códigos
  4. Se completa la firma tras validación exitosa

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 a firmar

Typestring
Required
Examplef47ac10b-58cc-4372-a567-0e02b2c3d479
formatuuid

Request Body​

application/json
JSON
{
"firstName": "Laura",
"lastName": "Pérez Martínez",
"phone": "+573001234567",
"email": "[email protected]"
}

Responses​

Solicitud de firma SMS/Email creada exitosamente
application/json
JSON
{
"status": "success",
"data": {
"signatureSMSEmail": {
"id": "b2c3d4e5-f607-8901-bcde-f23456789012",
"status": 1,
"signatureMethod": "phone-email",
"verified": false
}
}
}

Playground​

Server
Authorization
Variables
Key
Value
Body

Samples​

Powered by VitePress OpenAPI