У цьому матеріалі
Де: Налаштування → Читачі та гроші → Підключення → Платежі
Відкрийте цю сторінку: admin.<your-site>/settings/connections/payments (замініть <your-site> на адресу вашого сайту)
Перед початком
- Спочатку підключіть Razorpay, Stripe або PayPal. Дивіться Платежі.
- Ви маєте бути власником сайту.
Кроки
Stripe та PayPal: Keynate налаштовує сповіщення про платежі автоматично, коли це можливо. На картці з'явиться напис "Сповіщення про оплату у Stripe налаштовано за вас." Якщо ні, ви побачите "Ще один крок" і кнопку Завершити налаштування. Виконайте кроки нижче.
Razorpay: автоматичне налаштування не підтримується. На картці Razorpay є блок із 3 кроків та перевіркою в реальному часі: напис Очікуємо перше повідомлення від Razorpay… зміниться на Ми отримали перше повідомлення від Razorpay. після першого ж платежу (тестового чи справжнього). Натисніть Перевірити зараз, щоб перевірити знову. Дивіться Підключення Razorpay.
Покрокова інструкція для будь-якого шлюзу:
- Відкрийте Налаштування → Читачі та дохід → Підключення → Платежі.
- На картці вашого шлюзу знайдіть блок Webhook.
- Натисніть Відкрити webhooks (на кнопці буде назва вашого шлюзу). Панель шлюзу відкриється в новій вкладці.
- У платіжному шлюзі натисніть Додати.
- Поверніться в Keynate, натисніть Копіювати поруч із URL вебхука і вставте її в шлюзі.
- Позначте галочками події, перелічені у блоці Keynate.
- Razorpay: натисніть Копіювати біля секретного ключа і вставте його як secret. Використовуйте різні ключі для тестового та робочого режимів.
- Збережіть налаштування в платіжному шлюзі.
- Stripe та PayPal після збереження покажуть код. У Stripe це signing secret, який починається з
whsec_. У PayPal це Webhook ID. Скопіюйте його та вставте у відповідне поле в Keynate. - Натисніть Перевірити з'єднання.
Варто знати
- Для тестового та робочого режимів потрібні окремі webhook.
- Якщо ви загубили секретний ключ, створіть новий webhook у шлюзі та вставте новий код у Keynate.
Часті проблеми
- "Вставте секрет webhook, який ви вказали в Razorpay." Поле в Keynate порожнє. Вставте той самий секретний ключ, що й у Razorpay.
- "Використовуйте різні секрети webhook для тесту та live." Створіть новий ключ для іншого режиму.
- "Вставте секретний ключ підпису webhook. Він починається з whsec_." Скопіюйте його зі Stripe після додавання кінцевої точки.
- "Вставте Webhook ID (лише літери та цифри)." Скопіюйте ID зі списку Webhooks у вашому додатку PayPal.
- У Razorpay досі пише "Очікуємо перше повідомлення від Razorpay…". Зробіть невеликий тестовий платіж. Сповіщення надійде після першої оплати. Потім натисніть Перевірити зараз.
- Замовлення лишається несплаченим, хоча читач заплатив. Webhook не налаштовано або вказано невірно. Щоночі Keynate також звіряє замовлення з вашим платіжним шлюзом і виправляє пропущені.
Питання
Часті запитання
Це те саме, що й ключ API?
Ні. Ключі API дозволяють Keynate звертатися до шлюзу. А webhook дозволяє шлюзу повідомляти Keynate про оплату.
Чи потрібні окремі webhook для тесту та live?
Так. Для тестового та робочого режимів потрібні окремі адреси.
Що робити, якщо я загублю секретний ключ?
Створіть новий webhook у платіжному шлюзі та вставте новий код у Keynate.
Що робити, якщо замовлення не зараховується, хоча читач заплатив?
Webhook відсутній або налаштований неправильно. Щоночі Keynate додатково звіряє дані з шлюзом і самостійно виправляє пропущені оплати.