1. Flujo POS
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
    • 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. Flujo POS

Flujo POS

API para vender firmas electrónicas desde el punto de venta del aliado. El aliado cobra en su terminal y emite un cupón; el titular recibe por SMS un enlace, lo canjea con sus datos y en ese momento se origina su firma electrónica a nombre del aliado, por el flujo simplificado.

¿A quién está dirigido?#

Aliados con puntos de venta que cobran la firma en caja y dejan que el titular complete su solicitud después, desde su celular.

Orden de los Endpoints#

1.
GET Vigencias que el aliado puede vender: las vigencias que el aliado puede cobrar.
2.
POST Cobrar y emitir un cupón: registra la venta y envía el enlace de canje al titular.

Requisitos#

Token de acceso del aliado (ver Autenticación).
Permisos read:signature:pos_products y write:signature:pos_purchase. Para que el canje pueda originar la firma, además write:signature:request y read:signature:session_tracking: la firma se origina con el token del aliado.
Vigencias habilitadas por FirmaSeguraEC para el canal punto de venta.

Consideraciones#

El cupón es de un solo uso y vence en expiresAt: 24 horas por defecto.
Quien tenga el enlace puede canjear el cupón: trátelo como un comprobante de pago.
Envíe externalReference para reintentar sin duplicar la venta: si se repite, se devuelve el mismo cupón.
voucherUid identifica el cupón, y la solicitud de firma que nace del canje lo lleva como referenceTransaction.
Por ahora el aliado no recibe una notificación cuando el titular canjea el cupón ni cuando se emite la firma.

Para habilitar la venta por punto de venta, contactar a: requerimientos@firmaseguraec.com
Modificado en 2026-10-06 21:08:40
Anterior
Tipos de Solicitudes
Siguiente
Vigencias que el aliado puede vender
Built with