Cashback Campaign API Reference

curl "https://api.helloclever.co/v2/cashbacks/campaigns?status=active" \
  -H "app-id: your-app-id" \
  -H "secret-key: your-secret-key"

{
  "data": [
    {
      "id": "campaign-001",
      "name": "Weekend Cashback",
      "status": "active",
      "cashback_type": "percentage",
      "cashback_value": 10,
      "applicable_payment_methods": ["payid", "payto"],
      "max_cashback_per_transaction": 50.00,
      "starts_at": "2026-04-12T00:00:00Z",
      "ends_at": null
    }
  ],
  "meta": {
    "total": 1,
    "page": 1,
    "per_page": 20
  }
}

curl https://api.helloclever.co/v2/cashbacks/campaigns/campaign-001 \
  -H "app-id: your-app-id" \
  -H "secret-key: your-secret-key"

{
  "id": "campaign-001",
  "name": "Weekend Cashback",
  "status": "active",
  "tiers": [
    {
      "min_order_amount": 0,
      "cashback_type": "percentage",
      "cashback_value": 5
    },
    {
      "min_order_amount": 100,
      "cashback_type": "percentage",
      "cashback_value": 10
    }
  ],
  "max_cashback_per_transaction": 50.00,
  "max_cashback_whole_campaign": 10000.00,
  "max_cashback_per_user": 100.00,
  "applicable_payment_methods": ["payid", "payto"],
  "schedule": {
    "type": "repeat",
    "days": ["saturday", "sunday"]
  }
}

curl "https://api.helloclever.co/v2/cashbacks/users" \
  -H "app-id: your-app-id" \
  -H "secret-key: your-secret-key"

{
  "data": [
    {
      "user_id": "user-abc123",
      "email": "customer@example.com",
      "cashback_balance": 25.50,
      "status": "active"
    }
  ],
  "meta": {
    "total": 1,
    "page": 1
  }
}