Перейти к основному содержимому

Серверные уведомления для тестовых платежей (Sandbox)

Используйте серверные уведомления Sandbox, чтобы проверять работоспособность интеграции Pay SDK в вашем приложении перед переходом к реальным платежам.

Доступ к управлению​

Управление уведомлениями о тестовых платежах доступно пользователям с ролями:

  • Владелец приложения
  • Администратор
  • Релиз-менеджер

Чтобы начать получать тестовые уведомления:

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

  2. В меню слева выберите Монетизация → Уведомления на сервер.

    img

  3. В блоке Для тестовых платежей нажмите Подключить.

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

    img

Пример валидного URL-адреса:

https://sandbox.notification-server.my-company.ru
Предупреждение

Рекомендуем для тестовых уведомлений использовать отдельный URL, отличный от используемого для реальных платежей.

Ключ для расшифровки уведомлений​

После сохранения URL-адреса вы получите ключ для расшифровки уведомлений, сгенерированный по алгоритму AES-256.

Предупреждение

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

img

Обновление ключа расшифровки​

Если нужно изменить ключ расшифровки:

  1. Нажмите кнопку Обновить напротив поля Ключ расшифровки.

    img

  2. Подтвердите действие в открывшемся окне.

    img

  3. Скопируйте и сохраните новый ключ в надёжном месте. Старый ключ станет недействительным.

    img

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

Важно

Применимо только для Pay SDK

После указания URL-адреса и ключа вы можете проверить работоспособность настройки:

  1. Нажмите кнопку Проверить в строке Проверка соединения.
  2. RuStore отправит тестовое уведомление на ваш сервер.
  3. Результат проверки отобразится в RuStore Консоли:

  • ✅ Сервер принял тестовое уведомление — проверка прошла успешно.

  • ❌ Ошибка доставки (например, 429 Unauthorized) — сервер вернул ошибку. Проверьте конфигурацию сервера и доступность сети.

    SuccessfulError

Тестовые уведомления не имеют гарантий доставки и не повторяются. Убедитесь, что ваш сервер отвечает корректно и принимает уведомления.

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

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

Как только вы убедитесь в корректности конфигурации, активируйте переключатель Уведомлять о тестовых платежах.

После этого RuStore начнёт отправлять уведомления о тестовых платежах при изменении их статусов.

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

Для отключения уведомлений:

  1. Откройте RuStore Консоль и перейдите в Монетизация → Уведомления на сервер.
  2. Деактивируйте переключатель Уведомлять о тестовых платежах.

После отключения уведомления не копятся и не повторяются. При повторном включении отправка уведомлений начнётся только для новых событий.

Изменение URL-адреса сервера​

Если необходимо изменить URL сервера:

  1. Откройте RuStore Консоль и перейдите в Монетизация → Уведомления на сервер.
  2. Деактивируйте переключатель Уведомлять о тестовых платежах.
  3. Нажмите Изменить рядом с текущим URL и укажите новый адрес.
  4. Повторите тестирование отправки уведомлений.
  5. Активируйте переключатель Уведомлять о тестовых платежах снова.

Новый адрес начнёт действовать сразу после активации, ключ шифрования останется прежним.