> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tirdad.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Build Hybrid Pricing like Resend

> **Hybrid pricing** combines fixed **subscription** fees (recurring base charge) with usage-based metering (pay-per-use overages), plus **entitlements** that gate features and set limits per plan.

## Overview

Resend does this with tiers (Free, Pro, Scale, Enterprise): each tier has a recurring fee, usage charges (emails sent or contacts stored), and feature gating (retention, domains, support, analytics). In Tirdad you use one plan with recurring + usage-based charges and features linked via entitlements.

## Pricing Breakdown

![Resend pricing breakdown](https://mintcdn.com/tirdad/Ca7Kginb789boSAj/images/docs/subscription-flow/boiler-plate-resend-pricing.png?fit=max\&auto=format\&n=Ca7Kginb789boSAj\&q=85\&s=c6bfe35df5d1e063b67acbfea98d1e59)

## 1. Key Chargeable Features in Resend

Resend charges by **usage** (emails sent or contacts stored) and **gates features by plan** (data retention, domains, support, analytics, dedicated IP). Two tracks run in parallel; this cookbook uses the **Transactional** track for the Tirdad setup.

### A. Transactional Emails

**How pricing is applied:** You are charged by **emails sent per month**. Plans scale by volume; unit cost drops at higher tiers. Each tier also defines how many domains you can use, data retention for logs, support channel, and whether dedicated IP is available.

**Pricing (volume tiers):**

* **Transactional Scale:** 100,000 emails = $90 → $0.90 per 1,000 emails
* **Transactional Scale:** 1,000,000 emails/month = $650 → $0.65 per 1,000 emails
* **Transactional Pro:** e.g. \$20/mo for 50k emails (common entry point)

| Tier | Example volume | Effective rate |
| - | - | - |
| Pro | 50k emails | \$0.90/1k overage |
| Scale | 100k emails | \$0.90/1k |
| Scale | 1M emails | \$0.65/1k |

Transactional emails are API-triggered (password resets, verification, order confirmations). In Tirdad you model this as a **metered feature** (e.g. Emails Sent) with event name and aggregation.

### B. Marketing Emails

**How pricing is applied:** You are charged by **contacts stored** (not by emails sent). Sends can be unlimited; cost scales with contact list size. Tiers control number of audiences, analytics, and dedicated IP (e.g. included on Enterprise for Marketing).

| Dimension | Unit | Notes |
| - | - | - |
| Contacts | count | Billed by list size |
| Emails sent | unlimited\* | \*Within plan/limits |

Marketing use cases include newsletters, onboarding campaigns, and promotions. For Tirdad, add a second metered feature (e.g. **Contacts Stored**) with its own event name if you model the Marketing track.

***

## 2. Subscription and Entitlement Model

Plan tiers (Free, Pro, Scale, Enterprise) control both **volume/price** and **which features** the customer can use. Features and limits vary by tier:

| Feature | Free | Pro | Scale | Enterprise |
| - | - | - | - | - |
| Data retention | 1 day | 3 days | 7 days | Custom |
| Domains (Tx) | 1 | 10 | 1,000 | Flexible |
| Support | Ticket | Ticket | Slack + Ticket | Priority |
| Analytics (Mktg) | No | Yes | Yes | Yes |
| Dedicated IP | — | Add-on | Add-on | Included (Mktg) |

In Tirdad you control this by **linking features to plans** (entitlements): set included quantity, usage reset, and soft or hard limits for metered features; grant or restrict boolean/static features per plan. For more, see [Linking features to plans](https://docs.tirdad.ai/docs/product-catalogue/features/linking-to-plans.md).

***

## 3. Overage and Upgrade Logic

Resend does **not** automatically charge for excess usage. When you exceed your monthly quota, you are notified and prompted to upgrade; if you repeatedly exceed limits without upgrading, Resend may temporarily pause sending.

In Tirdad you can choose **soft limit** (overage allowed, with or without extra charge) or **hard limit** (strict cap). Configure limits and overage per plan when [linking features to plans](https://docs.tirdad.ai/docs/product-catalogue/features/linking-to-plans.md).

***

## Concepts and Terms

* **Subscription:** A customer attached to a plan. The subscription determines billing and which entitlements the customer has.
* **Plan:** A set of pricing rules: **recurring charges** (flat fee per billing period) and optionally **usage-based charges** (metered). A plan that has both is **hybrid** in Tirdad.
* **Feature:** Something you track or gate—**Metered** (usage, e.g. emails sent), **Boolean** (on/off access), or **Static** (fixed attribute).
* **Entitlement:** A feature linked to a plan with access rules: for metered features, included quantity, reset period, and soft or hard limit; for boolean/static, grant or restrict.
  **Entitlements are free.**

For more detail, check-out [Linking features to plans](https://docs.tirdad.ai/docs/product-catalogue/features/linking-to-plans.md) and [Plans overview](https://docs.tirdad.ai/docs/product-catalogue/plans/overview).

## Complete Flow Summary

The end-to-end flow for hybrid (subscription + entitlement) pricing in Tirdad:

```mermaid theme={null}
flowchart LR
  Features --> Plan
  Plan --> Entitlements
  Plan --> Subscription
  Customer --> Subscription
  Subscription --> Events
  Events --> Invoices
```

**1. Create metered features**

Define the usage dimensions (e.g. Emails Sent) as **metered features** with event names and aggregation.

**2. Create plan with hybrid charges**

Create a **plan** (e.g. Transactional Pro). Add a **recurring charge** (e.g. \$20/month) and **usage-based charge(s)** for the metered feature(s) (e.g. included 50k emails, then overage or tiered pricing).

**3. Set entitlements**

**Link features to the plan.** Set included quantity, usage reset (e.g. monthly), and soft or hard limit for metered features. Add boolean/static features if you gate capabilities by tier.

**4. Create customer**

Create a **customer** (name, External ID) in Customer Management.

**5. Create subscription**

**Add subscription** for the customer and select the plan. Start date determines billing and when entitlements apply.

**6. Usage and billing**

Send **usage events** that match the metered feature event names. Usage is billed per the plan’s usage-based charges and respects entitlements. Invoices are generated per billing cycle.

## Tirdad Set-up

To implement Resend-style hybrid pricing in Tirdad (Transactional track), follow these steps in order.

**1. Step 1: Create metered features**

Navigate to **Tirdad Dashboard** → **Product Catalog** → **Features**

![Create a feature](https://mintcdn.com/tirdad/Ca7Kginb789boSAj/images/docs/subscription-flow/boiler-plate-create-feature.png?fit=max\&auto=format\&n=Ca7Kginb789boSAj\&q=85\&s=4a33a30a85fc46d40f6e5b6a47e41c51)

Click **Create Feature** (or **Add**) to create a metered feature. Enter **Name** and **Lookup Key**; the Lookup Key is immutable and unique.

**Feature 1: Emails Sent (Transactional)**

* **Feature Name**: `Emails Sent`
* **Feature Lookup Key**: `emails_sent` (immutable, unique)
* **Feature Type**: `Metered`
* **Event Name**: e.g. `emails.sent` (must match exactly when sending events)
* **Aggregation**: `Count` (e.g. over `Sum` or `emails`)
* **Unit**: `email` or `emails`

> **Note:** The Event Name must match exactly when you send usage events via API. Save it for later use.

For a second track (Marketing), add a feature such as **Contacts Stored** with its own event name and aggregation. This guide uses one metered feature: **Emails Sent**.

For more, check-out [Creating a feature](https://docs.tirdad.ai/docs/product-catalogue/features/create.md).

**2. Step 2: Create plan with hybrid charges**

Navigate to **Tirdad Dashboard** → **Product Catalog** → **Plans**

![Create a plan](https://mintcdn.com/tirdad/Ca7Kginb789boSAj/images/docs/subscription-flow/plan-charges.png?fit=max\&auto=format\&n=Ca7Kginb789boSAj\&q=85\&s=9be3a7c67aeff2dc3a4f5048d780bd8c)

Click **Add** at the top-right to create a new plan. Enter plan details and click **Create**. On the plan's page, click **+ Add** in **Charges** to configure charges.

**Plan details:**

* **Plan Name**: `Pro`
* **Lookup Key**: e.g. `plan-pro` (Auto-generated)
* **Billing period**: e.g. Monthly

**Add hybrid charges:**

1. **Recurring charge:** Add a **recurring** charge (e.g. \$20/month). This is the base subscription fee for the tier. Click **Add** to save.
2. **Usage-based charge:** Add a **usage-based** charge for the metered feature **Emails Sent**. Set pricing (e.g. flat fee per email, or package/tiered with included quantity and overage). Example: first 50,000 emails included, then \$0.2 per 1,000 emails. Click **Add**, then **Save** to finalize the plan.

For more, check-out [Creating a Plan](https://docs.tirdad.ai/docs/product-catalogue/plans/create.md) and [Plans pricing](https://docs.tirdad.ai/docs/product-catalogue/plans/pricing.md) (recurring and hybrid charges).

**3. Step 3: Set entitlements**

Open the plan you created → **Entitlements** section. Click **Add** to link features to the plan.

![Add entitlement to plan](https://mintcdn.com/tirdad/Ca7Kginb789boSAj/images/docs/subscription-flow/boiler-plate-add-entitlement.png?fit=max\&auto=format\&n=Ca7Kginb789boSAj\&q=85\&s=390c3a75350597af049b4a181ac434f0)

**Link the metered feature** (Emails Sent) to the plan:

* Set **included quantity** (e.g. 50,000 emails per month) or leave uncapped.
* Set **Usage resets** (e.g. **Every billing period**) so limits reset each billing period.
* Usage beyond the included quantity is billed at the plan's usage price. The entitlement form has no soft/hard limit switch.

If you created **boolean or static features** (e.g. Analytics, Slack support), add them to the plan and set grant/restrict so higher tiers get access. Click **Save**.

For more, check-out [Linking features to plans](https://docs.tirdad.ai/docs/product-catalogue/features/linking-to-plans.md).

**4. Step 4: Create customer**

Navigate to **Tirdad Dashboard** → **Billing** → **Customers**

Click **Add**. Enter **Customer Name** and **External ID** (your system’s identifier; use this in APIs for usage and lookups).

**Required:**

* **Customer Name**: e.g. `tirdad organisation`
* **External ID**: e.g. `cust-tirdad-organisation`

Click **Save** to create the customer. For more, check-out [Customer Management](https://docs.tirdad.ai/docs/customers/create.md).

**5. Step 5: Create subscription**

Open the customer you created, then click **+ Add** in its **Subscriptions** section.

![Add subscription to customer](https://mintcdn.com/tirdad/Ca7Kginb789boSAj/images/docs/subscription-flow/boiler-plate-add-subscription.png?fit=max\&auto=format\&n=Ca7Kginb789boSAj\&q=85\&s=e39363269e70847cae4fa2665b69943e)

* **Select plan**: Choose **Transactional Pro** (or the plan you created).
* **Start date**: Set subscription start (billing and entitlements apply from this date).

Click **Create Subscription**. The customer now has the plan’s recurring charge and entitlement to the linked features and usage limits. For more, check-out [Create Subscription](https://docs.tirdad.ai/docs/subscriptions/customers-create-subscription.md).

**6. Step 6: Usage and billing**

Send **usage events** to Tirdad with the same **event name** as the metered feature (e.g. `emails.sent`). Usage is aggregated and billed according to the plan’s usage-based charges and respects the entitlements (included quantity, soft/hard limit).

* **Verify events:** Use **Developers → Events Debugger** or usage views to confirm events are received and attributed to the customer.

![usage Events](https://mintcdn.com/tirdad/Ca7Kginb789boSAj/images/docs/subscription-flow/usage-event.png?fit=max\&auto=format\&n=Ca7Kginb789boSAj\&q=85\&s=d087dd679d7d1935f286f62dc2151953)

* **Invoices:** Generated at the end of each billing cycle; they include the recurring fee and usage-based line items.

![Subscription Invoice](https://mintcdn.com/tirdad/Ca7Kginb789boSAj/images/docs/subscription-flow/subscription-invoice.png?fit=max\&auto=format\&n=Ca7Kginb789boSAj\&q=85\&s=d80eb3b6975e57b7247b72344038ccc9)

For more, check-out [Connecting to Billing](https://docs.tirdad.ai/docs/core-concepts/usage-events/connecting-to-billing.md) and your API reference for sending usage events.

## Next Steps

* **Map your app to Tirdad:** Emit usage events that match the metered feature event names (e.g. `emails.sent`) and associate them with the customer (e.g. via External ID).
* **Configure overage and limits:** Use [Linking features to plans](https://docs.tirdad.ai/docs/product-catalogue/features/linking-to-plans.md) to set soft vs hard limits and overage pricing per plan.
* **Add more plans:** Create Free, Scale, and Enterprise plans with different recurring fees, usage tiers, and entitlements (e.g. analytics, retention) to mirror Resend’s tiers.

For event ingestion and billing flow, check-out [Connecting to Billing](https://docs.tirdad.ai/docs/core-concepts/usage-events/connecting-to-billing.md). For plan and charge configuration, check-out [Creating a Plan](https://docs.tirdad.ai/docs/product-catalogue/plans/create.md) and [Linking features to plans](https://docs.tirdad.ai/docs/product-catalogue/features/linking-to-plans.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.