Subscriptions
To use subscriptions functionality, you'll need to install the app:
- Navigate to Apps
- Locate the Subscriptions app
- Select
install this app
Subscription orders
When a visitor creates an order containing subscription products:
- A subscription is created
- The subscription can be viewed and managed within your ShopWired account
- The subscription can be viewed and managed within the customer's account
- An order is created
- The customer is sent the Order confirmation email
- The order resulting from the subscription is the same as a standard order
Managing subscriptions
Managing subscriptions
To view and manage subscriptions, navigate to Orders > Subscriptions.
- Use the
searchto search subscriptions by subscription ID, customer surname, email address or postcode - Use the
productfilter to search subscriptions by SKU code or product name - Use the
subscription statusfilter to display subscriptions by status, eithersubscribedorcancelled - Use the
statefilter to display subscriptions by state, eitheractiveorarchived - The subscription's state does not affect whether or not the subscription will renew; it is used for internal organisation purposes only
The table on the subscriptions page displays each subscription:
- The
amountdisplays the grand total of the subscription - The
total amountdisplays the grand total of all orders resulting from the subscription - The
statusdisplays the subscription's status, either subscribed or cancelled - The
statecolumn (labelledarchive) displays whether the subscription is active or inactive - To make a subscription inactive, select the checkbox for the subscription in the
archivedcolumn
Select the edit option to view the full subscription details.
When viewing a subscription, you can select edit to edit the customer's details (billing name, billing address, shipping name, shipping address, email address and telephone number).
The products within a subscription cannot be edited.
Use the Internal notes / comments section to add internal notes about the subscription. These are not shown to your customer.
Creating subscription orders
Creating subscription orders
You can create subscriptions through your ShopWired account.
- Navigate to Orders > Create order
- Create the order in the standard way, adding the details for the customer
- Ensure that all the products selected have the same billing interval and, if applicable, the same number of fixed intervals
- Select
create order
The subscription will be created along with the first initial order and an Order confirmation email will be sent to the customer.
You cannot attach billing information to subscriptions created through your ShopWired account. Each time an order is created, following the subscription's renewal, it will be assigned the order status corresponding to your ShopWired account's for unpaid orders.
Cancelling a subscription
Cancelling a subscription
To cancel a subscription on behalf of your customer:
- Navigate to Orders > Subscriptions
- Select the subscription you want to cancel
- Select the
canceloption
When a subscription is cancelled:
- The status of the subscription changes to
cancelled - No further recurring payments will be processed
- The subscription cannot be reactivated
Your customers can also cancel subscriptions through your website. To cancel a subscription, a customer will need to log in to their account, navigate to the subscriptions page and select the cancel option for the subscription they want to cancel.
If a customer cancels a subscription through their customer account, you will not be notified.
Renewals
Renewals
Each time a subscription renews, and the customer's payment card is successfully charged, a new order is created replicating the products in the subscription.
- For subscriptions placed using the offline payment method, renewals are processed between 4.00am and 5.00am GMT
- For subscriptions placed using Stripe or ShopWired Payments, renewals are processed at the same time that the original (first) subscription order was created
- For subscriptions originally created in a free trial period, renewals are processed at 5.00am GMT
To ensure that a new Order confirmation email is generated and sent to you and your customer each time a subscription renews, navigate to Orders > Order settings and select the Send an order confirmation email each time a subscription renews setting.
Orders created from subscriptions include the word subscription after the payment method name (visible when viewing the order).
Failed billing
Failed billing
If a recurring subscription payment fails to process successfully because the credit/debit card used on the subscription was declined by the card-issuing bank, a new order will not be created for the subscription.
When using ShopWired Payments, the customer's card will be automatically retried up to 8 times over a 2 week period using Stripe's automatic retries feature.
When using Stripe, the customer's card will be automatically retried according to the retry settings you've set in your Stripe account - contact Stripe support for assistance.
Email notification
- When a subscription renewal fails, you will be automatically sent the Subscription payment failed email
- Your customer will not receive a copy of this email.
- The contents of this email can be customised by navigating to Settings > Emails
- The variable
{{ failed_subscription_id }}can be used in the email to return the ID of the subscription the email relates to
Subscription settings
Subscription settings
To set additional settings for subscriptions navigate to Apps > Installed > Subscriptions.
Monthly subscriptions billing day
To process all monthly subscription payments on the same day, set your preferred date in the Monthly subscriptions billing day setting.
When a new monthly subscription is created before the set day of the month, it will start as a free trial. No payment will be taken for the initial order, which will be assigned the for unpaid orders in your ShopWired account.
Weekly subscriptions billing day
To process all weekly and fortnightly subscription payments on the same day, set your preferred day of the week using the Weekly subscriptions billing day setting by selecting the day of the week.
When a new weekly or fortnightly subscription is created before the set day of the week, it will start as a free trial. No payment will be taken for the initial order, which will be assigned the for unpaid orders in your ShopWired account.
Automatically add refunds for free trial subscription orders
If this setting is enabled, a refund equal to the order's grand total will be automatically added to the initial order of any subscription with a free trial. This ensures that order totals and reports remain accurate and are not affected by the free trial order.
The refund will be added to the order with a comment of Subscription free trial.
Don't deduct stock for free trial subscription orders
If enabled, this setting ensures that stock levels are not reduced for items in the initial order of a subscription that begins with a free trial.
Automatically set the status of free trial subscription orders to cancelled
If enabled, this setting sets the status of orders created in a free trial period to the order status in your ShopWired account assigned to the for cancelled orders.
Skip logic days
Skip logic days
If a new subscription is created before the next Monthly subscriptions billing day or Weekly subscriptions billing day, it will start as a free trial. The free trial period will last for the number of days between the subscription start date and the next billing day.
Subscriptions with a free trial will display a notice at the top of the order page and will be assigned the for unpaid orders.
Theme installation
Theme installation
The display of subscription information on your website is determined by your website's theme. The subscription app is preconfigured on ShopWired Version 3, 4 and 5 themes and you do not need to make any changes to your theme files.
The account_subscriptions.twig template has access to the subscriptions array which contains both active and cancelled subscriptions for the customer.
The account_subscription.twig template can access information about a specific subscription, available at the URL /account/subscription/{{ subscription.id }}.
subscriptions
Returns an array of subscriptions for a customer.
subscription.created
Returns the date the subscription was created.
subscription.total_amount
Returns the total amount of the subscription.
subscription.id
Returns the ID for the subscription.
subscription.status
Returns the status of the subscription (active or cancelled).
subscription.order.products
Returns an array of products contained within the subscription.
basket.discount
The basket.discount variable includes discounts obtained as a result of buying a subscription option of a product which has a discount value set.
order.product.subscription_interval.id
Returns the ID of the subscription interval on an ordered product.
order.product.subscription_interval.description
Returns the name of the subscription interval on an ordered product.
order.product.subscription_interval.billing_intervals
Returns the number of billing intervals on an ordered product.
order.product.subscription_interval.is_one_off_purchase
Returns true if the ordered product is a one-off purchase.
order.subscription_discount
Returns the total value of discounts obtained from subscription products in the order, without VAT.
order.subscription_discount_including_tax
Returns the total value of discounts obtained from subscription products in the order, with VAT.
has_subscription_products
Returns true (on checkout/login when not using platform checkout) if the basket contains a subscription product.