Availability

3dcart integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts). 

3dcart Settings:

Perform the below set of instructions in your 3dcart account to integrate it with 2Checkout.

1. Sign in to your 3dcart admin
2. Click Payment Methods
3. Check Active
4. Enter your Store ID (2Checkout Account Number)
5. Click Save

2Checkout Settings:

Follow the below instructions in your 2Checkout Control Panel to finalize the 3dcart integration process.

1. Sign in to your 2Checkout account.
2. Navigate to Dashboard → Integrations → Webhooks & API section
3. Follow these steps to activate Redirect URL:

• In the Redirect URL section check “Enable return after sale”
• For Return method, select Link in the Thank You Page or Direct return
• Set the Approved URL to https://yourdomain.3dcartstores.com/...ive.asp?gw=2co (where yourdomain is your domain name)

4. Click Update to save your settings. 

 ​​​

About 3dcart

Fast, reliable, and most of all EASY TO USE, 3dcart will get your business online in just a few minutes! We provide the software, the hardware, and the support!

For more information, visit: 3dcart.com

This is a summary of the objects/classes and methods available.

Overview

The 2Pay.js Javascript library is a quick and secure way to collect sensitive credit card payments, using customizable UI components that give merchants full control over the checkout experience. It allows merchants to create seamless payment flows while keeping the need for PCI compliance to a minimum SAQ A level. This means that shoppers pass sensitive payment information directly to the 2Checkout platform without sharing their credit card details with the merchant.

Availability

The 2Pay.js payments solution is available for all 2Checkout merchants who already use or want to use the 2Checkout API integration, no matter what business model they have. 

Requirements

To benefit from the 2Pay.js solution, merchants need to be integrated with the 2Checkout API and use the latest version - API 6.0. 

Merchants with <20,000 transactions/year are recommended to have an SAQ-A filled in, but merchants >20,000 transactions are required to do so.

Benefits

The 2Pay.js solution brings multiple benefits for both merchants and shoppers:

• Improved payment processing with a more secure and compliant system
• Full-cart ownership for merchants as they don't need to handle customer data, by tokenizing the payment information for them
• Reduced complexity for the PCI DSS validation process via an SAQ-A self-questionnaire​
• Improved security for shoppers, who will pass sensitive payment data directly to the 2Checkout platform, thus bypassing the merchant's systems.

Activation

2Pay.js can be implemented by merchants via a JavaScript library that allows them to include the payment fields at checkout without the need to handle shoppers' credit card data in any way, as shown by the steps below:

• Merchants include a few lines of code in the interface where they need to collect payment information.​
• Merchants will run a JS library that will replace the input fields with iframes
• The iframes will collect and send shoppers' card data directly to the 2Checkout​ platform

How it works

Triggering an order with 2Pay.js will work like any other order placed via API​: the JavaScript library will pass the credit card data to the 2Checkout system and it will return a payment token​. The API order is placed using the payment token​.

1. The merchant runs a JavaScript library that will change the billing form by replacing the input fields with iframes. This way the data is sent directly to the 2Checkout system.​
2. In return, the merchant receives a token for the saved credit card information from the 2Checkout platform.​ The token is valid for 10 minutes. 
3. The merchant submits the billing information and the payment token via the 2Checkout API.​
4. The 2Checkout platform matches the token with the card data, extracts the card data and authorizes the payment, and stores the card in the vault. ​
5. The merchant then redirects the customer to the Order Confirmation page​.
6. Once the order is approved, the merchant receives a notification from the 2Checkout platform.
7. Finally, the 2Checkout system sends a notification once the payment is settled.​

Use cases

See here some use cases for the 2Pay.js implementation.

FAQ

1. What payment methods are available for use with the 2Pay.js library?

All API version 6 accepted credit cards can be used with the 2Pay.js library.

2. What integrations does 2Pay.js support?

2Pay.js was developed for integration within web sites so that it allows full seamless integration with the merchants' checkout flow.

3. Does 2Pay.js support 3D Secure version 2?

While 2Pay.js does not need 3D Secure support, the integration for this security check is done via API once the order is placed with the payment token. More information about the 3DS flow in the API can be found here.

