Skip to main content

User activity reports

Overview

Track Control Panel user activity, including Customer Support Representatives (CSR). This feature provides comprehensive oversight over a collection of 2Checkout user actions, and can be leveraged to audit their activities.

Availability

All 2Checkout accounts.

Workflow

Access to user logs is governed by the Users activity privilege located in the Orders & Reports section of the Role area. Follow the steps below to enable this role.

  1. Go to Account settings -> Manage user access.
  2. Go to the Roles tab.
  3. Edit a specific role and check the Users activity option in Account settings.

Run the report

  1. Go to Reports center -> Users activity.
  2. Select the user you want to run the report for.
  3. Select the user activity you want to include in the report.
  4. Choose the report interval.
  5. Click Build report.

Tracking functionality

The 2Checkout system is designed to track the following user actions:

  • Login and log out attempts;
  • Accessed pages;
  • Place new order on behalf of the shopper;
  • Upgrade subscription on behalf of the shopper;
  • Change credit card information;
  • Cancel/Enable subscription;
  • Change subscription price;
  • Enable subscription;
  • Extend subscription lifetime;
  • Stop recurring billing for a subscription;
  • Enable automatic billing for a subscription;
  • Send shopper invoice;
  • Request order refund (only the amounts refunded to shoppers are displayed);
  • Email Editor events.

Export as CSV

Use the Export as CSV functionality at your disposal in order to generate a comma separated values file containing additional details on top of what's available in the cPanel report.

Data exported includes:

  • Date
  • User name
  • Activity
  • Subscription reference
  • Order reference
  • Price/Amount
  • Currency
  • Billing cycles
  • Comment

Date

User name

Activity

Subscription reference

Order reference

Price/Amount

Currency

Billing cycles

Comment

2014-06-10 11:46:01

John Doe

Cancel order refund

ABCD123

1234567

50

USD

1 Customer request

Is this report time zone aware?

Yes. The datetime stamps logged by the 2Checkout system reflect the time zone settings that you configured for your account.

Authorizations report

Overview

Use the Authorizations report to get an overview of the 2Checkout automatic recurring backend operations. Monitor payment authorization rates for new acquisitions, manual and automatic renewal of subscriptions, trial conversions, and for the 2Checkout revenue recovery tools. 

You can access the Authorization Report section from your Merchant Control Panel by navigating to Dashboard → Reports center → Authorization report.

Availability

The authorization report functionality is available on all 2Checkout accounts.

Pre-authorization process

2Checkout pre-authorizes credit/debit cards and PayPal accounts using minimum amounts such as $1.00 / 1.00 EUR to enable customers access to free trials and to fulfill free orders (with 100% discounts and those with 0 prices set using "on the fly pricing"). This is a common industry-wide practice for e-commerce companies. Pre-authorizations are designed to ensure that credit/debit cards and PayPal accounts (the credit/debit cards associated with PayPal accounts) are valid and that the necessary funds exist to charge customers for trial conversions and subscription renewals. In addition, pre-authorization also acts as an anti-fraud protection mechanism.

Authorization requests between the 2Checkout system and the payment gateway or PayPal used to validate your card information do not result in money being withdrawn from customer accounts.

Report settings

You can control the data included in the report by changing the different report settings and selecting specific filters, as shown in this image. 

authorization_report_overview.png

Order type Set-Up

This report selection has 3 filters and allows you to identify/search authorization attempts based on their source (where the order originated): 

  • The new acquisition filter refers to the acquisition of new subscriptions 
  • The manual renewals filter refers to the renewal of existing subscriptions for which your customers have chosen to personally perform the renewal 
  • The auto-renewals filter refers to the renewal of existing subscriptions which your customers chose to automatically renew via the 2Checkout automated billing system. This includes Trial subscriptions which were renewed as paid subscriptions.

The Order Type filter is only available as part of the 2Recover add-on. If this add-on is not enabled for your account, the default setting for the Order Type selection is “Auto-renewals”.

reports.png

Payment method Set-Up 

The payment method selection allows you to filter the data displayed in the report based on the payment method used for the authorization: PayPal or Credit cards such as Visa, Mastercard, American Express, etc.

In addition to filtering the data displayed in the report, this selection will also impact the layout of the Authorization overview section.

The report centralizes data only for subscriptions purchased using credit cards or PayPal.

auth_report_payment_method.png

Select Interval Set-Up

