Products and Pricing

Products define what you sell and how you price it. RevKeen supports fixed one-time prices, recurring subscriptions, quantity-based tiered pricing, and usage-based billing. This page covers products, prices, discounts, and where tiered pricing fits.

What is a Product?

A Product represents something you sell. Products do not have prices directly attached to them. Instead, you create one or more Prices for each product, which allows you to offer:

• Multiple plan options (for example, Basic, Pro, and Enterprise)
• Different billing intervals (monthly vs. annual)
• Various currencies for international customers
• One-time and recurring options for the same product
• Quantity-based tiered pricing on a single fixed price

Product Types

Product Fields

Fulfillment Types

The fulfillment type determines how the product is delivered to customers:

Creating Products

Via Dashboard

1. Navigate to Product > Catalogue
2. Click + New Product
3. Fill in product details (name, description, fulfillment type)
4. Add product images (optional)
5. Add benefits/features (optional)
6. Save the product
7. Add one or more prices to the product

Via API

Recurring Product (Subscription)

const product = await client.products.create({
  productId: 'pro_monthly',
  name: 'Pro Plan',
  description: 'Full access to all features',
  kind: 'subscription',
  pricingModel: 'recurring',
  amountMinor: 2900, // $29.00
  currency: 'USD',
  interval: 'month',
  intervalCount: 1,
  trialDays: 14,

  // Optional: Features list for checkout display
  features: [
    'Unlimited projects',
    'Priority support',
    'Advanced analytics',
  ],
});

One-Time Product

const product = await client.products.create({
  productId: 'setup_fee',
  name: 'Setup Fee',
  description: 'One-time onboarding and configuration',
  kind: 'one_time',
  pricingModel: 'fixed',
  amountMinor: 9900, // $99.00
  currency: 'USD',
});

Listing Products

// List all active products
const products = await client.products.list({
  isActive: true,
});

// Filter by kind
const subscriptions = await client.products.list({
  kind: 'subscription',
  isActive: true,
});

Updating Products

const product = await client.products.update('prod_xxxxxxxx', {
  name: 'Pro Plan (2024)',
  amountMinor: 3900, // Price increase
});

Updating a product's price does not affect existing subscriptions. New subscriptions will use the updated price.

Archiving Products

// Archive a product (hide from new purchases)
const product = await client.products.update('prod_xxxxxxxx', {
  isActive: false,
});

Product Benefits

Benefits describe what is included with a product. They appear on checkout pages to help customers understand the value of what they are purchasing.

Benefits are displayed as a feature list on checkout pages. Add 3-5 key benefits to highlight the most important features.

Example benefits:

• Unlimited users
• 24/7 email support
• Advanced analytics dashboard
• Custom integrations
• Priority feature requests

Product Best Practices

1. Use clear, descriptive names -- Names should be instantly recognizable to customers (for example, "Pro Plan" not "SKU-12345").
2. Write compelling descriptions -- Explain the value proposition, not just technical specs.
3. Offer multiple price options -- Monthly and annual pricing can increase conversions and improve cash flow.
4. Add quality images -- Use high-resolution product photos or illustrations.
5. Highlight key benefits -- List 3-5 benefits that matter most to your customers.

Prices

Prices define how much a product costs and how it is billed. A single product can have multiple prices, enabling flexible pricing strategies like offering both monthly and annual billing options.

Price Types

One-Time Price -- A single payment for a product. Perfect for physical goods, digital downloads, or services with a fixed scope. Example: Software license for $299.

Recurring Price -- Repeated billing at a specified interval. Used for subscriptions, memberships, and ongoing services. Billing intervals: Daily, Weekly, Monthly, Yearly, or custom intervals (for example, every 3 months, every 6 weeks).

Pay-What-You-Want -- Let customers choose their own price. You can set minimum and suggested amounts. Great for donations, tips, or flexible pricing experiments. Example: Minimum $5, suggested $25.

Tiered Price -- A fixed price whose total changes with quantity. RevKeen supports both graduated and volume tiering modes for bulk discounts, seat-style quantity pricing, and quantity-based subscription billing. See Tiered Pricing for the full model.

Usage-Based (Metered) -- Charge based on actual consumption. Track usage with meters and bill at the end of each billing period. Supports per-unit, graduated tiers, volume tiers, and package pricing. Metered products do not charge upfront. They accumulate usage throughout the billing period and add the calculated charge to the invoice at renewal. See the full Usage-Based Billing guide for setup.

Price Fields

Creating Prices

One-Time Price

const price = await client.prices.create({
  productId: 'prod_xxxxxxxx',
  amountMinor: 29900, // $299.00
  currency: 'USD',
  type: 'one_time',
});

console.log(price.data.id); // price_xxxxxxxx

Monthly Subscription

const monthlyPrice = await client.prices.create({
  productId: 'prod_xxxxxxxx',
  amountMinor: 2900, // $29.00/month
  currency: 'USD',
  type: 'recurring',
  billingInterval: 'month',
  billingIntervalCount: 1,
  trialPeriodDays: 14, // 14-day free trial
});

