Подключение вебхуков
Начало работы
Для того, чтобы начать принимать оповещения:
- Ознакомьтесь с документацией по интеграции
- Разработайте веб-сервис для получения вебхуков на своей стороне
Обратите внимание:- Вы можете использовать отдельные адреса для получения оповещений по разным событиям
- Каждый вебхук имеет подпись (signature), с помощью которой вы можете удостовериться, что он отправлен именно нами. Реализуйте проверку подписи на своей стороне для повышения безопасности взаимодействия
- Ваш веб-сервис должен отвечать на вебхук определенным образом
- Подключите отправку вебхуков через Merchant Portal. Для этого создайте эндпоинт для каждого события, по которому вы хотите получать вебхуки
Создание эндопоинта
Для подключения оповещения добавьте новый адрес получения - эндпоинт.
Обратите внимание:
- По каждому событию, по которому вы хотите получать оповещения, нужно создать отдельный эндпоинт
- Вы можете создать для каждого события только один единственный эндпоинт
Для настройки:
- Откройте Merchant Portal и пройдите авторизацию
- Перейдите в раздел Вебхуки
- Нажмите кнопку Создать эндпоинт в верхней части страницы
- Заполните URL эндпоинта – это адрес веб-сервиса на вашей стороне, который будет получать оповещения об определенном событии (Event). URL должен быть доступен по протоколу HTTPS. URL может быть не уникальным, то есть вы можете настроить разные адреса для получения оповещений по разным событиям или использовать один и тот же URL
- Выберите событие, о котором вы будете получать оповещения на URL эндпоинта. Вы можете создать только один эндпоинт для каждого события
Событие Softline Checkout Softline Payments Создание заказа Используется Используется, отправляется в момент создания ссылки на оплату (это момент создания платежа) Получение результата оплаты (успех/ошибка) Используется Используется Отправка/возврат лицензионной информации для продукта Используется Используется, отправляется в момент возврата оплаты Отмена/возобновление подписки Используется Не используется - Заполните секретный ключ – это значение будет использоваться при генерации подписи вебхука
Новый эндпоинт создается в статусе Активирован. В этом статусе оповещение по событию будет отправлено на URL эндпоинта при наступлении события. Если вы хотите приостановить оповещения, деактивируйте эндпоинт.