Conectar Tilopay

Con Tilopay conectado, el enlace de pago de una reserva le cobra al turista con tarjeta y el dinero entra directo a tu cuenta de Tilopay. Tours Tico no cobra ni retiene nada de las reservas; Tilopay descuenta su propia comisión.

Cuando la reserva se paga, se confirma sola y el cobro queda registrado en el detalle de la reserva.

Antes de conectar: esta guía describe una función que se habilita por operador. Si en Ajustes → Cobros todavía no ves «Tilopay» en la lista de proveedores, escribinos: no hace falta que configures nada por tu cuenta.

Antes de empezar

• En Tours Tico necesitás el rol de propietario o administrador sin acceso restringido a marcas.
• Necesitás una cuenta de comercio ya aprobada en Tilopay, con acceso a admin.tilopay.com.
• Si tenés varias marcas, decidí a cuál le conectás la cuenta. Una marca sin pasarela propia usa la del negocio.

Lo primero que conviene entender: la prueba y el cobro real son la misma cuenta

Esta es la diferencia grande con PayPal, y la que más confunde si ya lo conectaste antes.

En PayPal, «Sandbox» y «Producción» son dos cuentas distintas con credenciales distintas. En Tilopay no: hay una sola cuenta y unas solas credenciales, y lo que decide si se cobra dinero de verdad es un interruptor dentro de Tilopay, no lo que pegás en Tours Tico.

Dicho al revés, para que quede claro lo que importa:

• Mientras ese interruptor esté encendido, tu comercio no cobra de verdad: las tarjetas se aprueban pero no entra plata. Sirve para probar el flujo completo antes de cobrarle a un cliente.
• No busques «credenciales de prueba» en Tilopay. No existen: son las mismas.

1. Copiar los tres datos de Tilopay

Ruta en Tilopay: iniciá sesión en admin.tilopay.com y entrá a HERRAMIENTAS → Integración con Plataformas (en inglés, TOOLS → Platform Integrations).

En el panel Credenciales de conexión (Connection credentials), dejá Integración de plataforma (Platform Integration) en Api General y copiá los tres valores. Cada uno tiene su botón de copiar:

En Tilopay (español)	En Tilopay (inglés)	En Tours Tico
Llave API	API Key	Llave API
Usuario API	API User	Usuario API
Contraseña API	API Password	Contraseña API

Los tres son necesarios. Tours Tico los guarda cifrados y no vuelve a mostrarlos: solo los usan las funciones que cobran.

2. Decidir si vas a probar primero

Si querés hacer una prueba antes de cobrarle a un cliente real, encendé el modo de prueba en Tilopay:

Ruta en Tilopay: CONFIGURACIÓN → Métodos de pago (SETTINGS → Payment Methods), panel Ambiente de pago (Payment environment), interruptor Activar modo pruebas (Enable test mode).

Ahí mismo está el enlace a las tarjetas de prueba (Testing cards).

Ojo con lo que el modo de prueba NO sirve para probar. Con el modo de prueba encendido, Tilopay aprueba todas las tarjetas — también las que su propia lista marca como «rechazadas». Lo comprobamos con dos de ellas y las dos salieron aprobadas. Eso significa que no podés usar el modo de prueba para ver qué pasa cuando a un cliente le rechazan la tarjeta: ese caso solo se ve en producción, con una tarjeta real sin fondos. Para lo que sí sirve es para lo importante: ver el flujo completo, que la reserva se confirme sola y que el cobro te aparezca en tu cuenta.

Cuando termines de probar, apagá el interruptor. Si te lo dejás encendido, tus clientes van a ver que el pago se aprueba y vos no vas a recibir el dinero.

3. Conectar en Tours Tico

Ruta: Ajustes → Cobros → Pasarela de pago → Conectar una pasarela

1. En Proveedor, elegí Tilopay.
2. En Modo, elegí Prueba si encendiste el interruptor en Tilopay, o Producción si vas a cobrar de verdad. Que este campo coincida con el interruptor de Tilopay es importante: mirá la sección de errores más abajo.
3. Pegá los tres datos y presioná Conectar.

