La API de QRwey! permite a los comercios generar códigos QR seguros y de vida corta que representan una intención para autofacturarse.
Estos códigos QR están diseñados para ser escaneados por la aplicación móvil de QRwey!, donde el cliente puede consultar los detalles de la operación y continuar con su proceso de autofactura.
El flujo típico de uso de QRwey! es el siguiente:
- Se registra una intención de autofactura usando la API de QRwey!
- QRwey! genera un token opaco, único y no predecible
- El token se firma usando HMAC-SHA256 para garantizar su integridad
- El token firmado se codifica dentro de un código QR
- El cliente final escanea con la app de QRwey! el QR para autofacturarse
- La app resuelve el QR y obtiene los detalles de la transacción
- El cliente final confirma con que RFC desea autofacturarse y con un clic se autofactura
El código QR no contiene información sensible directamente, solo una referencia segura a la transacción.
QRwey! utiliza tokens opacos como identificadores de las transacciones.
Esto significa que:
- No contienen información legible
- No siguen una secuencia
- No pueden ser adivinados o enumerados
Cada token es válido únicamente dentro de las reglas definidas al momento de su creación.
Para evitar que un QR sea manipulado, QRwey! protege cada token con una firma:
- Algoritmo: HMAC-SHA256
- Firma truncada para uso eficiente en URLs
- Validación obligatoria en cada resolución de QR
Si el token o la firma no coinciden, la transacción es rechazada.
Todos los códigos QR generados por QRwey! tienen una fecha de expiración explícita:
- La expiración se define usando el campo
expires_at - Una vez vencido, el QR ya no puede resolverse
- La validación de expiración es del lado de los servidores de QRwey!
Esto evita el uso indebido de QRs antiguos o reutilizados.
QRwey! es ideal para escenarios como:
- Estaciones de servicio (ventas de combustible)
- Sistemas y terminales de venta
- Flujos de facturación electrónica
- Confirmación de pagos posteriores a la venta
- Restaurantes, Cafeterías o venta al público para integrar en el ticket nuestros códigos QR
En todos estos casos, ¡olvidate de crear portales de autofactura!
Ahora que conoces el funcionamiento general, continúa con: