Skip to content

Push Notifications

Subscrypts Pulse sends push notifications to keep you informed about important subscription events — payments, expirations, and balance warnings — without needing to check the app manually.

Notification Types

Pulse supports six notification types, divided into two categories:

Real-Time Events

These notifications are triggered immediately when an on-chain event is detected:

Type Trigger Example
Payment Collected A subscription payment is processed on-chain "25 SUBS paid for subscription #142"
New Subscription A new subscription is created for your wallet "Subscribed to Premium Access from 0x8Ed1..."
Subscription Stopped A subscription is revoked or cancelled "Subscription #142 has been stopped"

Real-time notifications are powered by blockchain event listeners that detect _subscriptionPay, _subscriptionCreate, and _subscriptionStop events as they happen.

Scheduled Scans

These notifications are generated by periodic scans that run hourly:

Type Trigger Example
Expiring Soon Subscription approaching its next payment date "Subscription #142 expires in 3 days"
Expired Subscription has passed its payment date "Subscription #142 has expired"
Low Balance SUBS balance below your configured threshold "Your balance is 5 SUBS. You have upcoming subscription payments."

Scheduled notifications include a 24-hour cooldown per subscription — you won't receive the same alert more than once per day for the same subscription.

Notification Preferences

You can customize notifications in the Settings screen to match your needs.

Per-Type Toggles

Enable or disable each notification type independently:

  • New Subscription — on/off
  • Payment Collected — on/off
  • Subscription Stopped — on/off
  • Subscription Expired — on/off
  • Low Balance — on/off

Expiry Warning Threshold

Choose when you want to be warned about expiring subscriptions:

  • Percentage mode (default) — Warns when the remaining time drops below a percentage of the billing cycle. Default: 25%. For example, with a 30-day subscription, you'd be notified when 7.5 days remain.
  • Fixed days mode — Warns a fixed number of days before expiry (1–7 days).

The percentage mode adapts automatically to different subscription frequencies — shorter subscriptions get earlier warnings relative to their cycle length.

Quiet Hours

Set a UTC time range during which notifications are silenced:

  • Example: 22:00–07:00 UTC suppresses all notifications during nighttime
  • Notifications that occur during quiet hours are not lost — they are delivered when quiet hours end

Low Balance Threshold

Configure the minimum SUBS balance that triggers a low balance alert:

  • Default: 10 SUBS
  • The bot only checks wallets that have upcoming recurring payments
  • Adjust this threshold based on your subscription costs

How Push Notifications Work

Pulse uses two delivery methods depending on your platform:

Mobile (iOS & Android)

  • Push notifications are delivered via Firebase Cloud Messaging (FCM)
  • On iOS, FCM routes through Apple Push Notification Service (APNs)
  • Notifications appear as standard OS-level alerts, even when the app is closed

Desktop (Chrome, Edge, Firefox)

  • Push notifications are delivered via Web Push (VAPID)
  • The Pulse service worker handles incoming push messages in the background
  • Notifications appear as standard browser notifications

Notification History

All notifications are stored in the app for review:

  • Access your notification history in the Notifications tab
  • Notifications are organized by date (Today, Yesterday, etc.)
  • Tap a notification to mark it as read and navigate to the related subscription
  • An unread count badge shows how many new notifications you have
  • Notification history is automatically cleaned up after 90 days

Enabling Notifications

When you first set up Pulse, the onboarding wizard asks for push notification permission. If you skipped this step:

  1. Open Settings in Pulse
  2. Ensure at least one notification type is enabled
  3. Your browser or device will prompt you to allow notifications

Browser Permissions

If notifications aren't working, check your browser or device settings to ensure pulse.subscrypts.com has notification permission enabled.