Tours Tico prueba las credenciales contra Tilopay antes de guardarlas, así que si algo está mal te enterás en el momento y no cuando un turista intente pagar.

4. Qué ve el turista

Cuando abre su enlace de pago:

• Si tenés una sola forma de cobro, ve directamente el resumen de la reserva y el botón Pagar con Tilopay.
• Si tenés varias (por ejemplo Tilopay y PayPal), primero elige con cuál pagar.

Al presionar el botón, Tilopay abre su propia página de pago y el turista escribe ahí los datos de su tarjeta. Nunca los escribe dentro de Tours Tico: por eso tu enlace de pago no maneja números de tarjeta.

Tours Tico le manda a Tilopay los datos de contacto que ya tenés de la reserva, así que en esa página el cliente solo escribe la tarjeta, sin volver a llenar nombre, correo ni dirección. Como la reserva no pide dirección ni ciudad, esos campos viajan con un valor neutro (N/A): en tus registros de Tilopay vas a ver ese texto, y quiere decir exactamente eso — que no es un dato del cliente, no que se haya perdido.

Cuando termina, vuelve solo a tu enlace y ve el comprobante. Si cerró el navegador antes de volver, no se pierde nada: la próxima vez que abra ese enlace, Tours Tico consulta el pago y confirma la reserva.

Si el pago queda en proceso (puede pasar con métodos que dependen de una confirmación del banco), la reserva no se confirma todavía y el turista ve que su pago está en trámite. Vuelve a estar todo bien apenas el banco confirme y alguien reabra el enlace.

5. Conciliar un cobro con tu cuenta de Tilopay

Ruta en Tilopay: OPERACIÓN → Transacciones (OPERATION → Transactions).

Buscá por la columna Número de orden (Order number). Ese número es el mismo que Tours Tico muestra en el detalle de la reserva, así que sirve para cruzar cualquier cobro entre las dos pantallas.

6. Devolver dinero

Ruta: el detalle de la reserva → sección de pagos → Devolver dinero por Tilopay.

Podés devolver el total o una parte. El dinero sale de tu cuenta de Tilopay y la devolución no se puede deshacer desde Tours Tico.

Si devolvés desde el panel de Tilopay en lugar de hacerlo desde Tours Tico, la reserva no se actualiza en el momento. Tours Tico lo recupera cuando vuelve a consultar ese cobro, pero puede tardar: lo más simple es hacer las devoluciones desde Tours Tico, donde quedan registradas al instante y con el monto asociado a la reserva.

Errores comunes

«La pasarela no reconoció la llave API». La Llave API es de otro comercio, o se copió incompleta. Ojo: el usuario y la contraseña pueden ser correctos y la llave no, porque son datos independientes. Volvé a copiarla con el botón de copiar de Tilopay.

«La pasarela rechazó estas credenciales». El Usuario API o la Contraseña API están mal. Igual que arriba: copialos de nuevo desde Integración con Plataformas.

Los pagos se aprueban pero las reservas no se confirman. Es el caso que más cuesta descubrir solo: la pasarela está conectada en modo Producción y el modo de prueba sigue encendido en Tilopay. Esos pagos se aprueban sin mover dinero, así que Tours Tico no confirma la reserva a propósito — confirmarla sería dar por pagada una reserva que nadie pagó. Apagá el interruptor en CONFIGURACIÓN → Métodos de pago y volvé a intentar.

El turista dice que pagó y la reserva sigue pendiente. Pedile que vuelva a abrir su enlace de pago: al abrirlo, Tours Tico consulta el pago en Tilopay y, si está aprobado, confirma la reserva. Si aun así sigue pendiente, revisá Transacciones en Tilopay buscando el número de orden de la reserva.

Lo que Tours Tico no hace por vos

• No administra tu cuenta de Tilopay ni tus comisiones: eso se ve en admin.tilopay.com.
• No enciende ni apaga el modo de prueba. Ese interruptor es tuyo.
• No refleja las devoluciones que hagas por fuera de Tours Tico.