Настройка вебхуков

Вебхук — это программный код, который состоит из параметров и соответствующих им значений. При наступлении определенного события отправляется HTTP-запрос к вашему приложению, в котором передаются обновленные значения параметров. Чаще всего отправляется POST-запрос в JSON-формате.

Примеры событий: взаимодействие пользователя с каталогом товаров, оплата или отмена заказа.

Список вебхуков

Если вы хотите получать уведомления о событиях, реализуйте обработку вебхуков:

• Успешный платеж — отправляется, когда заказ оплачен, и содержит информацию о данных платежа и детали транзакции.
• Успешная оплата заказа — отправляется, когда был получен ответ об успешной обработке вебхука Успешный платеж. Содержит информацию о купленных товарах и ID транзакции.
• Возврат платежа — отправляется, когда заказ был отменен, и содержит информацию о данных отмененного платежа и детали транзакции.
• Отмена заказа — отправляется, когда был получен ответ об успешной обработке вебхука Возврат платежа. Содержит информацию о купленных товарах и ID отмененной транзакции.
• Проверка существования пользователя — отправляется на разных этапах оплаты. Содержит информацию о пользователе, который покупает игровой ключ.

Если вы используете персонализацию каталога товаров, реализованную на стороне вашего приложения, настройте обработку вебхука Персонализация каталога на стороне партнера.

Если вы используете внешний ID (ID транзакции в вашей системе) и хотите связать его с ID транзакции на стороне Иксоллы или хотите передать дополнительные параметры пользователя, настройте обработку вебхука Связывание ID транзакций.

Настройка вебхуков в Личном кабинете

Чтобы настроить вебхуки:

1. Откройте ваш проект в Личном кабинете.
2. Нажмите Настройки проекта в боковом меню и перейдите на вкладку Вебхуки.
3. Установите переключатель Вебхуки в положение Вкл.
4. Укажите URL-адрес, на который вы хотите получать вебхуки, в формате https://example.com.
5. Секретный ключ проекта для подписи вебхуков генерируется по умолчанию. Если вы хотите изменить его, нажмите значок обновления.
6. Нажмите Сохранить настройки.

Тестирование вебхуков в Личном кабинете

Если вы используете внешний ID (ID транзакции в вашей системе) и хотите связать его с ID транзакции на стороне Иксоллы или хотите передать дополнительные параметры пользователя, настройте обработку вебхука Связывание ID транзакций.

Если вебхуки настроены успешно, ниже блока настройки вебхуков отобразится блок тестирования вебхуков.

• Успешная оплата заказа и Отмена заказа
• Успешный платеж и Проверка существования пользователя

Примечание

Для тестирования необходимо создать хотя бы один пакет игровых ключей.

Чтобы протестировать вебхуки Успешная оплата заказа и Отмена заказа:

1. В блоке тестирования вебхуков перейдите на вкладку Магазин.
2. В раскрывающемся списке выберите тип Игровые ключи. Если пакеты игровых ключей еще не настроены в Личном кабинете, отобразится кнопка:
   • Подключить — если модуль Игровые ключи еще не подключен;
   • Настроить — если вы ранее уже подключали модуль, но не завершили настройку.

3. Укажите произвольное значение в поле ID заказа Иксоллы.
4. Выберите пакет игровых ключей из раскрывающегося списка.
5. Укажите платформы публикации игры.
6. Укажите произвольную стоимость игрового ключа в поле Сумма.
7. Выберите валюту, в которой оплачивается заказ.
8. Нажмите Тестировать.

На указанный URL-адрес придут вебхуки Успешная оплата заказа и Отмена заказа с указанными данными. Ниже кнопки Тестировать отобразятся результаты тестирования каждого типа вебхука.

Примечание

Если в блоке тестирования отобразилось предупреждение, что тест не пройден, проверьте настройки ответа на вебхук в вашем обработчике вебхуков. Причины ошибок в тестировании указаны в результатах тестирования.

Чтобы протестировать вебхуки Успешный платеж и Проверка существования пользователя:

1. В блоке тестирования вебхуков перейдите на вкладку Платежи.
2. Заполните необходимые поля:
   • ID пользователя;
   • ID заявки в Иксолле — ID транзакции на стороне Иксоллы;
   • Сумма;
   • Валюта — выберите валюту из раскрывающегося списка;
   • Invoice ID — ID транзакции на стороне вашей игры.

1. Вы можете использовать произвольные значения для тестирования.

1. Значение в поле ID пользователя используется для проверки существования пользователя в игре. Если вы хотите получить успешный ответ при тестировании, введите в поле ID пользователя значение, которое будет успешно провалидировано вашим сервером.

3. Нажмите Тестировать.

На указанный URL-адрес придут вебхуки Успешный платеж и Проверка существования пользователя с указанными данными. Ниже кнопки Тестировать отобразятся результаты тестирования каждого типа вебхука.

Примечание

Если в блоке тестирования отобразилось предупреждение, что тест не пройден, проверьте настройки ответа на вебхук в вашем обработчике вебхуков. Причины ошибок в тестировании указаны в результатах тестирования.

Обработчик вебхуков

Обработчик вебхуков — это программный код, который позволяет принимать поступающие вебхуки на указанный URL-адрес, генерировать подпись и отправлять ответ на вебхук на сервер Иксоллы.

Генерация подписи

При получении вебхука необходимо обеспечить безопасность передачи данных. Для этого из данных вебхука необходимо сгенерировать подпись и проверить, что она совпадает с подписью, отправленной в заголовке HTTP-запроса.

Чтобы сгенерировать подпись:

1. Осуществите конкатенацию JSON из тела запроса и секретного ключа проекта.
2. Примените SHA-1 криптографическую хэш-функцию к получившейся на первом шаге строке.

Отправка ответов на вебхук

Чтобы подтвердить получение вебхука, ваш сервер должен вернуть:

• 204 HTTP-код без тела сообщения в случае успешного ответа.
• 400 HTTP-код с описанием проблемы, если указанный пользователь не был найден или если передана недействительная подпись.

Ваш обработчик вебхуков также может возвращать код 5xx при временных проблемах на вашем сервере.

Если на вебхуки Успешная оплата заказа и Отмена заказа не был получен ответ или получен ответ с кодом 5xx, осуществляется повторная отправка вебхуков по следующему расписанию:

• 2 попытки с интервалом 5 минут;
• 7 попыток с интервалом 15 минут;
• 10 попыток с интервалом 60 минут.

Максимально осуществляется 20 попыток отправки вебхуков в течение 12 часов с момента первой попытки.

Если на вебхук Успешный платеж не был получен ответ или получен ответ с кодом 5xx, также осуществляется повторная отправка вебхуков через увеличивающийся временной интервал. Максимально осуществляется 12 попыток в течение 12 часов.

Если на вебхук Проверка существования пользователя не был получен ответ или получен ответ с кодом 400 или 5xx, повторная отправка вебхука Проверка существования пользователя не осуществляется.

Пользователь увидит ошибку, вебхуки Успешный платеж и Успешная оплата заказа отправлены не будут.

Оценить страницу

Что может сделать страницу еще лучше? Отправить

В другой раз

Спасибо за обратную связь!

Продолжить чтение