This setting allows you to select the time period you want to display in your report, as follows: 

  • For the new acquisition order type, data is filtered based on the date when the acquisition was made by your customer 
  • For the manual renewals order type, data is filtered based on the date the renewal was attempted by your customer, and as such will only show subscriptions where the renewal was attempted 
  • For the auto-renewals order type, using the “Report authorization data based on” option, you have the option to further refine the data based on: 
    • The date when the subscription has expired or 
    • The date when the renewal attempt was made (f the End date of the interval includes the current day, the report will show events that have already happened earlier in the day, and events that are scheduled to happen by the end of the day).  

Data displayed in the report is based on the Report time zone specified at the top of the report.  

authorization_report_time_interval.png

Product Set-Up

This selection allows you to filter the data displayed based on the product the subscriptions are for. For ease of use, you can perform the search by Product Name or Product Code, and you can also select one, several, or all products in your catalog.  

authorization_report_product.png

Include Hard Declines Set-Up 

Hard declines are authorization failures that can happen due to stolen or lost cards, invalid credit card data, or account closure. Due to the nature of these errors, further authorization attempts will not be retried.  

Enabling the Include hard declines checkbox allows you to include in your report data on authorization attempts that resulted in hard declines.  

authorization_report_hard_declines.png

Build the Authorization Report

To build the authorization report, follow these steps:

  1. Access the Authorization report section from your Merchant Control Panel by navigating to Dashboard → Reports center → Authorization report.
  2. Select the Order type based on the criteria described above.
  3. Select the Payment method.
  4. Optionally, you can also select these filters to increase the granularity of your report. However, they are not mandatory to build the report:
  • the time interval during which the renewal attempt was made.
  • the product the renewal attempt was made for.
  • check the Include hard declines option if you want the report to show you this type of authorization failure.

5. Click Build report.

To cancel generating the report, click Cancel report or close the Processing report window. 2Checkout does not generate the report in this case and you can choose a different set of filters.

To receive an email notification when the report is ready, click Email me when ready. The Processing report window closes and the system takes you to a page informing you that 2Checkout is generating the report. 2Checkout also sends you an email when the report is done.

If the report includes more than 10,000 subscriptions, the report loading time increases. In this case, you are prompted with an option to receive an email when the report is ready.

Report Layout

Authorizations overview

This section displays an overview of all authorization attempts performed that match the filtering criteria specified in the Report Settings section above. 

When the “Credit/Debit cards” payment method is selected in the Report Settings, this section will display one row with data aggregated across all card types, as well as one additional row for each card type, as shown in the image below: 

authorization_report_authorizations_overview.png

Field Description

Auto-renewals

Number of unique renewals (auto-recurring payment authorization attempts) per subscription billing cycle done or scheduled during the selected interval.

If for a subscription, the 2Checkout system makes an initial renewal attempt plus 3 subsequent retries, the auto-renewals count is 1.

When you select Today as the Auth attempt interval, the report shows data on subscriptions with authorization and retention events that:

· Happened earlier in the day when you generate the report.

· And those scheduled by day's end (in the selected time zone for the report).

2Checkout forecasts the scheduled events, so please keep in mind that the actual system-generated actions might differ from the expected events.

Auth attempts

Unique auto-recurring payment authorization attempts per subscription billing cycle in the selected interval.

This area also counts the total number of authorization retries per subscription billing cycle in the selected interval.

Successful renewals

Number of successful subscription renewals per billing cycle with auto-recurring payments authorized in the selected interval.

Authorization rate

Percentage of auto-recurring payments 2Checkout successfully authorized from the number of unique authorization attempts made.

Auto-recurring revenue

Total revenue generated from automatic recurring payments 2Checkout successfully authorized in the selected interval.

Use case

Considering the following subscriptions

Subscriptions

Billing cycle

Costs

Comments

Subscription 1

3 months

$300

First authorization attempt that falls outside of the selected auth attempt interval is not taken into consideration. However, the subsequent retry is.

Subscription 2

1 month

$75

This subscription fails to be authorized and renewed with a hard decline. There are no further attempts made by 2Checkout.

Subscription 3

1 month

$100

This subscription renews successfully on the first try every month.

Subscription 4

1 month

$50

Authorizations for this subscription fall in the same month.

...and the following attempts calendar,

this is what this section would display:

authorization_report_example view.png

Authorizations In-Depth View

This section displays an in-depth view of all automatic renewal authorization attempts performed that match the filtering criteria specified in the Report Settings section above.

authorization_report_extended overview.png

Account Updater Section

This section is only displayed when the Order Type is set to “Auto-renewals” and the “Payment Method” selection includes “Credit/Debit cards”.

The Account Updater service is an effective key customer retention tool designed to support seamless updates of credit/debit card account information. 

Field Description

Subscriptions with updated cards

