Esta sección responde las preguntas más comunes que surgen al integrar y operar la API de QRwey! en entornos reales de venta, facturación y confirmación de pagos.
Un QR en QRwey! representa una referencia segura a una transacción para un intento de autofactura, no contiene información sensible directamente.
El QR incluye:
- Un token opaco (
t) - Una firma HMAC (
m) - Una versión de formato (
v)
Todos los datos reales se obtienen únicamente al resolver el QR vía API.
Consulta: Cómo funciona QRwey!
Depende de la configuración del comercio:
- Multiuso: el QR puede resolverse varias veces antes de expirar
- Un solo uso: el QR se invalida después de la primera resolución
Si un QR ya fue consumido, la API responderá con 409 Conflict.
Consulta: Expiración & Reuse de Tokens
Una vez alcanzada la fecha expires_at:
- El QR ya no puede resolverse
- La API responde con 410 Gone
- Debes generar un nuevo QR
La expiración no puede extenderse.
Consulta: Ciclo de vida del QR & Seguridad
NO.
El header Idempotency-Key es obligatorio al crear un QR. Esto evita transacciones duplicadas en escenarios de reintentos.
Consulta: Idempotencia & Reintentos
409 Conflict: el QR ya fue consumido
→ Continúa el flujo como QR inválido410 Gone: el QR expiró
→ Genera un nuevo QR
Estos errores no deben reintentarse.
Consulta: Manejo de errores
Sí, siempre que:
- El QR esté dentro de su ventana de expiración
- El detalle de la transacción se valide vía API
- No confíes en el contenido del QR sin resolverlo
El QR por sí solo NO expone datos sensibles.
La API Key debe usarse solo en backend.
No debe:
- Exponerse en frontend
- Incluirse en aplicaciones móviles
- Compartirse entre sistemas sin control
Consulta: Autenticación
No es recomendable.
El ambiente de producción debe usarse SOLO con datos reales. Para pruebas, utiliza los ambientes de desarrollo o testing configurados para ese fin.
Consulta: Uso responsable
QRwey utiliza códigos de moneda ISO 4217. En México, el valor típico es:
MXN
Revisa el contrato completo en la Referencia del API.
SI.
QRwey! te permite crear intenciones de autofacturación, para que el cliente final se pueda autofacturar (timbrar XML, generar PDF) usando la apps iOS y Android de QRwey!. Si bien el timbrado y la generación del CFDi ocurre en QRwey!, es recomendable que a través de WebHooks actualizes la base de datos en tus sistemas para que almacenes el XML timbrado.
QRwey!:
- Crea intenciones de autofactura mediante QRs
- Genera QRs seguros
- Permite consultar el QR
- Realiza el timbrado una vez que el cliente final acepta con un clic la autofactura
- Disponibiliza portales de consulta y ligas de autofactura para cada RFC que genere dichos QRs
En la Referencia del API, generado directamente desde el OpenAPI oficial:
Recomendamos este orden: