Preguntas frecuentes

¿Mi tienda maneja datos de tarjeta?

No. El checkout no tiene campos de número, fecha ni código de seguridad: la tarjeta se lee en un terminal físico del comercio, y a tu página solo vuelve el número enmascarado del recibo. Las claves de pago móvil van del navegador del cliente al banco a través de FINORA y no se guardan. Lo que sí debes proteger es tu clave API y tu secreto de webhook. Cuánto exige tu adquirente en materia de seguridad para tu caso lo define él; pregúntale.

¿Qué hago con un pago EN_DUDA?

No entregues el pedido y no abras otra sesión para él. El banco no confirmó y el cobro pudo haber ocurrido. FINORA lo averigua y te manda un segundo aviso con APROBADA o RECHAZADA para la misma sesión. Si quieres saberlo antes, consulta la sesión.

¿Cuánto dura una sesión?

15 minutos si no dices otra cosa. Puedes fijar entre 60 y 3600 segundos con ttlSegundos. El cliente ve la cuenta regresiva. Si el tiempo se acaba con un cobro en vuelo, por ejemplo con el terminal ya leyendo la tarjeta, la operación termina igual y la sesión cierra con su veredicto real, no como EXPIRADA.

El banco rechazó. ¿Puede el cliente probar con otra tarjeta?

Sí, dentro de la misma sesión, mientras no venza. Cada rechazo te llega como aviso informativo (checkout.intento.rechazado); el cierre llega con checkout.sesion. Detalle en Los estados de una sesión.

¿Por qué no aparece la tarjeta?

Porque la sesión no tiene terminalId, o el terminal no está registrado en tu comercio. La tarjeta se cobra en un terminal físico: sin terminal no hay dónde. Pásalo al crear la sesión.

¿Puedo ofrecer solo algunos medios?

Los medios disponibles los define la configuración de tu comercio en FINORA, no tu página. Quien administra el comercio puede activarlos o apagarlos desde el Portal del comercio. Los que no aplican a un pedido se ven atenuados con el motivo, y el efectivo nunca aparece en la web.

El cliente cerró la pestaña a mitad del pago

Si vuelve a abrir el mismo enlace, el checkout retoma donde estaba: si hay un cobro en vuelo, muestra la espera; si ya terminó, muestra el resultado. El aviso a tu servidor llega igual, con o sin pestaña abierta.

¿Puedo confiar en onResultado para entregar el pedido?

No. Es código que corre en el navegador del cliente y se puede alterar. Entrega con el aviso firmado o consultando la sesión con tu clave.

¿El componente carga algo de terceros?

No. Ni fuentes, ni imágenes, ni scripts: es un solo archivo sin dependencias que solo habla con la URL que le pasas en base-url.

¿Funciona en un kiosco o una tableta?

Sí. Con pantalla táctil aparece un teclado numérico propio para cédula, teléfono y clave. Para una experiencia pensada para el dedo, usa el modo inmersivo.

¿Cómo pruebo sin dinero real?

Crea la sesión con "sandbox": true. Los céntimos del monto deciden el veredicto: Prueba cada veredicto en sandbox.