Skip to main content
knowledgecenter.avangate.com

Subscription renewal links

Overview

You can build and control manual subscription renewal links to offer directly to your customers.

Requirements

Custom renewals links can be created for active and past due subscriptions (excluding trials and non-recurring/lifetime subscriptions).

Early renewals

In addition to standard manual renewal links, you can also create more complex early renewal links, controlling price, renewal and expiration deadlines as well as subscription lifecycles. 

Create the custom renewal link

To build custom renewal links you need the following two elements:

  1. The main renewal link: https://secure.avangate.com/renewal/?
  2. The unique subscription reference from the Avangate system: LICENSE=1A22223BC4.
The simplest renewal link you can build is https://secure.avangate.com/renewal/?LICENSE=1A22223BC4.

URL parameters for renewal links

The following table summarizes the additional URL parameters that you can insert into links to customize manual renewals.

Parameter Required/Optional Description

DESIGN_TYPE

Optional

Value = 1. When DESIGN_TYPE=1 is used in Buy Links the parameter changes the layout of the shopping cart template interface, positioning the payment methods selector in a more prominent position, above the billing details area.

LAYOUT_TYPE

Optional

LAYOUT_TYPE enables you to control which version of the shopping cart is served to shoppers. Possible values:

CLASSIC - the desktop variant of the shopping cart (using LAYOUT_TYPE=CLASSIC will always display the desktop version of the cart even to mobile device users);

MOBILE - Avangate mobile cart (using LAYOUT_TYPE=MOBILE will always display the mobile version of the shopping cart, even to users of desktop browsers).

REF

Optional

External order reference (string). You can add a string identifier to every Buy Link created (less than 100 characters), and that will be saved with the order, in addition to the system generated Avangate order reference. If there is a need for longer references, a md5 hash can be applied for any string value, resulting a 32 characters string. This hash that can be verified after the order notification, on the client side. External references are visible when accessing the order details page for your orders.

SRC

Optional

To identify the source of your sales (which links are performing better), a separate link identifier can be assigned to each link. For instance, if there are two buy links on your website, one in the product page and another one in the download page, 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 to be applied in the order. You can send multiple values separated by comma (in case you need several coupons to be applied in the same order). 
For example: [...]&COUPON=voucher1,voucher2[...]

CARD

Optional

Possible values:

1 - use this parameter with value 1 in order to display the credit card details form in the selected landing page. Shoppers will place orders from the Review page.

2 - when this value is used, it not only allows the credit card details form to be displayed in the selected landing page, but also enables shoppers to place orders immediately after entering their payment data, excluding the Review page.

ORDERSTYLE

Optional

Allows you to set the corresponding template, overriding the default template assigned to the product group. 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.

AUTO_PREFILL=1

Optional

Include AUTO_PREFILL=1 in buy links for shopping carts.

When the AUTO PREFILL feature is active and AUTO_PREFILL=1 used in buy links, the ZIP code and country pair become the only required aspects of the billing address.

Address, City and State details are calculated automatically by the Avangate system. The address can miss altogether.

Note: Using the AUTO_PREFILL=1 parameter without the feature being enabled for your account will result in shoppers following the classic purchase flow, where all billing address data is mandatory. 

Domain use

  • secure.avangate.com domain. If your account is using the Avangate's secure.avangate.com domain, then this is what you need to include in your custom on-demand renewal links served to your customers, namely 
https://secure.avangate.com/renewal/?
  • 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/?