Overview

Update subscription plan/product pricing using the Price Options Group and the Pricing Configuration objects. 

Price options group

Overview

By understanding local markets' culture, you can very easily meet the payment preferences of visitors to your website, increase shopper comfort, and thus boost your conversion rates.
Preferred online payment methods vary dramatically across regions and markets, and each locale is impacted by fragmentation issues and particularities. 

Learn how to enable local and international payment methods (video) to grow your conversion rate in markets around the world.  

Overview

Retrieve information and manage subscriptions for your account.

Attributes

Overview

Apply discounts to the total order value, including taxes. Offers configured with Order Promotions are designed to discount a fixed amount from the total value of all products added to the cart during the shopping process.

Order promotions are applied by default to the total order value before taxes. Reach out to 2Checkout Support if you need to apply the discount to the net order value.

Availability

Available for all 2Checkout accounts.

Example

2Checkout displays order promotions as an additional product added to the shopping cart, either automatically or after the shopper adds the coupon code.

Adding an order promotion

1. Log in to your Merchant Control Panel account.
2. Navigate to Marketing tools → Promotions → Order promotions.
3. Click on Add order promotion.
4. Give the promotion a suggestive title and description. Shoppers can see the promotion title during purchase.
   
   • Add localized promotion names for any of the supported languages. The 2Checkout shopping cart automatically displays localized promotion names based on the selected shopping cart language.
5. Select when you want the promotion to run. You can limit promotions to a specific time interval or let them run indefinitely. To start a promotion as soon as you mark it Active, leave the start date empty. If you don't set the end date, the promotion will stop when the maximum number of orders has been reached or will continue to run if the maximum number of orders is unlimited.
6. Choose the coupon/voucher type:
   
   • Single - one voucher to impact multiple orders;
   • Multiple - individual and unique, per-order vouchers.
7. Choose whether to restrict the promotion to a number of orders, or apply it for all orders. This option is only available for single coupons.
8. Fill in the promotion coupon/voucher code. The maximum length of a coupon code is 255 alphanumeric characters.
   
   • Single: enter the coupon values manually
   • Multiple: either add the values manually one coupon per line or use the coupon generator available in the Control Panel to generate 5, 10, 20, 30, 50, or 100 vouchers at a time and either append them to an existing list or replace existing items. The generator creates random vouchers that resemble this: D8C10E32. 2Checkout recommends limiting the number of coupon codes to a maximum of 25000.
9. Choose whether or not to apply discounts automatically. Only available for single coupons. This option applies discounts to all selected products in all orders, without the need for shoppers to enter the coupon manually.
10. Choose whether or not to publish the promotion to the 2Checkout Affiliate Network.
11. Activate the promotion.
12. Click Save.

Advanced options for order promotions

If you apply a fixed discount, you can choose to apply it on the gross cart value (default) or on the net cart value. 

This option is available only upon request. Please reach out to your Sales representative or 2Checkout Support to activate it.

The Web Services Definition Language (WSDL) service description is available at: https://api.avangate.com/soap/3.0/?wsdl.

Overview

Chargebacks are shopper requests for funds reversal made directly to the bank/PayPal, possible only if the payment was made using a credit/debit card or PayPal. As a rule of thumb, buyers contact their credit card bank/issuer or PayPal directly to initiate a chargeback.

2Checkout charges commissions for the initial transactions associated with orders refunded as a result of chargeback disputes initiated by shoppers.

Recommended resources

Credit/debit card chargebacks

The chargeback process for credit/debit card transactions is described below.

Chargebacks are triggered by shopper requests to their credit/debit card issuer to dispute charges appearing on their credit card statement. Only chargebacks for payments made using the following credit/debit cards are accepted:

• VISA/MasterCard
• American Express
• Discover
• JCB
• Carte Bleu
• Diners Club
• EloCard
• HiperCard
• UnionPay

Shoppers may issue chargebacks for multiple reasons, including but not limited to:

• Shoppers haven’t received the purchased items;
• Shoppers are unsatisfied with purchases and are unable to resolve the problem directly with you;
• Shoppers are charged multiple times for the same order;
• Shoppers claim that they received your agreement for a refund, but the refund was never processed;
• An unauthorized party made a purchase with the shoppers’ credit card details;
• Shoppers have concerns about the validity of the purchase (they don’t recognize the charge on the statement);
• Shoppers claim that they did not agree to subscription renewals.

Chargeback time limits

The chargeback time limit refers to the specific time window allowed for parties to respond to each phase of a chargeback dispute. Cardholders, banks, and merchants each need to keep to the deadlines imposed by the card networks or risk losing a claim.

Cardholders/Card issuers