Number of auto-renewing subscriptions per billing cycle with attached cards updated by Account Updater in the selected interval.

Successful renewals

Number of auto-renewing subscriptions with attached cards updated by Account Updater, for which recurring payments were authorized successfully per billing cycle in the selected interval.

Authorization rate

Percentage of subscriptions with updated cards authorized successfully, from the total number of subscriptions with attached cards updated by Account Updater, per billing cycle in the selected interval.

Revenue

Revenue generated by the automatic renewal of subscriptions using the cards updated via Account Updater in the selected interval and the percentage from the total auto-recurring revenue (under Authorizations overview) generated from automatic successfully authorized recurring payments.

Basic Retry Logic Section

This section is only displayed when the Order Type is set to “Auto-renewals”. 

Basic Retry Logic refers to the first 2 attempts 2Checkout makes to automatically renew subscriptions, which usually occur very close to the subscription billing cycle expiration date.

Field Description

Auto-renewal retries

Number of subscriptions with at least one authorization retry per billing cycle in the selected interval, corresponding to your account's Basic Retry Logic configuration, following an initial failed automatic recurring payment.

Also shown is the percentage of subscriptions 2Checkout auto-renews using Basic Retry Logic from the total number of Auto-renewals (under Authorizations overview).

Retry attempts

Unique automatic authorization retries using Basic Retry Logic per billing cycle for each subscription, following an initial failed automatic recurring payment and the total number of authorization retries in the selected interval.

Also shown is the percentage of authorization retries 2Checkout makes using Basic Retry Logic from the total number of Authorization attempts (under Authorizations overview).

Successful renewals

Number of subscriptions 2Checkout renews successfully using Basic Retry Logic per billing cycle in the selected interval.

Authorization rate

Percentage of successful renewals 2Checkout makes using Basic Retry Logic per billing cycle from the number of subscriptions for which the platform made unique automatic authorization retries.

Revenue

Automatic renewal orders revenue the 2Checkout system generates from your account'sBasic Retry Logic setup.

2Checkout Updater Section

This section is only available as part of the 2Recover add-on, and is only displayed when the Order Type is set to “Auto-renewals”. 

2Checkout Updater allows you to identify the expired cards and update them on file so that cards’ stale expiration dates don't lead to lost revenues or lost subscribers. 

Field Description

Subscriptions with updated cards

Number of auto-renewing subscriptions per billing cycle with attached cards 2Checkout updates using the 2Checkout Expiration Date Updater in the selected interval.

Successful renewals

Number of auto-renewing subscriptions with attached cards 2Checkout updates using the 2Checkout Expiration Date Updater, with recurring payments authorized successfully per billing cycle in the selected interval.

Authorization rate

Percentage of subscriptions with updated cards 2Checkout authorized successfully, from the total number of subscriptions with attached cards updated using the 2Checkout Expiration Date Updater, per billing cycle in the selected interval.

Revenue

Revenue generated by automatic renewal of subscriptions using the cards updated via the 2Checkout Expiration Date Updater in the selected interval and the percentage from the total auto-recurring revenue (under Authorizations overview) generated from automatic successfully authorized recurring payments.

Advanced retry logic Section

This section is only available as part of the 2Recover add-on, and is only displayed when the Order Type is set to “Auto-renewals”. 

Advanced retry logic refers to the multiple renewing attempts 2Checkout makes beyond those of Basic Retry Logic to maximize authorization rates.

Field Description

Auto-renewal retries

Number of subscriptions with at least one authorization retry per billing cycle in the selected interval, corresponding to your account's Advanced retry logic configuration, following an initial failed automatic recurring payment.

Also shown is the percentage of subscriptions 2Checkout auto-renews using Advanced retry logic from the total number of Auto-renewals (under Authorizations overview).

Retry attempts

Unique automatic authorization retries using Advanced retry logic per billing cycle for each subscription, following an initial failed automatic recurring payment and the total number of authorization retries in the selected interval.

Also shown is the percentage of authorization retries 2Checkout makes using Advanced retry logic from the total number of Authorization attempts (under Authorizations overview).

Successful renewals

Number of subscriptions 2Checkout renews successfully using Advanced retry logic per billing cycle in the selected interval.

Authorization rate

Percentage of successful renewals 2Checkout makes using Advanced retry logic per billing cycle from the number of subscriptions for which the platform made unique automatic authorization retries.

Revenue

Automatic renewal orders revenue the 2Checkout system generates from your account's Advanced retry logic setup.

Dunning management Section

This section is only available as part of the 2Recover add-on, and is only displayed when the Order Type is set to “Auto-renewals”. 

