Overview

We will stop supporting the MD5 algorithm in our platform and impacted merchants will have to switch to SHA. The decommissioning will be carried out in two stages, having the deadline for the first phase on 15th of August, 2024 and the deadline for the second phase on 30th of June, 2025.

Availability

Areas in which MD5 will no longer be available are the following:

Phase One (deadline: 15th of August, 2024)

• API
• Webhooks (IPN and LCN)
• Shopping cart integrations
• Electronic delivery
• Buy links generated using MD5 hash

Phase Two (deadline: 30th of June, 2025)

• Finish page (BACK_REF parameter)
• Instant Notification Service (INS)
• Instant Refund Notification (IRN)
• Instant Delivery Notification (IDN)
• Instant Order Search Export (ISE)

Benefits

• Keeping up to date with technical security advancements.
• Increasing the security for authentication and removing potential security breaches.
• Secure and robust while being compatible with the existing algorithms in terms of the number of bits and representation size​

The Gateway Error Code will return a list of potential values. Knowing these will help you customize the message you want to relay to your customers relating to failed payment.

Payment successful flow

1. Shopper purchases a subscription in the shopping cart.

2. Once the payment is successful, a Payment receipt email is sent to the shopper with confirmation and details of their payment.

3. An electronic delivery email is provided to the shopper including the subscription plan information, activation codes/keys with short descriptions, downloadable product files, technical and payment support contact details.

      2Checkout can send the electronic delivery email either standalone or combined with the payment receipt notification (in one single email).

4. An Auto Renewal subscription compliance email is sent automatically to shoppers with confirmation and details of their subscription (information regarding billing cycle duration, next billing amount, next billing date etc).

5. A reminder email notification is sent to shoppers before their subscription expiration date.

   For ≥ 6 months billing cycle

   • A 30 days before expiration reminder email is sent, along with a 7 days before expiration reminder email.

   For a < 6 months billing cycle

   • Only a 7 days before expiration reminder email is sent.
      You can add other reminders should it make sense for your business, as the above illustrated examples are the mandatory ones, sent by default.

6. On the day of subscription expiration the auto-renewal subscription is activated which is confirmed when the shopper receives the Payment receipt for renewal email, along with the Delivery confirmation email.

      This notification can be sent in:
   
   One email: (1) Payment receipt and Delivery / Fulfillment
   
   Two emails: (1) Payment receipt + (2) Delivery / Fulfillment
   
   Three emails: (1) Payment confirmation + (2) Payment Receipt + (3) Delivery / Fulfillment

Trial Flow

1. Shopper purchases a subscription in the shopping cart and enrolls for a free or discounted trial.

2. Once the payment is successful a Payment receipt email is sent to the shopper with confirmation and details of their payment.

3. An electronic delivery email is provided to the shopper including the subscription plan information, activation codes/keys with short descriptions, downloadable product files, technical and payment support contact details.

      2Checkout can send the electronic delivery email either standalone or combined with the payment receipt notification (in one single email).

4. An compliance trial email is sent automatically to shoppers with confirmation and details of their trial (trial period duration, trial expiration, following billing date, following billing amount, a link to MyAccount for the shopper to be able to cancel the following automatic charge).

5. A Trial expiration notification email is sent to shoppers 5 days before their trial expiration date.

If the shopper continues with the subscription, the above flow should be followed.

Payment failed / Refund flows

Payment failed flow

1. Shopper purchases a subscription in the shopping cart.

2. The payment is being processed.

   Payment failed

   • If the payment fails, a Payment failed email is sent to the shopper, confirming the failed transaction and providing the possibility to return to the shopping cart and finalizing the purchase without having to go back through the ordering process.

   Payment successful

   • If the payment is successful, the above flow should be followed.

3. On the next billing date the automatic renewal is attempted and the new payment will be processed.

   Payment failed

   • If the payment fails, a Recurring payment failed email is being sent to the shopper, confirming the failed transaction and providing the possibility to continue with the renewal by changing the payment method or manually renewing the subscription.

   Payment successful

   • If the payment is successful, the auto-renewal subscription is activated and a confirmation Payment receipt for renewal email is being sent to the shopper, along with the Delivery confirmation email.

Refund flow

Refund can be requested after the initial purchase, once the payment is confirmed.

If the refund is requested and approved, the shopper will receive a Refund Confirmation email.

This can happen either after acquiring the subscription for the first time or at the last renewal.

Overview

