Waitlist

Available via: Dashboard only

How the Waitlist Works

When you enable the waitlist on a subscription offer, customers who subscribe are placed in a pending queue instead of being charged immediately. You (the merchant) must approve or decline each subscriber from the Dashboard.

Flow

1. Customer completes the checkout for a waitlist-enabled offer.
2. Their payment method is collected but not charged yet.
3. The subscription enters pending_waitlist status.
4. You review and approve or decline the subscriber from the Dashboard.
5. If approved: the customer has 24 hours to be charged automatically (or they can start immediately using the "override" link in their email).
6. If declined: the subscription is canceled and the customer is not charged.

Enabling the Waitlist

From the Dashboard

Toggle Waitlist when creating or editing a subscription offer.

Via the API

Set waitlistEnabled: true 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": "Exclusive Plan",
    "description": "Limited access — approval required",
    "amountInCents": 9999,
    "currency": "EUR",
    "interval": "month",
    "intervalCount": 1,
    "waitlistEnabled": true
  }'

Managing the Waitlist (Dashboard Only)

All waitlist management actions are available from the Subscriptions section of the Dashboard.

Approve a Subscriber

1. Go to Subscriptions and find the pending subscriber.
2. Click Approve.
3. The customer receives an approval email.
4. Their payment method is charged automatically within 24 hours, or they can click the "Start Now" link in the email to begin immediately.

Decline a Subscriber

1. Find the pending subscriber.
2. Click Decline.
3. The subscription is canceled. The customer is not charged.

Approve All

For a specific offer, you can approve all pending waitlisted subscribers at once:

1. Go to the offer details.
2. Click Approve All.
3. All pending subscribers are approved in batches.

Retry Capture

If a subscriber was approved but their payment failed (e.g., insufficient funds), you can retry:

1. Find the subscriber with failed_capture status.
2. Click Retry.
3. The system attempts to charge their payment method again.

Customer Actions

Customers receive email notifications with action links:

• Start Now (Override) — After approval, the customer can click this to start their subscription immediately instead of waiting for the automatic 24-hour charge.
• Cancel — The customer can cancel their waitlisted subscription before being charged.

If the automatic charge fails, the customer receives a payment recovery email with a link to update their payment method and retry.

Waitlist Statuses

Important Notes

• The 24-hour automatic charge window starts when you approve the subscriber. In development mode, this is reduced to 60 seconds for testing.
• If the automatic charge fails, the subscription moves to failed_capture. You can retry manually.
• Waitlist management is dashboard-only — there are no API endpoints for approve/decline actions.