Hard declines are authorization failures that can occur because of stolen or lost cards, invalid credit card data, or account closure. Due to the nature of these errors, further authorization attempts will not be retried.  

However, to maximize the likelihood of a subscription being renewed, 2Checkout allows instant notifications of hard declines to be sent out to your customers, including an easy way for them to update their payment method and renew the subscription.

Field Description

Hard declines

Number of subscriptions with hard decline authorization failures. The 2Checkout system sends out a dunning management email for each such subscription.

Updated card attempts

Number of credit card update attempts customers make per subscription by logging into their myAcccount as a result of a dunning email.

Successful renewals

Number of subscriptions successfully renewed using credit cards customers updated using their myAccount.

Authorization rate

Percentage of successful renewals using updated credit cards per billing cycle from the number of card update attempts made.

Revenue

Renewal order revenue the 2Checkout system generates using credit cards customers updated in their myAccount.

Authorization Insights

This report lists recurring payment authorization rates for the automatic renewal of subscriptions, trial conversions and custom retry logic attempts in the selected interval. The report lists 1,000 search results, and the CSV file includes 100,000 items/export. 

Each authorization attempt made for a subscription will be displayed on its own report row. For example, if the 2Checkout system makes four authorization attempts for a subscription, each would be included as a standalone line in the report. Another example involves two subscriptions renewed through a single order (one authorization event), in which case the report would display a line for each item. 

authorization_report_insights.png

FAQs

1. How can I see future scheduled authorization events?

When you include Today as the Auth attempt interval, the report shows data on subscriptions with authorization and retention events that:

  • Happened earlier in the day when you generate the report.
  • And those scheduled events by day's end (in the selected time zone for the report). Selecting Today as the Auth attempt interval triggers the report to display the data including authorizations scheduled until 11:59 PM in the time zone you choose.

2. What happens when I select a specific product or a group of products?

2Checkout displays only data for subscriptions generated for that/those product(s) with authorization and retention events in the selected Auth attempt interval.

3. What are hard declines?

Hard charge declines happen when the customer's bank, financial institution, or card issuer declines a transaction initiated with a credit or debit card. Reasons vary, but can include:

  • Card activity limit exceeded
  • Incorrect card details, such as the card number, expiration date, or the CVV
  • Processing failures due to the system, technical or infrastructure issues

2Checkout manages hard declines in line with industry practices, as permanent authorization failures, that cannot be recovered, regardless of the retry strategy employed. In hard decline scenarios, 2Checkout recommends that customers be contacted through alternate retention channels and asked to provide alternative payment methods. Hard decline reasons include:

  • Stolen or lost cards
  • Invalid credit card data

4. What happens to subscriptions for which a card charge resulted in a hard decline?

The 2Checkout system no longer attempts authorizations for subscriptions for which the initial card charge results in a hard decline. Unless you target the customers with your own retention strategies, such subscriptions expire. Please note that you can export a CSV (comma-separated value) file with details on recurring payment authorization attempts for your company's subscriptions.

5. What are the best practices around authorization retries?

The best practices around retrying authorizations for card charge declines revolve around the type of decline:

  • Soft decline - card decline is a temporary issue, there's a high probability that a subsequent try would be successful.
  • Hard decline - decline is permanent and no amount of retries would change that. The best course of action is to reach out to customers and ask for alternative payment methods.

6. What are soft declines?

2Checkout retries all transactions with authorization failures accompanied by soft decline messages from payment processors, because there's a high probability that subsequent authorizations will be successful. 2Checkout recommends that you adapt the number of retries and retention strategies to your business and customer base, and can provide guidance on optimizing conversion rates. Soft decline reasons include:

  • Insufficient funds
  • Card activity limit exceeded
  • Processing failures due to the system, technical or infrastructure issues
  • Expired cards

7. What happens to subscriptions for which a card charge resulted in a soft decline?

2Checkout retries authorizations per your account's retention capabilities, which can include:

  • Basic Retry Logic - two renewal authorizations designed to recover expired subscriptions for which the renewal process has failed.
  • Advanced retry logic - multiple renewal authorizations beyond those of Basic Retry Logic.
  • Account Updater - a key customer retention tool designed to support seamless updates of credit/debit card account information.
  • 2Checkout updater - 2Checkout expiration date updater, a retention tool supporting authorization retries based on a custom card expiration date algorithm.

8. What is an "attempt"?

Attempt = the authorization attempt count for each subscription.

9. What does renewal mean?

Renewal = the first recurring payment authorization attempt made for a subscription in a billing cycle.