You can implement Google Analytics 4 and Google Tag Manager tracking tools to help you track and monitor your ConvertPlus and InLine checkout orders in order to improve the shopping experience and increase the conversion rate.

Availability

Google Analytics 4 and Google Tag Manager can be set for all 2Checkout accounts.

Google Analytics 4 Settings

Implement Google Analytics 4

To implement Google Analytics 4 through Google Tag Manager (GTM) for your ConvertPlus and InLine Checkout, follow these steps:

1. In your browser window, navigate to Tag manager → All accounts.
2. Click on the Create Account button.
   
3. Fill in all the required fields:
   • Account Name
   • Country
   • Container name
   • Target platform → Web
4. Click on the Create button.
5. Copy the Google Tag Manager Container ID. It will be used in the 2Checkout Control Panel for the Google Tag Manager set-up.
   

Creating the Google Tag in Google Tag Manager

If you already have a Google Tag in your container that fires on all pages where the Google Tag Manager code is added, then you do not need to create a new Google Tag specifically for 2Checkout and can proceed directly to the next section. However, you need to make sure you add the cookie_flags configuration, described in step 3 below. This configuration is necessary, as the tracking script is placed in an iFrame for ConvertPlus and Inline carts.

1. Click to create a new tag in Google Tag Manager and select Google Tag from the list pre-defined tags.
   

2. In the Tag ID section in Google Tag Manager, enter the Measurement ID. You can find the ID in your Google Analytics 4 with the following steps:

   • Navigate to Admin -> Data Streams.
   • Click on your website property.
   • Copy the measurement ID.

   

3. In the Fields to set section select the following to add the cookie_flags configuration:
   • For Field Name add cookie_flags
   • For Value add SameSite=None;Secure
4. In the Triggering section, select All Pages.
   

Sending ecommerce information to Google Analytics 4 from the 2checkout shopping cart

Configure a trigger in Google Tag Manager

In Google Tag Manager, click on the Triggers section and then click to add a new trigger.

Create a Custom Event trigger

1. Name your trigger GA4 Event Ecommerce Trigger.
2. From the list provided, choose Custom event as Trigger Type.
3. In the field Event name, type .* and check the box Use RegEx matching.
4. For the This trigger fires on section, select Some custom events.
5. As rule, fill in the boxes with Event matches RegEx (Ignore case) begin_checkout|add_to_cart|remove_from_cart|purchase|view_item_list. Those are events in the dataLayer on the format of the GA4 documentation for developers provided by Google.
6. Click Save.
   

Configure the tag for GA4 for sending ecommerce data

1. Click on New to create a new tag that you can call GA4 Event Ecommerce Tag.
2. From the list provided by Google, select the option Google Analytics: GA4 event as Tag Type.
3. For Measurement ID, add the measurement ID from the Google Analytics 4 property to which you want to send data. This is normally the same measurement ID that you have in your Google Tag. Once you add the measurement ID from your Google Tag, you will see the message Google Tag found in this container.
4. For Event Name, select {{Event}}.
5. Under More Settings -> Ecommerce, click on the Send Ecommerce data checkbox and select Data Layer from the Data Source drop-down list.
   
6. Add as trigger for this tag the previously created trigger for GA4 Event Ecommerce Trigger.
   

Setup Cross-domain measurement in your Google Analytics 4 Admin page

Google Tag Manager code is placed in an iFrame with the domain tracking.avangate.net. In order for Google to recognize that a visitor is the same when entering your website and then entering the shopping cart, you need to setup cross-domain measurement in Google Analytics 4 Admin, according to information provided by Google.

1. In Admin, click on Data Streams, click on Web and then select your web data stream. In the web stream details, click Configure tag settings (at the bottom). In the Settings  section, click Configure your domains.
   
2. Under Include domains that match ANY of the following conditions, choose match type Contains and under Domains, enter the identifier of your domain (ex. yourwebsite.com) and then click Add Condition to add the next domains – tracking.avangate.net and secure.2checkout.com.
   

Test your Google Analytics 4 Settings with GTM Debugger

To test if your Google Analytics settings are correct, follow the steps below:

1. Download and install the Tag Assistant Companion browser extension found here.
2. Click on Preview.
   
3. Delete all existing domains.
   
4. Click on Add domain.
   
5. Add https://tracking.avangate.net/ and click Start.
   
6. Go back to the Google Tag Manager tab but DON’T close the tab with tracking.avangate.local.
   
7. Click on X in the top-left corner.
   
8. In the Tag Assistant tab, click on Add domain.
   
9. Enter the buy-link you want to debug and click Start.
   
