Conectar ONVO Pay

Con ONVO Pay conectado, el enlace de pago de una reserva le cobra al turista con tarjeta —dentro de tu propia página, si cargás la llave pública— y el dinero entra directo a tu cuenta de ONVO. Tours Tico no cobra ni retiene nada de las reservas; ONVO 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 «ONVO» 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 en onvopay.com. Se crea sola y el entorno de prueba queda disponible al instante; para cobrar de verdad hay que completar la activación del negocio, que ONVO revisa (correo, términos, datos del negocio, identificación, datos bancarios). Eso lo hacés vos: nosotros no intervenimos ni podemos apurarlo.
• 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: son dos juegos de llaves

Si ya conectaste Tilopay, esto funciona al revés y conviene tenerlo claro antes de empezar.

En Tilopay hay una sola cuenta y unas solas credenciales, y un interruptor adentro de Tilopay decide si el cobro es real. En ONVO no hay ningún interruptor que puedas confundir: hay dos entornos con llaves distintas.

• Las llaves de prueba empiezan con onvo_test_ y las de producción con onvo_live_.
• La llave que pegues es la que decide dónde ocurre el cobro. No hay forma de «dejarse encendido» un modo de prueba sin darse cuenta.
• Si pegás una llave de prueba con el modo en Producción (o al revés), Tours Tico la rechaza en el momento, antes de guardarla. Es a propósito: la mezcla es exactamente el error que haría que tus clientes vean «pago aprobado» sin que a vos te entre un colón.

¿ONVO o Tilopay?

Las dos cobran con tarjeta a tu propia cuenta y las dos se conectan desde la misma pantalla. Podés tener las dos conectadas: el turista elige.

Lo que inclina la balanza hacia ONVO:

• La cuenta se abre sola y el entorno de prueba funciona desde el minuto uno, sin trámite previo ni intermediarios.
• Un solo dato para conectar (la llave secreta) contra los tres de Tilopay.
• Las pruebas son de verdad pruebas. En Tilopay el modo de prueba aprueba todas las tarjetas, incluidas las que su propia lista marca como rechazadas, así que no sirve para ensayar un rechazo. En ONVO las tarjetas de prueba se comportan como dicen.

Sobre SINPE Móvil, para que no te lleves una sorpresa. ONVO cobra por SINPE Móvil, pero solo en colones, y los enlaces de pago de Tours Tico se emiten en dólares. Con la configuración de hoy, el turista que abra tu enlace va a ver únicamente tarjeta, aunque tengas SINPE activo en tu cuenta de ONVO. Si querés cobrar por SINPE, hoy el camino es un método de pago personalizado, donde el cliente te transfiere y avisa.

1. Copiar la llave secreta

Ruta en ONVO: iniciá sesión en onvopay.com y, arriba del menú lateral, poné el selector Entorno (Environment) en Test o en Live según lo que vayas a hacer. En Test vas a ver un banner morado avisando que estás en modo de prueba.

Entrá a Desarrolladores → Llaves API (Developers → API Keys). En la tabla Llaves estándar (Standard keys):

En ONVO	En Tours Tico
Llave secreta (Acceso completo)	Llave secreta
Llave pública (Cliente)	Llave pública (opcional)

La llave secreta viene tapada: usá el botón del ojo para revelarla y copiala entera.

Copiá también la pública, aunque diga «opcional». Es la que decide dónde escribe la tarjeta tu cliente:

• Con la llave pública, el formulario de tarjeta aparece dentro de tu enlace de pago: tu cliente escribe la tarjeta sin salir de ahí, y la verificación del banco (3-D Secure), si la pide, aparece en ese mismo recuadro.
• Sin ella, se le abre la página de ONVO, paga allá y vuelve. Funciona igual de bien y es lo que venía pasando hasta ahora.

