Managing Subscriptions

Available via: Dashboard and API

Viewing Subscriptions

From the Dashboard

Go to Subscriptions in your Dashboard to see all subscriptions. You can filter by:

• Status — Active, Past Due, Canceled, etc.
• Currency — EUR or USD
• Billing Interval — Day, week, month, year
• Offer — Filter by specific subscription offer
• Waitlist Status — Pending, approved, declined, etc.

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)
• Extra information collected during checkout

Via the API

List all subscriptions:

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

Filter subscriptions:

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

Get a specific subscription:

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

Get subscriptions for a specific offer:

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

Filter Parameters

Canceling a Subscription

From the Dashboard

1. Go to the subscription details.
2. Click Cancel Subscription.
3. The subscription enters PENDING_CANCELLATION and is fully canceled at the end of the current billing cycle.

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.xyz/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.xyz/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 — from the subscription details in the Dashboard, or via the API:

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

Retry Failed Payments (Dashboard Only)

If a recurring payment fails:

1. Go to the subscription details.
2. Click Retry Payment.
3. Inflow attempts to charge the customer's payment method again.

Payment Method Update Link (Dashboard Only)

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

1. Go to the subscription details.
2. Click Generate Payment Method Update Link.
3. Send the generated link to your customer.
4. The customer can update their payment method through a secure page.

Subscription Metrics (Dashboard Only)

The Subscriptions section of the Dashboard shows:

• MRR (Monthly Recurring Revenue) — Total recurring revenue normalized to a monthly basis
• Active Subscribers — Count of currently active subscriptions
• Churn — Subscriptions canceled in the current period