Skip to main content
knowledgecenter.avangate.com

Upgrade links

Overview

Create upgrade links and offer them to your customers. 

Availability

All Avangate accounts. 

Requirements

Configure upgrades for your products/subscription plans.

Create the custom upgrade link

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

  1. The main upgrade link 
    https://secure.avangate.com/order/upgrade.php?
  2. The unique subscription identifier from the Avangate system: LICENSE=1234567.

The simplest upgrade link you can build is:

https://secure.avangate.com/order/upgrade.php?LICENSE=1234567

Query parameters

The following table summarizes the query parameters that you can insert into links to customize upgrades.

 

Parameter Required Description

LICENSE

Required

Use with upgrade links to trigger the upgrade of a specific subscription, such as in the following example: https://secure.avangate.com/order/up...ICENSE=1234567, where 1234567 represents the Avangate subscription reference.

LANG

Optional

Language - selected language for order processing interface and emails. By default, if the parameter is missing, Avangate serves cart content in English. 

CURRENCY

Optional

Preselect the billing currency to be used in the transaction.

SHOPURL

Optional

Custom URL used for "Back to shopping" link.

OPTIONS

Optional

Preselect pricing options for the subscription, using the pricing options codes (the IDs you set for each option individually).

For example: OPTIONS5211=5usr,2year.

UPGRADEPROD

Required only when you also use UPGRADEOPT. Optional otherwise.

ID of the arget product for the upgrade process. 

UPGRADEOPT

Required together with UPGRADEPROD. Optional otherwise.

Option code belonging to the target product of the upgrade process.

DESIGN_TYPE

Optional

Value = 1. Use DESIGN_TYPE=1 in Buy Links to change 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 Avangate serves to shoppers. Possible values:

CLASSIC - the desktop variant of the shopping cart (using LAYOUT_TYPE=CLASSIC - Avangate serves the desktop version of the cart even to mobile device users.

MOBILE - Avangate mobile cart 

LAYOUT_TYPE=MOBILE - Avangate serves the mobile version of the shopping cart, even to users of desktop browsers.

REF

Optional

External order reference (string). Add a string identifier to every Buy Link created (less than 100 characters). Avangate saves the string at order-level, in addition to the system generated order reference. If there is a need for longer references, use a md5 hash. To access external reference info navigate to the details page for your orders.

SRC

Optional

To identify the source of your sales (which links are performing better), assign a separate link identifier 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 examples.

COUPON

Optional

Promotion coupon code applied to the order. Send multiple values separated by when you need several coupons to discount the same order. 
For example: [...]&COUPON=voucher1,voucher2[...]

CARD

Optional

Possible values:

1 - use this parameter with value 1 to display the payment form in the selected landing page. Shoppers get to place orders from the Review page.

2 - enable Avangate to display payment form in the selected landing page, and 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.

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. 

 

Example

https://secure.avangate.com/order/upgrade.php?LICENSE=1234567&CURRENY=EUR

Upgrade a specific subscription

To trigger the upgrade of a specific subscription, include the LICENSE parameter in the upgrade link, where 1A22223BC4 represents the Avangate Subscription Reference.

https://secure.avangate.com/order/upgrade.php?LICENSE=1A22223BC4

Domain use

  1. secure.avangate.com. If your account is using the Avangate's secure.avangate.com domain, then your custom on-demand renewal links would look like this: https://secure.avangate.com/order/upgrade.php?
  2. Custom domains such as store.YourDomain.com. If your account is using a custom domain such as store.YourDomain.com, then your custom on-demand renewal links would look like this: https://store.YourDomain.com /order/upgrade.php?