Skip to main content

Server Notifications for test payments (Sandbox)

Use Sandbox server notifications to verify your Pay SDK integration in your app before enabling real payments.

Access Control​

Management of test payment notifications is available to users with the following roles:

  • App Owner
  • Administrator
  • Release Manager

Configuring Test Notifications​

To start receiving test notifications:

  1. Open the RuStore Console and navigate to your application.

  2. In the left menu, select Monetization → Server Notifications.

    Connecting notifications

  3. In the For test payments card, click Connect.

  4. In the dialog that appears, enter your server’s notification URL for test payments. The address must start with https://.

    Server URL dialog

Example of a valid URL:

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

We recommend using a separate URL for test notifications to prevent mixing them with real payment notifications.

Decryption Key​

After saving the URL, you’ll receive a decryption key (AES-256). Copy and store it securely, as it’s displayed only once.

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

Be sure to copy the key and keep it in a safe place. You won’t be able to view it again.

img

Rotating the Decryption Key​

If you need to rotate the key:

  1. Click Update next to the Decryption Key field.

    img

  2. Confirm in the dialog that appears.

    img

  3. Copy and securely store the new key. The previous key will be invalidated.

    img

Testing Notifications​

Once the URL and key are configured, you can test:

  1. Click Check in the Test notification row.
  2. RuStore will send a test notification to your server.
  3. The result appears in the RuStore Console:
  • ✅ Server accepted the test notification — verification succeeded..
  • ❌ **Delivery error (e.g., 429 Unauthorized) — your server returned an error.

Test notifications do not have delivery guarantees and are not retried. Ensure your server responds correctly and accepts the notifications.

Enabling Test Notifications​

Once verification succeeds, toggle Notify on test payments on.

RuStore will then send notifications for test payment status changes.

Disabling Test Notifications​

To disable notifications:

  1. Open the RuStore Console and go to Monetization → Server Notifications.
  2. Toggle Send notifications off.

Notifications will not queue or retry while disabled. Re-enabling will resume with new events only.

Changing the Server URL​

If your notification URL changes:

  1. Open the RuStore Console and go to Monetization → Server Notifications.
  2. Toggle Send notifications off.
  3. Click Edit next to the URL and enter the new address.
  4. Re-run the connection test..
  5. Toggle Send notifications back on.

The new URL takes effect immediately; the decryption key remains unchanged.