10. What is a retry?

Retry = any authorization attempt made for a subscription in a billing cycle after the initial Renewal try.

11. What exchange rate does 2Checkout use?

2Checkout uses currency exchange rates from the day when customers paid the orders and all aggregated amounts are estimated.

 

 

Default shopper emails

Overview

Access details about the emails the 2Checkout platform sends to your shoppers.

 

Integrate AliDropship

Overview

AliDropship is a connector built over WooCommerce, that provides a payment module which integrates with our Inline Checkout ordering engine, and supports Credit Card and PayPal payments. The plugin can be used for WooCommerce-based websites as well.

Availability

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

AliDropship (WooCommerce) Settings

  1. Download the plugin from Wordpress and upload it to the /wp-content/plugins/ folder on your web-server.
  2. Or, in the admin interface of the Wordpress platform, navigate to the Plugins section and search for “YD Gateway 2Checkout for WooCommerce” and click Install Now.
  3. Activate the extension from the Plugins menu in the WordPress platform
  4. The option “2Checkout in popup with Credit Card/PayPal” will then be available in WooCommerce. To enable it, navigate to the Payments tab → Settings.
  5. Click Manage to start editing the 2Checkout payment method.
  6. Enter the payment method name and description.
  7. Activate the Demo mode to be able to place test orders.
  8. Copy the Merchant code and the Secret Word from your 2checkout Merchant Control Panel. To obtain the Secret Word, navigate to Dashboard → Integrations → Webhooks & API → Secret Word → INS Secret word. Your INS secret word should be the same as the buy-link secret word (can be found under Dashboard → Integrations → Webhooks & API, scroll down to the Secret Word area, under the INS Secret Word). Edit your INS secret word and buy-link secret word to match each other, then copy and paste them into your AliDropship admin. INS secret word.png
  9. Paste both the Merchant code and the Secret Word in the interface from where you are managing the “2Checkout in popup with Credit Card/PayPal” plugin. 

2Checkout Settings

  1. Go to the WooCommerce admin area and navigate to Payments tab → Settings. 
  2. Find the “2Checkout in popup with Credit Card/PayPal” plugin and click Manage.
  3. Find IPN URL field and copy its content.
  4. Sign in to your 2Checkout account.
  5. Navigate to Dashboard → Integrations → Webhooks & API and select the IPN settings tab.
  6. Click on Add IPN URL and paste the content copied from WooCommerce.
  7. Enable the Allow concurrent requests (faster notifications) checkbox.
  8. Close the pop-up by clicking Add IPN.
  9. For more information visit: AliDropship documentation.

About AliDropship Plugin

AliDropship plugin is the only WordPress solution for creating fully-fledged web stores ready to bring you high stable profit. The AliDropship plugin gives you everything you need to start your own successful dropshipping business right away. The tool offers a complete set of features that make it easy to start and run a successful dropshipping business. For more details, see the AliDropship website.

 

 

Webhooks

IPN (Instant Payment Notification)

By default, the 2Checkout system includes all test order data in Instant Payment Notifications along with data on 'real' orders. To differentiate between test orders and 'real' orders, and to manage purchases efficiently, you can include a IPN parameter in the notification received from 2Checkout's servers.

  1. Navigate to the IPN settings page.
  2. Scroll down to the Notifications Details area and check the checkbox for the TEST_ORDER option. (this option is unchecked by default).

Important! The new testing system has modified the behavior of the ORDERSTATUS parameter. 2Checkout continues to send ORDERSTATUS for test orders, however, it will contain the actual status of the order, with the exception of PROCESSING and TEST, which have been removed. If you were using ORDERSTATUS values to filter test orders, 2Checkout recommends that you change your settings immediately and filter test orders according to TEST_ORDER and not ORDERSTATUS.

Before (discontinued)

After (new system)

ORDERSTATUS parameter

New TEST_ORDER parameter

2 values were previously sent for test orders have been removed:

  • PROCESSING - Test order is waiting 2Checkout approval
  • TEST - Notification sent for Test orders

Possible values:

• 1 - for test orders

• 0 - for real orders

LCN (License Change Notification)

By default, the 2Checkout system includes all test subscription data in License Change Notifications along with data on 'real' subscriptions. To differentiate between test subscriptions and 'real' subscriptions, and to manage them efficiently, you can include a LCN parameter in the notification received from 2Checkout's servers.

  1. Navigate to the LCN settings page.
  2. Scroll down to the Notifications Details area and check the checkbox for the TEST option. (This option is unchecked by default)

TEST

Possible values:

  • 1 for test subscriptions
  • Missing for real orders.

