Set up a subscription¶
A subscription bills the same amount every cycle and keeps going until somebody stops it. There is no total to reach and no final payment. That is the whole difference from an installment plan.
Use it for memberships, retainers, and anything else the customer keeps paying for as long as they keep using it.
Before you start¶
- You need the Charge action on the record's page layout. See Part 6 of the quick start guide if it is missing.
- The gateway must support Subscription billing under its Supported Payment Modes. See the gateway reference.
- You need either a saved payment method for the customer, or you plan to charge by Payment Link instead.
- The background jobs must already be scheduled, or nothing you set up here will ever charge. See Part 7 of the quick start guide.
How a subscription ends¶
A subscription has one setting for this, Ends, with two choices:
| Ends | What happens |
|---|---|
| Never | It bills every cycle indefinitely. The only way it stops is if you stop it, or it pauses itself after repeated declines. This is the ordinary case |
| On date | It bills every cycle until a calendar date you set, then stops on its own |
Never is what makes a subscription a subscription. On date exists for a fixed-term commitment (a twelve-month membership, say) where the amount per cycle is still the thing you are agreeing, not a total to be divided up.
Choosing between On date and an installment plan
Both end on a date, so the question is which number is fixed. If you are agreeing an amount per cycle, use a subscription. If you are dividing a known total, use an installment plan with End date: that spreads the total evenly and works out the per-cycle amount for you.
Steps¶
- Open the record and click Charge.
- Choose Card, ACH, or Payment Link as the payment type.
- Choose Subscription.
- Choose how often it bills under Bills Every: weekly, fortnightly (labelled Biweekly on screen), monthly, quarterly, half-yearly or yearly.
- Under Ends, choose Never or On date. If you choose On date, set Subscription Ends On.
- Set the Start Date.
- Optional: enter an amount under Upfront Payment to charge something today, before the regular cycle begins.
- Click Preview Subscription.
- Check the preview, then click Start Subscription to confirm.
What you should see¶
A new record showing the frequency and next payment date. If you set an upfront payment, or a start date of today, the first charge processes immediately.
If you chose Payment Link instead of a saved payment method, no charge happens yet. ChargeOn emails the customer a link for the first amount due, and the subscription waits for them to pay it.
If it does not work¶
| Symptom | Likely cause | What to do |
|---|---|---|
| Subscription does not appear as an option | The selected gateway is not configured to support that mode | Check its Supported Payment Modes in the gateway reference |
| It was created, but no charge has ever happened | The background jobs are not scheduled | Part 7 of the quick start guide |
| It stopped charging on its own | Three consecutive declines paused it. Three is the default; your administrator can change the limit | Fix the payment method, then resume it |
| A charge came from a gateway you did not expect | The first charge failed over to a fallback gateway, and it is now permanently pinned to it | This is expected behaviour. See the warning in Installments and subscriptions |