Subscriptions
Add new Subscriptions
Subscription payments occur when customers authorise a merchant to charge them for goods or services on a scheduled basis. As opposed to one-time purchases, recurring payments require merchants to securely store additional customer information for future charges.
To add a new Subscription, which will automatically add a new Customer:
- Go to Subscriptions > Add new
- Complete the Customer's Personal Information, Address, Payment Information and Payment Details
- Choose the Interval, Frequency, Start and End Date, and Retry
- Select Add Subscription
OR add a Subscription from Customers, go here
Here are the Subscriptions' key parameters:
-
Interval - the period between Charge reattempts (daily, weekly, monthly or annually).
-
Frequency - the number of Charge reattempts for the set Interval (e.g. a Charge every 5 days equals Interval to 'days' and Frequency to '5').
-
Start Date - the date of the first Charge, in UTC format
-
End - the date of the last Charge, in UTC format
- End never โ process Charges until manual termination.
- End date โ process Charges until a specified date.
- End amount reached or exceeded - process Charges until a certain financial threshold has been reached or exceeded.
- End amount not to exceed - process Charges before a certain financial threshold has been reached. The remainder of the Charges will not be processed if there's a 'gap'.
- Total Transactions - process Charges until a specified number of payments have been collected.
- Total amount equals - process Charges until a specified amount of payments have been collected. The remainder of the Charges will be processed at the last Transaction if there's a shortfall.
Note
By default, the first Charge on the Subscription is scheduled for 11:30 AM UTC on the current day . If you create a Subscription earlier, the Charge will happen at this particular time, so do not worry if you do not see an immediate payment. If a Subscription is created after 11:30 AM UTC, the Charge will be made immediately.
Subscription Status
Subscription payments occur when customers authorize a merchant to charge them for goods or services on a scheduled basis. As opposed to one-time purchases, recurring payments require merchants to securely store additional customer information for future charges. Automated payments simplify the billing process, maximising revenue, securing cash flow, and fostering long-term customer relationships.
Note
Subscriptions statuses help diagnose any issues and act on amendments
Subscription Status | Description |
---|---|
Active | a subscription was created successfully and is active on the customer's account. The status is set automatically. However, you can manually update the status from Failed, Completed, Canceled, or Held to Active and reactivate the Subscription. |
Failed | a subscription has been cancelled manually. The reason could be a customer's request to cancel an active subscription, despite not all payments being processed. Or an initial failure of the automated payments due to incorrect customer payment details. |
Cancelled | a subscription has been cancelled manually. The reason could be a customer's request to cancel an active subscription, despite not all payments being processed. Or an initial failure of the automated payments due to incorrect customer payment details. |
Complete | a subscription has automatically ended. The reason is the completion of the subscription's pre-set conditions. For example, the recurring billings have collected the specified amount or number of transactions or have reached the end date. |
Held | a Subscription is paused and will only resume upon a manual reactivation. The records on charges are still created but not processed. Once you set the subscription back to active status, these charges will not be reattempted. |
Default Retry Failed Subscriptions
To configure a default retry cadence for all failed Charges or individual Subscription plans:
- Go to Subscriptions > Settings
- Set the parameters:
- Retry count- how many times the Customer's card is retried after a Charge fails.
- Retry interval (hours) - how many hours are in between the times the Customer's card is retried.
- Click Update.
Custom Retry Failed Subscription
To configure a custom retry cadence for individual failed Charges or Subscription plans:
- Go to Subscriptions > View All > Actions > View details for the specified Subscription. You can use the filter option or browse the list
- Under the Retry section, choose Custom from the dropdown list
- Set the Frequency, Number of retries, Retry interval and Failed status
- Click Update Subscription.
Note
The Frequency and Retry interval control how frequently the Charge will be reattempted, while the Number of Retries controls the maximum number of attempts to capture the Charge.
Update Subscription Status
To update the status of a Subscription (Failed status excluded):
- Go to Subscriptions > View All > Actions > View details for the specified Subscription. You can use the filter option or browse the list.
- Find Status in the upper right corner.
- Click change to and select the status from the drop-down menu.
- Confirm with Yes, please.
- Under the Subscription's Last Status Change, the Manual update will be reflected (previously Automatic).
Update Subscription frequency
To update the Subscription frequency:
- Go to Subscriptions > View All > Actions > View details for the specified Subscription. You can use the filter option or browse the list
- Make the required changes under Schedule > Frequency
- Click Update Subscription.
Note
The Frequency and Retry interval control how frequently the Charge will be reattempted, while the Number of Retries controls the maximum number of attempts to capture the Charge.
Update Payment Source expiry date from Subscription
To update the expiry date of a Payment Source from the Subscription:
- Go to Subscriptions > View All > Actions > View details for the specified Subscription. You can use the filter option or browse the list.
- Go to Payment Sources > Actions > Edit for the specified Source.
- Insert new Expiration month, year and CVV
- Click on Update Expiry.
Download Subscriptions Reports
To download relevant Transaction data in CSV format:
- Go to Subscription> View All > click on All Filtered Items or Just This Page.
Download either a single page with 10, 25, 50 or 100 rows or all filtered items, based on one or more of the criteria below:
- Customer Name
- Subscription ID
- Customer ID
- Payment Service
Note
For Reconciliation discrepancy, we use ISO 4217 standards to truncate transactions in all currencies to 2 digits after the decimal, without any rounding, e.g.30.895 is truncated to 30.89.
Cancel Subscriptions
To cancel a Subscription:
- Go to Subscriptions > View All > Actions > Cancel for the specified Subscription. You can use the filter option or browse the list
- Confirm with Yes, please.
Updated over 1 year ago