Documentation/Subscriptions for WooCommerce/Add or Edit a Subscription Manually

Add or Edit a Subscription Manually

WebToffee Subscription for WooCommerce allows you to create subscription products and manage subscriptions facilitating a flawless subscription-based e-commerce business enterprise model for your store.

In this article we will review the following sections:

Manually add a Subscription

The steps involved in manually adding a subscription are  as follows:

  1. Go toWooCommerce > WebToffee Subscriptions.
  2. Click the Add Subscription button.
  3. Add a customer to the subscription. Refer Add a Customer section for detailed steps.
  4. Add a billing schedule. Refer Add a Billing Schedule section for more info.
  5. Add products, shipping costs, tax and fees to the subscription, following the process described in the Add Items section below
  6. Set the subscription status, as per the process detailed in the Set Subscription Status section below.
  7. Create a pending renewal order from the Subscription Action meta box as explained in the Create pending renewal order section.


Add a Customer/Subscriber

While creating a subscription manually, associate it with the corresponding subscriber in the following manner:

  1. Click the Customer select box under the subscription details meta box.
  2. Type the first few letters of the name or email for the customer.
  3. Once a set of accounts is loaded, click the customer.


Once a subscriber is added, enter the billing and shipping addresses to be used to manage recurring payments and shipments for the subscription. Existing addresses on the customer’s account can automatically be loaded into Billing Details or Shipping Details of the Subscription details meta box.

To add these details:

  1. Click the pencil icon next to Billing Details.
  2. Click Load Billing Details.
  3. Click the pencil icon next to Shipping Details to Load Shipping Details or Copy Billing Details.

You can also add or edit these addresses, if necessary.

Add a Billing Schedule

The Billing schedule is the core aspect of a subscription. The Billing Schedule Details meta box consists of the following:

  • Date on which the subscription’s trial will end (if any)
  • End date of the subscription itself (if it expires automatically)
  • Recurring interval and period on which renewal orders are generated to capture recurring payments and manage the shipping of items.

To set a billing schedule on a subscription:

  1. Click the Recurrence section of the Billing Schedule meta box to set the billing interval for the subscription. By default, this is set to every, which means once per day, week, month or year, a renewal order is generated.
  2. Next select the billing period for the subscription, which can be day, week, month or year.
  3. Click the Start Date and enter a date or use the calendar to choose a date. The start date must be in the past.
  4. Click the Trial End Date, and enter a date or use the calendar to choose a date (optional).
  5. Use the Next Payment Date to edit the next recurrence of an existing subscription. Subsequent recurrences will be based on this date and the recurrence interval. e.g if you set the next payment date to 11th April 2019 the subsequent run will be on 11th May 2019 considering the monthly billing period and recurrence.
  6. Click the End Date text box, and enter a date or use the calendar to choose a date to set an expiry for the subscription. Leave it empty for a lifetime subscription.


Add Items: Products, Fees, Shipping, Tax

The product corresponding to a subscription along with its shipping cost, fee, tax etc. can be entered by clicking on Add item button. The item meta box consists of the following options:


To add product(s) to a subscription:

  1. Click the Add item(s) button in the Subscription Items meta box.
  2. Click the Add product(s) button.
  3. Click in the text box displaying the placeholder: Search for a product…
  4. Type the first few letters of the product’s name until matching products are populated.
  5. Click the name of the product you wish to add when it loads.
  6. Repeat steps 4-6 if you wish to add more products (optional).
  7. Click Add. The chosen product(s) is/are displayed as items in the Subscription Items meta box.
  8. Save.


To add fee to a subscription:

    1. Click the Add item(s) button in the Subscription Items meta box.
    2. Click the Add fee button.
    3. Click in the text box displaying the placeholder: Enter a fixed amount or percentage to apply as a fee and enter the amount you want to charge customers as a fee on each renewal.
    4. Click OK.