4. How can I include the N/A value in the required API fields?

You can easily include the N/A value in the required API fields as shown below:

// For US:

"BillingDetails": {
    "Address1": "N/A",
    "City": "n/a",
    "CountryCode": "US",
    "Email": "customer@2Checkout.com",
    "FirstName": "Customer",
    "FiscalCode": null,
    "LastName": "2Checkout",
    "Phone": "N/A",
    "State": "NY",
    "Zip": "10075"
  },


// For the rest of the world:

"BillingDetails": {
    "Address1": "N/A",
    "City": "n/a",
    "CountryCode": "RO",
    "Email": "customer@2Checkout.com",
    "FirstName": "Customer",
    "FiscalCode": null,
    "LastName": "2Checkout",
    "Phone": "N/A",
    "State": "N/a",
    "Zip": "N/A"
  },

Overview

WHMCS is an all-in-one Content Management System including client management, billing & support solution for online businesses and web hosts.​

Merchants can use the WHMCS connector to integrate with 2Checkout and process orders via ConvertPlus, InLine Checkout, and 2Pay.js, and provide an improved experience to their shoppers.​

Availability

The WHMCS integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts).

WHMCS Settings

Regardless of the fact that you are already using the WHMCS connector or you want to start using it to integrate with 2Checkout, you need to follow the steps below:

1. Download the 2Checkout payment module from GitHub by clicking on the Code button and then on Download ZIP.
   
2. Sign in to your WHMCS admin panel.
3. Navigate to Setup → Payments and click on Payment Gateways.
   
4. On the Payment Gateways page, click on the All Payment Gateways tab.
   
5. On the All Payment Gateways page, select 2Checkout's ConvertPlus, InLine Checkout, and API Gateway (2Pay.js).
   

6. Go to Manage Existing Gateways and configure each cart option by adding the required information from your 2Checkout Merchant Control Panel.
   

   • Tick the Show on Order Form box if you want this information to be displayed on the order.
   • Add the Merchant Code.
   • Add the Buy-Link Secret Word.
   • Add the Secret key.
   • Tick Test Mode if you wish to enable it. This allows you to place test orders using test payment methods, to check your integration with 2Checkout.
   • Tick the Skip 2CO Fraud Check box, if you want to mark invoices as paid without waiting for the 2Checkout fraud review.
   • Add Reasons for Refunds.
   • Click on Save Changes.

   The Merchant Code is your 2Checkout Merchant Code that you can obtain by logging in to your Merchant Control Panel and navigating to Integrations → Webhooks & API.  To find the Buy-Link Secret Word, log  in to your 2 Checkout Merchant Control Panel and navigate to Integrations → Webhooks & API → Secret Word . Edit your INS Secret Word to match the Buy-Link Secret Word , copy the value and paste it in the WHMCS admin panel. The Secret key can be found in your 2Checkout Merchant Control Panel, right next to the Merchant Code. Copy and paste it in your  WHMCS admin panel.

   
   

   Since WHMCS does not support special characters, but only letters (a-z) and digits, you can use a code generator to obtain a Secret Word that needs to be saved both in the 2Checkout Control Panel and the WHMCS admin.

2Checkout Settings

Follow the below instructions to finalize the WHMCS integration process.

1. Sign in to your 2Checkout Merchant Control Panel account.
2. Navigate to Dashboard → Integrations → Webhooks & API section.
   
3. Follow these steps to activate Redirect URL:
   
   • In the Redirect URL section check Enable return after sale.
   • For the return method, select Header Redirect (for both Standard and Inline checkout).
   • Set the Approved URL to http://www.yourdomain.com/whmcs/modu.../2checkout.php (replace http://yourdomain.com with the actual URL to your domain).
   • Save settings.
4. In the Webhooks and API section, under the Instant Notification Service (INS) card, check the Enable Global URL box.
   
