Trial Periods

How Trials Work

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

• The customer provides their payment method during checkout.
• The subscription status is set to ACTIVE with a trial start date.
• After the trial period expires, the first charge is processed automatically.
• If the first charge fails, the subscription follows the standard payment failure flow.

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.