In most cases, cardholders have up to 120 days from the transaction processing date to file a chargeback (the limits for cardholders can vary from one issuer to another and/or depending on the chargeback reason code).

2Checkout Merchants

Should provide us any information or documents available that they might have regarding the disputed order, within 3 working days from the chargeback notification, in PDF format – if they want to challenge the case.

Chargeback resolution

It might take between 90-120 days until a final resolution is received. The decision is based on a standard set of rules and regulations created by Visa/MasterCard and is then communicated to 2Checkout and the shopper.

Workflow

1. The issuer bank contacts 2Checkout’s bank with a request for the transaction details.
2. 2Checkout is informed by its bank/payment processor of the chargeback dispute, and the chargeback amount is debited from 2Checkout’s bank account.
3. 2Checkout responds to the open chargeback disputes by providing required documents to the bank.
4. You receive an IPN (instant payment notification) of the open chargeback dispute from 2Checkout.
5. 2Checkout restricts the disputed amount from being paid to you.

While chargebacks are handled directly by banks, 2Checkout still plays a role in resolving disputes. We are notified by the banking entities we’re working with of every chargeback, receiving information requests for each incident. The reason provided by the shopper to its issuer also reaches 2Checkout along with the request for transaction details.

6.  2Checkout provides the following standard details to the bank:
   • Payment method used by the shopper (PayPal account or first and last 4 digits of the card) to confirm the transaction.
   • Name, address, and email of the shopper to be verified by the bank and compared to the ones used to create the bank account.
   • Delivery details: subscription codes, attachments, or delivery confirmations.
   • Issued invoices
   • Terms and conditions, refund policy from your website showing that the shopper accepted the charge based on your public policies.
   • In case of a renewal transaction, the bank is also informed about the shopper’s agreement to the renewal made in the shopping cart.

2Checkout acts as a mediator between the bank, shopper and you, once a chargeback has been initiated. You will receive a request for additional details regarding the transaction to help us defend the dispute against the bank.

7. 2Checkout may request any shopper, transaction, or subscription-related documents from you, including, but not limited to:
   • Proof of delivery, in case it was made directly by you.
   • Support tickets received from the shoppers and answered by the support team, showing the customer issue resolution.
   • Any correspondence you had with the shoppers showing the validity of transactions, the fact that they placed the order and agreed to the delivery.
   • Proof that subscriptions delivered to shoppers are in use.
   • Correspondence with shoppers related to refund requests.
8. 2Checkout forwards all details received from you to the bank, adding further explanations if necessary. Based on the details received from 2Checkout and from the shopper, the bank and the credit/debit card issuer offer a resolution to the dispute. The decision is based on a standard set of rules and regulations created by Visa/MasterCard and is then communicated to 2Checkout and the shopper.
9. 2Checkout notifies you and the case is closed when a chargeback is won. 2Checkout pays the chargeback amount to you in full.
10. 2Checkout creates a reversal transaction when a chargeback is lost. You are notified about the lost cause and the debited amount.

In case of renewal transactions, a chargeback can be initiated for each individual payment.

Giropay transaction chargebacks

The chargeback process involving Giropay payments (direct transfer of funds between bank accounts) is similar to the one for credit/debit cards.

SEPA Direct Debit chargebacks

According to SEPA Direct Debit Core Scheme, the shopper has the possibility of raising a dispute without having to provide any justifications during the eight weeks following the direct debit transaction date. This is known as the right to a ‘no-questions-asked refund’.

If the transaction was unauthorized and the shopper can prove that, they can ask for a refund up to 13 months after the direct debit transaction date.

The Direct Debit chargebacks are not defendable according to the issuing banks and SEPA Direct Debit Core Scheme.

PayPal chargebacks

The PayPal chargeback process is similar to the one for credit/debit cards, with one important difference: both the shopper and 2Checkout directly negotiate the dispute with PayPal. PayPal chargebacks occur after shoppers contact PayPal to dispute charges made to their account.

PayPal chargebacks may be issued for a number of reasons, including but not limited to:

• Shoppers haven’t received the purchased items.
• Shoppers are unsatisfied with purchases and are unable to resolve the problem directly with you.
• Shoppers were charged multiple times for the same order.
• Shoppers claim that they received your agreement for a refund, but never received the refund.
• An unauthorized party made a purchase with the shoppers’ PayPal details.
• Shoppers have concerns about the validity of the purchase (they don’t recognize the charge on the statement).
• Shoppers claim they did not agree to subscription renewals.

Workflow