5. Enter http://www.yourdomain.com/whmcs/modu.../2checkout.php as the global endpoint URL.
6. Click on Update to save your changes.
7. Make sure to enable the IPN webhook notification in your Merchant Control Panel.
   
   • Log in to the 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & API.
   • Scroll down to the Notifications section and select IPN or Email Text & IPN from the drop-down, and then click on the Configure IPN button.
   • On the IPN Settings page, click on Add IPN URL.
   • Input the IPN URL available in the configuration page in the WHMCS admin, select the SHA 2 / SHA 3 hash and click on Add IPN.
     
   • After adding the IPN URL, the URL should be displayed in the IPN URLs section in your Merchant Control Panel.
     
   • Enable all triggers and response tags.
     

About WHMCS

WHMCS is an all-in-one client management, billing & support solution for online businesses. Handling everything from signup to termination, WHMCS is a powerful business automation tool that puts you firmly in control.

For more information visit WHMCS.com.

Availability

Ecwid integration is available only for 2Checkout accounts that handle their own tax and invoice management (2Sell and 2Subscribe accounts). 

Ecwid settings:

1. Create a new 2Checkout account
2. Go to Ecwid Control Panel → Payment
3. Scroll down to Other ways to get paid
4. Click Choose Payment Processor to see the list of payment gateways available for your country
5. Select 2Checkout from the drop-down menu
6. You will see 2Checkout Account Details. Find and copy your Approved and INS URL and save it somewhere as you will need it later

2Checkout settings:

1. Go to your 2Checkout Merchant Account
2. Navigate to Dashboard → Integrations → Webhooks & API
3. In the Redirect URL section, set the Return Method to “Header redirect”
   • In the Approved URL field, paste the “Approved and INS URL” that you copied earlier from your Ecwid control panel
   • Click Update to save the changes
4. In the Instant Notification System (INS) section:
   • Select Enable INS and Enable global URL and paste the value of “Approved and INS URL” you saved earlier
   • Click Update to save the changes
5. In the Secret word section:
   • Make sure both the INS secret word and the Buy-link secret word are set to the same value and copy it
6. Return to the 2Checkout Account Details in your Ecwid control panel
7. Enter your 2Checkout account number (Merchant Code) and the INS secret word
8. Scroll to Appearance options and enable this payment method

About Ecwid

Ecwid is a cloud-based e-commerce platform that helps to easily create a bold, easy to use online store and start selling anywhere online or in-person. Ideal for small and medium sized businesses. Ecwid can be seamlessly integrated with your existing website, business page on a social network, your blog, marketplaces or mobile app. All the storefronts are synced and managed from one control panel. Ecwid lets you organize your products, customize your storefront, accept credit card payments, track and respond to orders — all with a few clicks of the mouse. Find out more about Ecwid here.

Overview

Disputes Balance is a financial mechanism designed to manage the funds of order transactions for which customers disputed the charges made using their credit / debit card or PayPal.

When shoppers initiate chargebacks, the equivalent of the disputed charges is debited from 2Checkout's bank account. Disputed charges are also reflected in the 2Checkout system and the funds paid by shoppers for disputed transactions are retained in the Disputes Balance. Once a chargeback resolution is reached, the disputed charges are released from the Disputes Balance.

How 2Checkout calculates Dispute Balance amounts

Disputes Balance amounts are calculated by deducting affiliate commissions and taxes from the total order amount (the costs incurred by shoppers). Disputes Balance amounts include 2Checkout processing fees.

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

Dispute balance process flow

1. Customers can dispute charges to their credit/debit cards or PayPal claiming reasons such as:
   
   • Order not fulfilled/not delivered
   • Product(s) not as described/unfunctional
   • Duplicate order
   • Fraud/Order not recognized: Customers claim that they don't recognize the charge
   • Agreed refund not processed
   • New/renewal order not recognized
   • Authorization problem
   • Information request
2. 2Checkout is informed by the shopper bank or by PayPal of the chargeback initiated and the dispute is also reflected into the system. The disputed amount is debited from 2Checkout's bank account.
3. 2Checkout retains the funds associated with disputed orders, adding the value to the Disputes Balance.
4. 2Checkout works with the shopper bank or PayPal to resolve the disputes in your favor until a resolution is reached.
5. There are two possible outcomes to this process:
   
   • You win the dispute, in which case the funds retained are released from the Disputes Balance and paid to you with the next due payment.
   • You lose the dispute , in which case the funds retained are also released from the Disputes Balance. Refunds are issued reflecting the money paid back to shoppers. As is the case with all refunds, the order processing commissions received by 2Checkout will not be returned to you.

