Configura tu plataforma de pago premium
Las plataformas de pago premium integradas con Avantio permiten automatizar los cobros asociados a tus reservas y procesar transacciones de forma segura.
El procedimiento de conexión varía según el proveedor. En algunos casos deberás crear previamente una cuenta y completar el onboarding directamente con la plataforma. En otros, será necesario solicitar determinadas credenciales o enlaces de conexión al equipo de Customer Experience de Avantio.
En este artículo encontrarás el proceso de integración de cada proveedor, los datos necesarios y los plazos de activación orientativos.
¿Qué aprenderás en este artículo?
En este artículo aprenderás a:
Preparar la información necesaria antes de iniciar una conexión.
Completar el onboarding con el proveedor de pagos.
Solicitar a Avantio los enlaces o identificadores necesarios.
Facilitar correctamente las credenciales de integración.
Verificar la conexión mediante una reserva de prueba.
Identificar los principales errores durante el proceso.
Ventajas
Conectar una plataforma de pago premium te permitirá:
Automatizar los cobros relacionados con las reservas.
Reducir la intervención manual del equipo.
Centralizar la configuración de los pagos.
Reforzar la seguridad mediante sistemas como 3D Secure.
Mejorar la trazabilidad de las transacciones.
Facilitar el seguimiento de cobros, devoluciones e incidencias.
Adaptar la solución de pago al país en el que opera tu empresa.
¿Cuándo deberías realizar esta configuración?
Deberías realizar esta configuración cuando:
Hayas elegido la plataforma de pago que utilizará tu empresa.
Hayas confirmado que el proveedor opera en tu país.
Quieras comenzar a procesar cobros de reservas mediante la nueva plataforma.
Necesites sustituir una pasarela utilizada anteriormente.
Quieras automatizar pagos que actualmente gestionas de forma manual.
El proveedor haya aprobado la cuenta de tu empresa.
Antes de empezar
Conviene revisar previamente:
Que la plataforma seleccionada esté disponible en tu país.
Que hayas contratado el servicio directamente con el proveedor.
Que la cuenta esté registrada a nombre de la empresa correcta.
Que hayas completado las verificaciones legales y bancarias solicitadas.
Que dispongas de acceso administrativo a la cuenta.
Que tengas preparados los datos y credenciales necesarios.
Que sepas qué empresa, oficinas o alojamientos utilizarán la conexión.
Que la persona responsable de la configuración tenga permisos suficientes en Avantio.
También es recomendable acordar internamente quién se encargará de revisar los cobros, las devoluciones, las conciliaciones y las posibles incidencias.
Nunca envíes credenciales sensibles mediante canales no autorizados. Cuando sea necesario facilitar datos a Avantio, hazlo a través de un ticket dirigido al equipo de Customer Experience.
Conecta tu plataforma premium elegida con Avantio
Comercia Global Payments
Comercia Global Payments
Antes de empezar
Para utilizar Comercia Global Payments debes iniciar primero el proceso de contratación y onboarding directamente con Comercia.
Sigue estos pasos
Contacta con Comercia Global Payments a través de su persona de contacto comercial.
Indica que deseas utilizar Comercia Global Payments con Avantio.
Facilita la documentación empresarial y bancaria solicitada.
Completa el proceso de onboarding con Comercia.
Espera a que Comercia valide y apruebe la cuenta.
Comercia se pondrá en contacto con Avantio para facilitar los datos necesarios para la integración.
Confirma con el equipo de Customer Experience de Avantio que la solicitud está en curso.
Cuando la conexión esté disponible, realiza una reserva de prueba.
Comprueba que la transacción aparece correctamente en Avantio y en la interfaz de Comercia.
Tiempo de activación
El proceso suele completarse aproximadamente en una semana, aunque el plazo puede variar según la documentación y las validaciones requeridas durante el onboarding.
Stripe
Stripe
Antes de empezar
Para conectar Stripe necesitas:
Una cuenta Stripe de tipo Standard.
Haber completado el proceso de verificación solicitado por Stripe.
Acceso a la cuenta con permisos suficientes.
Un enlace de conexión facilitado por Avantio.
Sigue estos pasos
Accede a la página de Stripe y crea una cuenta de tipo Standard.
Completa los datos empresariales, fiscales y bancarios solicitados.
Finaliza el proceso de verificación de la cuenta.
Crea un ticket para el equipo de Customer Experience de Avantio.
Indica en el ticket que deseas conectar tu cuenta Standard de Stripe.
Espera a recibir el enlace de conexión.
Abre el enlace e inicia sesión con la cuenta de Stripe correspondiente.
Autoriza la conexión entre Stripe y Avantio.
Confirma con el equipo de Customer Experience que el proceso se ha completado.
Realiza una reserva de prueba y comprueba que el pago se procesa correctamente.
Tiempo de activación
La conexión puede quedar activa el mismo día, siempre que la cuenta Standard de Stripe esté verificada y preparada para operar.
SysPay
SysPay
Antes de empezar
Para iniciar la conexión con SysPay deberás completar su proceso de onboarding.
Durante este proceso, SysPay solicitará dos identificadores que debe facilitarte Avantio:
Account ID.
Merchant ID.
Sigue estos pasos
Contacta con el equipo comercial de SysPay.
Indica que quieres utilizar su integración con Avantio.
Facilita a SysPay la documentación empresarial y bancaria requerida.
Crea un ticket para el equipo de Customer Experience de Avantio.
Solicita tu Account ID y Merchant ID para la conexión con SysPay.
Facilita estos dos identificadores a SysPay.
Completa las verificaciones pendientes con el proveedor.
Espera a que SysPay active el módulo de procesamiento de pagos mediante API.
Cuando SysPay confirme que el módulo está listo, comunícalo al equipo de Customer Experience de Avantio mediante el ticket.
Avantio completará la configuración de la integración.
Realiza una reserva de prueba.
Comprueba que la transacción se procesa y aparece correctamente en ambas plataformas.
Tiempo de activación
La activación suele requerir unos días, dependiendo del tiempo necesario para completar el onboarding y activar el módulo de pagos mediante API.
Mercado Pago
Mercado Pago
Antes de empezar
Para conectar Mercado Pago necesitas:
Una cuenta de empresa activa.
Acceso a la sección de integraciones.
El User ID de la cuenta.
La clave secreta configurada para los webhooks.
El Access Token de producción.
La URL de webhook facilitada por Avantio.
Sigue estos pasos
Inicia sesión en tu cuenta de empresa de Mercado Pago.
Accede a la sección Tu negocio.
Selecciona Integraciones.
Localiza el panel de aplicaciones conectadas.
Accede a la aplicación que utilizarás para la conexión con Avantio.
Localiza el campo User ID.
Copia el valor y guárdalo en un lugar seguro.
Crea un ticket para el equipo de Customer Experience de Avantio.
Solicita la URL que debes utilizar para configurar los webhooks.
Vuelve a Mercado Pago y accede a la sección Webhooks.
Introduce la URL facilitada por Avantio.
En el apartado de eventos, selecciona Pagos.
Localiza el campo Clave secreta.
Copia el valor correspondiente a la clave secreta de los webhooks.
Accede a Credenciales de producción.
Localiza el campo Access Token.
Copia el valor y consérvalo de forma segura.
Comprueba que dispones de los siguientes datos:
User ID.
Webhooks Secret Key.
Access Token.
Facilita estos datos al equipo de Customer Experience de Avantio mediante el ticket y el canal seguro indicado.
Espera a que Avantio introduzca las credenciales en el asistente de conexión.
Cuando la configuración esté terminada, realiza una reserva de prueba.
Comprueba que el cobro se procesa y se registra correctamente.
Tiempo de activación
La activación puede ser inmediata una vez que Avantio recibe las credenciales correctas y completa su configuración.
Después de la activación, es necesario realizar una reserva de prueba para verificar que los cobros funcionan correctamente.
Tilopay
Tilopay
Antes de empezar
Para conectar Tilopay necesitas completar primero su proceso de onboarding y obtener las credenciales de producción.
Los datos necesarios son:
Tilopay Key.
Tilopay Password.
Tilopay Proxy Key.
Tilopay User.
También deberás elegir el modo de operación que utilizarás.
Modos de operación disponibles
3DS v.2
Con este modo, el huésped deberá autorizar mediante 3D Secure cada uno de los pagos asociados a la reserva.
Puede ser adecuado cuando quieres que todos los cobros requieran una autenticación individual por parte del titular de la tarjeta.
E-commerce: CIT y MIT
Con este modo, el huésped autoriza mediante 3D Secure el primer pago.
Los pagos posteriores asociados a la reserva pueden procesarse automáticamente como operaciones iniciadas por el comercio, siempre que se cumplan las condiciones establecidas por el proveedor.
Puede ser adecuado para reservas con varios vencimientos o pagos fraccionados.
Sigue estos pasos
Contacta directamente con Tilopay para iniciar el proceso de onboarding.
Indica que utilizarás la integración con Avantio.
Facilita la documentación empresarial y bancaria requerida.
Completa las verificaciones solicitadas por Tilopay.
Confirma con Tilopay qué modo de operación se adapta mejor a tu empresa: 3DS v.2 o E-commerce con CIT y MIT.
Solicita las credenciales de producción.
Comprueba que dispones de Tilopay Key, Tilopay Password, Tilopay Proxy Key y Tilopay User.
Crea un ticket para el equipo de Customer Experience de Avantio.
Incluye las credenciales necesarias mediante el canal seguro indicado por el equipo.
Indica el modo de operación seleccionado.
Espera a que Avantio configure la integración.
Realiza una reserva de prueba.
Comprueba el primer cobro y, cuando corresponda, el funcionamiento de los pagos posteriores.
Tiempo de activación
La activación suele completarse en unos días, dependiendo del tiempo necesario para finalizar el onboarding y obtener las credenciales.
Ascent Payment Solutions
Ascent Payment Solutions
Antes de empezar
Para conectar Ascent Payment Solutions necesitas completar su proceso de onboarding y disponer de las siguientes credenciales:
Client ID.
Site ID.
Key.
Password.
Price ID.
Sigue estos pasos
Contacta directamente con Ascent Payment Solutions.
Indica que deseas utilizar la integración con Avantio.
Completa el proceso de contratación y onboarding.
Facilita la documentación empresarial y bancaria requerida.
Espera a que Ascent apruebe la cuenta y genere las credenciales.
Comprueba que dispones de Client ID, Site ID, Key, Password y Price ID.
Crea un ticket para el equipo de Customer Experience de Avantio.
Facilita las credenciales mediante el canal seguro indicado.
Espera a que Avantio complete la configuración.
Realiza una reserva de prueba.
Comprueba que el cobro aparece correctamente tanto en Avantio como en la interfaz de Ascent.
Tiempo de activación
La conexión suele completarse en unos días, dependiendo del avance del proceso de onboarding con Ascent.
Resultado esperado
Al completar el proceso correspondiente a tu proveedor:
La plataforma de pago quedará conectada con Avantio.
Podrás procesar los cobros asociados a las reservas.
Las transacciones se enviarán a la plataforma configurada.
Podrás consultar los movimientos desde Avantio y, cuando corresponda, desde el panel del proveedor.
Los pagos utilizarán las medidas de seguridad y autenticación disponibles en la plataforma.
La integración solo debe considerarse terminada después de realizar y verificar correctamente una reserva de prueba.
Siguientes pasos recomendados
Después de activar la conexión:
Realiza una reserva de prueba con un importe reducido.
Comprueba que el pago se registra correctamente en Avantio.
Revisa que la transacción aparece en la plataforma de pago.
Verifica el estado del pago y la moneda utilizada.
Comprueba el funcionamiento de 3D Secure.
Verifica los pagos posteriores si trabajas con cobros fraccionados.
Realiza una devolución de prueba cuando el proveedor lo permita.
Confirma qué miembros del equipo tienen acceso al panel de pagos.
Documenta internamente el procedimiento para gestionar incidencias y chargebacks.
Informa al equipo antes de comenzar a procesar reservas reales.
Principales datos y credenciales
Según el proveedor, puedes necesitar los siguientes elementos:
Stripe: cuenta Standard y enlace de conexión.
Comercia Global Payments: cuenta aprobada y datos gestionados directamente entre Comercia y Avantio.
Tilopay: Tilopay Key, Tilopay Password, Tilopay Proxy Key y Tilopay User.
Ascent Payment Solutions: Client ID, Site ID, Key, Password y Price ID.
SysPay: Account ID y Merchant ID.
Mercado Pago: User ID, Webhooks Secret Key y Access Token.
Trata siempre estas credenciales como información confidencial.
Limitaciones y consideraciones
Ten en cuenta que:
Avantio no puede completar la integración hasta que el proveedor haya aprobado la cuenta.
Los plazos de activación son orientativos.
La documentación solicitada depende del proveedor y del país.
Las credenciales deben pertenecer al entorno de producción, salvo que se indique lo contrario.
Una credencial incompleta, caducada o copiada incorrectamente puede impedir la conexión.
La integración puede requerir la participación tanto del proveedor como de Avantio.
Algunas operaciones deben gestionarse desde el panel externo de la plataforma.
La activación técnica no garantiza que todos los métodos de pago estén habilitados.
La configuración de 3D Secure puede variar según la plataforma y el modo de operación.
Los cobros posteriores pueden requerir una configuración específica.
No debes empezar a procesar pagos reales sin haber completado una prueba.
Antes de cambiar una plataforma que ya está en uso, comprueba el impacto sobre las reservas existentes y los cobros que todavía estén pendientes.
Buenas prácticas
Utiliza una cuenta empresarial y no una cuenta personal.
Completa el onboarding antes de solicitar la activación en Avantio.
Comprueba cuidadosamente cada credencial antes de enviarla.
No compartas contraseñas ni tokens en canales no autorizados.
Mantén actualizado el contacto administrativo de la plataforma.
Limita los accesos a las personas que realmente necesiten gestionar pagos.
Activa la autenticación en dos pasos en el panel del proveedor cuando esté disponible.
Realiza siempre una reserva de prueba.
Comprueba tanto el primer pago como los pagos posteriores.
Revisa periódicamente las transacciones rechazadas.
Documenta internamente el proceso de devolución y chargeback.
Informa a Avantio y al proveedor si modificas la cuenta bancaria, la entidad legal o las credenciales.
Evita sustituir una conexión activa durante periodos con un volumen elevado de cobros pendientes.
Caso práctico
Una empresa decide utilizar Tilopay para gestionar reservas con varios pagos.
La empresa completa el onboarding y elige el modo E-commerce con CIT y MIT, ya que quiere que el huésped autorice el primer pago mediante 3D Secure y que los cobros posteriores se procesen automáticamente.
Después de recibir las credenciales de producción, la empresa facilita a Avantio la Tilopay Key, Tilopay Password, Tilopay Proxy Key y Tilopay User.
Avantio completa la configuración y la empresa crea una reserva de prueba con dos vencimientos. Primero verifica la autenticación del pago inicial y, posteriormente, comprueba que el segundo cobro se procesa según la configuración acordada.
Solo después de validar ambos pagos comienza a utilizar la integración con reservas reales.
Errores frecuentes
La conexión no puede activarse
Comprueba que la cuenta esté completamente aprobada por el proveedor y que hayas finalizado todas las verificaciones pendientes.
Las credenciales no son válidas
Revisa que hayas copiado los valores completos, sin espacios adicionales, saltos de línea ni caracteres omitidos.
Confirma también que sean credenciales de producción y no de un entorno de prueba.
El pago no aparece en la plataforma
Comprueba que la reserva utiliza la plataforma correcta y que la transacción se ha enviado realmente.
Revisa también el estado del pago y los posibles mensajes de error.
3D Secure no se muestra
La autenticación puede depender del tipo de tarjeta, del país, del emisor y de la configuración de la plataforma.
Confirma con el proveedor que 3D Secure está activo en la cuenta.
Los pagos posteriores no se procesan
Comprueba que la plataforma y el modo de operación permiten realizar cobros posteriores.
En Tilopay, revisa si se ha configurado el modo E-commerce con CIT y MIT cuando sea necesario.
Mercado Pago no recibe las notificaciones
Revisa que:
La URL del webhook sea correcta.
El evento Pagos esté seleccionado.
La clave secreta sea válida.
Las credenciales de producción estén activas.
SysPay no finaliza la activación
Confirma que SysPay haya recibido el Account ID y el Merchant ID correctos.
Cuando SysPay active el módulo API, avisa a Avantio para que podamos completar la integración.
Si algo no funciona
Si la integración no se comporta como esperas, revisa estos puntos antes de contactar con el equipo de Customer Experience:
Comprueba que la cuenta esté aprobada y activa.
Verifica que no haya validaciones pendientes con el proveedor.
Revisa que las credenciales sean correctas y estén completas.
Confirma que estás utilizando credenciales de producción.
Comprueba que el proveedor haya activado la integración o el módulo API.
Revisa que la plataforma correcta esté asociada a la configuración de pagos.
Comprueba el estado de la transacción en Avantio y en el panel del proveedor.
Actualiza la página y vuelve a revisar el resultado.
Realiza una nueva reserva de prueba cuando sea necesario.
Si el problema continúa, crea un ticket e incluye:
Nombre de la empresa.
Plataforma de pago utilizada.
Fecha y hora aproximadas de la operación.
Identificador de la reserva.
Importe y moneda.
Estado del pago.
Mensaje de error completo.
Capturas de pantalla.
Confirmación de que el onboarding está finalizado.
No incluyas contraseñas, tokens completos ni otras credenciales sensibles en las capturas de pantalla.
Preguntas frecuentes
¿Tengo que contratar la plataforma antes de conectarla con Avantio?
¿Tengo que contratar la plataforma antes de conectarla con Avantio?
Sí. Debes crear o contratar la cuenta directamente con el proveedor y completar el proceso de onboarding y verificación correspondiente.
Avantio interviene en la conexión técnica, pero no sustituye el contrato entre tu empresa y la plataforma de pago.
¿Cuánto tarda la activación?
¿Cuánto tarda la activación?
El plazo depende de cada proveedor:
Stripe puede activarse el mismo día si la cuenta Standard ya está preparada.
Comercia Global Payments puede requerir aproximadamente una semana.
Tilopay, Ascent y SysPay suelen requerir varios días.
Mercado Pago puede activarse inmediatamente después de recibir y configurar las credenciales correctas.
Estos plazos son orientativos y pueden variar.
¿Puedo enviar las credenciales por correo electrónico?
¿Puedo enviar las credenciales por correo electrónico?
Utiliza siempre el canal seguro indicado por el equipo de Customer Experience.
No compartas contraseñas, tokens o claves sensibles mediante canales no autorizados.
¿Es obligatorio realizar una reserva de prueba?
¿Es obligatorio realizar una reserva de prueba?
Sí, es muy recomendable.
La reserva de prueba permite comprobar que la plataforma está conectada, que el pago se registra correctamente y que la autenticación funciona antes de procesar reservas reales.
¿Quién configura la conexión?
¿Quién configura la conexión?
Depende de la plataforma.
En algunos casos, Avantio facilita un enlace o configura las credenciales. En otros, el proveedor debe activar previamente un módulo o comunicarse directamente con Avantio.
¿Puedo cambiar de plataforma de pago?
¿Puedo cambiar de plataforma de pago?
Sí, pero antes debes revisar los cobros pendientes y las reservas existentes.
No desactives la plataforma anterior hasta comprobar cómo se gestionarán los pagos que todavía no se hayan procesado.
¿Qué debo hacer si cambio una credencial?
¿Qué debo hacer si cambio una credencial?
Contacta con el equipo de Customer Experience de Avantio para actualizar la configuración.
Una credencial modificada o revocada puede interrumpir el procesamiento de los pagos.
¿Puedo utilizar varias plataformas al mismo tiempo?
¿Puedo utilizar varias plataformas al mismo tiempo?
La disponibilidad de esta opción dependerá de la configuración de tu cuenta, de la estructura de tu empresa y del uso previsto.
Contacta con el equipo de Customer Experience para que podamos revisar tu caso.