Coupons & Discounts

{
  discount_type: 'percentage',
  discount_value: 25  // 25% off
}

{
  discount_type: 'fixed',
  discount_value: 500,  // ₹500 off
  currency: 'INR'
}

// First month free
{
  discount_type: 'percentage',
  discount_value: 100,
  duration: 'once'
}

// 50% off for 6 months
{
  discount_type: 'percentage',
  discount_value: 50,
  duration: 'repeating',
  duration_months: 6
}

const subscription = await recurso.subscriptions.create({
  customer_id: 'cust_abc',
  plan_id: 'plan_pro',
  coupon: 'WELCOME20'
});

await recurso.subscriptions.update('sub_xyz', {
  coupon: 'UPGRADE50'
});

{
  code: 'PROONLY',
  applies_to_plans: ['plan_pro', 'plan_enterprise']
}

{
  code: 'BIGSPEND',
  minimum_amount: 10000  // ₹100+ purchases only
}

{
  code: 'NEWUSER',
  first_time_only: true
}

const coupons = await recurso.coupons.list({
  active: true
});

const validation = await recurso.coupons.validate({
  code: 'WELCOME20',
  customer_id: 'cust_abc',
  plan_id: 'plan_pro'
});

// Returns
{
  valid: true,
  discount_amount: 999,  // ₹999 off
  message: null
}

// Or if invalid
{
  valid: false,
  message: 'Coupon has expired'
}

// Prevent new redemptions
await recurso.coupons.archive('OLDCODE');

// Existing subscriptions keep their discount

const coupon = await recurso.coupons.get('WELCOME20');

// Returns
{
  code: 'WELCOME20',
  times_redeemed: 47,
  max_redemptions: 100,
  remaining: 53
}