Cobrar con QR

Crea el pago y usa payment.checkout.url para generar el código QR. Puedes usar la herramienta de QR de tu aplicación. El código debe contener esa URL tal como la recibiste, sin añadir claves ni datos de tarjeta.

El cliente escanea el QR y paga en el Checkout de Timbro. Tu servidor debe consultar el pago para confirmar el pago; puedes hacerlo cuando recibas un webhook.

Genera un QR para cada pago. Quien tenga el link puede abrir Checkout y ver el recibo, así que compártelo solo con el cliente o las personas que deban verlo.

Define cuánto tiempo queda abierto el QR

Envía expiresAfterSeconds al crear el pago para fijar cuántos segundos queda abierto el Checkout. Acepta de 300 (5 minutos) a 86400 (24 horas). Un sistema de caja que muestra el QR suele necesitar un plazo corto: envía expiresAfterSeconds: 600 para dar 10 minutos.

Si lo omites, el plazo es de 1800 segundos (30 minutos) cuando envías returnUrl y de 3600 segundos (1 hora) cuando no lo envías. Un QR que muestras en la caja normalmente no lleva returnUrl.

El pago informa el vencimiento en expiresAt, y checkout.expiresAt repite el mismo momento. Úsalos para decidir cuándo ofrecer un QR nuevo, sin calcular el plazo en tu sistema. Cuando quedan 15 minutos o menos, Checkout muestra al cliente el tiempo restante.

Si el QR abre el primer pago de una suscripción, ese pago vence a las 24 horas, no según el plazo normal de 30 o 60 minutos. Al vencer, la suscripción termina; crea otra con una subscriptionReference nueva si el cliente quiere comenzar de nuevo. Un pago de renovación puede tener expiresAt y checkout.expiresAt en null mientras el link siga abierto. Timbro fija un plazo de 7 días cuando el proveedor de email acepta el envío del aviso de pago pendiente. No muestres una cuenta regresiva mientras la fecha sea null; reenviar el aviso no extiende una fecha ya fijada.

Si el cliente no puede continuar

Consulta el estado del pago antes de volver a mostrar el QR. Si todavía permite continuar, muestra la misma URL. Si venció o se canceló, el mismo pago no se reabre: necesitas crear otro pago con una referencia nueva, después de confirmar qué pasó con el anterior.

NFC

El uso de NFC requiere pruebas y aprobación para el dispositivo y la afiliación del comercio. Timbro todavía no ofrece una integración general con terminales NFC. Revisa la disponibilidad antes de ofrecer esta opción.