Configure upselling campaigns
Overview
Use 2Checkout's built in upselling capabilities to give your customers the chance to purchase superior offerings once they add specific products to cart. Extra options, feature-rich SKUs, newer product versions, enhanced support and other recommendations bring additional value to customers while boosting your revenue.
Note: Since upselling recommendations are traditionally more expensive than the products initially added to cart by the shoppers, make sure that the offerings come with incremental value justifying the extra cost.
Requirements
In order to configure an upselling campaign you need to have at least one product set in the 2Checkout Control Panel.
Basic upselling campaigns
You can create basic upselling campaigns for products that do not feature any pricing options.
- To set up an upselling campaign, once you defined at least one product, go to the Upselling area under Marketing tools and click Create new campaign.
- Select the Primary product. This is the offering that will trigger the campaign when shoppers add it to cart and start the purchase processes. Note: The upselling tool is available for the Shopping Cart page only.
- Select a Recommended product. This is the offering suggested to your shoppers by 2Checkout once the campaign triggers.
You can define specific start and end dates for your upselling campaigns. This feature ensures that you can schedule a campaign by configuring the interval of time during which it will be active. Leave the Start date and End date fields empty to have the upselling campaign apply indefinitely.
An active upselling campaign will only be triggered during the interval you configure. The campaign remains active even after the end date is reached, but it will no longer trigger.
To start a campaign immediately, leave the start date empty. If you don't set an end date, the campaign stops when you disable it.
Note: The upselling recommendation is triggered only once per browser session, for every product upsell combination defined (closing the browser window will reset the browser session). 2Checkout sets cookies once an upselling campaign triggers and the recommended product is displayed to a shopper. Adding the Primary product to cart a second time while the initial browser session is still active does not cause the campaign to be triggered again.
In addition to selecting the primary and recommended product, you can also define their respective quantities. If you want the campaign to trigger regardless of the primary product's quantity found in the cart, check the Any quantity checkbox.
IMPORTANT: If you specify a primary product quantity that is lower than the minimum quantity configured in that product's page, you will get a notification informing you about this issue. You can still save the campaign, but it only triggers if you modify the quantity accordingly.
To offer the same quantity of the recommended product as the primary product to the shopper, check the Match quantity checkbox in the Recommended quantity section.
Upselling campaigns with advanced pricing options
You can create upselling campaigns for products with pricing options. You can define pricing options under Pricing configuration when creating/editing products under the Pricing tab.
The necessary steps to set up an upselling campaign with advanced pricing options are the same as described above. However, in addition to defining product quantities, you need to configure the pricing options of both the Primary and the Recommended offerings.
Upselling discounts
Use the Discount field to reduce the price of recommended products part of the up-selling campaign.
The discount will impact the price per unit of recommended products. A $20 discount for a $100 product will become $40 if the quantity of products added to cart is increased to 2.
You can create 2 types of discounts: |
|
Percent |
A percentage from 0 to 100% of the price per unit of the recommended product is discounted. Note: Only integer values are supported, i.e. 10% and not 10.5%. |
Fixed |
A fixed amount is deducted from the price per unit of the recommended product added to cart. You need to select the default currency and configure its associated discount. Note: the value of the discount needs to be a positive number larger than 0, or the field can be left blank. |
Fixed discount values can be set:
- Individually, for each currency. In this scenario, shoppers will see the discount you configured in accordance with the currency used in the shopping cart Note: the display currency does not impact the discount. For example, if the promotion you created offers $10, 15EUR and £5 discounts, shoppers in the US and those selecting US dollars as the cart currency will get $10 off. Similarly, customers buying your products using Euro will get a 15 EUR discount, while those transacting in £ will get £5 discounts.
- Default promotional value. Upsell discount will be triggered regardless of the cart currency. The 2Checkout system will automatically convert the value of the promotion for all customers making payments in non-default currencies.
- For the default currency and a selection of other currencies. Shoppers will get either:
- Specific discount you configured if the cart currency is the same as the default discount currency;
- Value of the discount configured for the default currency converted to the non-default currency used in the cart.
Upselling description
Add text and HTML tags in the field under the Upselling description area for each up-selling campaign to have a custom message displayed to shoppers. Furthermore, you can customize the message in a number of languages, according to your account settings.
Upselling display type
In the Upselling area, scroll down to change the way your campaigns are displayed to customers.
Two options are available:
- Interstitial webpage - The recommended product is displayed in an interstitial window, the shopper has to add the offering to cart to continue the purchase process.
- Overlay window - The recommended product is displayed in a pop-up window, the shopper never leaves the shopping cart. When the recommended product is added to cart, the page in the background is refreshed to reflect the new selection.
Both options offer customers the chance to replace the initial product or stick with it and move on with the ordering process. As clearly visible in the screenshots above, the Replace Product call to action is more prominent compared to the alternative.
Upselling scenarios
1. Primary product without pricing options in Default pricing configuration - Recommended product without pricing options in Default pricing configuration
Up-selling campaign will always start. Note: the quantity (number of units) of the Primary product cannot be changed (will always be 1).
2. Primary product without pricing options in Default pricing configuration - Recommended product with pricing options in Default pricing configuration
Up-selling campaign will always start.
3. Primary product with pricing options in Default pricing configuration - Recommended product without pricing options in Default pricing configuration
For the Primary product, you can select a specific pricing option (only if it's defined for the Default pricing configuration created for the product).
The up-sell campaign will only start when shoppers add to cart the primary product with the specific pricing options you selected when defining the campaign.
4. Primary product with pricing options in Default pricing configuration - Recommended product with pricing options in Default pricing configuration
For the Primary product, you can select a specific pricing option (only if it's defined for the Default pricing configuration created for the product) - campaign will start only when the primary product with specific pricing option is added to cart.
Recommended products will be offered only with the specific pricing options you selected, although shoppers will be able to change it once they add the offering to cart.
How to test whether an upselling campaign works
Once you're done configuring the up-selling campaign, go to Generate links. Select the primary product of the up-selling campaign, and generate a buy link for this offering.
The guidance available in the Place a test order in the 2Checkout platform is valid for all products, regardless of whether they're part of an up-selling campaign or not.
Important: Always place test orders after refreshing the browser session (deleting cookies). Alternatively, use InPrivate Browsing in Internet Explorer 9 and above, Incognito mode in Google Chrome, and Private browsing in Firefox, ensuring that no cookies are set.
Scenario 1: Upselling campaign always start
Up-selling campaign will always start in the following two cases:
- Primary product without pricing options in Default pricing configuration - Recommended product without pricing options in Default pricing configuration
- Primary product without pricing options in Default pricing configuration - Recommended product with pricing options in Default pricing configuration
Step 1: Generate the buy link for the Primary product of your up-selling campaign.
Step 2: Instead of hitting the Place test order button, copy the buy link generated and add &DOTEST=1 to the end of the link, per the guidance available here: Place a test order in the 2Checkout platform.
Step 3: Open a new window in your browser using InPrivate Browsing in Internet Explorer 9 and above, Incognito mode in Google Chrome, and Private browsing in Firefox. Paste the link you tweaked by adding the &DOTEST=1 parameter.
Step 4: The upselling campaign will be triggered automatically. Select to replace the Primary product with the Recommended offering and continue through the steps of placing a test order as described here: Place a test order in the 2Checkout platform.
Scenario 2: Upselling campaign start for specific pricing options
Upselling campaigns will only start for specific pricing options in the following two cases:
- Primary product with pricing options in Default pricing configuration - Recommended product without pricing options in Default pricing configuration
- Primary product with pricing options in Default pricing configuration - Recommended product with pricing options in Default pricing configuration
- Go to Generate links and select the Primary product of your upselling campaign.
- In the Main Settings area, enter the specific pricing option unique code that will trigger the up-selling campaign in the Additional pricing options field. The unique code can be accessed by editing the primary product, selecting the Pricing tab, scrolling down to the Pricing options groups area, and clicking to edit the active pricing options group. Next you will need to edit the specific pricing option designed to trigger the campaign and copy the value inserted under the Unique code field. Once you copied this value, paste it in the Additional pricing options field.
- Generate the buy link for the Primary product of your upselling campaign.
- Copy the buy link and add &DOTEST=1 to the end of the link, per the guidance available here: Place a test order in the 2Checkout platform.
- Open a new window in your browser using InPrivate Browsing in Internet Explorer 9 and above, Incognito mode in Google Chrome, and Private browsing in Firefox. Paste the link you tweaked by adding the &DOTEST=1 parameter.
- The up-selling campaign will be triggered automatically. Select to replace the Primary product with the Recommended offering and continue through the steps of placing a test order as described here: Place a test order in the 2Checkout platform.
Upselling scenarios priority
If multiple campaigns are configured for the same products, the 2Checkout system triggers the campaigns based on specificity criteria, as follows:
- The system primarily triggers the up-selling campaigns that have both specific product quantity and specific pricing options configured.
- If the first case is not detected, the system triggers the campaigns that have a specified product quantity configured, regardless of the pricing options.
- If the first two cases are not detected, the system triggers the campaigns that have specific pricing options configured, regardless of the product quantity.
- Ultimately, the system triggers the campaigns with any pricing options and any product quantity.
To give you a better overview of the scenarios priority, refer to the diagram below.
Upselling campaigns and localization strategies (regional prices)
When configuring up-selling campaigns, you'll need to factor in localized pricing strategies for the primary and recommended products. There are four scenarios you need to consider, related to the type of up-selling campaigns available.
The upselling report
This is an entirely new report introduced in July 2012 to help you monitor the evolution and performance of the up-selling campaigns configured for your account. The Up-selling report centralizes up-selling campaign statistics recorded in the selected time period; however, data is only available starting with July 21st, 2012, when tracking began. The report includes finished orders only, without refunds, for products involved in up-selling campaigns.
FAQ
- Are cascading upselling campaigns possible?
- No. While you can set two upselling campaigns Product A to Product B and Product B to Product C, the system will not recommend products in cascade to shoppers. This means that if a customer adds Product A to cart and then replaces it with Product B, the 2Checkout system will not recommend Product C in this particular scenario even if a valid up-selling campaign is set.
- What happens when multiple Primary products are added to cart? Are all upselling campaigns started?
- Only the upselling campaign for the first product added to cart will be started.
- Why can't I change the quantity (number of units) for the Primary product of my up-selling campaign?
- The quantity (number of units) of the primary product can only be changed when the configuration of at least one of the products in the upselling campaign has a specific pricing option selected. Otherwise, the default value if 1 and the up-selling campaign will always start.
- If both an auto-apply promotion and an upselling campaign discount impact a product, which one will work?
- The upselling discount will take precedence over the auto-apply promotion when shoppers add the recommended product to cart.
- Can I use both cross-sell and upsell for the same product?
- Yes, however, shoppers will only be able to benefit from either the cross-sell or the upselling, not both.
- Can I set multiple upselling campaigns impacting the same product?
- No. A product can be used only for a single up-sell campaign.
- Can multiple upselling campaigns be triggered?
- No. Only a single upselling campaign per browser session.
Copy payment info
Overview
Copy card-on-file data available in the Avangate system from a source subscription to an imported target subscription. Avangate uses the existing payment information to charge customers as a part of the recurring billing (renewal) process.
Use the copyPaymentInfo method.
Requirements
The imported target subscription and the source subscription must belong to the same customer. The Avangate system checks to make sure that the Avangate Customer Reference (internal identifier) coincides for the customer accounts associated to the target and source subscriptions.
Availability
Please contact Avangate directly if you wish to take advantage of this feature.
How does this method work?
- Customer A purchases Subscription A using a VISA credit card and you import Subscription B for the same customer with no data or with an AMEX card.
- When Avangate renews Subscription A, it charges Customer A using the VISA, while using the AMEX (if the data was provided) for Subscription B charges.
- When you copy the payment data from Subscription A to Subscription B, the Avangate system uses the VISA credit card to renew both subscriptions according with their respective recurring billing cycles. Avangate charges customers during the recurring billing process for the imported target subscription using the payment method they used to purchase the source subscription.
Parameters
Parameters |
Type/Description |
---|---|
sessionID |
Required (string) |
|
Session identifier, the output of the Login method. Include sessionID into all your requests. Avangate throws an exception if the values are incorrect. The sessionID expires in 10 minutes. |
TargetSubscriptionReference |
Required (string) |
The Avangate Subscription Reference of the imported target subscription, to which Avangate copies the payment on file data associated with the source subscription. |
|
SubscriptionReference |
Required (string) |
|
The Avangate Subscription Reference of the source subscription whose attached payment on file data Avangate copies to the target subscription. |
Request
<?php
require ('PATH_TO_AUTH');
var_dump($sessionID);
$TargetSubscription = 'FFAE3C9429';
$SourceSubscription = '9F4154733C';
$jsonRpcRequest = array (
'method' => 'copyPaymentInfo',
'params' => array($sessionID, $TargetSubscription, $SourceSubscription),
'id' => $i++,
'jsonrpc' => '2.0');
var_dump (callRPC((Object)$jsonRpcRequest, $host, true));
?>
Response
Parameter | Type/Description |
---|---|
Boolean |
true or false depending on whether or not the operation succeeded. |
Usage management
Overview
The usage-based/on-demand/pay-as-you-go pricing model allows merchants to charge their customers on the consumption or overage of a billable service or resource, usually on top of a recurring flat rate.
Use the Usage object to manage (add, update, delete, retrieve, and import) usage via the 2Checkout API (JSON-RPC APIv6).
Parameters
Parameters | Type | Required/Optional | Description |
---|---|---|---|
UsageReference | Integer | Optional | The unique usage identifier. Example: 123459876. |
SubscriptionReference | String | Required | Unique code that represents a subscription. Example: 83FE4FEF2. |
OptionCode | String | Required | Unique 2Checkout option code. The pay-per-usage price options group for which the usage is uploaded. Example: metered pricing. |
UsageStart | Datetime | Required | The datetime when the usage started; can be the same as UsageEnd. Example: 2018-09-03 17:28:32. |
UsageEnd | Datetime | Required | The datetime when the usage ended and was recorded. Example: 2018-09-03 17:28:32. |
Units | Integer | Required | Number of units recorded. Example: 10. |
Description | String | Optional | It can be used to store a short merchant comment of the usage being uploaded. This can be anything, from the source of usage (mobile, web, etc.), to why changes occurred, etc. Example: Subscription usage for September. |
Retrieve an order
Overview
Use the getOrder method to retrieve details on a specific order placed with dynamic product information, or catalog products, using its unique, system generated reference.
Parameters
Parameters | Type/Description |
---|---|
sessionID |
Required (string) |
|
Session identifier, the output of the Login method. Include sessionID into all your requests. Avangate throws an exception if the values are incorrect. The sessionID expires in 10 minutes. |
orderReference |
Required (string) |
|
Order reference number of older order, which is already approved/paid. |
skipPartnerOrders | Optional (boolean) |
Default value = TRUE. Decides if the partner orders should be retrieved or not. By default, they are skipped and instead of returning the partner order according to the orderReference, it will return the master order. |
Response
Parameters | Type/Description |
---|---|
Object (orders with catalog products) |
|
Order information | Object (orders with dynamic product information) |
Request
<?php
require ('PATH_TO_AUTH');
$orderReference = 'YOUR_ORDER_REFERENCE';
$skipPartnerOrders = 'FALSE';
$jsonRpcRequest = array (
'method' => 'getOrder',
'params' => array($sessionID, $orderReference, $skipPartnerOrders),
'id' => $i++,
'jsonrpc' => '2.0'
);
var_dump (callRPC((Object)$jsonRpcRequest, $host, true));
Increase subscriber retention
Overview
As we are going through a crisis period, 2Checkout is dedicated to helping your business grow, and minimize the effects the global economic slowdown might have on the eCommerce environment. Check out our Voluntary Churn Prevention tools below, which can help you access new markets, retain your customers, and offer subscribers just what they need right now.
Offer subscribers alternatives to extend or cancel subscriptions. Be transparent!
Some of your subscribers will want to cancel their existing subscriptions for various reasons (to temporarily reduce costs or simply because they are not using your services at the moment). Winning back these customers will cost you time and money, so it is recommended you offer them some alternatives to canceling their subscriptions.
- Offer discounts during the churning process to entice price-sensitive subscribers to stay. Activate a churn prevention campaign, and make discounts attractive enough to secure a purchase.
- Offer subscribers the option to pause subscriptions instead and then have these automatically resume at a specific date without reacquisition costs, using the pause a subscription option from your Control Panel, or by using the pauseSubscription API method.
- Extend the subscription duration and ask subscribers to re-enable automatic renewal right after they cancel it, to minimize the chances of them churning. You can extend subscriptions by:
- using the Extend button on the "Subscription Details" page in the Merchant Control Panel
- via API using the extendSubscription method.
- Allow subscribers to downgrade to basic plans by using custom downgrade links.
Don’t wait until your subscribers cancel. Be proactive about it!
You shouldn’t wait until a customer cancels a subscription to address the situation. We’ve outlined several measures you can take to ensure support to your most loyal customers:
- Extend subscription expiration for upcoming renewals by a couple of months is advisable for annual subscriptions that are due to expire in the coming period. This is done by:
- using the Extend button on the "Subscription Details" page in the Merchant Control Panel
- via API using the extendSubscription method.
- Temporarily cut down renewal prices to reduce cost pressure for subscribers. You can do this by:
- clicking on the Current billing amount link on the "Subscription Details" page in the Merchant Control Panel
- setting up renewal discounts
- via API using the setCustomRenewalPrice method
- Upgrade customers for free so they make the best of your product during these times. To make it easy to revert after this period, you can create a temporary plan to upgrade to with the same price as your low-end plan and have a subscription set to upgrade to that, instead of your main upgrade plan.
- Upgrade individual subscriptions by:
- using the Upgrade button on the "Subscription Details" page in the Merchant Control Panel. Make sure to apply a 100% discount code so that your customers get the upgrade for free
- using custom upgrade links (not available in ConvertPlus)
- via API using the setSubscriptionUpgrade method
- Communicate the value of your product appropriately with your customers through email communications going out from the 2Checkout platform (renewal notifications and unfinished payment notifications for recurring charges) or through additional marketing automation sequences you have on winning back customers.
Don’t assume why subscribers are churning. Know it!
If your subscribers eventually do end up churning, it is important that you are able to distinguish which subscribers churned because of the pandemic and which churned because of other reasons. To help you make that distinction we added “Coronavirus” as a cancelation reason in our subscription cancelation feedback form, part of our churn prevention campaign capability. You can see what the reasons for churn are using the churn prevention feedback report, and act only on those subscriptions which you see fit.
For any additional information on how to use any of these features, reach out to our Merchant Support Team or your account manager.
Apple Pay
Overview
As of 2020, there were 230 million global Apple Pay users or 48% of active iPhones had activated Apple Pay, out of which international accounts for 85%, and the U.S. for 15%. The number of transactions exceeded 10 billion in 2019 and registered 70% of global card payment volumes.
Apple Pay is available in 20 countries spread across the globe and provides an easy and secure way to make payments via iOS apps, watchOS apps, and websites on Safari. Nonprofits can accept donations within their apps and websites with Apple Pay.
Availability
Apple Pay is available for MoR business model accounts using all or any of our ordering engines (hosted shopping cart, ConvertPlus, and InLine).
For PSP business model, Apple Pay is available for activation only if your contract country is the United States.
Benefits
- Seamless payment experience. Shoppers are finalizing orders with minimum effort, with only a few clicks.
- Cross-platform support. The checkout experience is consistent across many platforms and devices: computers, tablets, or smartphones.
- Enhanced security. Shoppers benefit from a frictionless checkout experience by using Face ID, Touch ID, or double-clicking Apple Watch, while the payment information is sent by Apple Pay in a tokenized form. Shoppers can quickly and securely provide their payment, shipping, and contact information to check out.
Requirements
Shoppers need to use a device that supports Apple Pay (check the full list of devices in the FAQ section below).
Apple Pay is available only for a selected list of countries.
To display the Apple Pay buy button in the cart include the "DESIGN_TYPE = 2" parameter in your buy links. See more information about the Express payments checkout flow here. This parameter does not apply to the ConvertPlus ordering engine.
Pricing
2Checkout does not apply any cost to orders paid via Apply Pay. Your incoming orders will be commissioned based on the credit card method used during the purchase (Visa/MasterCard).
Workflow
- When the shopper enters the cart, the Apple Pay button is displayed along with the other Payment options.
- The shopper clicks on the Buy with Apple Pay button on the checkout page.
- The Apple Pay payment sheet opens on top of the checkout page.
- The shopper selects one of the cards associated with their iCloud account and verifies the billing/shipping information.
- Simultaneously, a confirmation request will be sent to the registered mobile device iPhone, iPad, or iWatch.
- The shopper authorizes the payment by using Face ID, Touch ID, or double-clicking on the Apple Watch.
- Payment is confirmed and the order is finalized with the information retrieved from the shopper's iCloud account.
- The 2Checkout 'Thank You' page will be displayed once the purchase is successfully finalized.
FAQs
1. What devices are supported by Apple Pay?
Apple Pay is available on the following devices:
- iPhone & iPad: iPhone X, 8/8 Plus, iPhone 7/7 Plus, iPhone 6S/6S Plus, iPhone 6/6 Plus, iPad Air 2, iPad mini 3, iPad mini 4, iPad Pro with iOS 10 or later installed
- Mac: All the Macs with macOS Sierra or later installed but only available via an iPhone X, 8/8 Plus, iPhone 7/7 Plus, iPhone 6S/6S Plus, iPhone 6/6 Plus, iPhone SE, or an Apple Watch/Apple Watch Series 2 and only via Safari.
- Users with iPhone 5, 5C and 5S can use the service through an Apple Watch, activated with a passcode.
2. How can I find out if Apple Pay is available in my country?
Check here the list of countries where Apple Pay is available.
3. What card networks are available in Apple Pay?
Supported networks: Visa, Mastercard.
4. Does Apple Pay work on other devices (other than Apple devices)?
No. It works only with Apple devices with Safari web browser.
5. Will pop-up blockers prevent the Apple Pay window from being displayed?
No. As the popup is generated by the browser it will not be blocked.
6. Does Apple Pay support automatic renewal?
Yes, orders placed via Apple Pay can be automatically renewed, according to the subscription settings.
7. Can refunds or chargebacks be processed for orders placed via Apple Pay?
A: Yes, as Apple Pay is an express flow for orders placed through credit cards, automatic refunds can be issued, and customers can open disputes from their bank.
Partner product download
Overview
Manage download files for your products directly into Partner Control Panel.
Benefits
- Improve partner communication, educating them about the products within their assigned pricing lists.
- Automate and streamline access to your product files, making it easier for your partners to distribute them to end-users.
You can enable download links for partners either per product or per file.
Enable product files
Follow the steps below to provide access to a product file.
Method 1
- Go to Setup → Products.
- Click Edit on a specific product.
- Go to the Fulfillment tab. The option is only available for products for which you're delivering a file for download.
- Scroll down to the Product File area.
- Enable the Display to partners in their Partner Control Panel option.
Method 2
- Go to Setup → Fulfillment.
- Click the Product Files tab.
- Identify the file to share with your partners.
- Click Edit.
- Scroll down to the Available products for this file section.
- Check the box next to the Partners option.
- Click Update settings.
Once you have enabled this feature, your partners receive immediate access to product files. The Partner Control Panel is updated with direct links to product files (all of which are available for download). Direct links to your products are displayed in Dashboard → Resources → Products, under the Download file column.
Partners can take advantage of direct access to product download files to enhance the shopping experience for their buyers. Shoppers will be able to download the files directly from the servers partners/vendors choose for hosting.
Subscription
Overview
Retrieve information and manage subscriptions for your account. Subscriptions can be retrieved starting with 5 minutes after their orders are generated in the 2Checkout system.
Object parameters
Parameters | Type/Description | |||
---|---|---|---|---|
SubscriptionReference |
String |
|||
|
Unique, system-generated subscription identifier. |
|||
StartDate |
String |
|||
|
Subscription start date(YYYY-MM-DD) - StartDate is mandatory when importing subscription data. If you changed the time zone for the Avangate API by editing system settings under Account settings, then the StartDate you provide must be in accordance with your custom configuration. |
|||
ExpirationDate |
String |
|||
|
Subscription expiration date(YYYY-MM-DD) - ExpirationDate is mandatory when importing subscription data. If you changed the time zone for the Avangate API by editing system settings under Account settings, then the ExpirationDate you provide must be in accordance with your custom configuration. |
|||
RecurringEnabled |
Boolean |
|||
|
Possible values: TRUE – recurring billing/automatic subscription renewals enabled FALSE– recurring billing/automatic subscription renewals disabled |
|||
SubscriptionEnabled |
Boolean Possible values: TRUE –subscription enabled FALSE–subscription disabled |
|||
Product |
Required (object) |
|||
|
The product for which Avangate generated the subscription. Details below. |
|||
|
ProductCode |
String |
||
|
|
Unique product identifier that you control. |
||
|
ProductId |
Int |
||
|
|
Unique, system-generated product identifier. |
||
|
ProductName |
String |
||
|
|
Product name. |
||
|
ProductQuantity |
Int |
||
|
|
Ordered number of units. |
||
|
ProductVersion |
String |
||
|
|
Product version. |
||
|
PriceOptionCodes |
Array |
||
|
|
The product options codes the customer selected when acquiring the subscription. Pricing options codes are case sensitive. |
||
EndUser |
Object |
|||
|
The end user of the subscription. Details below. |
|||
|
Person |
Object |
||
|
|
FirstName |
String |
|
|
|
|
End user's first name |
|
|
|
LastName |
String |
|
|
|
|
End user's last name |
|
|
|
CountryCode |
String |
|
|
|
|
End user country code [ISO3166-1 Alpha 2]. |
|
|
|
State |
String |
|
|
|
|
End user state. |
|
|
|
City |
String |
|
|
|
|
End user city. |
|
|
|
Address1 |
String |
|
|
|
|
End user first address line. |
|
|
|
Address2 |
String |
|
|
|
|
End user second address line. |
|
|
|
Zip |
String |
|
|
|
|
End user zip code. |
|
|
|
|
String |
|
|
|
|
End user email address. |
|
|
|
Phone |
String |
|
|
|
|
End user phone number. |
|
|
|
Company |
String |
|
|
|
|
Company name. |
|
|
Fax |
String |
||
|
|
End user fax. |
||
|
Language |
String |
||
|
|
Language [ISO639-2] the Avangate system uses for communications. |
||
SKU |
String |
|||
|
Stock keeping unit you defined. |
|||
DeliveryInfo |
Object |
|||
|
The object contains information about the delivery/fulfillment made to the customer. |
|||
|
Description |
String |
||
|
|
Delivery description. |
||
|
Codes |
Array of objects |
||
|
|
Code |
String |
|
|
|
|
Activation key/license code of the first order from this subscription. Use getSubscriptionHistory method if you want to retrieve the activation keys/license codes for all orders belonging to a subscription. |
|
|
|
Description |
String |
|
|
|
|
Code description for dynamic lists from your key generator. |
|
|
|
ExtraInfo |
Object |
|
|
|
|
Info set by your key generator for dynamic lists only. |
|
|
|
|
CodeExtraInfo |
Object |
|
|
|
Type |
String |
|
|
|
Label |
String |
|
|
|
Value |
String |
|
|
File |
Array of objects |
|
|
|
|
Content |
String |
|
|
|
|
Content of the file (base64 encoded). |
|
|
|
ContentLength |
Int |
|
|
|
|
File size. |
|
|
|
Filename |
String |
|
|
|
|
The name of the delivered file. |
|
|
|
FileType |
String |
|
|
|
|
The type of the delivered file. |
ReceiveNotifications |
Boolean |
|||
|
1 – Subscribe: Avangate sends subscription notifications to the end user. 0 – Unsubscribe – Avangate does not send subscription notifications to the end user. |
|||
Lifetime |
Boolean |
|||
|
Possible values:
False – the subscription has a recurring billing cycle less than or equal to three years. |
|||
PartnerCode |
String |
|||
|
Partner Code |
|||
AvangateCustomerReference |
Int |
|||
|
Unique, system-generated customer identifier. |
|||
ExternalCustomerReference |
String |
|||
|
Customer identifier that you control. |
|||
TestSubscription |
Boolean |
|||
|
True for test subscriptions, false otherwise. |
|||
IsTrial |
Boolean |
|||
|
True for trial subscriptions, false otherwise. |
|||
MerchantCode | String | |||
Unique, system-generated ID in the Avangate system. |
Place new partner orders
Overview
When placing an order on behalf of your partners, you can purchase new products in addition to upgrades and subscription renewals.
Requirements
- It's mandatory to associate products to price lists. Do this by connecting a single or multiple pricing configurations of the items you sell through 2Checkout with a price list. You also have to assign price lists to the partners that you want to be able to access your offerings. Products that are not part of price lists assigned to partners will not be available for purchase.
- The new purchase option is only available for active subscriptions/licenses, and not for disabled products.
Place new partner orders
- Go to Orders & customers -> Place partner order.
- Select the partner for which you're placing the order, either by typing the name in the Select partner box, or by using the drop down menu available. Alternatively, provided that you already placed orders on behalf of your partners, a list of Last used partners will be available in this area, and clicking on a name will automatically select it.
- You'll now get the possibility to order a new license, a renewal or an upgrade.
- Select the desired price list under the New license area.
- On the next page, choose the product for your order from the drop down menu. You will now be able to customize your order using values such as quantity, and additional settings (if available). Once finished, click the Add to cart button.
- Click Add more products to be redirected to the Edit Order screen where you can select additional products from the same pricing list as the last added to chart.
- Click the Change link to add products from different pricing lists.
- Click Add to cart.
- When you place orders on behalf of your partners, their value will automatically be deducted from the amount of available credit you awarded them with, provided that you configured a Credit limit for partner accounts.
- View Shopping Cart - You can now introduce an External Reference No. / PO, remove some or all items in the cart, change quantity details, add more products, and even leave a comment for the order that your partners will be able to read, by editing orders that haven't been placed. The Comments field supports direct communication with your partner. Any comments added will become part of the order information once you hit the Place order button. If the partner posts a reply, then a new comment is added and will be available in this area. Additional comments can be introduced by editing orders once they have been placed. Make sure to also enter a value for the External Reference No. / PO, if you want your order to have one. The parameter you introduce in this field will be visible both to you and to the partner, and synchronized across both Control Panels.
- Add extra margin / discount: To edit the discount details of a partner order you need to select Order search in the left hand side pane of the Vendor Control Panel, click on Partner orders and filter existing items to show only those with the Pending approval status. You can always also just search for a partner order, if you have specific details on hand. Once you identified the order you'd like to refresh, click View and then Edit Order. Additional information is available here.
- Attach end user information - Please read Require end user information for partner (reseller) orders for guidance and Require end user information before placing the order for the steps detailing the process.
- Place Order - click on the Place Order button once all the details of your order are finalized.
- Order confirmation - orders placed by you on the behalf of your partners are approved automatically.
- Attach end user information - Please read Require end user information for partner (reseller) orders for guidance and Require end user information after placing the order for the steps detailing the process.
- Partners have to provide the necessary details to push the order to the delivery/fulfillment stage, but you can also provide the details if you have them.
- Alternatively, fulfillment be done exclusively to partners, leaving them to deal with their customers, and in this case, no additional info is required.
- When the system configuration is set to distribute products/keys to end users, customers are required to first register ahead of delivery/fulfillment.
- Attach reseller information - You'll need to provide reseller information for the order to move to the delivery/fulfillment stage, if the reseller information is required according to the Partner's commercial settings. Partners are required to enter the necessary information to push the order to the delivery/fulfillment stage, but you can also provide the details if you have them.
- You can view and search through the full list of your partner resellers by clicking the View partner resellers button at the bottom of the Partners page.
- Partner invoices - Partner invoices can be generated manually or automatically, depending on partner account settings. If the order is placed without any available credit, or your partners do not enjoy a credit limit, they will first need to pay the partner invoice and only then will the process advance to the delivery/fulfillment stage. To manually issue a partner invoice, navigate to Partner partner invoices under Orders & customers.
- Click on the item in the list of available orders on the left hand side of the page to add them to the partner invoice you're generating, and click Preview.
- Hit Save to create the partner partner invoice. On the next screen you'll have the option to notify your partner of the newly generated partner invoice or to cancel it if necessary.
- Delivery/fulfillment. When delivery/fulfillment is handled by 2Checkout, not required or has been confirmed by you, the system will give green light to deliveries immediately for order that are paid in full or placed within available credit. Fulfillment for partner orders guidance is available here.
- Cancelling an order: To cancel an order make your way to Partner orders under Order search and identify the item you'd like to call off. Click to view the order, and get access to the Cancel button on the next screen. Cancelling orders automatically disables all associated licenses.
FAQ
- Can I edit pricing details for placed orders?
Yes. If no partner was generated then you'll be able to add extra margin and to increase the discount. When the partner was already issued you'll need to first cancel it to edit the order's extra margin and discount.
- How is the upgrade price calculated?
The upgrade price is calculated according to the upgrade settings and then applied to the upgrade promotion on the resulted price.
- How is the price calculated when applying an extra promotion?
Applying an extra promotion to the final price of a product in the Channel Manager shopping cart will discount the price further.
- What happens when you add extra margin?
Adding extra margin means that a particular partner will benefit from an extra discount applied to an order. The extra margin can be cumulated with an extra discount.