Skip to main content

ConvertPlus renewal flow

ConvertPlus renewal flow

Last updated: 29-Feb-2024
Rate this article:

Overview

Enable your customers to order on-demand renewals for their subscriptions using custom Buy-Links on ConvertPlus ordering flow.

 

Recommended resources

Availability

ConvertPlus renewal flow is available only to 2Checkout merchants that have activated ConvertPlus in their accounts. Contact 2Checkout for activation.

Requirements

Custom on-demand renewals buy links can be generated manually, and they work for active and past-due subscriptions (excluding trials and non-recurring/lifetime subscriptions). They can also be set from the Subscription page in Control Panel (Orders and customers à Subscriptions à Edit subscription details à Renew subscription).

Subscriptions can be renewed automatically ahead of their expiry deadline with 90 to 3000 days. The default platform renewal option is 370 days. Contact 2Checkout directly if you wish to customize this limitation.

Scenarios covered

  1. Renew Subscription A belonging to Product A (source product) keeping it under Product A (target product).
  2. Renew Subscription A belonging to Product A (source product) and moving/upgrading the customer to Product B (target product).

Workflow

Use this feature to enable your customers to renew their active and past-due subscriptions on demand, bypassing the upcoming renewal operation scheduled in the 2Checkout system.

Custom on-demand subscription renewals are performed:

  1. From the moment when the items were scheduled to renew/expire. For example, let's assume that Subscription A (a monthly subscription), scheduled to expire June 30th, 2019, is renewed through the use of an on-demand link with a period of 10 days on June 22nd. Subscription A's lifetime will be prolonged with 10 days starting with June 30th, and the renewal/expiry deadline moved to July 10th. Moving forward, Subscription A will be renewed a month after the July 10threnewal, per its monthly renewal cycle.
  2. By overriding the subscription billing cycle settings. However, following the custom on-demand renewal, the subscription will be governed by the renewal settings and pricing configuration of the product it's associated with.

Create a custom renewal link

Use the following parameters to generate ConvertPlus renewal links.

Parameter Required Description

merchant

Required

Your merchant identification code. The merchant code is available in Settings à Edit system settings, under the System settings tab.

subscription

Required

Unique system-generated identifier of your subscriptions. The subscription reference is available on Orders and customers à Subscriptions à Edit subscription details.

prod Optional

Identifier of the product used in the renewal process. The product code is available on Setup à Products à  Column code in the product listing.

By default, the renewal process uses the product from the original order. Use a different product code to renew a subscription to a different target product.

Note: When included in renewal links, this parameter needs to be signed as well.

qty Optional The number of units (quantity) for the renewed product. 
opt Optional

Control the pricing option used in the renewal process.

  • 1 product with 1 price option with 1 value (includes scale option type)
    • prod=code1&opt=gr1:val1
  • 1 product with 1 price option with multiple values
    • prod=code1&opt=gr1:val1;val2
language Optional Control the language used in the renewal process. Available values for language codes are displayed in this article.
recurrence Optional The interval of time that will be added to the subscription lifetime starting with the current renewal/expiry deadline. For example 10:day

Examples

Renew the subscription with the same product and a specific pricing option

For this example, let's assume that we need a custom on-demand renewal link for Subscription A (monthly subscription expiring on June 30th, 2019 with the reference 9E0BAD7B5C) associated with Product A with the code product_a.

Use the following parameters to generate the renewal link:

  • merchant=2COTEST
  • subscription=9E0BAD7B5C
  • prod=product_a
  • opt=group_name:option_value

The resulting renewal link is:

https://secure.2checkout.com/checkout/renew/?merchant=2COTEST&subscription=9E0BAD7B5C&prod=product_a&opt=group_name:option_value

Renew a subscription with a different product

For this example, let's assume that we need a custom on-demand renewal link for Subscription A (monthly subscription expiring on June 30th, 2019 with the reference 9E0BAD7B5C) associated with Product A with the code product_a. In the renewal process, the customer will also be upgraded from Product A to Product B (code product_b).

Use the following parameters to generate the renewal link:

  • merchant=2COTEST
  • subscription=9E0BAD7B5C
  • prod=product_b

The resulting renewal link is:

https://secure.2checkout.com/checkout/renew/?merchant=2COTEST&subscription=9E0BAD7B5C&prod=product_b

Domain use

  1. secure.2checkout.com domain - If your account is using the 2Checkout's secure.2checkout.com domain, then this is what you need to include in your custom on-demand renewal links served to your customers, namely https://secure.2checkout.com/renewal/?.
  2. Custom domains such as store.YourDomain.com - If your account is using a custom domain such as store.YourDomain.com, then this is what you need to include in your custom on-demand renewal links served to your customers, namely https://store.YourDomain.com /renewal/?

Control the ordering experience 

You can control some aspects of the ordering experience for customers using early renewal links, by appending the following parameters to the buy link created.

Parameter Required/Optional Description
order-ext-ref Optional Use this parameter to set an external reference to the order.

src

Optional

Control the order source identifier.

You can track the source page by entering the following parameters: 

src=prodpage for the product page or src=dldpage for the link on the download page 

(dldpage and prodpage are example strings only, you can use any combination).

coupon

Optional

Promotion coupon code discounting the price of a product added to checkout. You can send multiple values separated by a semicolon when standalone coupons discount different products added to checkout. 

For example [...]&coupon=voucher1;voucher2[...]
style

Optional

Control the cart template used during the renewal process.

Each template defined in the Interface Templates area of the Control Panel has a unique identifier associated which is visible in the browser address bar when previewing the shopping cart.

Rate this article:

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo