Caso de uso
Configurar el cobro con Redsys para el motor y las tentativas
Cómo dejar listo el TPV virtual Redsys para que el motor de reservas y los enlaces de cotización cobren solos, y qué página ve el cliente cuando no hay pasarela.
Módulos
Autor
Miquel Romera Luis
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
- Ve a Facturación › Configuración › Pagos en línea › Proveedores de pago y abre Redsys.
- 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).
- Deja el Tipo de transacción en 0 (autorización). Con otro valor, el cobro se queda a medias o no se hace.
- En Modo de operación Redsys, elige Redirección a Redsys.
- En Idioma del consumidor del comerciante, elige el idioma de la página de pago (Castellano, por defecto).
- Cambia el Estado a Modo de prueba y guarda. En Modo de prueba el proveedor queda sin publicar: los visitantes de la web no lo ven (les sale «Pago no disponible»), pero tú sí, si tienes la sesión de Astro HMS abierta. Haz la reserva de prueba en tu motor desde el mismo navegador donde has entrado en Astro HMS (no en una ventana de incógnito), con una tarjeta de prueba del banco.
- Si todo va bien, pon la clave y los datos de real que te da el banco y cambia el Estado a Habilitado: al hacerlo se publica solo. Comprueba entonces con una ventana de incógnito que el motor ya lleva a la página del banco.
- Comprueba que el proveedor es de la misma empresa que tu hotel.
- Si la empresa tiene más de un proveedor de pago (por ejemplo, un Redsys por hotel), elige el de cada hotel en PMS › Configuración › Marcas, pestaña Booking engine, campo Proveedor de pago del motor. Cobra las reservas, las cotizaciones y las tarjetas regalo de esa marca. Si se queda vacío, el motor usa el Proveedor de pago preferido de Sitio web › Configuración › Ajustes o, si no, el primero de la empresa, que puede ser el de otro hotel: la ficha de la marca lo avisa. El campo solo lo ven los administradores.
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
Importante: si el Estado no es Habilitado, el motor cobra en el entorno de pruebas: el cliente cree que ha pagado y no te llega el dinero.
Importante: el proveedor tiene que estar Publicado para que lo vean los clientes: se publica solo al pasarlo a Habilitado y se despublica al pasarlo a Modo de prueba. Tampoco puede estar marcado como terminal físico: un proveedor con datáfonos no se puede publicar, así que para el motor usa uno aparte. Si no, el motor no lo encuentra y el cliente ve la página «Confirmación pendiente», que le dice que el pago en línea no está disponible y le da un código para contactar con el hotel.
Nota: con Redirección a Redsys, la tarjeta no se guarda: solo se cobra. Si necesitas la tarjeta para cobrar después, habla con soporte.
- 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 para cobrar la estancia entera o una señal»).
- 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.
- Bizum: el proveedor Redsys cobra con un solo método, el que elijas en Método de pago (Pago con Tarjeta o Bizum), y el motor usa un solo proveedor, así que hoy el motor no puede ofrecer tarjeta y Bizum a la vez. Deja Pago con Tarjeta.
- El alta con el banco (pruebas, validación de tu web y pase a real) está en la guía «Dar de alta el TPV virtual con el banco: pruebas, validación y pase a real».
Errores habituales
Si la página del banco muestra «Error en datos enviados. Contacte con su comercio», el código SIS está en el código fuente de esa página (botón derecho, «Ver código fuente», una línea con «<!--SIS0xxx:-->»).
| Código o síntoma | Qué pasa | Qué hacer |
|---|---|---|
| SIS0042 | La firma no es correcta: la clave secreta no es la de ese entorno o ese terminal (por ejemplo, la de pruebas en real). | Pon la clave del entorno en el que estás y comprueba el terminal. |
| SIS0026 | El comercio o el terminal no existe en ese entorno: suele pasar al cobrar en real antes de que el banco haya hecho el pase. | Revisa el FUC y el terminal. Si aún no tienes el pase a real, vuelve a Modo de prueba y pídelo. |
| SIS0028 | El terminal está dado de baja en el banco. | Pregunta al banco. |
| SIS0052 | Número de pedido repetido: el TPV no admite dos cobros con el mismo número. | Vuelve a empezar la reserva. Si se repite, avisa a soporte. |
| SIS0431 / SIS0007 | El banco no puede leer los datos enviados, casi siempre por un carácter especial como «%» en el nombre del comerciante o en la descripción del producto. | Quita los caracteres especiales de esos campos del proveedor. |
| SIS0022 / SIS0023 | Tipo de transacción no válido. | Pon el Tipo de transacción en 0. |
| El cliente paga pero la reserva no se confirma | La notificación del banco no llega a Astro HMS. | En el portal de Canales del banco, Notificaciones, mira el motivo (por ejemplo, HTTP 403). Revisa que la notificación vaya a /payment/redsys/return y que tu cortafuegos deje pasar a Redsys. |
Valoración
¿Te ha resultado útil este documento?
¿No has encontrado lo que buscabas?
Abrir ticket de soporteVer también
Artículos relacionados
Dar de alta el TPV virtual con el banco: pruebas, validación y pase a real
Poner en marcha el motor de reservas de principio a fin: habitaciones, tarifas, Redsys, condiciones y web
Qué ofrece el motor de reservas: mejoras, estancias partidas, calendario y extras
¿Necesitas ayuda?
¿No encuentras lo que buscas?
Explora todos los procesos o contacta con soporte para recibir ayuda personalizada.