10. Go back to the Google Tag Manager debugger tab.
    
11. Click on the Enable button behind the Connecting this window to avangate.net pop-up.
    
12. Click on Continue.
    
13. You are now debugging tracking.avangate.net, but this domain receives tags from the shopping cart.
    
14. Submit and publish your settings.
    

Checking a purchase in Google Analytics 4

Place an order on the 2checkout shopping cart, using the template which has your Google Tag Manager code.

Log into your Google Analytics 4, go to Monetization -> Ecommerce purchases.

You will see the number of purchases for your products and the revenue from your purchases.

Control Panel Settings

The Analytics section in your Control Panel allows you to integrate Google Analytics 4 or/and Google Tag Manager(with GA 4) in the ConvertPlus or InLine ordering engines and thus track the behavior of your shoppers on the 2Checkout pages.

Follow these steps to complete your analytics integration:

1. Log into your Control Panel.
2. Navigate to Setup → Ordering options.
3. Click on the Analytics tab.
4. Click on the ConvertPlus and InLine Checkout tab.
   
5. In the Google Tag Manager(with GA 4) box, click on Set up and fill in the Google Tag Manager (with GA4) Container ID.
6. Click Save.
   
7. Complete the integration by using the slider to activate Google Tag Manager. It is not recommended to activate both Google Analytics 4 and Google Tag Manager to send data to the same Google Analytics 4 property, otherwise, duplicate data will occur.
   

Overview 

You can implement Google Analytics 4 without the Google Tag Manager (GTM) to help you track and monitor your ConvertPlus and InLine checkout orders in order to improve the shopping experience and increase conversion rate. 

Availability 

Google Analytics 4 can be set for all 2Checkout accounts. 

Implement Google Analytics 4 in ConvertPlus and InLine Checkout

Follow these steps to implement Google Analytics 4 in ConvertPlus and InLine Checkout: 

1. Navigate to your Google Analytics 4 account. 

2. Copy your Google Analytics 4 Measurement ID and use it in your 2Checkout Merchant Control Panel to set up Google Analytics 4 for your ConvertPlus and InLine carts. 

3. To get your Google Analytics 4 Measurement ID, go to Google Analytics 4 → Admin → Data Streams → Web → Select your web property. Under Measurement ID you will find the code you need to copy and paste into your Merchant Control Panel. 

Cross-domain tracking settings

Google Tag Manager code is placed in an iframe with the domain tracking.avangate.net. In order for Google to recognize that a visitor is the same when entering your website and then entering the shopping cart, you need to setup cross-domain measurement in Google Analytics 4 Admin, according to information provided by Google.  

In Admin, click Data Streams, click Web and then select your web data stream. In the web stream details, click Configure tag settings (at the bottom). In the Settings section, click Configure your domains. 

Under Include domains that match ANY of the following conditions, chose match type Contains and under Domain, enter the identifier of your domain (ex. yourwebsite.com) and then click Add Condition to add the next domains – tracking.avangate.net and secure.2checkout.com.

Merchant Control Panel Settings

The Analytics section in your Merchant Control Panel allows you to integrate Google Analytics 4 in the ConvertPlus or InLine ordering engines and thus track the behavior of your shoppers on the 2Checkout pages.

Follow these steps to complete your analytics integration:

1. Log into your  Merchant Control Panel.
2. Navigate to Setup → Ordering options.
3. Click on the Analytics tab.
4. Click on the ConvertPlus and InLine Checkout tab.

5.In the Google Analytics box, click on Edit. 

6. Fill in the Google Analytics 4 Measurement ID and click Save.

7. Complete the integration by using the slider to activate Google Analytics 4.

Checking a purchase in Google Analytics 4 

Place an order on the 2checkout shopping cart, using a ConvertPlus or Inline cart. 

Log into your Google Analytics 4, go to Monetization -> Ecommerce purchases. 

You will see the number of purchases for your products and the revenue from your purchases. 

1. The 2Checkout data layer for Google Analytics 4 tracking is placed in an iFrame. This data layer contains eCommerce information built on the structure required by Google Analytics 4 reporting for the following events: checkout, view item list (for cross-sell products), add to cart (for cross-sell products), purchase and remove from cart. 2. For fully enhanced eCommerce reporting in Google Analytics 4, it is recommended that you send information to Google Analytics 4 from your website that includes for example product views, select product, add to cart. More information on enhanced eCommerce reporting can be found here:  https://developers.google.com/analytics/devguides/collection/ga4/reference/events?client_type=gtag.