- Учётные данные API
- Ключ API
- Ключ для публикации
- Секрет веб-хука
Stripe Elements размещает поля для карты Stripe на вашей странице бронирования, и путешественники платят картой, не покидая её. Нужен аккаунт Stripe, который принимает реальные платежи: как его открыть, показано в руководстве по Stripe.
Скопируйте ключи из Stripe
- 1
Откройте ключи API в рабочем режиме
Откройте dashboard.stripe.com/apikeys и убедитесь, что вы в рабочем режиме (live mode), а не в песочнице (sandbox). Тестовый ключ не вызывает ошибку: он отмечает бронирования как оплаченные деньгами, которых не существует.
- 2
Скопируйте ключ для публикации
В разделе Standard keys скопируйте Publishable key. Он начинается с pk_live_.
- 3
Скопируйте секретный ключ
Скопируйте Secret key (если он скрыт, нажмите Reveal live key). Он начинается с sk_live_. Никому его не показывайте: с ним можно списывать деньги с карт от вашего имени.
Добавьте веб-хук в Stripe
Без него деньги с путешественников списываются, а их бронирования остаются неподтверждёнными.
Ваш адрес веб-хука TourTask для Stripe Elements
https://api.tourtask.com/v1/payments/stripe-elements/notifications/booking- 1
Создайте получателя событий
Откройте dashboard.stripe.com/webhooks, по-прежнему в рабочем режиме, и нажмите Create an event destination.
- 2
Выберите Your account и Snapshot
Выберите Your account и формат данных Snapshot: TourTask не умеет читать события Thin, которые рекомендует Stripe.
- 3
Выберите событие
Выберите payment_intent.succeeded и никаких других событий.
- 4
Выберите Webhook endpoint
Нажмите Continue и выберите тип получателя Webhook endpoint.
- 5
Введите адрес TourTask
Нажмите Continue, вставьте указанный выше адрес TourTask в поле Endpoint URL и нажмите Create destination.
- 6
Скопируйте секрет подписи
На странице получателя нажмите Reveal secret и скопируйте секрет подписи. Он начинается с whsec_.
Уже есть получатель для шлюза Stripe? Всё равно добавьте новый: каждому шлюзу нужен свой.
Добавьте Stripe Elements в TourTask
- 1
Откройте карточку Stripe Elements
Откройте Конфигурация → Варианты оплаты и нажмите карточку Stripe Elements в разделе Онлайн-платежи → Платежные шлюзы. Её нет? Выберите Показать все шлюзы под карточками.
- 2
Выберите страну и валюту
В поле Страна выберите страну, где находятся ваш аккаунт Stripe Elements и его банковский счёт, а в поле Валюта — валюту, в которой платят путешественники. Нажмите Добавить. Чтобы потом изменить что-либо из этого, удалите Stripe Elements кнопкой Удалить и добавьте заново.
- 3
Введите учётные данные API
В разделе Аутентификация на карточке есть поле для каждого из них:
Ключ API
Ключ для публикации
Секрет веб-хукаКаждое поле сохраняется, когда вы щёлкаете за его пределами.
- 4
Активируйте Stripe Elements
Нажмите Активировать, когда все поля заполнены. Карточка получает статус Активный, и путешественники могут платить через Stripe Elements на вашей странице бронирования. Каждый платёж поступает прямо на ваш собственный счёт Stripe Elements: TourTask никогда не удерживает ваши деньги.
Ключ API: ваш секретный ключ sk_live_…
Ключ для публикации: ваш ключ pk_live_…
Секрет веб-хука: ваш секрет подписи whsec_…
Нажмите Открыт по умолчанию в карточке, чтобы платёжная форма показывалась раскрытой вверху вашей страницы бронирования.
Проверьте, что Stripe Elements работает
У TourTask нет тестового режима для Stripe Elements, а правила Stripe запрещают тестовые платежи реальными картами.
- 1
Откройте форму оплаты картой
На своей странице бронирования забронируйте тур и выберите оплату картой: появится форма оплаты Stripe. Закройте страницу, не оплачивая.
- 2
Отмените тестовое бронирование
Откройте бронирование в TourTask и нажмите Отменить бронирование.
- 3
Проверьте первый платёж
Когда путешественник оплатит картой, бронирование будет отмечено как оплаченное, а платёж появится в вашем Stripe Dashboard.
- 4
Проверьте веб-хук
В Stripe откройте вкладку Event deliveries получателя: у payment_intent.succeeded должен быть статус Delivered.
Проверьте веб-хук в Stripe: рабочий режим, формат Snapshot, событие payment_intent.succeeded и точный адрес. В TourTask в поле Секрет веб-хука должен быть секрет подписи именно этого получателя. Вкладка Event deliveries получателя в Stripe показывает каждую неудачную попытку.
Добавьте Apple Pay и Google Pay
Apple Pay и Google Pay — отдельные шлюзы, которые настраиваются как Stripe Elements, с теми же двумя ключами. Каждому нужен свой получатель веб-хука со своим адресом, а секрет подписи этого получателя вставляется в поле Секрет веб-хука этого шлюза.
Apple Pay
https://api.tourtask.com/v1/payments/apple-pay/notifications/bookingGoogle Pay
https://api.tourtask.com/v1/payments/google-pay/notifications/bookingВ отличие от платёжной формы, кнопки кошельков показываются только на адресах, зарегистрированных в Stripe в разделе Settings → Payment method domains. Зарегистрируйте каждый адрес, на котором бронируют путешественники: ваш собственный сайт, yourname.tourtask.com и ваш сайт TourTask (yourname.tourtask.site или его собственный домен). example.com и www.example.com — это две отдельные записи.
Частые вопросы
Нет. Данные карты передаются прямо из браузера путешественника в Stripe.
Со Stripe Elements путешественники остаются на вашей странице бронирования, а Stripe отправляет их на собственную страницу Stripe и обратно. Можно использовать оба.
Те, что включены в настройках способов оплаты вашего Stripe Dashboard. Карты включены по умолчанию.
Нет. TourTask конвертирует сумму бронирования в валюту, которую вы выбрали для шлюза.