Herald LogoHerald Docs
Sdk

Billing & Quotas

Managing subscriptions and overage billing for your Protocol.

Billing & Quotas

Herald uses a flexible billing model that combines fixed subscription tiers with pay-as-you-go overage payments.

Subscription Tiers

TierMonthly VolumePriceFeatures
Developer1,000FreeEmail only, Shared Gateway
Growth50,000$99/moTelegram + Email, Priority Queue
Scale250,000$299/moAll Channels, Custom Webhooks, Analytics
Enterprise1,000,000$999/moDedicated Infra, SLA, Custom Rate Limits

Overage Billing

If you exceed your monthly quota, Herald will automatically transition to overage billing.

  • Rate: $0.005 per additional notification.
  • Invoicing: Invoices are generated at the end of the month via our Helio Billing Integration.

Managing Billing via SDK

You can check your remaining balance and manage your subscription directly using the HelioBilling module.

import { HelioBilling } from "@herald-protocol/sdk";

const billing = new HelioBilling({ apiKey: "..." });

// Get current tier and usage
const usage = await billing.getUsage();
console.log(`${usage.sent} / ${usage.limit} used`);

// Start checkout for more credits
const { url } = await billing.createCheckoutSession({
  tier: "growth",
});

Auto-Renewal

Subscriptions are automatically renewed every 30 days. You can cancel or downgrade your subscription at any time via the Developer Dashboard.

On this page