Overview

Use the Product object to create/add, update/edit and retrieve subscription plans/products for your account. You can control:

• Product information
• Pricing
• Subscription plan settings and renewal configuration
• Subscription plan recurring billing
• Fulfillment
• Shipping classes
• Localization

Overview

Use the object below to create, update and retrieve customers in 2Checkout.

Input parameters

Overview

Use the URL Affiliate Checker to keep track of sales generated by members of the 2Checkout Affiliate Network for services/products that you sell using a third-party e-commerce platform.​​​​​​

• 3rd party e-commerce provider -> URL affiliate checker -> detects 2Checkout cookie -> 2Checkout buy links
• 3rd party e-commerce provider -> URL affiliate checker -> does not detect 2Checkout cookie -> third-party buy-link

Requirements

In order to use URL Affiliate Checker, the following requirements must be met:

• The 2Checkout Affiliate Network is enabled for your account.
• Products sold through a third-party platform and available to 2Checkout Affiliates must be configured within the 2Checkout platform as well, and need to be assigned to commissions lists associated with 2Checkout Affiliates. Make sure to specify a commission you're willing to pay for affiliate referrals.

How does the URL Affiliate Checker work?

The URL Affiliate Checker enables you to redirect shoppers to 2Checkout ordering pages when they're referred by a 2Checkout Affiliate. The 2Checkout system tracks sales referred by affiliates and ensures that they get rewarded correctly and receive commissions for sales generated.

Installing the URL Affiliate Checker

To install the URL Affiliate Checker replace the Buy-buttons links (the buy-links placed on your call to actions) with the Affiliate Checker links generated using the Control Panel. Essentially, you need to replace the links on the buy-buttons that point to the third-party shopping cart. The 2Checkout system checks if shoppers come from a 2Checkout affiliate:

• If shoppers are referred by a 2Checkout affiliate (a cookie is detected) they're redirected to the 2Checkout ordering link (2Checkout shopping cart);
• If the Affiliate cookie is not present, the visitor will be redirected to a page of your choice.

URL Affiliate Checker link generator

Follow these steps to generate the affiliate checker link:

1. Generate a buy-link for your products using the 2Checkout Control Panel.
2. Enter the link generated into the Regular 2Checkout buy-link field.

3. Specify the URL where shoppers will be redirected in case that no 2Checkout affiliate cookie is detected.

4. Click the Generate link button and copy and paste this code replacing your regular buy links.

5. Shoppers clicking on the URL Affiliate Checker buy-links will be redirected to the 2Checkout shopping cart, if a 2Checkout affiliate ID is detected, or to the third-party shopping cart that you use.

6. Orders placed by shoppers which used the buy-links from 2Checkout affiliates will immediately be visible in the Order search area of the Control Panel.

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.

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.