Trial Periods - Fluxrate

Fluxrate supports free trial periods on subscriptions. During the trial:

Subscription status is TRIAL
No invoices are generated
Usage is still tracked (for billing after the trial ends)

Configuring Trials

On the Plan

Set trial_days when creating a plan to apply a default trial to all subscriptions:

curl -X POST https://api.fluxrate.co/api/v1/plans \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=<token>" \
  -d '{
    "name": "Pro",
    "type": "HYBRID",
    "billing_interval": "month",
    "currency": "USD",
    "trial_days": 14
  }'

On the Subscription

Override the trial period per subscription using trial_end_date:

curl -X POST https://api.fluxrate.co/api/v1/subscriptions \
  -H "Content-Type: application/json" \
  -H "Cookie: access_token=<token>" \
  -d '{
    "customer_id": "<customer_id>",
    "plan_id": "<plan_id>",
    "billing_interval": "month",
    "start_date": "2025-01-01T00:00:00Z",
    "trial_end_date": "2025-01-15T00:00:00Z"
  }'

Trial End Behavior

When trial_end_date passes, the invoice worker automatically:

Transitions the subscription to ACTIVE
Sets current_period_start = trial_end_date
Begins normal billing

Usage during the trial is tracked but not billed. The first invoice covers only the period after the trial ends.