Use 2Checkout ConvertPlus to provide your customers with a swift and safe payment experience. Depending on your desired workflow, you can either create ordering interface links using our dedicated interface (ConvertPlus) or generate the parameters dynamically, in your own system.
2Checkout enables you to use ConvertPlus with both catalog products, and with products generated dynamically via buy link parameters.
Eligible 2Checkout accounts. Contact 2Checkout to inquire about ConvertPlus.
To use ConvertPlus dynamic ordering, pass the dynamic parameter with TRUE or 1 value. When creating orders with catalog products, the prod parameter should contain the product code of your catalog item. For dynamic ordering, the prod parameter should contain the name of your dynamic product.
How to create dynamic ConvertPlus buy links
Start from the base ConvertPlus buy link:
Add your merchant code to the buy link, so that 2Checkout links the sale to your account. Your merchant code can be found in your Control Panel, in the Account Information area. Example: merchant=2COLRNC.
Set the dynamic parameter to TRUE or 1.
Add product information such as product type, name, price and quantity.
- Include additional product information, such as recurring options or customer redirect URL.
Sample ConvertPlus buy link for dynamic product information
The following buy link reproduces a dynamic ordering experience:
Buy link parameters
When you generate a checkout link, 2Checkout automatically includes some of the parameters in the list below in the URL, depending on a number of variables, such as the products, discounts, currency, and more. You can use these query parameters to generate checkout links in your own system, without having to rely on the functionality in you account.
Use these parameters to control the billing information displayed in the shopping cart. By adding these parameters in the buy link, you can pre-fill the customer information and minimize the customer effort in the ordering process.
|Optional||Send customer email.|
|name||Optional||Send full customer name. Ex: "John Steward Doe".|
|phone||Optional||Send customer phone number.|
|country||Optional||Send customer country code. Two-digits code. Ex: "UK".|
|state||Optional||Send customer state code. Two-digits code. Ex: "CA".|
|address||Optional||Send customer address.|
|address2||Optional||Send customer additional address information.|
|zip||Optional||Send customer zip code.|
Use these parameters to control the billing information displayed in the shopping cart. By adding this parameters in the buy link, you can pre-fill the customer information and minimize the customer effort in the ordering process.
|ship-name||Optional||Send customer delivery name. Ex: "John Steward Doe".|
|ship-country||Optional||Send customer delivery country code. Two-digits code. Ex: "UK".|
|ship-state||Optional||Send customer delivery state code. Two-digits code. Ex: "CA".|
|ship-address||Optional||Send customer delivery address.|
|ship-address2||Optional||Send customer additional delivery address information.|
|ship-zip||Optional||Send customer delivery zip code.|
Use the parameters to create products with dynamic information, skipping the need of handling a product catalog in your 2Checkout Control Panel.
|dynamic||Required for dynamic products||Boolean. Set TRUE for dynamic products.|
|prod||For catalog products||Product codes added to checkout, separated by a semicolon.
Do not use spaces or blanks. Example: prod=46CC15F39;7488E17CC0. Product codes are assigned by you at the moment you are adding new products.
In the Control Panel, click to edit a product, and select the Information tab. The Product code of the item you're editing is available at the top of the General area under Information.
Warning: Changing a product code already used in active buy links will completely break the checkout flow for those links. If you change a product code, make sure all your buy links for that product are replaced with new links generated with your current product code.
|prod||For dynamic products||
Set the dynamic parameter TRUE to use dynamic products in the ordering process.
When using dynamic products, the prod parameter contains as value the name of the dynamic product. For multiple products, send them separated by a semicolon.
|item-ext-ref||For dynamic products||Set product identifier for your dynamic products. When included, the parameter needs to be signed.|
|type||Required for dynamic products||
The type of the dynamic product. Possible values:
For multiple dynamic items, send the values separated by a semicolon.
The number of units (quantity) for each product in checkout, separated by a semicolon ;. Do not use spaces or blanks. Example: qty=2;1.
qty works in conjunction with prod, based on their respective order. The first value of the qty parameter controls the number of units for the products whose identifier is in the first position of the prod parameter.
|price||Required for dynamic products||
For dynamic products, enter the product price.
For multiple dynamic items, send the values separated by a semicolon.
|tangible||Required for dynamic products||
Send TRUE or 1 for products that require physical delivery.
|opt||Optional||Defines the product pricing options.
URL formating rules:
":" is considered a pair separator
"," is considered a value separator
";" is considered a parameter separator between products
|description||Optional for dynamic products||For dynamic products, set a description that is displayed in the checkout page. The description field is displayed only for the 'One column with payment buttons' template. The description will not be visible in the default template.|
|recurrence||Required for dynamic products||
For dynamic products, set product recurring options.
Send multiple dynamic items separated by a semicolon.
Possible values for units:
*This parameter is conditioned by two other parameters: duration and renewal-price.
|duration||Required for dynamic products||For dynamic products, set the duration of the recurrence.|
|renewal-price||Required for dynamic products||For dynamic products, set the price that should be applied to the renewal order.|
Use the parameters below to control the purchasing flow. You can add a success URL for your finalized orders, change the cart template, add a source parameter or choose to place test orders.
|merchant||Required||Your merchant identification code. The merchant code is available in Settings > Edit system settings, under the System settings tab.|
Required for the manual renewal of catalog products
Unique system-generated identifier of your subscriptions. The subscription reference is available on Orders and customers à Subscriptions à Edit subscription details.
|expiration||Optional||Buy link expiry date. The link becomes invalid after the date from this parameter. Send as a UTC timestamp. Example:
|return-url||Optional||URL to which customers are redirected after their finalized purchase. Learn more about Redirect URL on this article.|
The return method used for redirecting your customers after a successful sale. Possible values:
Promotion coupon code discounting the price of a product added to checkout. You can send multiple values separated by semicolon when standalone coupons discount different products added to checkout.
Use this parameter to identify the source of your sales (which links are performing better). 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.
Cart template used for the checkout experience.
Use the style parameter to send ConvertPlus cart themes customized via Cart Editor.
|currency||Optional||Preselected billing currency 2Checkout uses to charge your customers.|
|empty-cart||Optional||Boolean. Use for resetting cart contents.|
|order-ext-ref||Optional||Use this parameter to set an external reference to the order.|
Defines the language for the order interface. English is the default language.
Available values for language codes are displayed in this article.
|origin-url||Optional||Set an origin URL for the purchase.|
Use style for setting a customized cart template for the checkout experience.
The parameter can be populated with the styling code assigned to each of your customized ConvertPlus cart themes. Contact 2Checkout to learn how to retrieve the styling code for your customized themes.
|test||Optional||Use test=1 to place test orders. Exclude for regular order. Dummy credit card details are provided so you can test the entire order placing process. Guidance on the 2Checkout test ordering system is available here.|
|customer-ref||Optional||The 2Checkout system generates default customer numerical (integer) IDs automatically for all orders of products that feature subscriptions. Can be used for new acquisitions aggregating new subscriptions under an existing Customer account.|
|customer-ext-ref||Optional||The external customer reference.|
ConvertPlus parameters to be included in the signature
- General parameters included in the signature, regardless of the type of checkout (catalog products, dynamic products, renewal, unfinished payment): return-url, return-type, expiration, order-ext-ref, item-ext-ref, customer-ref, customer-ext-ref
- Parameters to be included in the signature for dynamic products buy-links: currency, prod, price, qty, tangible, type, opt, description, recurrence, duration, renewal-price
- Parameters to be included in the signature for manual renewal buy-links: prod, qty, opt