- Учётные данные API
- Ключ API
- Секрет веб-хука
Настройте Stripe, чтобы путешественники платили картой на собственной платёжной странице Stripe и возвращались к оплаченному бронированию. Нужен банковский счёт в одной из стран, перечисленных выше.
Создайте аккаунт Stripe
- 1
Зарегистрируйтесь в Stripe
Создайте аккаунт на dashboard.stripe.com/register. Выбирайте страну компании внимательно: после запуска аккаунта Stripe не сможет её изменить.
- 2
Пройдите проверку компании
Заполните заявку на dashboard.stripe.com/account/onboarding: данные о компании, о людях, которые за ней стоят, и о банковском счёте для выплат. Реальные платежи станут доступны, когда Stripe вас проверит.
Скопируйте секретный ключ Stripe
- 1
Откройте ключи API
Откройте dashboard.stripe.com/apikeys и переключитесь из песочницы (sandbox) в рабочий режим (live mode).
- 2
Скопируйте секретный ключ
В разделе Standard keys нажмите Reveal live key и скопируйте Secret key: он начинается с sk_live_. Никому его не показывайте: любой, у кого он есть, может принимать и возвращать платежи от вашего имени.
Добавьте веб-хук TourTask в Stripe
Веб-хук сообщает TourTask о каждом платеже, даже если деньги зачисляются через несколько дней или путешественник так и не возвращается.
Ваш адрес веб-хука TourTask для Stripe
https://api.tourtask.com/v1/payments/stripe/notifications/booking- 1
Создайте получателя событий
Откройте dashboard.stripe.com/webhooks в рабочем режиме и нажмите Create an event destination.
- 2
Выберите Your account и Snapshot
Выберите Your account и формат данных Snapshot: TourTask не умеет читать события Thin, которые рекомендует Stripe. Версию API оставьте как есть.
- 3
Выберите два события
Отметьте checkout.session.completed и checkout.session.async_payment_succeeded — и больше ничего.
- 4
Выберите Webhook endpoint
Нажмите Continue и выберите тип получателя Webhook endpoint.
- 5
Введите адрес TourTask
Нажмите Continue, вставьте указанный выше адрес TourTask в поле Endpoint URL и создайте получателя.
- 6
Скопируйте секрет подписи
На странице получателя нажмите Reveal secret и скопируйте секрет подписи: он начинается с whsec_.
Добавьте Stripe в TourTask
- 1
Откройте карточку Stripe
Откройте Конфигурация → Варианты оплаты и нажмите карточку Stripe в разделе Онлайн-платежи → Платежные шлюзы. Её нет? Выберите Показать все шлюзы под карточками.
- 2
Выберите страну и валюту
В поле Страна выберите страну, где находятся ваш аккаунт Stripe и его банковский счёт, а в поле Валюта — валюту, в которой платят путешественники. Нажмите Добавить. Чтобы потом изменить что-либо из этого, удалите Stripe кнопкой Удалить и добавьте заново.
- 3
Введите учётные данные API
В разделе Аутентификация на карточке есть поле для каждого из них:
Ключ API
Секрет веб-хукаКаждое поле сохраняется, когда вы щёлкаете за его пределами.
- 4
Активируйте Stripe
Нажмите Активировать, когда все поля заполнены. Карточка получает статус Активный, и путешественники могут платить через Stripe на вашей странице бронирования. Каждый платёж поступает прямо на ваш собственный счёт Stripe: TourTask никогда не удерживает ваши деньги.
Чтобы добавить доплату или изменить порядок способов оплаты, см. онлайн-платежи.
Проверьте, что Stripe работает
У TourTask нет тестового режима для Stripe, а правила Stripe запрещают тестовые платежи реальными картами.
- 1
Откройте платёжную страницу Stripe
На своей странице бронирования забронируйте тур и выберите Stripe. Откроется платёжная страница Stripe: закройте её, не оплачивая.
- 2
Отмените тестовое бронирование
Откройте бронирование в TourTask и нажмите Отменить бронирование.
- 3
Проверьте первый платёж
Когда путешественник оплатит через Stripe, бронирование будет отмечено как оплаченное, а платёж появится в вашем Stripe Dashboard.
- 4
Проверьте веб-хук
В Stripe откройте вкладку Event deliveries получателя: у checkout.session.completed должен быть статус Delivered. Если доставка не удалась, проверьте URL получателя, формат Snapshot и поле Секрет веб-хука.
Частые вопросы
Те, что включены в настройках способов оплаты вашего Stripe Dashboard. Способ с отложенным зачислением, например банковское списание, отмечает бронирование как оплаченное только после поступления денег.
Нет. TourTask конвертирует сумму бронирования в валюту, которую вы выбрали для шлюза.
Нет. Платежи поступают на ваш собственный аккаунт Stripe, а Stripe выплачивает их в ваш банк.