2Checkout strongly recommends that you take the necessary measures to adapt your system to the way that the TEST parameter works in LCNs to filter test items from 'real' orders.

January 2019

 

           

Date

           

           

Feature/Patch

           

           

Type

           

           

Documentation

           

January 3, 2019 Merchants can now allow their shoppers to edit their Inline shopping cart, so they can easily modify quantities and pricing options.  Patch  
January 16, 2019 ConvertPlus now supports new customer ID parameters in the ordering flow, so that merchants can better track their customers’ orders. Feature  
January 25, 2019 Improved Underwriting Application page. Ensures an optimized underwriting process for new-sign up merchants, with impact over the Control Panel. Feature -
January 25, 2019 Dynamic product descriptions are now included in order notification emails so that merchants can easily reconcile the orders in their platforms with those in the 2CO environment. Feature -

Integrate WooCommerce

Overview

WooCommerce is a plugin that integrates easily with any website built on WordPress. The plugin helps merchants turn their websites into fully functional WordPress eCommerce platforms with just a few clicks.​

WooCommerce offers online retailers a suite of services including payments, marketing, shipping, and customer engagement tools to simplify the process of running an eStore for small and enterprise merchants. ​

Related links

Availability

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

WooCommerce Settings

Regardless if you are already using the WooCommerce connector or you want to start integrating with 2Checkout to receive payments, you need to follow the steps below:

  
Current module version is not compatible with WooCommerce 8.0 (High-Performance Order Storage). A new compatible version will soon be released.
  1. Download the 2Checkout payment module from GitHub by clicking on the Code button and then on Download ZIP.

    woocommerce_connector_1_github.png

  2. After downloading the .zip archive, open it and extract the folders twocheckout-convert-plus, twocheckout-inline, and twocheckout. Archive these folders separately as a .zip file.

  3. Log in to your WordPress admin, navigate to Plugins and click on Add new.

    woocommerce_connector_1.png

  4. On the Add plugins page, click on Upload plugin, then on Choose File and on Install Now.

    woocommerce_connector_2.png

  5. On the Plugins page, activate the modules for ConvertPlus, InLine cart, and 2Pay.js by checking the boxes and clicking on the Apply button.

    woocommerce_connector_3.png

  6. Go back to the Dashboard, scroll down to WooCommerce, and click on Settings.

    woocommerce_connector_4.png

  7. Under WooCommerce - Settings, click on the Payments tab.

    woocommerce_connector_5.png

  8. Enable all three modules and then click on Set up to configure each module.

    woocommerce_connector_6.png

  9. Configure each module by filling in all the fields:

    • Input a Title and Description for the module. These fields control how your users will see the module during checkout.
    • Input the Seller ID. Your Seller ID is the Merchant Code from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
      • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Copy the Merchant Code from the API section and paste it into the Seller ID field in WooCommerce.
    • Input the Secret Key. To copy the Secret Key from 2Checkout and paste it in the WooCommerce platform:
      • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Copy the Secret Key from the API section and paste it into the Secret Key field in WooCommerce.
    • Input the Secret Word. Your Secret Word is the Buy-Link Secret Word from the 2Checkout Merchant Control Panel. To copy this code from 2Checkout and paste it in the WooCommerce platform:
      • Log in to your 2Checkout Merchant Control Panel and navigate to Integrations → Webhooks & APIs. Go to the Secret Word section, edit the INS Secret Word to match the Buy-Link Secret Word, then copy the code and paste it into the Secret Word field in WooCommerce.
    • Fill in the IPN URL
    • Check the Debug Log option if you want to log 2Checkout events
    • Check the Demo order option if you want to be able to place test orders

    woocommerce_connector_8.png

  10. Click on Save changes.

    woocommerce_connector_7.png

  11. Test your integration by placing an order. If your setup is correct,

    • the ConvertPlus flow will look as below

    woocommerce_connector_test_9.png

    • the InLine checkout flow will look like this

    woocommerce_connector_test_10.png

    • the 2Pay.js flow will be displayed as shown below. You can customize the form by using the Custom style option.

    woocommerce_connector_9.png

    woocommerce_connector_test_11.png

2Checkout Settings

  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 Redirect URL section, set the Approved URL to your WooCommerce URL
    • For Return method, select Header Redirect
  4. Click Update to save your settings.
  5. 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 enable the IPN webhook

    set up IPN in merchant control panel_1.png

    • For the Payment notification type field, select IPN or Email Text & IPN, and then click on the Configure IPN button
    • On the IPN settings page, click on the Add IPN URL button and input the IPN URL available in the configuration page in WooCommerce

    woocommerce_connector_test_12.pngwoocommerce_connector_test_13.png

    • Enable all triggers and response tags

    set up IPN in merchant control panel_4.png

