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 billing day
Subscription billing day
If you'd like all subscription payments to be processed on the same day (only applicable for subscriptions on a monthly period), navigate to Apps > Installed > Subscriptions and set your desired billing day in the Subscriptions billing day setting.
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.