Discount Codes

Discount codes give you powerful tools to incentivize purchases and run promotional campaigns. You can create percentage-based or fixed-amount discounts that apply to specific products, with full control over duration, expiration, and redemption limits.

Creating Discount Codes

Via Dashboard

Navigate to Discounts in your Creem Dashboard
Click Create Discount Code
Configure your discount settings:
- Name: Internal name for your reference (e.g., “Holiday Sale 2024”)
- Code: Customer-facing code (e.g., “HOLIDAY50”)
- Type: Percentage or fixed amount
- Amount/Percentage: The discount value
- Duration: How long the discount applies
- Products: Which products this code applies to
- Expiration Date: When the code expires (optional)
- Max Redemptions: Limit total uses (optional)
Click Create to activate the discount

Via API

You can also create discounts programmatically using the API.

TypeScript SDK
REST API

import { Creem } from "creem";

const creem = new Creem({
  apiKey: process.env.CREEM_API_KEY!,
  server: process.env.NODE_ENV === "production" ? "prod" : "test",
});

// Create a percentage discount
const percentageDiscount = await creem.discounts.create({
  name: "Percentage Discount",
  code: "PERC10",
  currency: "USD",
  type: "percentage",
  percentage: 10,
  duration: "forever",
  appliesToProducts: ["prod_YOUR_PRODUCT_ID"],
});

// Create a fixed amount discount
const fixedDiscount = await creem.discounts.create({
  name: "Fixed Discount",
  code: "FIXED10",
  amount: 1000, // In cents
  currency: "USD",
  type: "fixed",
  duration: "forever",
  appliesToProducts: ["prod_YOUR_PRODUCT_ID"],
});

# Create a percentage discount
curl -X POST https://api.creem.io/v1/discounts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Launch Week Special",
    "code": "LAUNCH50",
    "type": "percentage",
    "percentage": 50,
    "duration": "once",
    "applies_to_products": ["prod_YOUR_PRODUCT_ID"],
    "expiry_date": "2024-12-31T23:59:59Z",
    "max_redemptions": 100
  }'

# Create a fixed amount discount
curl -X POST https://api.creem.io/v1/discounts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Bonus",
    "code": "WELCOME20",
    "type": "fixed",
    "amount": 20,
    "currency": "USD",
    "duration": "once",
    "applies_to_products": ["prod_YOUR_PRODUCT_ID"]
  }'

Discount Types

Percentage Discounts

Reduce the price by a percentage (e.g., 25% off).

{
  "type": "percentage",
  "percentage": 25,
  "duration": "once"
}

A $100 product with a 25% discount becomes $75.

Fixed Amount Discounts

Reduce the price by a fixed amount in a specific currency (e.g., $20 off).

{
  "type": "fixed",
  "amount": 20,
  "currency": "USD",
  "duration": "once"
}

A $100 product with a $20 discount becomes $80.

Duration Options

Control how long a discount applies for subscriptions.

Once

Applies only to the first payment. Perfect for acquisition discounts.

{
  "duration": "once"
}

Use case: “Get 50% off your first month” for a monthly subscription.

Forever

Applies to all payments for the lifetime of the subscription.

{
  "duration": "forever"
}

Use case: “Lifetime 20% discount for early supporters” on a subscription.

Repeating

Applies for a specific number of months, then reverts to full price.

{
  "duration": "repeating",
  "durationInMonths": 3
}

Use case: “50% off for your first 3 months” on a subscription.

Duration only affects subscription products. For one-time payments, the discount is always applied once.

Applying Discount Codes

Customer-Entered Codes

Customers can enter discount codes directly at checkout. If the code is valid for the product and hasn’t expired, it will automatically apply. No implementation required - this works out of the box!

Pre-Applied Codes

Pre-apply a discount code programmatically when creating a checkout session. This is useful for landing pages, email campaigns, or special offers.

Next.js
TypeScript SDK
Better Auth
REST API

import { CreemCheckout } from "@creem_io/nextjs";

export function PromoButton() {
  return (
    <CreemCheckout productId="prod_YOUR_PRODUCT_ID" discountCode="LAUNCH50">
      <button>Claim 50% Off</button>
    </CreemCheckout>
  );
}

const checkout = await creem.checkouts.create({
  productId: "prod_YOUR_PRODUCT_ID",
  discountCode: "LAUNCH50",
  successUrl: "https://yoursite.com/success",
});

// Redirect to checkout with discount pre-applied
window.location.href = checkout.checkoutUrl;

const { data } = await authClient.creem.createCheckout({
  productId: "prod_YOUR_PRODUCT_ID",
  discountCode: "LAUNCH50",
  successUrl: "/dashboard",
});

if (data?.url) {
  window.location.href = data.url;
}

curl -X POST https://api.creem.io/v1/checkouts \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "product_id": "prod_YOUR_PRODUCT_ID",
    "discount_code": "LAUNCH50",
    "success_url": "https://yoursite.com/success"
  }'

Managing Discount Codes

Retrieve a Discount

Get details about a specific discount code.

TypeScript SDK
REST API

// By discount ID
const discount = await creem.discounts.get({
  discountId: "disc_1234567890",
});

// By discount code
const discount = await creem.discounts.get({
  discountCode: "LAUNCH50",
});

console.log(discount.redeem_count); // See how many times it's been used

# By discount ID
curl -X GET "https://api.creem.io/v1/discounts?discount_id=disc_1234567890" \
  -H "x-api-key: YOUR_API_KEY"

# By discount code
curl -X GET "https://api.creem.io/v1/discounts?discount_code=LAUNCH50" \
  -H "x-api-key: YOUR_API_KEY"

Delete a Discount

Permanently delete a discount code. This action cannot be undone.

TypeScript SDK
REST API

await creem.discounts.delete({
  discountId: "disc_1234567890",
});

curl -X DELETE https://api.creem.io/v1/discounts/disc_1234567890/delete \
  -H "x-api-key: YOUR_API_KEY"

Next Steps

Revenue Splits

Automatically split revenue between multiple parties

Free Trials

Offer free trials for your products

Customer Portal

Let customers manage their subscriptions and billing

Addons

Add licenses, file downloads, and more to your products

Get Started

AI

Features

Code

Integrations

Community

Merchant of Record

For Customers

Discount Codes

Creating Discount Codes

Via Dashboard

Via API

Discount Types

Percentage Discounts

Fixed Amount Discounts

Duration Options

Once

Forever

Repeating

Applying Discount Codes

Customer-Entered Codes

Pre-Applied Codes

Managing Discount Codes

Retrieve a Discount

Delete a Discount

Next Steps

Revenue Splits

Free Trials

Customer Portal

Addons

​Creating Discount Codes

​Via Dashboard

​Via API

​Discount Types

​Percentage Discounts

​Fixed Amount Discounts

​Duration Options

​Once

​Forever

​Repeating

​Applying Discount Codes

​Customer-Entered Codes

​Pre-Applied Codes

​Managing Discount Codes

​Retrieve a Discount

​Delete a Discount

​Next Steps

Revenue Splits

Free Trials

Customer Portal

Addons

Creating Discount Codes

Via Dashboard

Via API

Discount Types

Percentage Discounts

Fixed Amount Discounts

Duration Options

Once

Forever

Repeating

Applying Discount Codes

Customer-Entered Codes

Pre-Applied Codes

Managing Discount Codes

Retrieve a Discount

Delete a Discount

Next Steps