Coupons & Discounts

You can create and manage coupons to offer discounts on subscriptions, one-time charges, or promotions.

Types of Discounts

• Percentage-based (e.g., 10% off)

• Fixed amount (e.g., $20 off)

• Free trial extension (e.g., +14 days free)

• Limited-time offers

Example JSON:

{
  "coupon_id": "fall2025",
  "type": "percentage",
  "value": 15,
  "duration": "repeating",
  "duration_in_months": 3
}

Applying Coupons

Coupons can be applied during checkout or to an existing subscription.

# Apply a coupon to a subscription
curl -X POST https://api.saasapp.com/v1/subscriptions/sub_123/apply-coupon \
  -H "Authorization: Bearer <API_KEY>" \
  -d coupon_id=fall2025

If a customer already has a discount, applying a new coupon will replace the old one unless stacking is enabled.

Coupon Restrictions

You can control how coupons are used:

• Limit total redemptions (e.g., first 100 customers)

• Restrict by product or plan

• Set expiration date

• Allow stacking or prevent overlap

Table example:

Testing Coupons in Sandbox

Always test discounts in the Sandbox before going live.

# Example test coupon
saasapp coupons create --id=test50 --type=fixed --value=50 --sandbox

Tip: Use test customers and trial subscriptions to verify discount logic.

Best Practices

• Use percentage discounts for flexibility across currencies

• Set expiry dates to create urgency

• Limit redemptions for exclusive campaigns

• Monitor coupon performance in analytics reports

Summary

• Create flexible coupons (percentage, fixed, trials)

• Apply them at checkout or on existing subscriptions

• Restrict usage with limits and expiry rules

• Test everything in Sandbox before launching promotions