Trial Periods

How Trials Work

When you create a subscription offer with a trial period, the customer's subscription starts immediately upon checkout, but they are not charged until the trial ends.

• The customer provides their payment method during checkout — no charge happens (the card is collected through a PaymentSetup).
• The subscription status is set to TRIAL with a trial start date. It transitions to ACTIVE once the first charge succeeds at the end of the trial.
• After the trial period expires, the first charge is processed automatically.
• If the first charge fails, the subscription follows the standard payment failure flow.

Integrating trials with the SDK or API? See Free Trial & Card Setup for the full flow: initiating the subscription, collecting the card without charging, and tracking the setup via webhooks.

Setting Up a Trial

From the Dashboard

When creating a subscription template in Product catalog → Subscription templates:

1. Under Pricing, click More options.
2. Enter the number of free days in Free trial (1–365).
3. Click Create template.

You can also change the free trial later: open the template and click Edit. See Subscription Templates.

Via the API

Include the trialPeriodDays field when creating an offer:

curl -X POST https://api.inflowpay.com/subscription/offer \
  -H "X-Inflow-Api-Key: your_private_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Pro Plan",
    "description": "Full access with 14-day free trial",
    "amountInCents": 2999,
    "currency": "EUR",
    "interval": "month",
    "intervalCount": 1,
    "trialPeriodDays": 14
  }'

Trial + Entry Fee

A subscription offer can have a free trial or an entry fee, not both. The Dashboard doesn't let you set both, and if an offer created via the API has both, the entry fee applies and the trial is ignored.

Important Notes

• Trial periods are set at the offer level — all subscribers to that offer get the same trial duration.
• The customer must provide a valid payment method during checkout, even for free trials.
• Customers can cancel during the trial period without being charged.
• Trial period values must be between 1 and 365 days.