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.
import { createCreem } from 'creem_io';
const creem = createCreem({
apiKey: process.env.CREEM_API_KEY!,
testMode: process.env.NODE_ENV !== 'production',
});
// Create a percentage discount
const percentageDiscount = await creem.discounts.create({
name: 'Percentage Discount',
code: 'PERC10',
currency: 'USD',
type: 'percentage',
percentage: 10,
duration: 'forever',
});
// 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',
});
# 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.
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"
}
Repeating
Applies for a specific number of months, then reverts to full price.
{
"duration": "repeating",
"durationInMonths": 3
}
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.checkout_url;
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.
// 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.
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