En los dos casos los datos de la tarjeta viajan directo a ONVO y nunca pasan por Tours Tico: en el primero, el formulario es de ONVO, embebido en la página. Podés empezar sin ella y pegarla después con Reemplazar: el cambio aplica al siguiente enlace que se abra.

Tours Tico la guarda cifrada y no vuelve a mostrarla: solo la usan las funciones que cobran.

2. Conectar en Tours Tico

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

1. En Proveedor, elegí ONVO.
2. En Modo, elegí Prueba o Producción, según de qué entorno copiaste la llave.
3. Pegá la Llave secreta. La Llave pública es opcional, pero pegala si la tenés: es la que hace que tu cliente pague sin salir de tu enlace.
4. Presioná Conectar.

Eso es todo lo que hace falta para empezar a cobrar. El secreto del webhook no se pide acá, y es a propósito: ONVO lo genera recién cuando creás el webhook, y para crearlo necesitás la URL que Tours Tico te muestra en la tarjeta apenas conectás. Es el paso siguiente, y te queda esperando en la misma tarjeta.

Tours Tico prueba la llave contra ONVO antes de guardarla, así que si está mal o es del entorno equivocado te enterás en el momento y no cuando un turista intente pagar.

3. Crear el webhook y pegar su secreto

Este paso es opcional pero muy recomendado, y conviene entender qué cambia.

El webhook es un aviso automático que ONVO le manda a Tours Tico apenas se paga. Sin él, todo funciona igual, pero la reserva se confirma solo cuando el turista vuelve a tu enlace después de pagar. Si cierra el navegador en la página de ONVO, la reserva queda pendiente hasta que alguien reabra ese enlace. Con el webhook, se confirma sola.

1. En la tarjeta de la pasarela ya conectada, en Ajustes → Cobros, vas a ver «Paso 2» con la URL del webhook y un botón para copiarla. Queda siempre a la vista: podés volver por ella cuando quieras, hoy o la semana que viene.
2. En ONVO, andá a Desarrolladores → Webhooks (Developers → Webhooks) y tocá + Agregar webhook (+ Add webhook).
3. Pegá la URL en URL del webhook y poné cualquier texto en Descripción (por ejemplo, «Tours Tico»). ONVO no te va a pedir que elijas eventos: manda todos, y Tours Tico ignora los que no le tocan.
4. Guardá el webhook. Recién ahí ONVO genera el secreto, y no aparece en el formulario donde lo acabás de crear: aparece en la tarjeta del webhook, en la lista de Webhooks, bajo el rótulo SIGNING SECRET, con los botones Show y Copy. Tocá Show para verlo y Copy para copiarlo.
5. Volvé a Ajustes → Cobros y pegalo en el campo del Paso 2, en la tarjeta de ONVO. Tocá Guardar secreto. No hace falta volver a poner la llave secreta: ese paso pide solo esto.

Cuando quede guardado, la tarjeta pasa a decir «Webhook configurado» y te deja Cambiar secreto por si algún día lo rotás. Ese estado se guarda: si recargás o volvés mañana, no vas a ver el paso 2 otra vez.

Si no encontrás el secreto, mirá la tarjeta del webhook en la lista y no el formulario de creación. Y si aun así no aparece, no te trabes: el paso 2 te espera. Los cobros se confirman igual cuando el turista vuelve del pago, y podés completarlo cuando quieras sin reconectar nada.

Tours Tico nunca confirma una reserva solo porque llegó un aviso. Cuando el webhook entra, volvemos a preguntarle a ONVO por ese pago y recién entonces confirmamos. Por eso un aviso falso no puede darte una reserva por pagada.

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 para pagar.
• Si tenés varias (por ejemplo ONVO y PayPal), primero elige con cuál pagar.

Lo que pasa después depende de si cargaste la llave pública:

Con llave pública. El formulario de tarjeta aparece ahí mismo, dentro de tu enlace: nombre, número, vencimiento y código. Si el banco pide verificación (3-D Secure), la pantalla del banco se abre dentro del mismo recuadro. Los datos de la tarjeta van directo a ONVO —el formulario es suyo, embebido— y no pasan por Tours Tico.

