Перейти к содержимому
QR code to Stripe paymentsДокументация QR2Stripe

← Все инструкции

Настройка плагина для WordPress

Плагин QR2Stripe Pay создаёт платежи, показывает QR-код и помечает платёж как оплаченный, когда Stripe его подтверждает.

Temporary Stripe key Ключ A. Автоматическая настройка Stripe использует его один раз и не сохраняет.
Location name, Street, City, Postal code, Country (2 letters) Адрес Terminal Location. Страна должна совпадать со страной вашего аккаунта Stripe.
Terminal Location ID Идентификатор Terminal Location, начинается с tml_. Заполняется автоматической настройкой.
Webhook signing secret Секрет подписи вебхука Stripe, начинается с whsec_. Без него платежи никогда не помечаются как оплаченные.
QR mode API (рекомендуется) или Inline. См. статью о режимах API и Inline.
Website Stripe key (API mode) Ключ B. Вместо сохранения здесь можно определить QR2STRIPE_API_KEY в wp-config.php, тогда ключ не хранится в базе данных.
QR validity (minutes) Сколько времени QR-код можно оплатить. По умолчанию 10 минут.
Default currency, Merchant name Валюта новых платежей и название продавца, которое показывается на телефоне.

Установка плагина: в WordPress откройте Плагины → Добавить новый → Загрузить плагин, загрузите qr2stripe-pay-VERSION.zip и нажмите Активировать. Автоматически создаётся страница Payment с шорткодом [qr2stripe_payment].

Автоматическая настройка Stripe: откройте QR2Stripe → Settings → Automatic Stripe setup, вставьте ключ A, заполните название и адрес Location и нажмите Set up Stripe. Плагин создаёт Terminal Location и вебхук и сохраняет Location ID и секрет подписи вебхука. Ключ A используется один раз и не сохраняется. Сразу после этого удалите ключ A в Stripe.

Выберите режим QR. В режиме API вставьте ключ B в поле Website Stripe key (API mode) или определите его в wp-config.php (см. первый пример). Сохраните настройки.

Жёлтые предупреждения вверху страниц QR2Stripe показывают, чего ещё не хватает. Когда они исчезнут, сайт готов.

Чтобы выполнить часть в Stripe вручную, создайте Location в Stripe (Terminal → Locations, скопируйте ID tml_) и вебхук (Developers → Webhooks → Add endpoint или Add destination) для событий из Your account, единственное событие payment_intent.succeeded и адрес endpoint из второго примера. Покажите секрет подписи и вставьте Location ID и секрет в настройки плагина. Вебхуку не нужны разрешения. Он должен быть доступен по публичному HTTPS, localhost не работает.

Адрес сайта должен использовать HTTPS, а постоянные ссылки должны быть включены (Настройки → Постоянные ссылки, любой вариант, кроме «Простые»). Иначе адрес в QR содержит ?rest_route=, и приложение его отклоняет.

define('QR2STRIPE_API_KEY', 'rk_...');
https://YOUR-SITE/wp-json/qr2stripe/v1/stripe-webhook