Skip to main content
knowledgecenter.avangate.com

ConvertPlus URL parameters

Overview

To start selling with Avangate you need to redirect shoppers to Avangate`s hosted secure ConvertPlus checkout. 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.

Availability 

Eligible Avangate accounts. Contact Avangate to inquire about ConvertPlus. 

Requirements 

Configure at least one product to generate a ConvertPlus link. 

Query parameters 

 When you generate a checkout link, Avangate 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. 

PARAMETER

Required/Optional

DESCRIPTION

id

Required

Product IDs added to checkout, separated by a semicolon ;. Do not use spaces or blanks. Example: id=1234567;1234568. Avangate automatically assigns a unique, system-generated identifier to products you add or import into the platform. Product ID = 1234567.

In the Control Panel, click to edit a product, and select the Information tab. The Product ID of the item you're editing is available at the top of the General area under Information. Product IDs are different than Product Codes, also available in this area, but which you control.

 id works in conjunction with qty, based on their respective order.

qty

Required

The number of units (quantity) for each product in checkout, separated by semicolon ;. Do not  use spaces or blanks. Example: qty=2;1.

qty works in conjunction with id, 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 id parameter. 

coupon

Optional

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. 
For example: [...]&coupon=voucher1;voucher2[...]

currency

Optional

Preselected billing currency Avangate uses to charge your customers.

success-url

Optional

Avangate redirects your shoppers to a custom URL after they successfully place an order. When using success-url you bypass Avangate’s hosted ‘Thank You’ page for instant payment methods (this impacts any tracking set up in the page) but not for offline payment methods such as bank/wire transfer.

src

Optional

Use this parameter to identify the source of your sales (which links are performing better). You can assign standalone link identifiers 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).

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 Avangate test ordering system is available here.

Test cards

Card number

VISA

4111111111111111

MasterCard

5555555555554444

AMEX

378282246310005

Discover

6011111111111117

JCB

3566111111111113

 

Use case. To achieve the desired result use the corresponding cardholder names.

Cardholder name

  • Successful authorization for the initial transaction and all recurring charges. 

John Doe

  • Successful authorization for the initial transaction and manual renewal transactions but recurring charges fail to authorize with the Insufficient Funds error message.

Mike Doe

  • Successful authorization for the initial transaction and manual renewal transactions but recurring charges fail to authorize with the Stolen Card error message.

Jenny Doe

  • Insufficient funds

Mona Doe

  • Try again later

Mark Doe

  • Stolen card

Red Doe

  • Authentication failed

Joy Doe

  • Expired card

Angela Doe

  • Invalid card number

Adrian Doe

  • Invalid CVV

Jack Doe