About WooCommerce

WooCommerce is the most popular WordPress eCommerce plugin. And it’s available for free. Packed full of features, perfectly integrated into your self-hosted WordPress website. For more information, visit: woothemes.com/woocommerce.

FAQ

1. Does the new connector use webhooks?​​

Yes, it uses IPN, so make sure you enable it from your Merchant Control Panel.

2. Do order statuses get updated on the WooCommerce side if any change occurs after place order?​​

Yes, both order and fraud statuses are synchronized, as well as refunds.​

3. Can I place refunds?​​

Yes. You can place refunds from the WooCommerce portal.​

4. Can I use this connector with a 2Monetize account?​​

No, the connector is built to cover only the 2Sell and 2Subscribe accounts.

Order tracking script

Overview

Add custom JavaScript code to the last stage of the ordering process (the Thank You page). This area can be used to add a monitoring script, such as Google Analytics, for advanced tracking of your sales, visitor, and customer conversion rates. Scripts supported are not limited to Google Analytics, and you can also include Google AdSense code.

Web Analytics platforms offer information on visitor traffic trends for your web properties. Using this tool, you can integrate your Google Analytics account with your shopping cart and extract relevant information such as behavior and transaction statistics.

Availability

Tracking scripts for the desktop version of the shopping cart are available to all 2Checkout accounts.

The tracking script is included in the Thank You page (finish.php) displayed to customers only after they successfully place an order:

  • Payment needs to be authorized successfully. This usually happens for online payment methods that are authorized instantaneously, such as credit/debit cards and PayPal.
  • Payment needs to go through without any problems or errors.

Set up tracking scripts

The tracking script is included in the Thank You page (finish.php) displayed to customers only after they successfully place an order:

  • Payment needs to be authorized successfully. This usually happens for online payment methods that are authorized instantaneously, such as credit/debit cards and PayPal.
  • Payment needs to go through without any problems or errors.

To set up tracking scripts, follow these steps: 

  1. Log in to your Merchant Control Panel.
  2. Go to Setup -> Ordering Options -> Analytics.
  3. Select the type of platform (cart) you want to include the tracking code on.
  4. You can use HTML formatting and tags and edit the code directly.
  5. Define tracking scripts for specific or for all languages available for your account. You will be able to track visitors and sales according to the cart language selected either automatically, by the 2Checkout system through its geo-location capabilities, or manually by the shoppers. If the tracking script isn't included for a certain language, you will not be able to track successful orders for customers using that language in the cart. Use the Apply for all languages option to set the same script for all languages available for your account.
  6. To change scripts, you need to edit each item in part. Selecting the Apply for all languages option will overwrite all existing scripts with the latest version you supply.
  7. Click Save tracking script to save a new script or any edits.

SSl Protocol

Use the SSL protocol when including external scripts (e.g. Google Analytics) or images:

A JS object called myOrder is available on the Thank You page providing information about the purchased products, including ID, quantity, name, price, etc.

Use the tracking script for all orders

By default, the after-sale message is displayed only for orders with payments authorized instantly (this includes usually credit cards and PayPal), after the payment is complete (transaction needs to be authorized successfully). To display the message for all placed orders regardless of the payment status:

  1. Go to Setup -> Ordering Options.
  2. Scroll down to the bottom of the Order settings area and check the checkbox for the Show message for all placed orders option.
  3. Click Save Settings.

The message will be displayed even for orders where the payment is not yet received (like bank transfers or checks).

Tracking script example

<!-- Global site tag (gtag.js) - Google Ads: 123456789 -->
  <script async src="https://www.googletagmanager.com/gtag/js?id=AW-123456789"></script>
  <script>
      window.dataLayer = window.dataLayer || [];
      function gtag(){dataLayer.push(arguments);}
      gtag('js', new Date());
      gtag('config', 'AW-123456789');
  </script>

  <!-- Event snippet for Example conversion page -->
    <script>
      gtag('event', 'conversion', {'send_to': 'AW-123456789/AbC-D_efG-h12_34-567',
        'value': 1.0,
        'currency': 'USD'
      });
    </script>

myOrder object

In addition to the custom JavaScript code that you can add to the last page of the purchase process (Thank You page - finish.php), 2Checkout also provides a JS object labeled myOrder.

productsInOrder

Array

An array containing all order products. Every array element is a JavaScript object with the following properties:

id

String

Unique system-generated product ID.

name

String

