Managing contracts
When a customer places a subscription order, ShopWired creates a subscription contract. The contract records the customer's subscription items, payment method, billing and delivery details, and renewal terms. The Subscriptions app uses it to manage future renewals.
Contracts created through the new subscription system appear in the app's Contracts section. Subscriptions created before you activated the new system remain in the earlier Subscriptions app. Read more about migrating from Subscriptions v1.
Find and view a contract
Find and view a contract
- Navigate to Apps > Subscriptions in your ShopWired account
- Navigate to Contracts
- Search by plan name or use the status and next renewal date filters
- Select
More filtersto filter by payment method, renewal status, stock and products, renewal type or customer ID - Select the contract to view it
The contract page has four tabs:
- Summary shows the contract details, next renewal, billing and delivery addresses, payment method and the plan settings recorded when the customer subscribed
- Items shows each product or variation, quantity, price, VAT rate, status and current product availability
- Renewals and orders shows recorded renewal progress, payment attempts, related orders and one-off payments
- Timeline shows subscription changes and actions in date order
The contract's ShopWired status and the app's renewal status are shown separately. An active contract does not necessarily mean that its next renewal can proceed; check both statuses and any message explaining why action is needed.
The Plan when bought section records the original plan settings. Editing a plan does not change an existing contract. Read more about creating and managing plans.
Pause, resume or cancel a contract
Pause, resume or cancel a contract
Pause a contract
Select Pause contract on an active contract, review the explanation and add an Internal note (optional) if needed. Select Pause contract in the confirmation to apply the change.
Pausing stops the app from scheduling future renewals until the contract is resumed.
If a renewal is in progress, a payment has failed or the contract needs review, the app may prevent the change. Read the message shown and review Renewals and orders before taking another action.
Resume a contract
Select Resume contract on a paused contract. In When to renew, select one of the available options:
Keep the original scheduleuses the next future date on the original subscription scheduleChoose a date and timelets you enter a future date in Next renewal date and time (GMT)
Select Resume contract to apply the change, then check the next renewal shown in Summary.
The Renew now option is currently unavailable. Resuming does not take an immediate payment.
The app needs an existing renewal schedule to resume scheduled renewals. If the action is unavailable, read the explanation shown beneath it.
Cancel a contract
- Select
Cancel contract - Enter a Reason for cancelling
- Select the confirmation that cancellation is final
- Select
Cancel contractto apply the change
Start a contract
A contract that has been created in ShopWired but is not yet active is shown as Starting.
Where available, select Start contract, review the details and select the confirmation that the contract should start. Select Start contract to apply the change.
Starting makes the contract active in ShopWired and sets up its renewal schedule in the app, unless it is paid offline. Offline renewal orders are not created automatically.
Change renewal terms
Change renewal terms
Use the actions in Contract details on the Summary tab to change the number of orders or trial end.
Change the number of orders
- Select
Change number of orders - In Ends after, select
UnlimitedorA set number of orders - If you select a set number, enter the total in Number of orders
- Review the number of orders already completed
- Select
Save
The limit includes the first order. For example, a limit of 6 allows the first order and 5 renewal orders.
If the new limit is equal to or lower than the number already completed, the contract will have no further renewals.
Change the trial end
Select Change trial end to enter a new trial end date or remove the existing trial end date.
The app calculates the resulting next renewal date before saving. It does not save a change that would put the next renewal in the past.
Removing the trial end date moves the next renewal to one subscription interval after the contract was created. Check the resulting date before confirming the change.
Skip the next renewal
For an eligible active online contract, select Skip next renewal to move the app's next scheduled renewal forward by one subscription interval.
Review Next renewal now and After skipping, add an Internal reason (optional) if needed, then select Skip renewal.
Skipping does not create an order or take a payment.
Renewal schedules use GMT throughout the year, including when the UK changes to British Summer Time. Check Next renewal and Renewal times in Summary after making a schedule change.
Read more about renewals and failed payments.
Change contract items
Change contract items
Select the Items tab to review the products and variations in the contract. Each item has its own status. Active items are included in future renewals; paused and cancelled items are not.
Edit an item
- Select
Edit itembeside the item - Edit its Quantity, Price without VAT, VAT rate or Status
- Select
Save changes
Enter item prices without VAT. This differs from the VAT-inclusive fixed price entered when creating a plan.
Add an item
- Select
Add item - Enter a product name or SKU code in Search products
- Select
Search - Select the required product or variation, checking its exact SKU code
- Enter Quantity, Price without VAT and VAT rate
- Select an Initial status and enter Comments if needed
- Select
Add item
Only products and variations with a SKU code can be added. Review the product and stock information before saving.
Cancel an item
Select Cancel item, review the item details and confirm the cancellation.
Cancelling an item is permanent. The item remains in the contract's record but is excluded from future renewals. Use the paused status instead if you intend to resume the item later.
Changes to contract items affect future renewals. They do not edit orders already placed.
Customers can also manage available item changes through the customer portal. Read more about customer subscription management.
Edit billing and delivery details
Edit billing and delivery details
- Select the contract's Summary tab
- Select
Edit billing and shipping - Enter the updated billing and delivery details
- Check both addresses
- Select
Save details
The app labels delivery details as Shipping address within Billing and shipping.
If the delivery address should match the billing address, select Shipping address is the same as billing. Otherwise, check the separate delivery address before saving.
The Country ID (required) setting uses ShopWired's numeric country ID, not a country name or two-letter country code. Retain the existing value unless the country needs to change.
Address changes apply to the subscription's future orders. They do not edit orders already placed.
Update payment details
Update payment details
For an eligible contract paid through Stripe or ShopWired Payments, the Payment method section provides two ways to update the existing payment method.
Card details are entered on a secure ShopWired-hosted page and are not displayed in the Subscriptions app. These actions do not switch the contract to another payment provider.
Open the secure payment page
- Select
Update payment details - Select
Create secure linkif a link is not already available - Select
Open secure page - Complete the card update on the secure page
- Return to the contract and select
Check for updates
Check the link's expiry before using it. If it has expired, follow the option shown to generate a replacement.
Opening the secure page or returning from it does not, by itself, confirm that the payment details were changed.
Send a link to the customer
- Select
Create customer payment link - Check the contract's billing email address and message preview
- Select
Create linkif a link is not already available - Select
Send emailto send it to the billing email address on the contract - Check the email delivery status
Where available, select Copy customer link to copy the link and send it to the contract's billing email address.
The customer link can be used once and expires seven days after it is created. It opens the card-update task for that contract only; it does not sign the customer in to the wider customer portal.
If email sending is unavailable, check the sender and email settings on Payment retries and alerts. Read more about subscription settings and notifications.
Payment update links are not available for offline contracts. Updating a card does not pay an earlier failed renewal or start another payment automatically.
View renewals, orders and charges
View renewals, orders and charges
Select Renewals and orders to check each renewal's progress, payment attempts and related orders.
Recorded renewal progress shows the original due date, numbered payment attempts, next retry, final choice and any reason the renewal needs review. Select Reload renewal history to refresh this information.
A scheduled retry does not mean the payment has already been attempted. A pending final choice does not mean the contract has already been paused or cancelled.
Select a linked ShopWired order to view it. Use Timeline to review when the app or ShopWired recorded changes.
Review recovery actions
Where available, the renewal controls include:
Check ShopWiredreads the latest payment and order information without taking another paymentCheck and repair orderchecks the existing payment and order before attempting an available repairRun due retryruns an eligible retry when it is due under the saved retry rulesClose failed renewalcloses that failed renewal in the app without refunding a payment, cancelling the contract or increasing its completed order count
The app explains why an unavailable action cannot be used. Review the result under Recent recovery actions before submitting another request.
Read more about renewals, failed payments and recovery.
Take a one-off payment
A one-off payment is separate from a subscription renewal.
Where available, select Take a one-off payment in Payment method:
- Enter Amount, including VAT
- Enter a Description, which is shown on the customer's receipt
- Select
Review payment - Check the customer, contract, amount, currency and description
- Select the payment button showing the amount to take
- Review the result
A one-off payment does not create an order or advance the subscription's renewal schedule or completed order count.
If the result is not confirmed, review Payments to confirm on Issues before taking another payment.
Offline contracts can be viewed and managed, but the app does not create their renewal orders automatically or collect one-off card payments for them.
Export contracts
Export contracts
Select Export CSV from Contracts to navigate to Import and export.
On the Export contracts tab, select the contract filters and information to include, then select Create export. Download the completed file from History.
The export can include contract items, renewal history, related order IDs and the app's renewal schedule. Follow the importing and exporting subscription data guide for the available filters and column definitions.