Coupon Management APIs

​

Overview

​

Base URL

https://talentg.vercel.app/api

​

Authentication

Authorization: Bearer <supabase_jwt_token>
Content-Type: application/json

​

Coupon CRUD Operations

​

List Coupons

​

Create Coupon

​

Update Coupon

​

Delete Coupon

​

Coupon Validation & Application

​

Validate Coupon (Already documented in Payments API)

​

Apply Coupon (Already documented in Payments API)

​

Coupon Usage Tracking

​

Get Coupon Usage Details

​

Bulk Operations

​

Bulk Create Coupons

​

Bulk Update Coupons

​

Coupon Types

​

Percentage Discount

{
  "discount_type": "percentage",
  "discount_value": 20  // 20% off
}

​

Fixed Amount Discount

{
  "discount_type": "fixed_amount",
  "discount_value": 10000  // ₹100 off
}

​

Free Access

{
  "discount_type": "free_access",
  "discount_value": null  // 100% discount
}

​

Applicable Services

​

Error Handling

​

Common Error Codes

​

Error Response Format

{
  "success": false,
  "error": {
    "code": "COUPON_EXISTS",
    "message": "Coupon code already exists",
    "details": {
      "code": "SAVE20",
      "existing_coupon_id": "coupon_123"
    }
  }
}

​

Rate Limiting

• Read operations: 1000 requests per hour per user
• Create/Update operations: 500 requests per hour per user
• Bulk operations: 50 requests per hour per user
• Validation operations: 2000 requests per hour per user

​

SDK Examples

const createCoupon = async (couponData) => {
  const token = await getSupabaseToken();

  const response = await fetch('/api/admin/coupons', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${token}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify(couponData)
  });

  return response.json();
};

// Usage
const coupon = await createCoupon({
  code: 'FLASH50',
  description: 'Flash sale 50% off',
  discount_type: 'percentage',
  discount_value: 50,
  applicable_services: ['strength_finder'],
  expiration_date: '2025-11-01T23:59:59Z'
});

​

Best Practices

​

Coupon Code Format

• Use uppercase letters and numbers only
• Keep codes between 6-12 characters
• Avoid special characters except underscores
• Make codes memorable and brandable

​

Usage Limits

• Set reasonable usage limits to prevent abuse
• Consider per-user limits for fairness
• Monitor usage patterns and adjust limits as needed

​

Expiration Management

• Set appropriate expiration dates based on campaign goals
• Consider timezone implications for global users
• Provide clear expiration notifications

​

Security Considerations

• Validate all coupon inputs server-side
• Implement rate limiting on validation endpoints
• Log all coupon usage for audit trails
• Use secure random generation for bulk codes