TPV de tu banco (Redsys): conectar, cobrar y preguntas frecuentes

1. El código de comercio (FUC), el terminal y la clave de firma (SHA-256) de tu TPV virtual. También los ves en el portal de administración de Redsys de tu banco.

2. Un terminal solo para Acogify (recomendado): si algún día lo necesitas, el banco puede darlo de baja sin tocar el resto de tus cobros.

3. Notificación online (HTTP) activada: es la forma en que el banco confirma a Acogify que un pago se ha hecho. Sin ella, los pagos por la página del banco pueden quedarse como pendientes.

4. Según lo que vayas a usar: devoluciones; pago por referencia (tarjeta en archivo) y operaciones sin autenticación, para garantías con tarjeta, prepagos programados y no-show; preautorización, para retener un importe y cobrarlo después.

5. Obligatorio: el pago InSite activado en ese terminal y el dominio app.acogify.com autorizado para InSite. Es lo que permite que el cliente escriba la tarjeta en la página de pago y en el motor de reservas sin salir a la del banco. Lo tiene que pedir el hotel: Acogify no puede activarlo por ti, porque es un permiso que da tu banco sobre tu terminal.

Puedes copiar y enviar este mensaje a tu gestor del banco (cambia lo que va entre corchetes):

Asunto: Alta de un terminal del TPV virtual para Acogify, con pago InSite

Hola, [nombre del gestor]: Soy [tu nombre], de [nombre del establecimiento] (CIF [CIF]). Vamos a cobrar con nuestro TPV virtual de Redsys desde nuestro programa de gestión hotelera, Acogify. Os pedimos, por favor: 1) Un terminal nuevo del TPV virtual, solo para este uso. 2) El código de comercio (FUC), el número de terminal y la clave de firma SHA-256 de ese terminal. 3) La notificación online (HTTP) activada. 4) El pago InSite activado en ese terminal, con el dominio app.acogify.com autorizado para InSite; es imprescindible, porque es donde nuestros clientes escriben la tarjeta. 5) Pago por referencia (tarjeta en archivo, COF) y operaciones iniciadas por el comercio sin autenticación (MIT), para garantías con tarjeta y no presentados. 6) Devoluciones y preautorización. Muchas gracias. Un saludo, [tu nombre] · [teléfono]

Lo imprescindible son los puntos 1 a 4, InSite incluido. Lo demás, según lo que vayas a usar: lo que el banco no active, Acogify no lo ofrece y ese cobro sigue por Stripe o no se ofrece.

Cuando el banco te confirme InSite, entra en Pasarela de pago, pulsa «Cambiar datos del TPV» y marca «Pago integrado (InSite)». Si el banco aún no ha autorizado el dominio, el cuadro de la tarjeta no carga.

1. Abre Configuración › Cobros y caja › Pasarela de pago. En el bloque «TPV virtual de tu banco (Redsys)», pulsa «Conectar TPV».

2. Escribe el código de comercio, el terminal y la clave de firma. Elige el entorno: «Pruebas» si el banco te ha dado un comercio de pruebas, «Real» para cobrar de verdad.

3. Marca lo que tu banco te ha activado (devoluciones, pago por referencia, preautorización, pago integrado). Si no lo sabes, marca solo lo que te hayan confirmado: se puede cambiar después.

4. Pulsa «Guardar y comprobar». Acogify comprueba la clave con Redsys sin mover dinero. Si es correcta, el TPV queda «Activo»; si no, no se guarda nada.

5. En «Qué pasarela usa cada cobro», elige el TPV donde quieras usarlo.

6. Haz una prueba con un importe pequeño (un enlace de pago a ti mismo) y comprueba que llega a Administración › Pasarela de pago y al portal de tu banco.

Alta: no hay botón de «conectar con el banco». Hay que pedir los datos al banco y pegarlos en Acogify. La clave se guarda cifrada y no se vuelve a mostrar.

Comisión: la que tengas negociada con tu banco. El dinero entra directamente en tu cuenta del banco, sin pasar por Acogify ni por Stripe.

Lo que puedes hacer depende de tu banco: cada banco activa (o no) devoluciones, pago por referencia, preautorización o pago integrado, y fija los límites de su TPV (por ejemplo, un importe máximo de devolución).

Tarjetas de las agencias online (Booking y otras OTA): no se pueden cobrar con el TPV; para eso hace falta Stripe.

American Express: tu banco tiene que tenerla contratada en el TPV, y además se aplica la casilla «Aceptar American Express» de Pasarela de pago para las tarjetas de garantía.

Pago integrado (InSite): sin él, el cliente paga en la página segura de su banco y vuelve. Con él, escribe la tarjeta en la página de Acogify. Las dos formas son seguras.

Seguridad extra: tras cambiar la clave, 24 horas en las que solo el administrador hace devoluciones y cobros con tarjeta guardada, con aviso por email a los administradores.

Con el pago integrado, el cliente escribe la tarjeta en la misma página de pago de Acogify, en un formulario seguro de tu banco, sin salir a la página del banco. Vale para el pago del motor de reservas, los enlaces de pago de la reserva, el cobro suelto y las tarjetas de garantía (reserva y mesa).

