Configurar el cobro con Redsys para el motor y las tentativas

Deja listo el TPV virtual Redsys para que el motor de reservas y los enlaces de cotización cobren solos, sin que recepción tenga que hacer nada. Para el responsable de administración o de sistemas del hotel.

Objetivo

Que el cliente pague (la estancia entera o una señal) al terminar su reserva en el motor, y que la reserva quede confirmada sola.

Antes de empezar

• Pide al banco un TPV virtual Redsys con lo siguiente:
  • Número de comercio (FUC) y terminal. Si además vas a cobrar plazos después de la reserva (MOTO), pide dos terminales: uno con autenticación 3DS para el motor y otro MOTO.
  • Clave de firma SHA-256, la de pruebas y la de real.
  • Nombre comercial (25 caracteres como mucho) y descripción.
  • Divisa euro (978).
  • Autorización (operación 0) con EMV3DS 2.
  • Notificación online por HTTP POST a https://<tu dominio>/payment/redsys/return, y que envíe los parámetros en las URL de OK y KO.
  • Devoluciones (operación 3), también parciales.
  • Consulta de operaciones (servicio SOAP consultaOperaciones): Astro HMS la usa para comprobar los pagos que se quedan a medias.
  • Si cobras plazos después: operativa MOTO por REST con número de tarjeta y sin CVV obligatorio. El banco puede pedirte el certificado PCI DSS de Astro HMS: pídeselo a soporte.
  • Si haces fianzas: preautorización, confirmación y anulación (operaciones 1, 2 y 9) y cuántos días dura la preautorización.
  • Opcional: Bizum y tarjetas de prueba.
• No hace falta pedir tokenización, «pago por referencia», exenciones SCA ni InSite: Astro HMS no los usa.
• Tu web tiene que ir por https, y el motor de reservas tiene que estar asociado a tu hotel (guía «Configurar y usar el motor de reservas»).
• Permisos: gestor de contabilidad o administrador. La clave secreta solo la ve el administrador.

Conceptos clave

• Redirección a Redsys: el cliente paga en la página del banco, con la autenticación de su banco. Es el modo recomendado.
• Pago directo (API Redsys): el cliente escribe la tarjeta en una página del hotel. Hoy no lo uses: elige siempre Redirección a Redsys.
• Entorno de pruebas: cualquier estado que no sea Habilitado cobra en el entorno de pruebas del banco, no de verdad.

Paso a paso

1. Ve a Facturación › Configuración › Pagos en línea › Proveedores de pago y abre Redsys.
2. En la pestaña de credenciales, rellena los datos del banco: Nombre del comerciante (25 caracteres como mucho), Código de comerciante (el FUC), Descripción del producto, Clave secreta, Terminal y Divisa - Redsys (978, el euro).
3. Deja el Tipo de transacción en 0 (autorización). Con otro valor, el cobro se queda a medias o no se hace.
4. En Modo de operación Redsys, elige Redirección a Redsys.
5. En Idioma del consumidor del comerciante, elige el idioma de la página de pago (Castellano, por defecto).
6. Cambia el Estado a Modo de prueba y haz una reserva de prueba en tu motor con una tarjeta de prueba del banco.
7. Si todo va bien, cambia el Estado a Habilitado y marca Publicado.
8. Comprueba que el proveedor es de la misma empresa que tu hotel.
9. Si tienes más de un proveedor de pago, ve a Sitio web › Configuración › Ajustes, bloque Motor de reservas, y pon redsys en Proveedor de pago preferido.

Resultado esperado

Al terminar una reserva en el motor (o desde un enlace de cotización), el cliente va a la página de pago de su banco, paga y vuelve a tu web con la reserva confirmada. En Facturación › Pagos ves el cobro.

Ten en cuenta

• Lo que se cobra (la estancia entera, una señal o nada) no se configura aquí, sino en las condiciones de pago de cada tarifa (guía «Configurar las condiciones de pago…»).
• Si tu web pasa por un cortafuegos (WAF), tiene que dejar pasar las notificaciones de Redsys a /payment/redsys/return.
• Dos tareas automáticas tienen que estar activas (vienen activas): Expire stale tentatives y Reconcile pending payments.