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

# Consumables

> Grant one-time or repeatable products without a subscription or a lifetime purchase.

Consumables let you grant a customer an entitlement when they buy a
product, without tracking it as a subscription or a lifetime purchase. This makes them ideal for selling credit packs, one-time add-ons, and similar products with FunnelFox Billing.

## How it works

A consumable is an Offering (Feature)
with the type `consumable` that you attach to a Price Point. These are the
same Offerings and Price Points you already use for subscriptions and
lifetime products.

<Frame>
  <img src="https://mintcdn.com/funnelfox/nzSy5-g2bUXMcbRS/assets/consumable.png?fit=max&auto=format&n=nzSy5-g2bUXMcbRS&q=85&s=1956e6a87a5c96883f188de96a7fbee0" width="1920" height="989" data-path="assets/consumable.png" />
</Frame>

When a customer buys a product that carries a consumable Offering,
FunnelFox Billing grants the consumable. What happens next depends on the
product it is attached to:

* **Subscription product**: The consumable is re-granted on every billing
  cycle.
* **Lifetime (one-off) product**: The consumable is granted once.
* **Consumable-only product**: A Price Point whose only Offering is a
  consumable, so the product exists purely to sell that consumable.

<Info>
  Consumables have no balance or counter. Each grant is one record, either
  active or revoked. FunnelFox Billing does not count or deduct them, so keep
  that logic in your own product.
</Info>

## Manage consumables

### Create consumable

Create a consumable in two steps. Granting is automatic, so there is no
separate step to give it to a customer.

<Steps>
  <Step title="Create the Offering (Feature)">
    Go to the **Offering (Features)** section on the **Settings** page,
    enter an `ident` and description, set **Type** to `consumable`, then
    click **Create Offering (Feature)**. You can also use the
    [`POST /feature/create`](/docs/api-reference/pricepoints/create-a-feature-offering)
    endpoint.
  </Step>

  <Step title="Attach it to a product">
    Add the Offering to a Price Point's `features`, on its own or alongside
    a subscription or lifetime Offering. Use the **Price Points CSV
    manager** or the
    [`POST /pp/create`](/docs/api-reference/pricepoints/create-a-price-point)
    endpoint.
  </Step>
</Steps>

### View consumables

You can see a customer's consumables in three places:

* **Support Tool**: Each [user page](/docs/billing/view-subscriptions-billing)
  has a **Consumables** section that lists every consumable with its status
  (active or revoked), granted and revoked timestamps, source order, and
  Offering. This view is read-only.
* **Billing API**: Call
  [`POST /my_assets`](/docs/api-reference/information/list-a-users-subscriptions-and-one-off-purchases)
  with the customer's `external_id` to return their consumables alongside
  subscriptions and one-off purchases. Each consumable includes
  `is_active`, `started_at`, and `revoked_at`.
* **Webhooks**: FunnelFox Billing sends a consumable event with subtype
  `granted` on each purchase and renewal, and `revoked` on a full refund.
  See [FunnelFox Billing webhooks](/docs/develop/webhooks-billing) to receive
  and verify them.

## Purchase lifecycle

Consumables are managed entirely through the order lifecycle. There are no
manual grant, top-up, revoke, or pause actions.

| Event                                        | Effect on the consumable                                             |
| -------------------------------------------- | -------------------------------------------------------------------- |
| Customer completes a purchase                | Granted, one per consumable Offering on the product                  |
| Subscription renews                          | Re-granted for the new billing cycle                                 |
| Full refund of the original order            | All grants from that purchase, including renewal grants, are revoked |
| Partial refund, soft refund, or cancellation | No effect, the consumable stays active                               |
| Time passing                                 | No effect, consumables do not expire                                 |