Lo tiene que pedir el hotel a su banco (Acogify no puede activarlo). Cómo: 1) pide a tu banco que active InSite en tu terminal; 2) pídele que autorice el dominio app.acogify.com (es la dirección de la página de pago); 3) en Configuración › Pasarela de pago, pulsa «Cambiar datos del TPV» y marca «Pago integrado (InSite)».

Si el banco del cliente pide confirmar la compra (código por SMS, app del banco…), se abre la pantalla de su banco y, al terminar, vuelve solo a la página de pago con el resultado. Guardar una tarjeta de garantía casi siempre pide esa confirmación.

Debajo del formulario queda siempre «Continúa en la página segura del banco», por si algo falla. Si no marcas el pago integrado, la página de pago muestra el botón «Pagar» y el cliente paga en la página de su banco: funciona igual.

El pago por QR de la cuenta del restaurante sigue yendo a la página del banco.

En Configuración › Pasarela de pago, la tabla «Qué pasarela usa cada cobro» deja elegir Stripe o el TPV para: pagos de la reserva, motor de reservas del hotel, garantía de la reserva, garantía de mesa, QR del restaurante y cobro suelto.

«Automático» usa el TPV si está activo y tu banco tiene activado lo que ese cobro necesita; si no, Stripe. Si eliges el TPV para algo que tu banco no tiene activado (por ejemplo, garantías sin pago por referencia), ese cobro sigue por Stripe.

Las tarjetas que llegan de las agencias online (OTAs) siguen siempre por Stripe.

Desde la ficha de la reserva (o el panel del planning), en «Cobros con el TPV de tu banco»: crear un enlace de pago (no cobra nada hasta que el cliente paga; vale 7 días), pedir o guardar la tarjeta de garantía, y cobrar con la tarjeta guardada según las condiciones aceptadas. Que la tarjeta esté guardada no asegura que el banco autorice el cargo.

American Express: la casilla «Aceptar American Express» de Pasarela de pago vale para Stripe y para el TPV. Si está desmarcada, una tarjeta Amex no se guarda como garantía (no se cobra nada) y la página pide otra al cliente.

Devoluciones: desde «Gestionar pagos», con tu PIN, hasta lo cobrado menos lo ya devuelto. Cada banco fija los límites de su TPV: si no permite una devolución, se indica y no se devuelve nada.

Cobro suelto: en Administración › Pasarela de pago, «Cobrar con TPV virtual» (pasas la tarjeta aquí mismo) o «Enviar enlace de pago» (el cliente paga desde su móvil). Ambos piden primero tu PIN y no van ligados a ninguna reserva.

En Administración › Pasarela de pago tienes dos pestañas: «Movimientos» (cobros, devoluciones y garantías, con totales) y «Enlaces de pago» (cada enlace con su estado y un botón para copiarlo).

Todo lo cobrado y devuelto aparece en Administración › Pasarela de pago. Comprueba siempre el estado antes de repetir un cobro.

¿Dónde encuentro la clave de firma? Te la da tu banco junto al código de comercio y el terminal. También está en el portal de administración de Redsys de tu banco, en los datos del terminal (suele llamarse «clave SHA-256»). Es una cadena de unos 32 caracteres.

¿Puedo usar el mismo terminal que uso en la tienda o en otra web? Es mejor uno solo para Acogify: si un día hay que darlo de baja o cambiar la clave, no afecta al resto de tus cobros.

¿Qué pasa si la clave es incorrecta? Redsys la rechaza al comprobarla y no se guarda nada. Revisa que sea la del mismo terminal y del mismo entorno (pruebas o real).

¿Por qué un cobro sale como «Pendiente»? Acogify solo da un pago por hecho cuando el banco lo confirma. Si el cliente pagó en la página del banco y la confirmación aún no ha llegado, queda pendiente. Compruébalo en el portal del banco antes de cobrar otra vez.

¿Puedo tener Stripe y el TPV a la vez? Sí. Elige en «Qué pasarela usa cada cobro» cuál usa cada sitio. Las tarjetas de las OTA siempre van por Stripe.

¿Puedo hacer devoluciones? Sí, si tu banco tiene activadas las devoluciones, desde la reserva con tu PIN, hasta lo cobrado menos lo ya devuelto. Si el banco tiene un límite, la devolución se rechaza y no se devuelve nada.

¿Qué hago si cambio de banco o de terminal? Pulsa «Cambiar datos del TPV» y pega los datos nuevos. Los cobros pasados se conservan.

¿Acogify ve los datos de las tarjetas? No. El número lo escribe el cliente en el formulario o la página de su banco; Acogify solo recibe una referencia.

La clave de firma se guarda cifrada y nadie la puede volver a ver, tampoco Acogify. Al guardarla se comprueba con Redsys sin mover dinero.

Tras cambiar la clave, durante 24 horas solo el administrador puede hacer devoluciones y cobros con tarjeta guardada, y se avisa a los administradores.

Acogify solo da un pago por hecho cuando el banco lo confirma con su firma.