FINORA Checkout · Role path

Desarrollador de comercio electrónico

DocumentedIntermediate10 min

This content is not available in your language yet.

Quién eres

Programas o mantienes la tienda web de un comercio y te toca que los clientes paguen en línea. No tienes que saber de bancos ni de tarjetas: FINORA Checkout se encarga del cobro. Lo tuyo es abrir la sesión en tu servidor, mostrarle el pago al cliente y confirmar el pedido solo cuando llega el aviso firmado.

Lo que haces en el sistema

Creas una sesión de cobro por pedido, desde tu servidor y con la clave API del comercio.
Muestras el pago: página alojada, etiqueta o modal.
Verificas la firma de cada aviso antes de entregar.
Pruebas cada final en sandbox: aprobado, rechazado, en duda, vencido.
Cuadras los pedidos pagados contra las sesiones aprobadas.

Una regla lo resume: la clave se queda en tu servidor y el pedido se confirma con la firma, no con el navegador.

Tu ruta

Integra FINORA Checkout en 10 minutos10 min
Un pedido de prueba pagado de punta a punta, contra el banco simulado.
Cómo funciona una sesión de cobro8 min
La clave API, el token de cliente y el secreto del aviso: qué hace cada uno.
Los estados de una sesión8 min
Qué hace tu tienda con cada final, y por qué «en duda» no es un rechazo.
Crea una sesión de cobro5 min
Monto, referencia, tiempo de vida, terminal y datos del pagador.
Incrusta el checkout en tu página8 min
Página alojada, etiqueta o modal: elige según tu tienda.
Verifica la firma del aviso10 min
Node, Java o PHP, con el vector de prueba para comprobar tu código.
Prueba cada veredicto en sandbox10 min
Provoca cada final cambiando los céntimos del monto.
Consulta el estado real de una sesión5 min
Cuando el aviso no llegó, o para cuadrar el día.
Ponle los colores de tu marca5 min
Las variables --fc-* y los temas claro, oscuro y automático.
Crea la clave API de tu comercio5 min
Desde el Portal del comercio, con el alcance justo.
Captura de tarjeta en la web sin terminalHoja de ruta
Un campo de tarjeta alojado por FINORA, para cobrar con tarjeta sin un terminal físico.

Tu lista antes de salir a producción

Una vez, al integrar

La clave API y el secreto del aviso viven en variables de entorno del servidor, fuera del repositorio.
El navegador recibe solo sesionId y token, o la urlPago.
Tu endpoint de avisos verifica v1, rechaza firmas de más de 300 segundos y responde en menos de 10.
Un aviso repetido (mismo X-Finora-Entrega) no entrega dos veces.
Recorriste en sandbox los seis casos de la lista de comprobación.

Cada día

Revisa que no queden pedidos en espera por EN_DUDA más tiempo del normal; si los hay, consulta la sesión.

Cada mes

Cuadra las sesiones aprobadas contra los pedidos entregados.
Revisa las entregas de avisos fallidas en el Portal del comercio y reenvíalas si hace falta.

Lo que se mide de tu trabajo

Indicador	Qué quiere decir	Buena señal
Pedidos confirmados por aviso	Pedidos entregados con un aviso verificado, no por la vuelta del navegador	Todos
Avisos fallidos	Entregas que agotaron los reintentos	Ninguno, o reenviados el mismo día
Pedidos cobrados dos veces	Un mismo pedido con dos sesiones aprobadas	Ninguno
Diferencias al cuadrar	Sesiones aprobadas sin pedido entregado, o al revés	Cero

Errores frecuentes

Lo que pasa	Por qué	Qué hacer
La firma nunca coincide	Se firma el JSON ya interpretado, no el cuerpo crudo	Lee el cuerpo tal como llegó en la ruta del aviso
Pedidos entregados sin pago	Se confió en `?estado=APROBADA` o en `onResultado`	Entrega solo con el aviso verificado
Un cliente pagó dos veces	Ante `EN_DUDA` se abrió otra sesión	Espera el segundo aviso; nunca reintentes una duda
Se anuló un pedido que luego se pagó	Se trató `checkout.intento.rechazado` como final	El cierre llega solo con `checkout.sesion`
No aparece la tarjeta	La sesión no tiene `terminalId`	Pásalo al crear la sesión
La clave apareció en el código del navegador	La sesión se creaba desde el frontend	Muévela a tu servidor y genera una clave nueva

Tu rol en el sistema

No necesitas usuario en FINORA para programar: trabajas con la clave API y el secreto del aviso del comercio. Los genera quien tiene el permiso de claves en el Portal del comercio, normalmente el dueño o el administrador. Pídele una clave de pruebas para desarrollar y una distinta para producción.