Настройка вебхуков
Местоположение: Настройки → Платежи → Webhook
Местоположение:Настройки → Платежи → Webhook
Webhooks позволяют QuantaPay уведомлять ваш сервер в режиме реального времени, когда платеж завершен.
Поля
| Поле | Описание |
|---|---|
| Webhook URL | HTTPS-endpoint на вашем сервере, который будет получать POST-запросы при возникновении событий, связанных с платежами. Должен быть общедоступным URL. |
| Webhook Secret Key | Автоматически сгенерированный секретный ключ, включенный в JSON-payload webhook в качестве поляkeyИспользуйте его, чтобы убедиться, что входящие webhooks действительно отправлены QuantaPay. |
Настройка
- Введите URL вашего webhook endpoint (например,
https://yoursite.com/webhook/quantapay) - КлючWebhook Secret Keyгенерируется автоматически. Нажмите кнопку обновления, чтобы сгенерировать его заново, если необходимо.
- Сохраните настройки.
Как это работает
Когда платеж завершен (статусC), QuantaPay отправляет HTTP POST-запрос на ваш Webhook URL со следующими данными:
- JSON body, содержащий
{ "key": "your-secret", "transaction": { ... } } - Убедитесь, что поле
keykey соответствует вашему Webhook Secret Key, чтобы подтвердить подлинность.
Полный формат webhook payload, код проверки подписи и рекомендации см. в разделеAPI Reference: Webhooks.
Тестирование
Чтобы протестировать ваш webhook:
- Создайте тестовую checkout session через API
- Совершите небольшой платеж
- Проверьте логи вашего сервера на наличие входящего webhook
Совет: Используйте такой сервис, какwebhook.siteво время разработки, чтобы проверить входящие webhook payloads.