1. Shoppers contact PayPal requesting a chargeback.
2. PayPal contacts 2Checkout with a request for the transaction details. The reason provided by the shopper to PayPal is sent to 2Checkout along with the request for transaction details. Note: Based on how the funding source is set by shoppers in their PayPal accounts, they can dispute transactions directly to their bank instead of PayPal. In this case, PayPal acts as a mediator between 2Checkout and the shopper’s issuing bank.
3. PayPal informs 2Checkout about the open dispute, and the amount is debited from 2Checkout’s bank account.
4. 2Checkout responds to the open chargeback dispute contacting PayPal.
5. You receive an IPN (instant payment notification) of the chargeback dispute from 2Checkout.
6. 2Checkout blocks the disputed amount from being paid to you.
7.  2Checkout provides the following details to the bank:
   
   • Payment method information (PayPal account) to confirm the transaction.
   • Name, address, and e-mail of the shopper to be verified by PayPal and compared to the ones used to create the user account.
   • Delivery details: subscription keys, attachments.
   • Issued invoices.
   • Terms and conditions, refund policy from your website showing that the shopper accepted the charge based on your public policies.
   • In case of a renewal transaction, PayPal is also informed about the shopper’s agreement to the renewal made in the shopping cart.

2Checkout acts as a mediator between PayPal, the shopper and you, once a chargeback has been initiated. You will receive a request for additional details regarding the transaction to help us argue the case with PayPal.

1. 2Checkout may request any shopper, transaction, or subscription-related documents from you, including, but not limited to:
   • Proof of delivery, in case it was made directly by you.
   • Support tickets received from the shoppers and answered by the support team, showing the customer issue resolution.
   • Any correspondence you had with the shoppers showing the validity of transactions, the fact that they placed the order and agreed to the delivery.
   • Proof showing that subscriptions delivered to shoppers are in use.
   • Correspondence with shoppers related to refund requests.
2. 2Checkout forwards all details received from you to PayPal, adding further explanations if necessary. Based on the details received from 2Checkout and from the shopper, PayPal offers a resolution to the dispute. The decision is then communicated to 2Checkout and the shopper.
3. 2Checkout notifies you and the case is closed when a chargeback is won. The chargeback amount on which 2Checkout placed a hold when the chargeback was opened is paid to you in full.
4. 2Checkout creates a reversal transaction when a chargeback is lost. You are notified about the lost cause and the debited amount.

In case of renewal transactions, chargebacks can be initiated for each individual payment separately.

Overview

Use the API methods displayed below to create orders for physical products.

Search the shipping methods defined in your Control Panel, and extract information on how the shipping price is calculated.

Overview

Configure regular promotions to apply to products purchased by your partners.

Availability

You can configure all regular promotions to apply to Channel Manager transactions.

Adding a partner promotion

1. Go to Marketing tools -> Promotions -> Regular promotions.
2. Click Add regular promotion.
3. Give the promotion a suggestive title and description. Shoppers can see the promotion title during purchase.
4. Select when you want the promotion to run. You can limit promotions to a specific time interval or let them run indefinitely. To start a promotion as soon as you mark it Active, leave the start date empty. If you don't set the end date, the promotion will stop when the maximum number of orders has been reached or will continue to run if the maximum number of orders is unlimited.
5. Apply the promotion to Channel Manager.
6. Choose the coupon / voucher type:
   
   • Single - one voucher to impact multiple orders;
   • Multiple - individual and unique, per-order vouchers.
7. Choose whether to restrict the promotion to a number of orders, or apply it for all orders. This option is only available for single coupons.
8. Choose whether or not to limit the promotion based on the product quantity. Any product quantity above this limit will be sold at full price.
9. Fill in the promotion coupon/voucher code. The maximum length of a coupon code is 255 alphanumeric characters.
   
   • Single: enter the coupon values manually
   • Multiple: either add the values manually one coupon per line, or use the coupon generator available in the Control Panel to generate 5, 10, 20, 30, 50 or 100 vouchers at a time and either append them to an existing list or replace existing items. The generator creates random vouchers that resemble this: D8C10E32. 2Checkout recommends limiting the number of coupon codes to a maximum of 25000.
10. Select the discount type:
    
    • Percent
    • Fixed
11. Choose whether or not to apply discounts automatically. Only available for single coupons. This option applies discounts to all selected products in all orders, without the need for shoppers to enter the coupon manually.
12. Choose whether or not to publish the promotion to the 2Checkout Affiliate Network.
13. Activate the promotion.
14. Select the products to be included in the promotion.
15. Click Save.

What should I use, a single coupon or multiple vouchers?

It depends on the type of promotions you're offering partners.