Si la tarjeta se rechaza, el formulario se queda donde está y lo dice con todas las letras («tu banco rechazó el pago», «no se pudo completar el pago»): puede corregir el número o probar con otra tarjeta ahí mismo, sin volver a empezar la reserva. Debajo le queda además un «Pagar de otra forma», que lo lleva a la página de ONVO.

Si el formulario no llega a cargar (una extensión que bloquea, una red que se cae), la página lo dice y ofrece un botón para pagar en la página de ONVO. Nadie se queda sin poder pagar.

Sin llave pública. Al presionar el botón, ONVO abre su propia página de pago (checkout.onvopay.com) y el turista escribe ahí los datos de su tarjeta. Cuando termina, vuelve solo a tu enlace y ve el comprobante.

En los dos casos, ONVO devuelve al turista sin ningún dato en la dirección: la página no se entera del resultado por la vuelta, se lo pregunta a ONVO. Para vos es lo mismo, y es más seguro — nadie puede fingir un pago manipulando el enlace de retorno.

Si cerró el navegador antes de volver, no se pierde nada: llega el webhook, o bien la próxima vez que abra ese enlace Tours Tico consulta el pago y confirma la reserva.

5. Conciliar un cobro con tu cuenta de ONVO

Ruta en ONVO: Pagos → Todas las transacciones (Payments → All transactions).

Acá hay un detalle que conviene saber de antemano: el detalle de una transacción de ONVO no muestra el número de la reserva. Por eso Tours Tico lo manda en la Descripción del cobro, con la forma OT-2026-0042 · Nombre del tour. Esa columna es la que te sirve para cruzar un cobro con su reserva.

Las devoluciones aparecen mezcladas en esa misma lista, identificadas como reembolso del pago correspondiente.

6. Devolver dinero

Ruta: el detalle de la reserva → sección de pagos → el botón de devolver.

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

Si devolvés desde el Dashboard de ONVO en lugar de hacerlo desde Tours Tico, la reserva no se actualiza en el momento. Lo más simple es hacer las devoluciones desde Tours Tico, donde quedan registradas al instante y asociadas a la reserva.

Errores comunes

«La llave no corresponde al modo elegido». Copiaste una llave onvo_test_ con el modo en Producción, o una onvo_live_ con el modo en Prueba. Fijate en el selector Entorno de ONVO antes de copiar: cada entorno tiene su propia llave.

«ONVO no reconoció la llave». Está incompleta o es de otra cuenta. Volvé a revelarla con el botón del ojo y copiala entera.

No aparece la opción de SINPE Móvil en la página de pago. No es un error de configuración: los enlaces se emiten en dólares y ONVO ofrece SINPE solo en colones. Mirá la nota de más arriba.

Conecté ONVO y no me pidió el secreto del webhook. Es lo esperado desde la última versión: el secreto tiene su propio paso en la tarjeta, después de conectar, porque antes de eso todavía no existe. Miralo en Ajustes → Cobros, en la tarjeta de ONVO.

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 ONVO y, si está aprobado, confirma la reserva. Si te pasa seguido, es la señal de que te conviene configurar el webhook.

El pago figura «en proceso». Puede pasar con métodos que dependen de una confirmación posterior. La reserva no se confirma todavía y el turista ve que su pago está en trámite; se resuelve solo cuando ONVO confirma.

Lo que Tours Tico no hace por vos

• No administra tu cuenta de ONVO ni tus comisiones: eso se ve en tu Dashboard.
• No completa la activación de tu negocio para cobrar en vivo. Ese trámite es tuyo y lo revisa ONVO.
• No crea el webhook por vos: ONVO no permite crearlo desde afuera de su Dashboard.
• No refleja las devoluciones que hagas por fuera de Tours Tico.