Annual Subscription (with discount)

// Annual price with 2 months free (10 months = $290 instead of $348)
const annualPrice = await client.prices.create({
  productId: 'prod_xxxxxxxx',
  amountMinor: 29000, // $290.00/year
  currency: 'USD',
  type: 'recurring',
  billingInterval: 'year',
  billingIntervalCount: 1,
});

Quarterly Billing (Custom Interval)

// Bill every 3 months
const quarterlyPrice = await client.prices.create({
  productId: 'prod_xxxxxxxx',
  amountMinor: 7500, // $75.00 every 3 months
  currency: 'USD',
  type: 'recurring',
  billingInterval: 'month',
  billingIntervalCount: 3, // Every 3 months
});

Trial Periods

For recurring prices, you can offer a free trial period. During the trial:

• Customer gets full access to the product
• No payment is collected
• Subscription status is trialing
• At trial end, the first invoice is generated and charged

Trial periods are set on the Price, not the Product. This means you can offer different trial lengths for different pricing tiers.

Multiple Prices per Product

A single product can have multiple prices. Common patterns include:

Tiered Pricing

Tiered pricing lets one fixed price change as quantity grows. Use it when you want bulk discounts, seat-style quantity pricing, or subscriptions where the charge depends on how many units the customer selects.

Use separate prices for different billing intervals such as monthly vs annual. Use tiered pricing when the same price should change based on quantity.

For the full setup guide, API fields, examples, and invoice behavior, see Tiered Pricing.

Pricing Best Practices

1. Always offer annual pricing -- Annual plans with a discount improve cash flow and reduce churn.
2. Use trial periods strategically -- 7-14 day trials work well for most SaaS products.
3. Price in minor units -- Always use cents/minor units to avoid floating point issues ($29.99 = 2999).
4. Archive, do not delete -- Set is_active: false instead of deleting prices to preserve history.

Billing Intervals

Discounts

Discounts let you offer promotional pricing to customers. Create discount codes that customers can apply at checkout, or apply discounts directly to orders and subscriptions.

Discount Types

Percentage Off -- Reduce the total by a percentage (for example, 20% off). Example: $100 with 20% off = $80.

Fixed Amount -- Reduce the total by a specific amount (for example, $25 off). Example: $100 with $25 off = $75.

Free Trial -- Extend the trial period for subscriptions (for example, 30-day trial instead of 14). Example: Add 30 days free trial period.

Discount Fields

Discount Scope

Control what the discount applies to:

Creating Discounts

Via Dashboard

1. Navigate to Product > Discounts
2. Click + New Discount
3. Enter discount code (for example, SUMMER20)
4. Select discount type and amount
5. Configure scope and limits
6. Save the discount

Via API

// Percentage discount
const discount = await client.discounts.create({
  code: 'SUMMER20',
  type: 'percentage',
  percentOff: 20,

  // Optional limits
  maxRedemptions: 100,
  expiresAt: '2026-08-31T23:59:59Z',

  // Optional: Limit to specific products
  productIds: ['prod_xxx', 'prod_yyy'],
});

// Fixed amount discount
const fixedDiscount = await client.discounts.create({
  code: 'SAVE25',
  type: 'fixed',
  amountOff: 2500, // $25.00
  currency: 'USD',
});

// Free trial extension
const trialDiscount = await client.discounts.create({
  code: 'FREETRIAL30',
  type: 'free_trial',
  trialDays: 30,
});

Using Discounts at Checkout

For checkout links, enable discount codes in the link settings:

1. Edit the checkout link
2. Enable Allow discount codes
3. Customers will see a discount code input field
4. Valid codes are applied automatically

Using Discounts via API

// Apply discount to a subscription
const subscription = await client.subscriptions.create({
  customerId: 'cus_xxx',
  items: [{ priceId: 'price_xxx' }],
  discountId: 'disc_xxx', // Apply the discount
});

// Apply discount to an order
const order = await client.orders.create({
  customerId: 'cus_xxx',
  lineItems: [{ priceId: 'price_xxx', quantity: 1 }],
  discountId: 'disc_xxx',
});

Tracking Redemptions

Track how discounts are being used:

• Redemption count -- How many times the code has been used
• Total discounted -- Sum of all discount amounts applied
• Revenue impact -- How much revenue was affected

View discount analytics in Product > Discounts by clicking on any discount.

Discount Best Practices

1. Use memorable codes -- SUMMER20, WELCOME10, BLACKFRIDAY are easy to remember and type.
2. Set expiration dates -- Create urgency and prevent indefinite discount usage.
3. Limit redemptions -- Control promotion costs by capping total uses.
4. Track performance -- Monitor redemption rates and revenue impact.
5. Deactivate, do not delete -- Set is_active: false to preserve history.

Related

• Tiered Pricing -- Configure quantity-based graduated and volume pricing
• Subscriptions -- Create subscriptions with products
• Usage-Based Billing -- Meter-based pricing for variable usage
• Checkout Links -- Sell products through reusable hosted checkout URLs