- Учётные данные API
- Торговый счет
- Ключ API
- Префикс URL API
- Ключ HMAC
Вы подключите свой торговый счёт Adyen к TourTask: четыре значения, один веб-хук и тестовый платёж. Нужен рабочий аккаунт Adyen, а не тестовый, и его получение занимает несколько недель.
Получите рабочий аккаунт Adyen
- 1
Свяжитесь с отделом продаж Adyen
Заполните форму отдела продаж Adyen и укажите, что продаёте туры. Adyen относит туроператоров к бизнесу с ограничениями: нужны дополнительные документы, а проверка длится дольше.
- 2
Спросите о резерве до подписания договора
Adyen может удерживать часть ваших выплат в качестве резерва. Для туров, оплаченных за несколько месяцев вперёд, он может быть большим.
Скопируйте данные из Adyen
Войдите в рабочую Customer Area, ca-live.adyen.com, под пользователем с ролью Merchant admin. Держите каждое значение под рукой: вы введёте их все, когда добавите Adyen в TourTask после веб-хука.
- 1
Скопируйте торговый счёт
В разделе Settings → Merchant accounts скопируйте код торгового счёта, а не аккаунта компании. Он нужен для поля Торговый счет в TourTask.
- 2
Скопируйте префикс URL
В разделе Developers → API URLs скопируйте Prefix: только префикс, а не весь веб-адрес. Он нужен для поля Префикс URL API в TourTask.
- 3
Создайте учётные данные API
Выберите аккаунт компании, откройте Developers → API credentials и перейдите на вкладку Payments. Выберите Create new credential, затем Web service user и Create credential.
- 4
Сгенерируйте ключ API
В разделе Server settings → Authentication откройте вкладку API key и выберите Generate API key. Adyen показывает ключ только один раз: скопируйте его для поля Ключ API в TourTask, а затем выберите Save changes в Adyen.
Создайте веб-хук
Без этого веб-хука деньги с путешественников списываются, но их бронирования остаются неподтверждёнными.
Ваш адрес веб-хука TourTask для Adyen
https://api.tourtask.com/v1/payments/adyen/notifications/booking- 1
Добавьте Standard webhook
В рабочей Customer Area откройте Developers → Webhooks, выберите Create new webhook, затем Add рядом с Standard webhook.
- 2
Включите его для своего торгового счёта
В разделе General включите Enabled и убедитесь, что в Merchant accounts есть ваш счёт.
- 3
Введите адрес TourTask
В разделе Server configuration вставьте указанный выше адрес TourTask в поле URL.
- 4
Сгенерируйте ключ HMAC
В разделе Security нажмите значок редактирования рядом с HMAC Key, затем Generate. Adyen показывает ключ только один раз: скопируйте его для поля Ключ HMAC в TourTask.
- 5
Выберите Save configuration
Затем пропустите Test configuration: эта проверка не проходит, даже когда веб-хук настроен правильно.
Добавьте Adyen в TourTask
- 1
Откройте карточку Adyen
Откройте Конфигурация → Варианты оплаты и нажмите карточку Adyen в разделе Онлайн-платежи → Платежные шлюзы. Её нет? Выберите Показать все шлюзы под карточками.
- 2
Выберите страну и валюту
В поле Страна выберите страну, где находятся ваш аккаунт Adyen и его банковский счёт, а в поле Валюта — валюту, в которой платят путешественники. Нажмите Добавить. Чтобы потом изменить что-либо из этого, удалите Adyen кнопкой Удалить и добавьте заново.
- 3
Введите учётные данные API
В разделе Аутентификация на карточке есть поле для каждого из них:
Торговый счет
Ключ API
Префикс URL API
Ключ HMACКаждое поле сохраняется, когда вы щёлкаете за его пределами.
- 4
Активируйте Adyen
Нажмите Активировать, когда все поля заполнены. Карточка получает статус Активный, и путешественники могут платить через Adyen на вашей странице бронирования. Каждый платёж поступает прямо на ваш собственный счёт Adyen: TourTask никогда не удерживает ваши деньги.
Проверьте Adyen
У TourTask нет тестового режима для Adyen, поэтому проверьте его на небольшом реальном бронировании, а потом верните деньги.
- 1
Оплатите бронирование
Забронируйте самый дешёвый тур на своей странице бронирования, выберите Adyen и заплатите своей картой. Когда вы вернётесь на страницу бронирования, бронирование подтвердится само.
- 2
Верните платёж
В бронировании выберите Вернуть платёж в меню действий платежа, а затем Вернуть через Adyen.
- 3
Отмените тестовое бронирование
Если тестовый платёж не прошёл
- Платёж сразу не проходит: проверьте, что все четыре значения взяты из рабочей Customer Area. В поле Торговый счет должен быть код торгового счёта, а не аккаунта компании.
- Вы заплатили, но бронирование не подтверждено: в рабочей Customer Area проверьте, что веб-хук в состоянии Enabled, включает ваш торговый счёт и его URL точно совпадает с указанным выше. Если всё так, сгенерируйте для него новый HMAC Key и вставьте его в поле Ключ HMAC в TourTask. Затем выберите Save configuration в Adyen.
Частые вопросы
Те, что включены для вашего торгового счёта в Customer Area Adyen. TourTask их не фильтрует.
Обычно несколько дней. TourTask сразу фиксирует возврат, а в вашей Customer Area Adyen видно, когда деньги вернулись.
Нет. TourTask отправляет путешественников на собственную платёжную страницу Adyen, поэтому здесь ничего настраивать не нужно.