Configura tu pasarela de pago
Avantio permite conectar diferentes pasarelas de pago para automatizar los cobros asociados a las reservas.
El proceso de integración depende de cada proveedor. Algunas plataformas requieren configuraciones específicas por parte de tu entidad bancaria, mientras que otras necesitan credenciales de producción, tokenización, webhooks o una página web operativa para completar las pruebas.
Antes de iniciar el proceso técnico, debes confirmar la compatibilidad, formalizar el contrato correspondiente y completar el onboarding solicitado por el proveedor.
¿Qué aprenderás en este artículo?
En este artículo aprenderás a:
Preparar la información necesaria antes de iniciar la conexión.
Solicitar las activaciones requeridas a tu banco o proveedor.
Identificar las credenciales necesarias para cada plataforma.
Configurar webhooks y tokenizaciones.
Completar la conexión con ayuda de Avantio.
Realizar las pruebas necesarias antes de procesar pagos reales.
Resolver los errores más habituales durante la integración.
Ventajas
Conectar una pasarela de pago con Avantio te permitirá:
Automatizar los cobros de las reservas.
Reducir las operaciones manuales.
Aplicar sistemas de autenticación como 3D Secure.
Centralizar la configuración de pagos.
Mejorar la trazabilidad de las transacciones.
Realizar preautorizaciones cuando la plataforma lo permita.
Procesar pagos posteriores según la configuración contratada.
Recibir notificaciones de pago en tiempo real.
Facilitar la gestión de devoluciones e incidencias.
¿Cuándo deberías realizar esta configuración?
Deberías iniciar esta configuración cuando:
Hayas elegido la plataforma de pago.
Hayas confirmado que opera en tu país.
Conozcas los costes asociados.
El proveedor haya aprobado la cuenta de tu empresa.
Dispongas de las credenciales de producción.
Tu banco haya realizado las activaciones necesarias.
Quieras sustituir una conexión anterior.
Necesites automatizar los cobros desde Avantio.
Antes de empezar
Conviene revisar previamente:
Que la empresa esté registrada en un país compatible.
Que hayas formalizado el contrato con el proveedor.
Que el proceso de onboarding esté finalizado.
Que dispongas de acceso administrativo a la cuenta.
Que las credenciales correspondan al entorno de producción.
Que tu TPV sea compatible con los protocolos requeridos.
Que tengas una página web operativa cuando sea necesaria.
Que hayas definido quién gestionará las pruebas.
Que conozcas los métodos de pago que utilizarás.
Que hayas confirmado si necesitas preautorizaciones o tokenización.
También es recomendable coordinar la activación con el equipo responsable de reservas, pagos y conciliación.
Nunca compartas credenciales sensibles mediante canales no autorizados. Facilita la información solicitada a través de un ticket dirigido al equipo de Customer Experience.
Conecta tu plataforma elegida con Avantio
Redsys mediante Worldline
Redsys mediante Worldline
La integración permite conectar un TPV Redsys con Avantio Payments utilizando el conector proporcionado por Worldline.
Antes de empezar
Contacta con el equipo de Customer Experience de Avantio para verificar que tu banco y tu TPV son compatibles.
Actualmente, esta integración no está disponible con Banco Sabadell.
Una vez confirmada la compatibilidad, Avantio te facilitará el contrato correspondiente.
Solicita las activaciones a tu banco
Después de firmar el contrato, solicita a tu entidad bancaria las siguientes configuraciones:
Activación del protocolo SIS REST PSPS.
Asociación del comercio Redsys a PSP OGONE SIS REST CON MPI EXTERNO.
Activación de las operaciones MIT.
Activación de las operaciones MOTO.
Habilitación de 3D Secure v2.
Activación de las preautorizaciones.
Las operaciones MOTO son necesarias para determinadas transacciones relacionadas con portales.
Las preautorizaciones permiten realizar retenciones y liberaciones de importes, por ejemplo, para gestionar fianzas.
Configuración adicional para BBVA
Cuando el banco adquirente sea BBVA, debes solicitar también la activación del protocolo de CVC opcional.
Si tu entidad bancaria necesita información técnica adicional, puede contactar con Avantio a través de:
Datos necesarios
Una vez que el banco haya confirmado las activaciones, crea un ticket para el equipo de Customer Experience y facilita:
Merchant ID o FUC.
Código MCC o categoría del comercio.
Número de terminal.
Métodos de pago disponibles.
Acquirer BIN de Visa.
Acquirer BIN de Mastercard.
Indica también si el TPV admite otros métodos, como American Express.
Sigue estos pasos
Contacta con el equipo de Customer Experience de Avantio.
Solicita la comprobación de compatibilidad de tu banco.
Confirma que tu entidad bancaria puede trabajar con el protocolo requerido.
Revisa y firma el contrato facilitado por Avantio.
Solicita al banco la activación del protocolo SIS REST PSPS.
Solicita la asociación del comercio a PSP OGONE SIS REST CON MPI EXTERNO.
Pide la activación de MIT y MOTO.
Solicita la habilitación de 3D Secure v2.
Solicita la activación de las preautorizaciones si vas a gestionar fianzas.
Si trabajas con BBVA, solicita el CVC opcional.
Espera a que el banco confirme todas las activaciones.
Reúne el Merchant ID, MCC, número de terminal y Acquirer BIN.
Facilita los datos a Avantio mediante un ticket.
Espera a que se complete la configuración técnica.
Realiza una reserva de prueba.
Comprueba el funcionamiento del pago.
Prueba las operaciones posteriores o las preautorizaciones cuando corresponda.
Tiempo estimado de activación
El proceso puede tardar desde varios días hasta varias semanas.
El plazo depende de:
La velocidad de respuesta de la entidad bancaria.
La configuración previa del TPV.
La activación del protocolo requerido.
La validación de los identificadores técnicos.
La activación final de la plataforma.
Axerve
Axerve
Antes de empezar
Contacta con Axerve para formalizar el contrato y solicitar el alta de la cuenta.
Cuando contactes con el proveedor, solicita también el servicio de Tokenization si necesitas utilizar tarjetas tokenizadas para pagos posteriores.
Una vez aprobado el contrato, Axerve te facilitará acceso a su intranet o backoffice.
Credenciales necesarias
Desde el panel de Axerve debes obtener:
ShopLogin.
ApiKey.
Además, deberás configurar una URL de webhook para recibir las notificaciones de pago.
Configura el webhook
El webhook permite que Axerve comunique a Avantio los cambios de estado de las transacciones en tiempo real.
Solicita la URL a Avantio
Crea un ticket para el equipo de Customer Experience.
Indica que estás configurando Axerve.
Solicita la URL de webhook correspondiente a tu cuenta.
Conserva la URL exactamente como te la facilitemos.
Añade la URL en Axerve
Accede al panel de Axerve.
Dirígete a Configurazione.
Selecciona Ambiente.
Localiza el campo Url server to server.
Copia la URL facilitada por Avantio.
Guarda la configuración.
No modifiques la URL ni añadas espacios adicionales.
Sigue estos pasos
Contacta con Axerve.
Indica que utilizarás la integración con Avantio.
Formaliza el contrato.
Solicita el servicio de tokenización cuando sea necesario.
Completa las verificaciones de la cuenta.
Accede al backoffice de Axerve.
Localiza el ShopLogin.
Obtén la ApiKey.
Crea un ticket para el equipo de Customer Experience.
Solicita la URL del webhook.
Accede a Configurazione → Ambiente → Url server to server.
Introduce la URL facilitada.
Guarda la configuración.
Facilita a Avantio el ShopLogin y la ApiKey.
Espera a que se complete la integración.
Realiza una reserva de prueba.
Comprueba que Axerve envía las notificaciones de pago.
Verifica que el estado de la transacción se actualiza en Avantio.
Tiempo estimado de activación
La conexión puede completarse el mismo día desde que Avantio recibe y valida los datos proporcionados por Axerve.
El plazo puede aumentar cuando:
El contrato todavía no está aprobado.
La tokenización no está activada.
Las credenciales son incorrectas.
El webhook no está configurado.
La cuenta no está habilitada para operar en producción.
Amazon Payment Services
Amazon Payment Services
Antes de empezar
Contacta con Amazon Payment Services para formalizar el contrato e iniciar el proceso de onboarding.
Durante este proceso, indica expresamente que necesitas utilizar la tokenización.
La tokenización es necesaria para almacenar de forma segura una referencia de la tarjeta y realizar las operaciones permitidas por la plataforma sin conservar directamente los datos sensibles.
Credenciales necesarias
Para activar la conexión necesitas:
MerchantId.
AccessCode.
ShaRequest.
ShaResponse.
Las credenciales deben corresponder al entorno de producción, salvo que se soliciten primero datos específicos para realizar pruebas.
Sigue estos pasos
Contacta con Amazon Payment Services.
Confirma que la plataforma está disponible en tu país.
Indica que utilizarás la integración con Avantio.
Formaliza el contrato.
Completa la documentación del onboarding.
Solicita la activación de la tokenización.
Espera a que Amazon Payment Services apruebe la cuenta.
Solicita las credenciales de integración.
Comprueba que dispones de MerchantId, AccessCode, ShaRequest y ShaResponse.
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.
Completa la autenticación 3D Secure.
Comprueba que la transacción aparece correctamente.
Verifica el funcionamiento de la tokenización cuando sea necesario.
Atención a los detalles
Todos los pagos procesados mediante esta pasarela utilizarán 3D Secure de forma predeterminada.
Comprueba que el flujo de reserva permite al huésped completar correctamente la autenticación.
Tiempo estimado de activación
La activación suele requerir varios días.
El plazo dependerá principalmente de la finalización del onboarding, la activación de la tokenización y la entrega de las credenciales.
PowerTranz
PowerTranz
PowerTranz es la versión de FAC compatible con 3D Secure v2.
Sustituye a la integración anterior de FAC, que únicamente admitía 3D Secure v1.
Antes de empezar
Para completar la integración debes disponer de una página web operativa.
La web se utilizará para realizar pruebas:
En el entorno de test.
En el entorno real o de producción.
Confirma con PowerTranz que tu cuenta y tu mercado son compatibles con la versión que admite 3D Secure v2.
Credenciales necesarias
Solicita a PowerTranz:
PowerTranzId.
PowerTranzPassword.
Las credenciales deben corresponder al entorno indicado para cada fase de las pruebas.
Sigue estos pasos
Contacta con PowerTranz para iniciar el proceso de onboarding.
Indica que utilizarás la integración con Avantio.
Confirma que contratarás la versión compatible con 3D Secure v2.
Facilita a PowerTranz la documentación requerida.
Prepara una página web operativa.
Solicita las credenciales del entorno de pruebas.
Obtén el PowerTranzId y el PowerTranzPassword.
Crea un ticket para el equipo de Customer Experience de Avantio.
Facilita las credenciales mediante el canal seguro indicado.
Coordina con Avantio las pruebas en el entorno de test.
Comprueba que el proceso de autenticación funciona correctamente.
Completa con PowerTranz la activación del entorno de producción.
Facilita las credenciales definitivas cuando sean diferentes.
Realiza una prueba en el entorno real.
Comprueba que el pago aparece tanto en Avantio como en PowerTranz.
Confirma con Avantio que la integración puede comenzar a utilizarse.
Resultado esperado
Al finalizar el proceso:
PowerTranz estará conectado con Avantio.
Los pagos utilizarán 3D Secure v2.
Podrás procesar tarjetas en las monedas admitidas.
Las transacciones se registrarán en el panel del proveedor.
La web estará preparada para completar el flujo de autenticación.
Resultado esperado
Al finalizar la conexión de la plataforma seleccionada:
La pasarela estará vinculada con Avantio.
Podrás procesar los pagos de las reservas.
Los cobros utilizarán la autenticación disponible.
Las transacciones se enviarán al proveedor correspondiente.
Los cambios de estado se actualizarán mediante el mecanismo configurado.
Podrás realizar las operaciones permitidas por tu contrato.
Los pagos posteriores o preautorizaciones funcionarán cuando estén habilitados.
No debes considerar finalizada la integración hasta haber completado correctamente una reserva de prueba.
Siguientes pasos recomendados
Después de activar la plataforma:
Realiza una reserva de prueba con un importe reducido.
Comprueba que el pago aparece en Avantio.
Revisa que la operación aparece en el panel del proveedor.
Confirma que el importe y la moneda son correctos.
Verifica el funcionamiento de 3D Secure.
Comprueba las notificaciones del webhook cuando corresponda.
Prueba la tokenización si la has contratado.
Revisa los pagos posteriores.
Prueba una preautorización cuando la plataforma lo permita.
Comprueba el procedimiento de devolución.
Confirma los permisos de los usuarios internos.
Documenta el procedimiento para gestionar incidencias.
Informa a tu equipo antes de comenzar a procesar pagos reales.
Principales datos y opciones
Según la plataforma, necesitarás:
Redsys mediante Worldline: Merchant ID o FUC, MCC, número de terminal, métodos de pago y Acquirer BIN.
PowerTranz: PowerTranzId y PowerTranzPassword.
Amazon Payment Services: MerchantId, AccessCode, ShaRequest y ShaResponse.
Axerve: ShopLogin, ApiKey y URL del webhook.
También puedes necesitar:
Activación de MIT.
Activación de MOTO.
Configuración de 3D Secure v2.
Activación de preautorizaciones.
Tokenización.
Página web operativa.
Credenciales de test y producción.
Configuración server-to-server.
Limitaciones y consideraciones
Ten en cuenta que:
La integración no puede completarse hasta que el proveedor apruebe la cuenta.
Los plazos dependen del proveedor o de la entidad bancaria.
Las credenciales deben corresponder al entorno adecuado.
Los datos incorrectos pueden impedir la conexión.
La activación de 3D Secure depende de la configuración de la cuenta.
La tokenización debe contratarse cuando sea necesaria.
Las operaciones MIT y MOTO requieren autorización específica.
Las preautorizaciones no están disponibles si el banco no las habilita.
Los webhooks deben configurarse exactamente con la URL facilitada.
PowerTranz requiere una página web operativa para realizar las pruebas.
Redsys necesita configuraciones específicas por parte del banco.
Amazon Payment Services utiliza 3D Secure de forma predeterminada.
No debes procesar pagos reales antes de finalizar las pruebas.
La modificación de una credencial puede interrumpir los cobros.
Antes de sustituir una pasarela existente, revisa qué ocurrirá con los pagos pendientes de las reservas ya creadas.
Buenas prácticas
Confirma la compatibilidad antes de iniciar el proceso.
Utiliza siempre una cuenta empresarial.
Completa el onboarding antes de solicitar la conexión.
Solicita credenciales de producción.
No compartas contraseñas o claves en canales no autorizados.
Copia las credenciales sin espacios adicionales.
Guarda las claves en un gestor seguro.
Limita los accesos administrativos.
Activa la autenticación en dos pasos cuando esté disponible.
Configura correctamente 3D Secure v2.
Solicita la tokenización desde el inicio si vas a necesitarla.
Realiza pruebas en todos los entornos necesarios.
Verifica los webhooks después de la activación.
Comprueba tanto los pagos iniciales como los posteriores.
Documenta los cambios realizados por tu banco.
No desactives la conexión anterior hasta validar la nueva.
Caso práctico
Una empresa española quiere conservar las condiciones de su TPV Redsys y automatizar sus cobros mediante Avantio Payments.
Primero, contacta con Avantio para confirmar que su banco es compatible.
Después de firmar el contrato, solicita a la entidad bancaria la activación del protocolo SIS REST PSPS, MIT, MOTO, 3D Secure v2 y preautorizaciones.
Cuando el banco confirma la configuración, la empresa facilita a Avantio el Merchant ID, el MCC, el número de terminal y los Acquirer BIN.
Avantio completa la configuración y la empresa realiza una reserva de prueba. También verifica una preautorización para comprobar que puede retener y liberar correctamente una fianza.
Una vez comprobadas todas las operaciones, comienza a utilizar la conexión con reservas reales.
Errores frecuentes
El banco no conoce el protocolo solicitado
Facilita a la entidad bancaria el nombre completo del protocolo y las operaciones que debe habilitar.
Cuando sea necesario, el banco puede contactar con Avantio a través de [email protected].
Redsys no procesa los pagos posteriores
Comprueba que las operaciones MIT estén activadas.
Revisa también la configuración MOTO cuando las transacciones estén relacionadas con determinados portales.
La preautorización no funciona
Confirma con el banco que las preautorizaciones están habilitadas en el terminal correspondiente.
La activación general del TPV no implica necesariamente que esta operación esté disponible.
El pago no completa 3D Secure
Verifica que 3D Secure v2 esté activado en la cuenta y que el proveedor haya configurado correctamente la autenticación.
PowerTranz no puede completar las pruebas
Comprueba que la página web esté operativa y accesible.
Revisa también que estés utilizando la versión de PowerTranz compatible con 3D Secure v2.
Las credenciales de PowerTranz no funcionan
Confirma si las credenciales corresponden al entorno de test o al entorno real.
No utilices credenciales de pruebas para procesar pagos en producción.
Amazon Payment Services rechaza la conexión
Comprueba que MerchantId, AccessCode, ShaRequest y ShaResponse estén completos y pertenezcan a la misma cuenta.
Verifica también que el onboarding esté finalizado.
No se pueden procesar pagos posteriores con Amazon Payment Services
Confirma que la tokenización esté activada.
Haber contratado la pasarela no implica necesariamente que el servicio de tokenización esté habilitado.
Axerve no actualiza el estado de los pagos
Revisa la configuración del webhook.
La URL debe estar añadida en:
Configurazione → Ambiente → Url server to server
La ApiKey de Axerve no es válida
Comprueba que la clave sea de producción y que no incluya espacios o caracteres adicionales.
La reserva de prueba funciona, pero el pago real no
Confirma que la prueba no se haya realizado únicamente en un entorno de test.
Verifica que la cuenta y las credenciales de producción estén activas.
Si algo no funciona
Antes de contactar con el equipo de Customer Experience:
Comprueba que el contrato esté formalizado.
Verifica que el onboarding esté completo.
Confirma que la cuenta esté aprobada.
Revisa que las credenciales sean correctas.
Comprueba si pertenecen al entorno de test o producción.
Verifica que 3D Secure v2 esté activado.
Confirma que la tokenización esté habilitada cuando sea necesaria.
Revisa las configuraciones realizadas por el banco.
Comprueba la URL del webhook.
Confirma que la página web esté operativa.
Revisa el estado de la transacción en el panel del proveedor.
Actualiza la página y vuelve a comprobar el resultado.
Realiza una nueva reserva de prueba.
Si el problema continúa, crea un ticket e incluye:
Nombre de la empresa.
Plataforma utilizada.
Banco o adquirente, cuando corresponda.
Identificador de la reserva.
Fecha y hora de la operación.
Importe y moneda.
Estado de la transacción.
Mensaje de error completo.
Capturas de pantalla.
Entorno en el que se produjo el error.
Confirmación de las activaciones realizadas.
No incluyas contraseñas, ApiKeys completas ni otras credenciales sensibles en las capturas.
Preguntas frecuentes
¿Debo contratar la plataforma antes de conectarla?
¿Debo contratar la plataforma antes de conectarla?
Sí. Debes formalizar el contrato y completar el onboarding directamente con el banco o proveedor.
Avantio interviene en la integración técnica, pero no sustituye el contrato comercial.
¿Cuánto tarda la activación?
¿Cuánto tarda la activación?
Depende de la plataforma:
Redsys mediante Worldline puede tardar días o semanas.
PowerTranz puede requerir varios días y diferentes fases de prueba.
Amazon Payment Services suele tardar varios días.
Axerve puede activarse el mismo día después de recibir los datos correctos.
Los plazos son orientativos.
¿Qué es la tokenización?
¿Qué es la tokenización?
La tokenización sustituye los datos de una tarjeta por una referencia segura.
Permite realizar determinadas operaciones posteriores sin almacenar directamente la información sensible de la tarjeta.
¿Qué es un webhook?
¿Qué es un webhook?
Un webhook es una URL que permite a la plataforma enviar notificaciones automáticas a Avantio cuando cambia el estado de un pago.
En Axerve, debe configurarse en la sección Url server to server.
¿Qué diferencia existe entre MIT y MOTO?
¿Qué diferencia existe entre MIT y MOTO?
MIT son transacciones iniciadas por el comercio sobre una tarjeta previamente autorizada.
MOTO se utiliza para determinadas operaciones en las que el pago se inicia mediante canales como correo o teléfono. En esta integración, puede ser necesario para procesar algunas transacciones procedentes de portales.
¿Para qué sirven las preautorizaciones?
¿Para qué sirven las preautorizaciones?
Permiten retener temporalmente un importe sin efectuar el cobro definitivo.
Pueden utilizarse, por ejemplo, para gestionar fianzas y liberar posteriormente el importe retenido.
¿Es obligatorio realizar una reserva de prueba?
¿Es obligatorio realizar una reserva de prueba?
Sí, es muy recomendable.
La reserva de prueba permite comprobar el pago, la autenticación, las notificaciones y las operaciones posteriores antes de trabajar con reservas reales.
¿Puedo enviar las credenciales por correo?
¿Puedo enviar las credenciales por correo?
Utiliza únicamente el canal seguro indicado por el equipo de Customer Experience.
No envíes contraseñas ni claves sensibles mediante canales no autorizados.
¿Quién puede ayudarme durante la conexión?
¿Quién puede ayudarme durante la conexión?
Puedes contactar con tu Account Manager o con el equipo de Customer Experience de Avantio.
Podremos ayudarte mediante un ticket de soporte o, cuando sea necesario, a través de una videollamada.