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 offer:

1. In the offer creation form, find the Trial Period field.
2. Enter the number of free days (1–365).
3. Complete the offer creation.

Via the API

Include the trialPeriodDays field when creating an offer:

curl -X POST https://api.inflowpay.xyz/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

You can combine a trial period with an entry fee. In this case:

1. The customer enters the trial period (no charge).
2. When the trial ends, the entry fee is charged first.
3. Subsequent charges use the regular subscription amount.

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.