В этом материале
Где: Настройки → Читатели и деньги → Подключения → Платежи
Откройте эту страницу: admin.<your-site>/settings/connections/payments (замените <your-site> адресом вашего сайта)
Перед началом
- Сначала подключите Razorpay, Stripe или PayPal. См. раздел Платежи.
- Вы должны быть владельцем сайта.
Инструкция
Stripe и PayPal: если возможно, Keynate настраивает уведомления в вашем аккаунте автоматически. На карточке появится надпись: «Уведомления об оплате в Stripe настроены автоматически». Если настроить не удалось, появится надпись «Остался еще один шаг» и кнопка Завершить настройку. Выполните шаги ниже.
Razorpay: автоматическая настройка невозможна. В блоке Razorpay есть пошаговая подсказка из 3 шагов с проверкой: статус Ожидание первого сообщения от Razorpay… сменится на Первое сообщение от Razorpay получено после первого платежа (тестового или реального). Нажмите Проверить сейчас, чтобы проверить снова. См. Подключение Razorpay.
Шаги для любого платежного шлюза:
- Откройте Настройки → Читатели и доход → Подключения → Платежи.
- На карточке нужного шлюза найдите блок Вебхук.
- Нажмите Открыть вебхуки (на кнопке будет имя шлюза). Панель управления платежного шлюза откроется в новой вкладке.
- В панели шлюза нажмите Добавить.
- Вернитесь в Keynate, нажмите Копировать рядом с URL вебхука и вставьте скопированное в панели шлюза.
- Отметьте события, перечисленные в блоке Keynate.
- Razorpay: нажмите Копировать рядом с секретным кодом и вставьте его как секрет. Используйте разные секреты для тестового и боевого режимов.
- Сохраните изменения в панели шлюза.
- Stripe и PayPal покажут код после сохранения. В Stripe он называется signing secret и начинается с
whsec_. В PayPal он называется Webhook ID. Скопируйте его и вставьте в соответствующее поле в Keynate. - Нажмите Проверить соединение.
Полезно знать
- Для тестового и боевого режимов нужны отдельные вебхуки.
- Если вы потеряли секретный ключ, создайте новый вебхук в панели шлюза и вставьте новый код в Keynate.
Частые проблемы
- «Вставьте секрет вебхука, указанный в Razorpay». Поле в Keynate не заполнено. Вставьте тот же секрет, который вы указали в Razorpay.
- «Используйте разные секреты вебхука для теста и боевого режима». Сгенерируйте новый секрет для второго режима.
- «Вставьте signing secret вебхука. Он начинается с whsec_». Скопируйте его из Stripe после добавления конечной точки (endpoint).
- «Вставьте Webhook ID (только буквы и цифры)». Скопируйте ID из списка вебхуков в вашем приложении PayPal.
- В Razorpay отображается «Ожидание первого сообщения от Razorpay…». Сделайте небольшой тестовый платеж. Сообщение поступит после первой оплаты. Затем нажмите Проверить сейчас.
- Заказ не отмечен как оплаченный, хотя читатель совершил платеж. Вебхук не настроен или указан неверно. Каждую ночь Keynate сверяет заказы с платежным шлюзом и исправляет пропущенные.
Вопросы
Часто задаваемые вопросы
Это то же самое, что и ключ API?
Нет. Ключи API нужны Keynate для отправки запросов в шлюз. А вебхук позволяет шлюзу передавать данные в Keynate.
Нужен ли отдельный вебхук для теста и боевого режима?
Да. Для тестового и боевого режимов требуется отдельный вебхук.
Что делать, если секретный ключ утерян?
Создайте новый вебхук в панели платежного шлюза и вставьте новый код в Keynate.
Что делать, если читатель оплатил заказ, но статус не изменился?
Вебхук отсутствует или настроен неправильно. Keynate каждую ночь сверяет заказы со шлюзом и автоматически обновляет пропущенные оплаты.