Managing Subscriptions

Available via: Dashboard and API

Viewing Subscriptions

From the Dashboard

Go to Subscriptions in your Dashboard to see all subscriptions. You can search, pick a date range with Select dates, and filter by Status, for example Active, Past due or Cancelled. Click + to add more filters:

• Currency — EUR or USD
• Interval — Daily, Weekly, Monthly, Yearly
• Customer ID — Filter by a specific customer
• Template ID — Filter by a specific subscription template

Click Columns to choose which columns are shown.

Click on a subscription to see its details, including:

• Customer email
• Payment history for this subscription
• Current status and next payment date
• Discord information (if integrated)

See Subscriptions for the full Dashboard guide.

Via the API

List all subscriptions:

curl https://api.inflowpay.com/subscription?page=1&limit=20 \
  -H "X-Inflow-Api-Key: your_private_key"

Filter subscriptions:

curl "https://api.inflowpay.com/subscription?status=ACTIVE&currency=EUR&interval=month" \
  -H "X-Inflow-Api-Key: your_private_key"

Get a specific subscription:

curl https://api.inflowpay.com/subscription/{subscriptionId} \
  -H "X-Inflow-Api-Key: your_private_key"

Get subscriptions for a specific offer:

curl https://api.inflowpay.com/subscription/offers/{offerId}/subscriptions \
  -H "X-Inflow-Api-Key: your_private_key"

Filter Parameters

Canceling a Subscription

From the Dashboard

1. Open the subscription and click Cancel subscription, or click ⋮ → Cancel subscription in the list.
2. To end the subscription right away, tick Cancel immediately. Otherwise, the subscription enters PENDING_CANCELLATION and is fully canceled at the end of the current billing period.
3. Click Confirm.

Via the API

By default, cancellation takes effect at the end of the current billing cycle (the subscription enters PENDING_CANCELLATION):

curl -X DELETE https://api.inflowpay.com/subscription/{subscriptionId} \
  -H "X-Inflow-Api-Key: your_private_key"

To cancel immediately, pass cancelNow: true in the body:

curl -X DELETE https://api.inflowpay.com/subscription/{subscriptionId} \
  -H "X-Inflow-Api-Key: your_private_key" \
  -H "Content-Type: application/json" \
  -d '{ "cancelNow": true }'

Reactivating a Subscription

A subscription in PENDING_CANCELLATION can be reactivated before the cycle ends — in the Dashboard, open the subscription and click Keep subscription on the Pending cancellation banner, or via the API:

curl -X PATCH https://api.inflowpay.com/subscription/{subscriptionId} \
  -H "X-Inflow-Api-Key: your_private_key" \
  -H "Content-Type: application/json" \
  -d '{ "cancelAtPeriodEnd": false }'

POST /subscription/{id}/reactivate and POST /subscription/{id}/upgrade are deprecated — both are replaced by PATCH /subscription/{id}.

Changing the Plan, Pausing, Extending Trials

Upgrades, downgrades, billing cycle changes, proration, pauses, and trial extensions all go through the unified PATCH /subscription/{id} endpoint. See Updating a Subscription for the full guide.

In the Dashboard, open the subscription to Pause subscription, Extend trial or End trial now, or click ⋮ → Change plan or Postpone payment. See Manage a Subscription.

Retry Failed Payments (Dashboard Only)

If a recurring payment fails:

1. Open the subscription. A subscription that is Past due or Unpaid shows a Failed payment banner. A subscription Pending cancellation whose last renewal failed keeps that status (it still ends at currentPeriodEnd) and can be retried the same way.
2. Click Retry payment on the banner.
3. Inflow attempts to charge the customer's payment method again — for whatever amount is currently due. A paid retry does not change a scheduled cancellation: the subscription stays Pending cancellation until the period end.

Inflow also retries failed renewals automatically. If Smart Retry is enabled, those automatic attempts (and the amount due when you click Retry payment above) charge progressively less instead of the full price, to recover more subscribers.

Payment Method Update Link (Dashboard Only)

If a customer's card has expired or their payment method needs updating:

1. Open the subscription. A subscription that is Past due or Unpaid shows a Failed payment banner.
2. Click Copy update link on the banner.
3. Send the copied link to your customer.
4. The customer can update their payment method through a secure page.

Subscription Metrics (Dashboard Only)

Subscription metrics are in Analytics → Reports, not on the Subscriptions page. Reports include:

• MRR and ARR — Recurring revenue normalized to a monthly or yearly basis
• New subscriptions and Subscription retention — How many customers subscribe and stay subscribed
• Churn — Subscriptions lost over the period

See Reports.