Dashboard account balance information

The account balance report on the 2Checkout dashboard shows information on the Disputes Balance from the moment of the last payment you received from 2Checkout.

• Retained to Disputes Balance - the value of all disputed charges retained for chargebacks initiated in the report period starting from the last payment you received from 2Checkout.
• Released from Disputes Balance - the value of all disputed charges released for chargebacks closed in the report period starting from the last payment you received from 2Checkout.

Disputes Balance email

Disputes Balance data is reported using a standalone notification in addition to the 2Checkout Sales Report you receive each payment cycle. This email report details only the amounts retained and released from Disputes Balance.

The 2Checkout Sales Report also includes Disputes Balance information in addition to refund info.

Accounting Summary

This report centralizes payment data, including upcoming transfers.

• Balance represents an estimated value of the funds you're due to receive on the next payment.
• Overall Disputes Balance represents the total value of unresolved disputed charges for complete orders that 2Checkout retains until a chargeback resolution is reached (Released Disputes Charges are deducted from the Overall Disputes Balance). Released Disputes amounts for transactions in non-payment currencies are reported in your account's default payment currency.
• Retained to Disputes Balance - the value of all disputed charges retained for chargebacks initiated in the report period starting from the last payment you received from 2Checkout.
• Released from Disputes Balance - the value of all disputed charges released for chargebacks closed in the report period starting from the last payment you received from 2Checkout.

The report provides an overview of the most in-demand products in your portfolio, for specific periods of time. It uses exchange rates valid on the day you generate it and can aggregate orders from the following sales channels: direct, Affiliate Network, Network Cross-Sales and Distribution Partners.

The report gathers data from finished orders, not taking into account refunds.

Two sorting options are available: Total products and Total amount.

• Selecting Total products lists best-selling products, quantity-wise, while also displaying total per product information (the total amount generated by a single product through sales).
• The Total amount option lists top-selling products organized according to revenue generated through sales (total per product values), with the quantity of sold items not reflected in the hierarchy, even though displayed.

Selecting All currencies causes all order currencies to be converted to the default currency configured for the account. The 2Checkout exchange rate from the day when the Products Report is generated will be used.

Use the Order type option to filter product sales based on the order type:

• New acquisitions
• Renewals (manual and automatic subscription renewals)
• Upgrades
• Trials (trial orders for which customers provided their credit card information)

Exported CSV reports include the following information.

Overview

Shoppers place orders through 2Checkout by using an ordering/checkout interface. 2Checkout offers a collection of purchase flows/funnels, enabling you to control the complexity of the ordering process, from the first page in which customers land to the final stage of the purchase. Use specific query parameters to control the purchase flow in combination with Buy Links.

Availability

Available to all 2Checkout accounts.

Purchase Flows

https://secure.2checkout.com/order/checkout.php?CART=1

https://secure.2checkout.com/order/checkout.php?CART=1&CARD=2

https://secure.2checkout.com/order/checkout.php?CART=1&CARD=1

https://secure.2checkout.com/order/cart.php

https://secure.2checkout.com/order/checkout.php

https://secure.2checkout.com/order/product.php

https://secure.2checkout.com/order/download.php

https://secure.2checkout.com/order/trial.php

Overview

Perform easy account management via API Requests. The 2Checkout API portfolio contains extended capabilities that can help you automate processes as: creating products or promotions, placing orders (both with catalog and dynamic product information), issuing refunds, retrieving the shipping price for an order, handling subscriptions and many others.

Overview

2Checkout's lead management introduces a smart and easy way to reduce customer churn and gain useful insights into what drives customers to cancel automatic renewals. Use order recovery follow-up emails to reduce unfinished payment and cart abandonment rates with up to 20% by learning how to configure lead management campaigns. 

You can use lead management to:

• run a report on unfinished payments
• send abandoned shopping cart follow-up emails
• request invoices