- Credenciales de API
- Cuenta de comerciante
- Clave API
- Prefijo de URL de la API
- Clave HMAC
Vas a conectar tu cuenta de comerciante de Adyen a TourTask: cuatro valores, un webhook y un pago de prueba. Necesitas una cuenta real de Adyen, no una de prueba, y conseguirla lleva semanas.
Adyen no permite registrarse por cuenta propia. Adyen no publica su factura mínima: pregunta a su equipo de ventas. A la mayoría de los operadores pequeños les conviene más otra pasarela de pago.
Consigue una cuenta real de Adyen
- 1
Contacta con el equipo de ventas de Adyen
Usa el formulario de ventas de Adyen e indica que vendes tours. Adyen considera a los operadores turísticos un negocio restringido, con documentos adicionales y una revisión más larga.
- 2
Pregunta por el depósito antes de firmar
Adyen puede retener como depósito de garantía parte del dinero que te transfiere. Con tours pagados con meses de antelación, puede ser elevado.
Copia tus datos de Adyen
Inicia sesión en la Customer Area real, ca-live.adyen.com, con un usuario que tenga el rol Merchant admin. Ten cada valor a mano: los rellenas todos al añadir Adyen en TourTask, después del webhook.
- 1
Copia la cuenta de comerciante
En Settings → Merchant accounts, copia el código de la cuenta de comerciante, no el de la cuenta de empresa. Va en Cuenta de comerciante en TourTask.
- 2
Copia el prefijo de la URL
En Developers → API URLs, copia el Prefix: solo el prefijo, no una dirección web completa. Va en Prefijo de URL de la API en TourTask.
- 3
Crea una credencial de API
Selecciona tu cuenta de empresa, ve a Developers → API credentials y abre la pestaña Payments. Selecciona Create new credential, elige Web service user y luego Create credential.
- 4
Genera la clave API
En Server settings → Authentication, abre la pestaña API key y selecciona Generate API key. Adyen muestra la clave una sola vez: cópiala para Clave API en TourTask y luego selecciona Save changes en Adyen.
Crea el webhook
Sin este webhook, a los viajeros se les cobra, pero sus reservas quedan sin confirmar.
Tu dirección de webhook de TourTask para Adyen
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Añade un webhook estándar
En la Customer Area real, ve a Developers → Webhooks, selecciona Create new webhook y luego Add junto a Standard webhook.
- 2
Actívalo para tu cuenta de comerciante
En General, activa Enabled y comprueba que Merchant accounts incluye la tuya.
- 3
Introduce la dirección de TourTask
En Server configuration, pega la dirección de TourTask de arriba como URL.
- 4
Genera la clave HMAC
En Security, selecciona el icono de edición junto a HMAC Key y luego Generate. Adyen muestra la clave una sola vez: cópiala para Clave HMAC en TourTask.
- 5
Selecciona Save configuration
Después, omite Test configuration: falla aunque el webhook esté bien.
Añade Adyen en TourTask
- 1
Abre la tarjeta de Adyen
Ve a Configuración → Opciones de pago y haz clic en la tarjeta Adyen en Pagos en línea → Pasarelas de pago. ¿No está? Elige Mostrar todas las pasarelas de pago debajo de las tarjetas.
- 2
Elige el país y la moneda
En País, elige el país de tu cuenta de Adyen y de su cuenta bancaria, y en Moneda, la moneda en la que pagan los viajeros. Haz clic en Agregar. Para cambiar cualquiera de los dos más adelante, quita Adyen con Eliminar y vuelve a añadirlo.
- 3
Rellena tus credenciales de API
En Autenticación, la tarjeta tiene un campo para cada una:
Cuenta de comerciante
Clave API
Prefijo de URL de la API
Clave HMACCada campo se guarda cuando haces clic fuera de él.
- 4
Activa Adyen
Haz clic en Activar cuando todos los campos estén rellenados. La tarjeta pasa a Activo y los viajeros pueden pagar con Adyen en tu página de reserva. Cada pago llega directamente a tu propia cuenta de Adyen: TourTask nunca retiene tu dinero.
Prueba Adyen
TourTask no tiene modo de prueba para Adyen, así que prueba con una reserva real pequeña que luego reembolses.
- 1
Paga una reserva
Reserva tu tour más barato en tu propia página de reserva, elige Adyen y paga con tu propia tarjeta. Al volver a tu página de reserva, la reserva se confirma sola.
- 2
Reembolsa el pago
En la reserva, elige Reembolsar pago en el menú de acciones del pago y luego Reembolsar por Adyen.
Una reserva cancelada no se puede reembolsar a través de Adyen.
- 3
Cancela la reserva de prueba
Si el pago de prueba falla
- El pago falla de inmediato: comprueba que los cuatro valores vienen de la Customer Area real. Cuenta de comerciante debe ser el código de la cuenta de comerciante, no el de la cuenta de empresa.
- Pagaste, pero la reserva no se confirma: en la Customer Area real, comprueba que el webhook está Enabled, incluye tu cuenta de comerciante y tiene la URL exactamente como arriba. Si es así, genera en él una nueva HMAC Key y pégala en Clave HMAC en TourTask. Luego selecciona Save configuration en Adyen.
Preguntas frecuentes
Los que están activados para tu cuenta de comerciante en la Customer Area de Adyen. TourTask no los filtra.
Normalmente unos días. TourTask registra el reembolso al instante, y tu Customer Area de Adyen muestra cuándo se ha devuelto el dinero.
No. TourTask envía a los viajeros a la propia página de pago de Adyen, así que no hay nada que configurar para eso.