Product name.

quantity

Int

The number of product units added to cart.

code

String

Editable product code that you control

price

Float

Product price.

priceUSD

Float

Product price in USD.

priceEUR

Float

Product price in EUR.

category

String

Product category.

coupon

String

Promotion code used for the product.

discount

Float

Value of the customer discount for the product expressed in the currency used for the order.

discountEUR

Float

Value of the customer discount for the product expressed in EUR.

discountUSD

Float

Value of the customer discount for the product expressed in USD.

pricingOptions

String

Selection of product pricing options added to cart.

purchaseType

String

Product purchase type:

· REGULAR

· TRIAL

· RENEWAL

· UPGRADE

productVersion

String

Product version.

promotion

String

Marketing campaign/promotion name of the product.

productsIds

Array

Array with the IDs of the products in the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and feature standalone IDs.

productsQuantities

Array

Array with the number of units of products added to the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and feature quantity (1).

productsNames

Array

Array with the names of the products added to the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system. productNames will feature the promotion title.

productsCodes

Array

Array with the codes of the products added to the cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and feature standalone codes.

productsPrices

Array

Array with the prices (expressed in the currency selected for the order) of the products added to cart.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and have negative values equal to the amount of the discount which gets deducted from the total order value.

productsPricesUSD

Array

Array with the prices (expressed in the USD) of the products added to the cart.

productsPricesEUR

Array

Array with the prices (expressed in the EUR) of the products added to the cart.

productsNumber

Int

The number of distinct products added to the cart.

productsPromotionsCoupons

Array

Array with promotion coupons impacting products added to cart.

refNo

Int

Unique, system-generated order reference number.

externRefNo

String

The order external reference number.

idAffiliate

Int

The affiliate ID referring products in the order (0 if the order was not referred by an affiliate).

AFFSRC

String

Affiliate source (SRC) parameter. NULL if no Affiliate SRC is used for an order.

totalPrice

Float

Total order value (in the currency selected for the order).

totalPriceUSD

Float

Total order value (in USD).

totalPriceEUR

Float

Total order value (in EUR).

discount

Float

Value of coupon discount expressed in the currency selected for the order.

 

Order promotions (non-coupon discounts) are similar to products in the 2Checkout system and the discounted value is not included under discount.

discountUSD

Float

Value of coupon discount expressed in USD.

 

discountEUR

Float

Value of coupon discount expressed in EUR.

 

affiliateCommission

Float

Value of the affiliate commission for the order (expressed in the currency selected for the order).

affiliateCommissionUSD

Float

Value of the affiliate commission for the order (in USD).

affiliateCommissionEUR

Float

Value of the affiliate commission for the order (in EUR).

tax

Float

Value of sales tax or VAT (for EU) expressed in the currency selected for the order.

taxUSD

Float

Value of sales tax or VAT (for EU). (in USD)

taxEUR

Float

Value of sales tax or VAT (for EU). (in EUR)

shipping

Float

Shipping costs expressed in the currency selected for the order.

shippingUSD

Float

Shipping costs expressed in USD.

shippingEUR

Float

Shipping costs expressed in EUR.

currency

String

The currency selected for the order (ISO 4217 code; e.g.: EUR, USD, AUD, CAD).

city

String

Shopper city from the billing details.

state

String

Shopper state from the billing details.

Country

String

Shopper country code (ISO 3166; e.g.: US, CA, AU, FR, DE) from the billing details.

zipCode

String

Shopper country zip code from the billing.

avangateCustomerId

Int

Unique customer ID generated by 2Checkout for subscriptions sold. 2Checkout populates the value of the customer identifier only if you use the CUSTOMERID query parameter in your Buy Links.

externalCustomerId

String

Customer ID you control for subscriptions sold. 2Checkout populates the value of the customer identifier only if you use the CUSTOMERID query parameter in your Buy Links.

FAQ

  1. Is there a way to bypass the Thank You page?
    • Yes. If you use a Redirect URL when generating Buy Links, i.e. including the BACK_REF parameter in Buy Links together with a specific URL where shoppers are redirected after placing the order. Note: Shoppers will be redirected to this URL after the payment is confirmed. The redirect URL replaces the default "Thank you" page (except for offline payment methods such as Bank Transfer).

Need help?

Do you have a question? If you didn’t find the answer you are looking for in our documentation, you can contact our Support teams for more information. If you have a technical issue or question, please contact us. We are happy to help.

Not yet a Verifone customer?

We’ll help you choose the right payment solution for your business, wherever you want to sell, in-person or online. Our team of experts will happily discuss your needs.

Verifone logo