Discounts & Promotions

Overview

Reponse supports discount codes, automatic discounts, and a promotions engine. Codes can be shopper-entered or auto-applied. When a code is applied to a cart, Reponse checks the promotions table first, then falls back to legacy discount codes — giving you flexibility to migrate at your own pace.

Prerequisites

Discount types

Discount classes

Step 1 — Create a discount code

Via the dashboard

1. Go to Dashboard → Discounts → Create.
2. Fill in code, type, value, and optional conditions.
3. Click Save.

Via the API

import { createDiscountCode } from '@/lib/discount.actions';

const discount = await createDiscountCode('ws_xxx', {
  code: 'SUMMER25',
  type: 'percentage',
  value: 25,
  currency: 'EUR',
  starts_at: '2026-06-01T00:00:00Z',
  end_at: '2026-08-31T23:59:59Z',
  conditions: 'Minimum order €50',
});

Step 2 — Configure conditions and targeting

Step 3 — Schedule discounts

Control when discounts are active:

await createDiscountCode('ws_xxx', {
  code: 'FLASH50',
  type: 'percentage',
  value: 50,
  starts_at: '2026-07-04T08:00:00Z',   // starts July 4 at 8 AM
  end_at: '2026-07-04T20:00:00Z',       // ends same day at 8 PM
});

Discounts outside their active window are rejected with `"Discount code is not active yet"` or `"Discount code has expired"`.

Step 4 — Set usage limits

When the total usage limit is reached, the code returns `"Discount code usage limit reached"`.

Combining discounts

Reponse supports stacking multiple discount codes on a single cart. The combinator engine groups discounts by kind and applies them in order:

1. Product discounts — applied to line items first
2. Order discounts — applied to the subtotal
3. Shipping discounts — applied to shipping cost

import { useDiscountCodes } from '@/lib/discount.actions';

const result = await useDiscountCodes(
  ['disc_1', 'disc_2'],  // discount code IDs
  'lead_xxx',
  150.00                  // original cart total
);
// result → { success: true, discountAmount: 25.00, finalAmount: 125.00 }

Control stacking with the `combines_with` field:

{ "combines_with": ["product", "shipping"] }

Bulk code generation

Generate up to 500 unique codes from a template:

import { bulkCreateDiscountCodes } from '@/lib/discount.actions';

const result = await bulkCreateDiscountCodes('ws_xxx', {
  prefix: 'VIP',
  count: 100,
  type: 'percentage',
  value: 20,
  end_at: '2026-12-31T23:59:59Z',
  usage_limit_per_customer: 1,
});
// result → { created: 100, codes: ["VIP-A3K7X", "VIP-B9M2R", ...] }

Codes are generated with confusable characters removed (no `I`, `O`, `0`, `1`).

Applying to a cart

Automatic discounts

Automatic discounts are reflected when you fetch a cart — no action needed.

Code discounts

// Via SDK
await reponse.cart.applyPromo({
  path: { id: cartId },
  body: { code: 'SUMMER25' },
});

// Via REST API
// POST /v1/cart/:id/promo
// { "code": "SUMMER25" }

API reference

Troubleshooting