1. Firmas Transaccionales
Firmasegura
  • Inicio
    • Introducción
    • Autenticación
  • Firmas Regulares
    • Firmas Regulares
    • Registrar solicitud
      POST
    • Consulta de estado de solicitud
      GET
    • Corrección de código dactilar y/o adjuntos
      PATCH
    • Schemas
      • SignatureReportItem
      • RequestTimesReportItem
      • RequestResult
      • RequestStatusValidation
      • RevocationRequest
  • Firmas Transaccionales
    • Firmas Transaccionales
    • Eventos webhook
    • Registrar solicitud
      POST
    • Consulta estado de validación
      GET
    • Obtención de certificado y resultados
      GET
    • Schemas
      • TransactionalSignatureValidationStatus
      • TransactionalSignatureProcessResult
  • Tercero Vinculado
    • Tercero Vinculado
    • Eventos webhook
    • Info
      • Evidencias de Tercero Vinculado
    • Registrar solicitud
      POST
    • Reintentar proceso de generación
      POST
    • Cancelación de solicitud
      POST
    • Reenviar correo para reclamar certificado
      POST
    • Consultar estado de solicitud
      GET
    • Reenviar correo del certificado
      POST
    • Obtener certificado .p12 y contraseña
      GET
    • Schemas
      • LinkedPartnerReportItem
      • LinkedPartnerTransactionalResult
      • LinkedPartnerRequest
      • ErrorResponse
      • LinkedPartnerResult
      • linkedPartnerRequest
      • RAIZ
  • Registro Civil
    • Registrar cédula de prueba
      POST
    • Schemas
      • TestDataMultipartRequest
      • TestDataDocumentRequest
      • TestDataDocumentResponse
      • ProblemDetail
      • GatewayErrorResponse
  • Flujo simplificado
    • Introducción
    • Eventos Webhook
    • Registrar solicitud
    • Consultar estado
    • Cancelar solicitud
  • Flujo por API
    • Flujo Por API
    • Consulta de TyC
    • Solicitud de Firma
    • Validación de Identidad
    • Solicitud de FaceLiveness
    • FaceLiveness
    • Emisión
    • Schemas
      • ApiError
  • Recursos Adicionales
    • Lista de ciudades y provincias
    • Lista de periodos de firmas
    • Lista de estados de revocación
    • Lista de estados de solicitud FR
    • Lista de tipos de solicitud FR
    • Estados de validación de solicitudes FR
    • Tipos de validación de solicitudes FR
    • Códigos de error de validación FR
    • Lista de razones de cancelación automática FR
    • Lista de estados de solicitud FT
    • Lista de estados de validacion FT
    • Lista de tipos de validación FT
    • Lista de tipos de Certificado TV
    • Lista de estados de solicitud TV
    • Tipo de Evidencias TV
    • Lista de Estados/Etapas de Sesión de FS
    • Tipos de Solicitudes
  • Flujo POS
    • Flujo POS
    • Flujo POS
      • Vigencias que el aliado puede vender
      • Cobrar y emitir un cupón
    • Schemas
      • VoucherResponse
      • ProductResponse
      • GatewayError
      • CreatePosPurchaseRequest
      • ApiValidationError
      • ApiProblem
  1. Firmas Transaccionales

Registrar solicitud

POST
https://api.dev-firmaseguraec.com/collector/transactional-signature/request
Última modificación:2026-10-27 17:25:53
Endpoint para el registro de una solicitud de firma transaccional con la información del solicitante requerida.

Términos y condiciones#

El campo termsAndConditionsId pasará a ser obligatorio.
Antes de registrar la solicitud se debe consultar GET /collector/terms-and-conditions/transactional-signature (permiso read:collector:terms_and_conditions), que devuelve la versión vigente de los términos y condiciones de firma transaccional. Se debe mostrar su contenido (content, en HTML) al solicitante y, una vez aceptado, enviar su id en el campo termsAndConditionsId.
Se recomienda consultar el endpoint en cada solicitud y no almacenar el id: al publicarse una nueva versión, la anterior deja de estar vigente.
Si el campo no cumple, la solicitud se rechaza con 412 Precondition Failed:
CasoMensaje
No se envía termsAndConditionsIdNo se aceptaron los términos y condiciones
El identificador no existeEl ID de términos y condiciones no existe en la base de datos
El identificador corresponde a otro tipo de firmaLos términos y condiciones no corresponden al tipo de solicitud
La versión ya no está vigenteLa versión de términos y condiciones ya no está vigente

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros del Body application/jsonRequerido

Ejemplos

Respuestas

🟢200Éxito
application/json
Respuesta en caso de crearse la solicitud exitosamente
Bodyapplication/json

🟠409Conflict
🟠412Precondición fallida
🟠400Solicitud incorrecta
🔴500Error interno del servidor
Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location 'https://api.dev-firmaseguraec.com/collector/transactional-signature/request' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "referenceTransaction": "firma-001",
    "identificationNumber": "1700000000",
    "fingerCode": "E4333V2422",
    "email": "john.doe@yahoo.com",
    "city": "QUITO",
    "address": "Villaflora, calle ficticia S5-100 y calle 2",
    "cellphoneNumber": "+593998765432",
    "callbackUrl": "http://callback.url",
    "termsAndConditionsId": "8d1e4b7c-2f3a-4a9e-b6c5-1e0d9f8a7b24",
    "validationLinkLifetime": "30"
}'
Respuesta Ejemplo de Respuesta
200 - Registro de solicitud
{
    "transactionalSignatureRequestId": "faad343e-e09d-4969-bbef-6fa877e0d9c8",
    "referenceTransaction": "firma-001",
    "registrationDate": "2025-02-06 12:00:00",
    "linkExpirationDate": "2025-02-06 12:30:00",
    "validationLink": "https://validation.dev-firmaseguraec.com/transactional-signature/faad343e-e09d-4969-bbef-6fa877e0d9c8"
}
Modificado en 2026-10-27 17:25:53
Anterior
Eventos webhook
Siguiente
Consulta estado de validación
Built with