To add shipping details to a subscription:

    1. Click the Add item(s) button in the Subscription Items meta box.
    2. Click the Add shipping button. A generic Shipping item will be displayed in the Subscription Items meta box.


    1. Click the pencil icon next to the shipping line item.
    2. Click in the text box displaying the placeholder: Shipping.
    3. Enter a label for the shipping item to display to customers viewing the subscription and associated orders.
    4. Click the select box below the Shipping text box.
    5. Select a Shipping Method from the drop-down and enter the amount you want to charge customers for shipping on each renewal.
    6. Save


To add tax to a subscription:

    1. Click the Add Tax button in the Subscription Items meta box.
    2. Click the radio button next to the tax rate you wish to add.
    3. Click Add and Recalculate.
    4. Repeat for each tax rate you want to be applied to the subscription.


Note: Before adding a tax rate to the subscription, you need to set up tax rates in WooCommerce>Settings (Tax)tab.

Now that we have set up all the quintessential details of a subscription. What remains is to create an order to record the transaction so that it reaches the customer. This will be done by creating a pending renewal order.

Create a pending renewal order

Let us create a pending renewal order against this subscription.

    1. From the Subscriptions Actions meta box, select Create Pending Renewal Order.
    2. Create related order.

      WebToffee Subscription-Create pending renewal order

    3. A renewal order in pending status will be created in the Related order meta box as shown below:


Activating a subscription

Now that we have an order corresponding to a subscription, the next step is to activate the subscription. A subscription will be made Active if and only if a payment is done towards it. The subscription can be made active in two ways:

    1. The subscriber can directly make a payment by using the Pay option from the Order section. When the payment has been made successfully:
        • the subscription changes to Active status
        • the next payment date will be filled up under Billing schedule

      WebToffee Subscriptions-Pay from Orders


    2. Alternatively, the store owner can update the order status to Processing/Completed upon receiving the payment manually. This can be done by changing the order status to Processing in the order status meta box as indicated below, from the order detail page.


Add Payment method

Now that the subscription is active, the subscriber can add a payment method for the subsequent payments to be triggered as per the scheduled recurrence in automatic repayment mode.

Subscription for WooCommerce-Add Payment

Subscription for WooCommerce-Add Payment

The payment method can be added only for an active subscription once the order is been placed. The Add Payment method can be accessed from My Subscription section. On adding a payment method, the subsequent payments for scheduled recurrences will be taken automatically via the configured payment mode.

Modifying an existing Subscription

We can also edit an existing subscription but there is a limitation on what aspects can be edited. It is also important to note that any such changes will reflect only in the upcoming recurrences.

Note: Additionally there could also be limitations w.r.t the respective payment gateway providers for edits related to billing schedule and recurring totals.

Change Billing Schedule

Change the billing schedule constitutes the subscription’s end date, next payment date, trial end date or recurring schedule.

  1. Go to WooCommerce > Webtoffee Subscriptions.
  2. Click the Subscription ID which redirects you to the Edit Subscription screen.
  3. Modify subscription’s end date, next payment date, trial end date or recurring schedule, as required. If you need instructions for this process, see the section on how to Add Billing Schedule.
  4. Save Subscription.


Change Recurring Totals

Change a subscription’s recurring amount manually:

  1. Go to WooCommerce >Webtoffee Subscriptions.
  2. Click the Subscription ID which redirects you to the Edit Subscription screen.
  3. If you want to change an existing product, shipping, tax or fee line’s total:
    • Select the pencil icon next to the line item you want to change
    • Change the amount
    • Save
  4. Recalculate the total amount by clicking on it.
  5. Update Subscription.


Subscription Status

By default, all actively running subscriptions are in Active status. The customers will be entitled to the benefits only when the subscription is in active status. However, the admin can choose to manually update the status of the subscriptions if there is a need as an exception(manual transaction, failed payment, dispute, etc.)

To change a subscription’s status:

    1. Click the Subscription Status select box in the Subscription details meta box.
    2. Click the status you want to give the subscription.


  • Was this article helpful?
  • YesNo