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

Чтобы получать уведомления об изменении статуса платежей в вашем приложении, настройте, протестируйте и включите отправку через 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 Консоль.
• Если ключ шифрования оказался утерян или скомпрометирован, получите новый ключ и обновите его на своём сервере.