Price

The Price resource lets you create and manage Stripe Prices for products.

Minimal Example

Create a one-time fixed price for a product:

import { Price } from "alchemy/stripe";

const price = await Price("basic-license", {
  currency: "usd",
  unitAmount: 2999, // $29.99
  product: "prod_xyz",
});

Recurring Subscription Price

Create a recurring subscription price with fixed monthly billing:

import { Price } from "alchemy/stripe";

const subscriptionPrice = await Price("pro-monthly", {
  currency: "usd",
  unitAmount: 1499, // $14.99/month
  product: "prod_xyz",
  recurring: {
    interval: "month",
    usageType: "licensed",
  },
});

Metered Usage Price

Create a metered price for usage-based billing:

import { Price } from "alchemy/stripe";

const meteredPrice = await Price("storage", {
  currency: "usd",
  unitAmount: 25, // $0.25 per GB
  product: "prod_xyz",
  recurring: {
    interval: "month",
    usageType: "metered",
    aggregateUsage: "sum",
  },
});

Tiered Pricing

Graduated Tiers

With graduated tiered pricing, different portions of usage are charged at different rates:

import { Price } from "alchemy/stripe";

const apiUsagePrice = await Price("api-usage", {
  currency: "usd",
  product: "prod_xyz",
  billingScheme: "tiered",
  tiersMode: "graduated",
  recurring: {
    interval: "month",
    usageType: "metered",
  },
  tiers: [
    {
      upTo: 10000,
      unitAmount: 0, // First 10k API calls free
    },
    {
      upTo: 50000,
      unitAmount: 2, // $0.02 per call from 10k-50k
    },
    {
      upTo: "inf",
      unitAmount: 1, // $0.01 per call beyond 50k
    },
  ],
});

Volume-Based Tiers

With volume-based pricing, the total quantity determines the rate for ALL units:

import { Price } from "alchemy/stripe";

const storagePrice = await Price("storage-volume", {
  currency: "usd",
  product: "prod_xyz",
  billingScheme: "tiered",
  tiersMode: "volume",
  recurring: {
    interval: "month",
  },
  tiers: [
    {
      upTo: 100,
      unitAmount: 500, // $5 per GB for up to 100GB total
    },
    {
      upTo: 1000,
      unitAmount: 400, // $4 per GB for 101-1000GB total
    },
    {
      upTo: "inf",
      unitAmount: 300, // $3 per GB for over 1000GB total
    },
  ],
});

Overage Cap with Flat Amount

Protect customers from bill shock with a flat fee cap:

import { Price } from "alchemy/stripe";

const cappedUsagePrice = await Price("api-calls-capped", {
  currency: "usd",
  product: "prod_xyz",
  billingScheme: "tiered",
  tiersMode: "graduated",
  recurring: {
    interval: "month",
    usageType: "metered",
  },
  tiers: [
    {
      upTo: 100000,
      unitAmount: 1, // $0.01 per call up to 100k
    },
    {
      upTo: "inf",
      flatAmount: 100000, // Cap at $1000 for unlimited usage
    },
  ],
});

Billing Meters

For advanced usage tracking, you can associate a price with a Stripe Billing Meter:

import { Price } from "alchemy/stripe";

// First create a meter (not shown - requires Meter resource)
// const meter = await Meter("api-usage-meter", { ... });

const meteredPrice = await Price("api-usage-with-meter", {
  product: "prod_xyz",
  currency: "usd",
  billingScheme: "tiered",
  tiersMode: "graduated",
  recurring: {
    interval: "month",
    usageType: "metered", // Required for meter association
    meter: "meter_123abc" // Associate with billing meter
  },
  tiers: [
    { upTo: 10000, unitAmountDecimal: "0" },
    { upTo: 25000, unitAmountDecimal: "0.002" },
    { upTo: "inf", flatAmountDecimal: "3000" }
  ],
});

Note: Meters can only be associated with prices that have recurring.usageType = 'metered'.