Reseller Program

What the Reseller Program page is for

The Reseller Program page is the central switch and policy panel for your wholesale reseller programme. From one place you decide who can apply to become a reseller, what tier they sit in, how their orders are paid, how their API and webhook integrations behave, and whether you also resell another operator's catalogue through an upstream connection.

How to reach this page

In the admin panel, open Settings, then under the Financial group choose Reseller Program. The entry only appears when the resellers feature is enabled for your platform. Wholesale pricing itself is not set here — you configure it per product (see Products).

Turning the programme on

At the top of the page is the main Enable Reseller Program toggle, described as “Allow users to apply as resellers and purchase at wholesale prices.”

1. Flip the toggle on. The full set of policy sections (tiers, approval, orders, payment, API, webhooks) appears beneath it.
2. When the toggle is off, an amber notice reads: “The reseller program is currently disabled. Enable it to allow reseller applications and wholesale orders.” While it is off, the Reseller link does not appear in client sidebars and reseller features are inaccessible.
3. With the programme on, a secondary Show ‘New’ Badge toggle appears. Leave it on to display a “New” badge next to the Reseller link in the client sidebar, drawing attention to the new offer.
4. Click Save Settings (top right) to persist everything on the page.

Saving is a single action for the whole page. Tier rows, toggles, payment mode and the numeric fields are all stored together when you click Save Settings. The upstream connection list, however, saves immediately as you add, edit or delete connections — it does not wait for the page Save.

Reseller Tiers

The Reseller Tiers table defines a ladder of levels based on sales volume. Each tier a reseller reaches can unlock better wholesale pricing on your products. A reseller's tier is calculated from their total sales over the last 30 days, and the highest tier they qualify for applies.

The table has these columns:

• Color — a row of coloured dots (bronze, silver, gold, platinum, diamond). Click a dot to assign that colour to the tier, purely as a visual label.
• Tier Name — an editable text field for the tier's name (for example Bronze, Silver, Gold).
• Min Sales — the minimum 30-day sales total a reseller must reach to enter this tier, shown with your platform currency symbol.

To add a tier, click Add Tier; a new band is appended with a threshold above the highest existing one. To remove a tier, click the trash icon at the end of its row (you cannot remove the last remaining tier). Tiers are automatically sorted by their minimum-sales value.

The first (lowest) tier must start at 0 in monthly sales — its minimum-sales field is locked and cannot be edited. If you try to save without a tier at 0, the page shows an error (“First tier must start at 0 monthly sales”) and refuses to save. This guarantees every approved reseller always lands in a starting tier.

Approval Settings

These three toggles control how new resellers are onboarded and what identifiers you collect from them.

Toggle	What it does
Auto-Approve Applications	Automatically approves new reseller applications without manual review. Leave it off if you want to vet each applicant yourself from the Resellers page.
Require Company Name	Resellers must provide a company name when applying.
Require VAT Number	Resellers must provide a valid VAT number when applying.

Order Settings

The Minimum Order Amount field sets the smallest order value a reseller may place, shown in your platform currency. Set it to 0 for no minimum.

Payment Mode

The Payment Mode section is a set of three selectable cards that decide how reseller orders are paid. Click a card to select it (the chosen card is highlighted with a check mark).

Mode	How it works
Saved Payment Method	Auto-charges the reseller's saved card or PayPal. The order fails if no method is saved or the charge is declined.
Credit Balance	Deducts the order from the reseller's credit balance. The order fails if the balance is insufficient.
Invoice (Net Terms)	Generates an unpaid invoice for the reseller. The service is provisioned only after the invoice is paid.

When you select Invoice (Net Terms), an extra Invoice Due Days field appears. Enter the number of days until the reseller invoice is due; provisioning happens only once that invoice is paid.

Changing the payment mode affects future reseller orders only. Existing services are not retroactively rebilled.

API Settings

The Rate Limit (requests/hour) field caps how many API requests each reseller may make per hour. This is a per-reseller ceiling, so one busy reseller cannot exhaust the allowance of another.

Webhook Settings

These fields govern how reseller webhook deliveries are retried when they fail.

Field	What it does
Max Retry Attempts	How many times a failed webhook delivery is retried before it is given up.
Base Retry Delay (seconds)	The starting wait between attempts. Retries use exponential backoff — each attempt waits the base delay multiplied by 2 to the power of the attempt number.

Upstream Connections

The Upstream Connections section — marked with a link icon — lets you become a reseller of another FluxBilling platform. Products from a connected platform become available for you to sell to your own customers at wholesale prices, without managing the underlying infrastructure yourself. Use the toggle at the right of the section header to switch upstream connections on.

With it enabled, you see a short info note, a count of connected platforms, and an Add Connection button. Each existing connection appears as a row in a table with these columns:

• Platform — the connection name and its API URL.
• Status — a badge reading Active, Paused, Error or Disabled (an error message is shown beneath when present).
• Products — how many products have been synced from that platform.
• Orders — how many orders have been placed through it.
• Last Sync — when products were last synced (or Never).

Each row ends with four action buttons: Sync Products (refresh icon, pulls the latest catalogue), Auto-create Local Products (plus icon, creates matching products in your own catalogue), Edit Connection, and Delete Connection (which asks for confirmation first).

Adding or editing a connection

Clicking Add Connection (or the edit button) opens a dialog with these fields:

Field	Purpose
Connection Name	A label for the connection, for example “Supplier Platform A”. Required.
Description	Optional notes about this connection.
Platform API URL	The web address of the platform you are reselling from. Required.
Reseller API Key	Your reseller API key issued by that other platform. Use the eye icon to reveal or hide it. When editing an existing connection, leave it blank to keep the stored key.
Sync Interval (hours)	How often the catalogue is automatically synced (1 to 168 hours).
Default Markup (%)	A percentage added on top of the upstream wholesale price when products are created locally (0 to 100).
Auto-sync products automatically	A checkbox that keeps the catalogue refreshing on the chosen interval.

1. Fill in the connection name, the platform API URL, and your reseller API key.
2. Set the sync interval and default markup, and decide whether to auto-sync.
3. Click Test Connection. On success the dialog reports how many products were found; on failure it shows the reason.
4. Click Create Connection (or Update Connection when editing) to save.

Always run Test Connection before saving a new upstream link. A bad URL or wrong API key is caught here instead of leaving you with a connection that quietly sits in an Error state.

Recommended setup

For a typical business-to-business programme, turn on Auto-Approve Applications together with Require Company Name and Require VAT Number. You skip manual review while still collecting the identifiers you need for tax compliance. Pair that with a clear tier ladder and per-product wholesale prices so resellers see a real benefit as their volume grows.

Related

Resellers · Reseller Details · Products · Settings: Billing