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
search
to search subscriptions by subscription ID, customer surname, email address or postcode - Use the
product
filter to search subscriptions by SKU code or product name - Use the
subscription status
filter to display subscriptions by status, eithersubscribed
orcancelled
- Use the
state
filter to display subscriptions by state, eitheractive
orarchived
- 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
amount
displays the grand total of the subscription - The
total amount
displays the grand total of all orders resulting from the subscription - The
status
displays the subscription's status, either subscribed or cancelled - The
state
column (labelledarchive
) displays whether the subscription is active or inactive - To make a subscription inactive, select the checkbox for the subscription in the
archived
column
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
cancel
option
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.
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.
Subscription settings
Subscription settings
To set additional settings for subscriptions navigate to Apps > Installed > Subscriptions.
Subscription billing day
To process all monthly subscription payments on the same day, set your preferred date in the Subscriptions billing day setting.
When a new monthly subscription is created before the next billing day, 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.
Skip logic days
Skip logic days
If a new subscription is created before the next 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.