• Single - a single coupon can be set up designed to let you and partners use it for as many orders as you wish. You can control the validity of the single coupons by specifying a maximum number of orders. You will need to define the coupon code manually.
• Multiple - unique coupons can be used with a one-time effect, each discounting a single order (i.e. they cannot be reused, as such you can no longer have them impact an unlimited number of orders). You can enter coupons manually, one item per line, or have the 2Checkout platform's coupon generator produce the codes for you. Coupons can be created in batches of 100 and appended to those already generated, or used to replace them entirely.

Maximum quantity per product

Define the maximum number of units per product (order line) to which the coupon will be applied.

For example, let's assume that you're offering a discount of $10 with Coupon 1 for Product 1 ($100) and you limited the maximum quantity per product to 5.

A partner purchasing 10 units of Product 1 will pay $90*5 + $100*5 = $950.

Can discounts be applied automatically to orders?

By selecting the Auto apply discount (instant discount) option, any discounts configured will be automatically applied to products when they're added to the shopping cart.

How do Channel Manager promotions (discount) codes/vouchers work?

Channel manager discount coupons can be used:

1. By you when placing orders on behalf of your partners;
2. By your partners during the ordering process.

Impact on price in relation to manual discounts, extra margin and partner margin

Discount coupons (promotions) for partners (Channel Manager) impact the total costs of the products involved in the ordering process.

For example, let's assume that Subscription 1 costs $100. A 10% Discount coupon (promotion) for Channel Manager will reduce the costs that partners have to pay to $90.

You can control the costs of partner orders even further, using a number of promotional and incentivizing mechanisms such as manual discounts, partner margin and extra margin. These contribute to reducing product/service prices progressively, in the following order:

1. Coupon / voucher discounts;
2. Manual discounts;
3. Partner margin;
4. Extra margin.

In the example above you can see how promotions and margins impact product / service costs. $$70.41 represents the final price that partners will pay for 2Checkout New Subscription after all discounts and margins were deducted.

Can multiple coupons be used for multiple products part of the same partner order?

There are a number of promotional scenarios that you should be aware of, especially when they'll involve orders with multiple coupons and products in the same shopping cart.

1. Regular promotions with multiple products each with its own coupon code will be applied in concert.

   Product 1	Coupon 1
   Product 2	Coupon 2
   Product 3	Coupon 3

   In this example, let's assume that you or your partner added Product 1, Product 2 and Product 3 to cart. Subsequently, Coupon 1, Coupon 2 and Coupon 3 are also added to using the coupon code one after the other. Since each coupon applies to a different product, all products in the cart will be discounted, by the specific promotion configured for them.

2. Regular promotions configured for the same product are not cumulative.
   

   Product 1	Coupon 1
   Product 1	Coupon 2

   However, if Coupon 1 and Coupon 2 govern discounts for the same product, adding them one after the other in the shopping cart will result in the 2Checkout system applying only the discount for the last promotional voucher provided, and disregarding all previous price cuts.

3. A single coupon for multiple products can coexist with other discounts as long as they apply to different offerings.
   

   Product 1	Coupon 1
   Product 2	Coupon 1, Coupon 3
   Product 3	Coupon 2, Coupon 3

   In the example above, when added to cart, Coupon 1 will apply to both Product 1 and Product 2, simultaneously. Coupon 2 can also be added, and it will impact only Product 3. However, if Coupon 3 is introduced after Coupon 1, it will replace the later for Product 2, the system keeping Coupon 1 only for Product 1.

4. Multi-product promotions can be limited to impact only a certain volume of units for specific products, and will apply per-order line, starting with the first item in the cart, until the maximum number of units is reached.
   

   Product 1: 1 user / 1 year	5 units	Coupon 1 (quantity limit 10 units)
   Product 1 with different pricing options: 3 users/3 years	15 units	Coupon 1 (quantity limit 10 units)
   Product 2	23 units	Coupon 1 (quantity limit 10 units)

   In the example above, Coupon 1 will discount all 5 units of Product 1: 1 user / 1 year. In addition, it also discount 5 units of Product 1 (that it will count as the same product as the one on the first order line) with different pricing options: 3 users/3 years, reaching the quantity limit of 10 units.

   At the same time, it will discount a full 10 units of Product 2, since it's another order line, and a different product.

Order search export

Partner discounts are displayed in the order search export CSV for each product they impact. The name of the promotion, as well as the impact (per unit) are included in the export.

Do partner discounts work for renewals and upgrades?

This functionality is not supported for the time being.

Before you start using the 2Checkout API, check your PCI DSS compliance status. Find out more details about what PCI compliance means and what you should do to be PCI compliant here. 

2Checkout offers a powerful collection of tools created to reduce your churn rate. Follow the path we set up for you to gain insight into our retention best practices, and start using the tools at your disposal.