Включение отправки уведомлений

Чтобы получать уведомления об изменении статуса платежей в вашем приложении, настройте, протестируйте и включите отправку через RuStore Консоль.

Перед включением уведомлений

• Настройте сервер для получения уведомлений от RuStore.

• Убедитесь, что компания не заблокирована, у нее подключена монетизация и в приложении есть возможность совершать покупки.

  подсказка

  • Как подключить монетизацию
  • Как создать платный товар в приложении

Настройка отправки уведомлений

1. Откройте RuStore Консоль и перейдите в ваше приложение.

2. Выберите в меню слева «Монетизация» — «Уведомления на сервер» и нажмите «Подключить».

3. Укажите URL-адрес вашего сервера, который будет принимать уведомления. Адрес должен начинаться с https://.

   Пример валидного URL-адреса: https://www.notification-payment-server.my-company.ru

4. Скопируйте и сохраните ключ для расшифровки уведомлений. Его необходимо добавить в механизм симметричного шифрования на вашем сервере.

Тестирование отправки уведомлений

Перед тем, как включать отправку уведомлений протестируйте конфигурацию сервера. Для этого нажмите «Отправить» в строке «Тестовое уведомление». Ваш сервер получит тестовое уведомление.

На него не распространяются гарантии доставки. Отправлять тестовое уведомление вы можете не чаще, чем раз в 30 секунд.

Ответ от сервера отобразится в RuStore Консоль. Если он отличается от «Уведомление успешно доставлено», нужно проверить конфигурацию сервера и сетевую доступность между RuStore и сервером. В таблице ниже собраны возможные ответы сервера:

Ответ сервера	Ошибка	Описание
HTTP-код 4xx или 5xx	Not Found, Unauthorized и другие	Отображаются текстовые коды ошибок согласно RFC 7231
Превышено время запроса	Read timed out	На исполнение запроса от RuStore до Backend вашего сервера есть ограничение по времени, при превышении которого появляется эта ошибка. Лимит составляет 3 секунды, если в сокет ничего не пишется, но не более 5 секунд ожидания ответа в целом
Соединение сброшено BE разработчика	Connection reset	Backend вашего сервера сбросил соединение
Проблемы с SSL	Unsupported or unrecognized SSL message	Проблемы с SSL, проверьте сертификат сервера
	Name or service not known	Указан несуществующий адрес сервера

Включение отправки уведомлений

Как только вы убедитесь, что сервер корректно получает уведомления и отправляет подтверждения о доставке, активируйте переключатель «Отправлять уведомления». Сервис начнёт отправлять уведомления в режиме реального времени.

Уведомления отправляются в ситуациях, когда у платежа изменяется статус.

Ситуация	Изменение статуса платежа
Пользователь выбрал способ оплаты в приложении, платёж исполняется	У платежа появляется статус executed
Пользователь отменил платёж	Статус платежа меняется на cancelled
Средства пользователя зарезервированы, счёт ожидает подтверждения (только для покупки потребляемых продуктов)	Статус платежа меняется на paid
Оплата прошла успешно	Статус платежа меняется на confirmed
Средства по счёту возвращены покупателю	Статус платежа меняется на refunded
Произошла отмена резервирования средств	Статус платежа меняется на reversed

Если в ответ на уведомление ваш сервер присылает ошибку, RuStore попытается отправить уведомление повторно, см. Гарантии доставки уведомлений.

Что дальше

Сразу после включения: убедитесь, что информация из payload уведомления расшифровывается корректно. Именно в ней хранятся данные о приложении, купленном продукте, а также новом и предыдущем статусах.

В дальнейшем:

• При сбоях или технических работах на сервере вы можете временно отключить отправку уведомлений.
• Если URL-адрес для получения уведомлений изменился, измените его в RuStore Консоль.
• Если ключ шифрования оказался утерян или скомпрометирован, получите новый ключ и обновите его на своём сервере.