For the complete documentation index, see llms.txt. This page is also available as Markdown.
Upgrade orders
Through upgrade orders, your shoppers can update their subscriptions by changing their product or by selecting a different quantity or pricing option for their existing product.
Availability
ConvertPlus upgrade orders are available only to 2Checkout merchants that have activated ConvertPlus in their accounts, for subscriptions that were initially purchased through ConvertPlus / Inline cart templates. Contact 2Checkout for activation.
Self service, by using the Upgrade button available next to their subscription in ther 2Checkout myAccount shopper support portal.
By using an upgrade link available in Control Panel on the subscription page or custom built by you and made available to the shopper (in an email campaign, inside your product, via direct email / chat, etc).
Upgrade link use cases
1
One upgrade option preselected in the link
The upgrade option is preselected in the buy link and the shopper lands on the Upgrade checkout.
The shopper will land either on the Upgrade checkout, if only one upgrade product is set up or on the Upgrade page, if more than 1 upgrade option is set up on the product associated with the initial subscriptionn.
Here is a list of relevant parameters that might be useful to add in the Upgrade order link, to the base Upgrade URL on ConvertPlus.
Base URL
https://secure.2checkout.com/checkout/upgrade?
Parameter
Required
Description
merchant
Required
Your merchant code to identify your account.
subscription
Required
Identifies the subscription that is being upgraded. Can be lifetime or recurring.
prod
Optional
Adds a product as an upgrade option to the link (needs to be set up as a valida upgrade option for the initial product).
Use separator %3B between 2 products e.g.
prod=PRODUCT_CODE1%3BPRODUCT_CODE2
opt
Optional
Preselects the specified pricing option group&option for the selected product. e.g. opt=gr1:val1. Works only with preselected product (1 product per link). See more on this parameter.
tpl
Optional
Checkout template code. Defaults to the template ID used in the previous order for the subscription.
qty
Optional
The quantity of the product offered as upgrade offer. Defaults to the minimum quantity set per product.
