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

# Single Purchase

## **Overview**

Single purchases are one-time, non-recurring offerings that bundle features and entitlements for a fixed price. They are ideal for one-off services, digital downloads, consultation packages, or any product that doesn’t require ongoing billing.

With Metrifox, product and growth teams can create, price, and manage single purchases without engineering support. Once configured, they’re automatically displayed in your pricing pages and checkout flows via Metrifox’s SDKs.

### **Create a Single Purchase**

You can create a single purchase from two places:

1. **Via the Offerings page:**
   * Navigate to **Catalog → Offerings**.
   * Switch to the **Single Purchase** tab.
   * Click **Create Single Purchase**.
2. **Via a specific Product:**
   * Navigate to **Catalog → Products**.
   * Select the desired product.
   * In the **Single Purchases** section, click **Add**.

Then, define your offering’s details:

| **Field**               | **Description**                                            | **Example**                             |
| :---------------------- | :--------------------------------------------------------- | :-------------------------------------- |
| **Name**                | The customer-facing name of your offering.                 | `60-min Strategy Session`               |
| **Description**         | Internal or external description of the offering.          | `One-time deep dive and strategy call.` |
| **Single Purchase Key** | A unique API identifier. Leave blank to auto-generate.     | `strategy_call_60min` (auto-generated)  |
| **Customer Visibility** | Toggle to show/hide this offering in public pricing pages. | `On` (Visible)                          |

Click **Create Single Purchase** to save. Your new offering will be saved as a **draft** until you launch it.

### **Attach Features**

Features define what a customer receives when they make this purchase.

1. In your single purchase, go to the **Features** section.
2. Click **Attach**.
3. Select the feature(s) you want to include.
4. Configure the entitlement based on the feature type:

**Boolean Features**

* No configuration needed. Attaching the feature grants access.

**Metered Features**

Configure usage limits and rules:

| **Setting**           | **Description**                                                                                                           | **Example**             |
| :-------------------- | :------------------------------------------------------------------------------------------------------------------------ | :---------------------- |
| **Limit Enforcement** | Controls overage behavior. Single purchases use a **Hard Limit** by default—customers cannot exceed their allotted usage. | `Hard Limit`            |
| **Quota Limit**       | The total usage included.                                                                                                 | `1` (e.g., 1 session)   |
| **Included Usage**    | The amount of usage included in the purchase price.                                                                       | `60` (e.g., 60 minutes) |
| **Reset Interval**    | How often usage resets. For single purchases, this is typically **None**.                                                 | `None`                  |

1. **Customize Display:** Use the **⋮ menu** to hide a feature from public view or edit its display text for pricing pages.
2. Click **Done**.

### **Define Pricing**

Set how customers are charged for this one-time purchase.

1. In your single purchase, navigate to the **Prices** section.
2. Click **Add Price**.

**Fixed Price**

* Select **Fixed Charge**.
* Enter the price. Since this is a one-time purchase, billing intervals do not apply.
* **Note:** Customers will not enter a quantity; it is always 1.

**Dynamic Price**

* Select **Set Dynamic Price**.
* Choose the metered feature to base the price on.
* Define pricing tiers (e.g., volume discounts, graduated pricing).
* Select a model: **Flat Fee**, **Per Unit**, or **Package Pricing**.

### **Attach Add-ons**

Offer complementary one-time purchases at checkout.

1. In your single purchase, find the **Attached Add-ons** section.
2. Click **Attach Add-on**.
3. Select a launched add-on from the list.
4. Configure the attachment:
   * **Mandatory:** Automatically added to the cart; customer cannot remove it.
   * **Optional:** The customer can choose to add it.
   * **Visibility:** Control if the add-on is shown to customers or is admin-only.

### **Attach One-Time Charges**

Automatically add fees like setup or delivery charges.

1. In your single purchase, go to the **Charges** section.
2. Click **Attach Charge**.
3. Select a charge and set its trigger:
   * **Upon First Purchase:** charged only the first time a customer buys this item.
   * **On Every Purchase:** charged every time the item is purchased.

### **Launch Your Single Purchase**

Once configured, make it available to customers.

* Click **Launch Single Purchase** in the top right.
* **Note:** Any future edits create a new version that must be launched to go live.

### **Manage Single Purchases**

* **View:** See all single purchases under **Catalog → Offerings** (Single Purchase tab) or within a specific **Product** page.
* **Edit:** Select a single purchase and click **Edit**. All changes create a new version that must be launched.
* **Delete/Archive:**
  * **Delete:** Only possible for drafts never launched.
  * **Archive:** For launched offerings. Prevents new purchases but preserves historical data.