Включение отправки уведомлений
Чтобы получать уведомления об изменении статуса платежей в вашем приложении, настройте, протестируйте и включите отправку через RuStore Консоль.
Перед включением уведомлений
-
Настройте сервер для получения уведомлений от RuStore.
-
Убедитесь, что компания не заблокирована, у нее подключена монетизация и в приложении есть возможность совершать покупки.
Настройка отправки уведомлений
-
Откройте RuStore Консоль и перейдите в ваше приложение.
-
Выберите в меню слева Монетизация > Уведомления на сервер и нажмите Подключить.
-
Укажите URL-адрес вашего сервера, который будет принимать уведомления. Адрес должен начинаться с
https://
.Пример валидного URL-адреса:
https://www.notification-payment-server.my-company.ru
-
Скопируйте и сохраните ключ для расшифровки уведомлений. Его необходимо добавить в механизм симметричного шифрования на вашем сервере.
Тестирование отправки уведомлений
Перед тем, как включать отправку уведомлений протестируйте конфигурацию сервера. Для этого нажмите Отправить в строке Тестовое уведомление. Ваш сервер получит тестовое уведомление.
На него не распространяются гарантии доставки. Отправлять тестовое уведомление вы можете не чаще, чем раз в 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 Консоль.
- Если ключ шифрования оказался утерян или скомпрометирован, получите новый ключ и обновите его на своём сервере.