Skip to main content

Country-based promotions

Overview

Create promotions that apply based on your customer's country of purchase. Customers across the world respond to different incentives, therefore by making your promotions country-specific you are increasing the effectiveness of your marketing tools. Set promotions to apply to a certain country, region, or continent, depending on your business needs.

How it works

To make your promotions country-specific, follow these steps:

1. Set pricing localization

Geo-specific promotions work by incorporating a local pricing configuration in the promotion setup. Use pricing localization capabilities to define specific prices based on the customer's country/region/continent. Check our pricing localization article for learning how to define local prices for your products.

2. Assign pricing configurations to your promotions

To make your promotions geo-specific, click on Add pricing options when creating a promotion. Select the products that have a localized pricing scheme, and add the pricing configuration in the promotion setup.

promotion pricing options.png

Click on Add to promotion, to successfully add a localized pricing configuration to your promotion. 

Automatic billing canceled

Use the variables in the list below to customize the Automatic billing canceled shopper email according to your needs. Check the 'Mandatory' column to see the variables that are required in your customized version of the e-mail.

Variable name Description Test value Mandatory

ALLOW_MYACCOUNT_PROMO

Include or exclude myAccount information in the email body

1

No
AVANGATE_LOGO Avangate logo URL https://secure.avangate.com/images/e...endor_logo.png Yes

BASE_URL

Merchant's full host

https://secure.avangate.com

No

BUSINESS_COMPANY

Avangate company name

Avangate

No

BUSINESS_SUPEMAIL

Avangate support email address

support@avangate.com

No

COMMERCIALNAME

Merchant's commercial name

[Software Company Name]

No

ENCRYPTED_MERCHANT_CODE

Encrypted merchant code

0

No

FIRSTNAME

Shopper's first name used on the billing information

[John

No

LANGUAGE

Order language (abbreviated) selected by shopper

en

No

LASTNAME

Shopper's last name used on the billing information

Doe]

No

PRODNAME

Product name

[Test product name]

Yes

PRODUCTS[index1].LICENSE_TYPE

Type of purchased subscription

0

No
SUBSCRIPTION_EXPIRATION_DATE Subscription expiration date. 2020-04-20 No

TECHEMAIL

Merchant support email address

support@software-company-website.com

No

TECHPHONE

Merchant support phone number

[888-xxx-xxxx]

No

USER_EMAIL

Email address used by shopper to login/signup to myAccount

example@customer-email.com

No

WEBSITE

Website where the shopper placed the order

http://www.software-company-website.com

No

Involuntary Churn Prevention

Overview

Involuntary churn happens when the use of products or services provided by the merchant is discontinued for reasons independent of the customer. Every year, cloud software and online services companies lose millions of dollars in potential recurring revenue to customer churn. While reducing churn is the main goal for any subscription-based business, most retention strategies neglect one of the biggest and most recoverable causes of lost recurring revenue: failed payment authorizations.

With more than 1/6 card transactions failing for one reason or another, implementing strategies to reduce and/or recover declined authorizations is one of the best investments any recurring-revenue based business can make. Just as there are many reasons for payments to fail, there are numerous ways to prevent and recover them. The most successful retention strategies use many of these tactics simultaneously, and advanced tracking and analytical tools to monitor and optimize results.

Involuntary Churn Prevention Tools

You can uplift your revenues by up to 20% by using 2Checkout's Involuntary Churn Prevention tools. These tools are available out-of-the-box, but also part of our 2Recover add-on:

  • Multi-currency Management – Improve localization and limit cart abandonment with the multi-currency management which offers access to local billing currencies and can help you increase authorization rates by up to 25%.
  • Intelligent Payment Routing – Intelligent Payment Routing enables you to match or route card transactions to the payment gateways best equipped to handle them and retry authorizations using a failover or back-up gateway.
  • Dynamic 3D Secure – Helps you achieve a positive impact on authorization in specific countries and mitigate fraud risks.
  • Account Updater Service – The Account Updater Service enables 2Checkout to automatically update subscription customer card data when cardholder information changes or goes out of date, thus allowing you to increase retention by up to 40%.
  • Expired Cards Updater – Identify and automatically update expired cards and increase authorization rates by up to 4%.
  • Advanced Retry Logic – When authorization fails due to a soft decline, you can retry a renewal 6 additional times, before and after the subscription expiration, and recover up to 20% of failed transactions.
  • Hard Decline Notifications – When authorization fails due to a hard decline, notify the subscriber via email including an easy way to update their payment method and increase renewal rates by up to 1%.
  • Dispute Prevention Service – Automatically refund disputes which are likely to become lost chargebacks and reduce chargeback fees.
  • Advanced Authorization Report – Monitor the impact of the 2Recover add-on and employ the insight to adjust and optimize your tactics to reduce churn.

 

Products with physical delivery

Overview

2Checkout is your reliable payment partner for receiving payments from customers worldwide. Depending on your business model, you can opt-in for selling electronic or physical products.

Catalog physical products

Use the Control Panel to manage your catalog of physical products, with advanced control over attributes such as: handling fee and product weight.

Create shipping methods that will be displayed to your customers in cart, based on product weight, customer location and other filters that you control. You can later confirm the shipment of your tangible products towards your customers.

Dynamic physical products

2Checkout enables you to receive orders placed with dynamic product information, even if you are selling tangible products.

Read this article to learn more about orders placed with dynamic product information.

 

Cookie management for 2Checkout myAccount

Overview

A cookie is a small text file that a website places on a user’s computer (including smartphones, tablets, or other connected devices) to store information about the user’s activity. Throughout the world, regulating entities see cookies as a “persistent identifier”, thus falling under the rules applied to protect Internet users' personal information.

Regulatory entities:

Availability

All shoppers have access to the myAccount customer portal. Consequently, all of them will be seeing the cookie consent displayed (in one form or another, depending on where they are located when they access the portal. See more details below).

Out-of-the-box enhancement by 2Checkout

For shoppers in California (USA) and the European Union, 2Checkout uses three types of cookies:

  • Strictly necessary (mandatory) - These cookies help protect shoppers' data available during and after logging into their 2Checkout myAccount and cannot be disabled.
  • Preference (optional) - These cookies are used to remember customers’ choices during navigation through their 2Checkout myAccount, such as pagination selection or list types.
  • Statistics (optional) - These cookies help 2Checkout understand the shoppers' interaction with their customer myAccount, so that our system can identify issues and continuously improve the overall experience shoppers have. Data is collected and reported anonymously.

2Checkout collects consent upon the shoppers' 1st access in myAccount through a footer ribbon where the user can:

  • Accept all cookies - This will check all the above 3 types of cookies
  • Customize settings/Do not sell my info (for California users only) - This will enable the user to check any cookies other than the mandatory ones
  • Access the 2Checkout cookie policy.

Once the shopper performs an action on the footer ribbon, this will not be shown during any other subsequent accessing of the portal (for a one-year period). A link to “Cookie settings” will be available (bottom right corner), where the user will be able to change options for the optional types of cookies at any time. After one year, the footer ribbon will, once again, be displayed, to collect consent for the placed cookies.

Cookie Management MyAccount



 

By clicking on the Customize settings button, the user will be prompted with a separate window where they can choose their preferred settings.

Cookie Management - Customize settings

The footer ribbon displayed for California shoppers will display a variation of the text on the customize settings button, as shown below.

cookie management for myAccount_US_4.png

For shoppers from the rest of the world (ROW), including the US outside California, 2Checkout uses three types of cookies:

  • Strictly necessary - These cookies help protect customers' data available during and after login into their myAccount platform and cannot be disabled.
  • Preference - These cookies are used to remember customers’ choices during navigation through myAccount, such as pagination selection or list types.
  • Statistics - These cookies help 2Checkout understand the interaction of the users with their myAccount platform so our system can identify issues and continuously improve the overall experience they have. Data is collected and reported anonymously.

2Checkout collects consent upon 1st access in myAccount that all cookies are enabled (they cannot be unchecked) through the footer ribbon where the user can:

  • Click OK - This will mark the fact that the user acknowledged the cookies set-up.
  • Access the 2Checkout cookie policy.

Once the shopper performs an action on the footer ribbon, this will not be shown during any other subsequent accessing of the portal (for a one-year period). A link to “Cookie settings” will be available (bottom right corner), where the user will not be able to change options for the optional types of cookies.

Cookie management - cookie policy

 

For US users with unidentified state locations, 2Checkout will display the rules applied for California users.

For ROW users with unidentified state location 2Checkout will display the rules applied for EU users.

Customization options

Depending on the template you already use for your 2Checkout myAccount platform, the footer ribbon can be adapted to visually align with your website's layout. But customization needs to keep mandatory elements in place, to make sure compliance requirements are met:

  • The user needs to be prompted to actively provide consent for the cookie setup.
  • The link to the “cookies settings” needs to always be available inside the customer portal – for the user to view/change options.
  • The link to the Cookie policy available on 2Checkout website should always be displayed inside the ribbon + cookie management overlay.

If customization is needed for your company, you can reach out to your assigned account manager within 2Checkout or write an email to support@2checkout.com to assist you in the process.

Subscription price changed

Use the variables in the list below to customize the Subscription price changed shopper email according to your needs. Check the 'Mandatory' column to see the variables that are required in your customized version of the e-mail.

Variable name Description Test value Mandatory
AVANGATE_LOGO Avangate logo URL https://secure.avangate.com/images/e...endor_logo.png Yes

BUSINESS_COMPANY

Avangate company name

Avangate

Yes

COMMERCIALNAME

Merchant's commercial name

0

No

FIRST_NAME

Shopper's first name used on the billing information for the order that generated the subscription

Doe

No

LAST_NAME

Shopper's last name used on the billing information for the order that generated the subscription

John

No

MYACCOUNT_URL

URL for myAccount. To the BASE_URL we add /myaccount/

http://www.avangate.com

Yes

NEW_PRICE.amount

New price of the subscription

128

Yes

NEW_PRICE.currency

Currency set on the subscription

eur

Yes

NEXT_BILLING_DATE

Date of the following renewal

40980.97455

No

NEXT_CIRCLES

Number of billing cycles for which the custom price has been set

7

No

OLD_PRICE.amount

Old price of the subscription

120

Yes

OLD_PRICE.currency

Currency set on the subscription

eur

Yes

PID

Product ID number

0

No

PRODUCT_NAME

The name of the renewal product

Product name

Yes

SELLER_COMPANY

Merchant company name

Seller Company

No

SUPPORT_EMAIL

Merchant support email address

support@avangate.com

No

SUPPORT_PHONE

Merchant support phone number

78665522

No

SUPPORT_WEB

Merchant support URL

http://www.avangate.com

No

Subscription renewal

Overview

Use this section to handle the renewal of your subscriptions.

You can retrieve information regarding the renewal status of a subscription, including the manual renewal link that a customer needs to access in order to renew.

Enable or disable the recurring billing for a subscription using the API methods displayed below.

Automatic renewal reminder

Overview

Use the variables in the list below to customize the Automatic renewal reminder shopper email according to your needs. Check the 'Mandatory' column to see the variables that are required in your customized version of the e-mail.

Variable name Description Test value Mandatory
ALLOW_MYACCOUNT_PROMO Include or exclude myAccount information in the email body 0 No
AUTO_RENEWAL Indicates whether or not the shopper has enabled automatic renewal on the subscription 1 No
AUTO_RENEWAL_DAYS_LEFT Indicates the number of days left until date of first attempt for automatic renewal 0 No
AVANGATE_LOGO 2Checkout logo URL https://secure.2checkout.com/images/e...endor_logo.png Yes
AVANGATE_RESELLER_ROLE This is mandatory content you need to keep in your emails, given 2Checkout acts as Reseller/Merchant of Record for online purchases on your website. 2Checkout acts as an authorized reseller of #Merchant commercial name online products and services. Yes
AVANGATE_WEBSITE 2Checkout website http://www.2checkout.com Yes
BASE_URL Merchant's full host https://secure.2checkout.com/ No
BUSINESS_COMPANY 2Checkout company name 2Checkout No
BUSINESS_HOTLINE 2Checkout support phone 0 No
BUSINESS_HOTLINEUS 2Checkout US hotline number 0 No
BUSINESS_SUPEMAIL 2Checkout support email address support@2checkout.com No
BUY_NOW_LINK Short version of renewal buy link (prefilled with shopper information) https://secure.2checkout.com/order/ch..._ID=xxxxxxxxxx No
BUY_NOW_LINK_RAW Renewal link prefilled with shopper information (long version) 0 No
CARD_DETAILS 0 0 No
CARD_DETAILS.EXPIRATION_DATE 0 42692 No
CARD_DETAILS.LAST_DIGITS 0 41111 No
CARD_DETAILS.TYPE 0 Visa No
CARD_EXPIRED Indicates whether the payment card associated to the subscription will expire during the current billing cycle 0 No
COMMERCIALNAME Merchant's commercial name Software Company Name No
COUNTRY Shopper's country used on the billing information USA No
COUPON_DISCOUNT Indicates the value of the discount (either the percentage of the fixed amount) 40 No
COUPON_DISCOUNT_CURRENCY Indicates the 3-letter code for the currency in which the discount was set 0 No
COUPON_DISCOUNT_TYPE Indicates whether the discount is PERCENT or FIXED PERCENT No
CURRENCY Order billing currency USD No
DISPLAY_MY_ACCOUNT_INFO Include or exclude myAccount information in the email body 1 No
EMAIL Shopper email address used on the delivery information. If no delivery information is available. the billing information is used. example@customer-email.com No
ENCRYPTED_MERCHANT_CODE Encrypted merchant code 0 No
EXPIRATIONDATE Subscription expiration date 41962 No
EXPIRED Indicates whether the subscription is active or past due/expired. Possible values: TRUE (for active subscriptions), FALSE (for past due/expired subscriptions). 0 No
EXTERNAL_CUSTOMER_REFERENCE Unique customer identifier assigned to each customer by a vendor's system. This identifier allows the vendor support team to quickly retrieve customer details, transaction history, and account information. Alphanumeric string No
FIRSTNAME Shopper's first name used on the billing information John No
FIRST_NAME_BILLING Shopper's first name used on the billing information John No
HOTLINE_NUMBERS 0 0 No
IS_IMPORTED_SUBSCRIPTION Indicates whether the subscription has been imported into the 2Checkout system. 0 No
IS_SUBSCRIPTION_EXPIRED Indicates whether the subscription is active  0 No
LASTNAME Shopper's last name used on the billing information Doe No
LAST_NAME_BILLING Shopper's last name used on the billing information Doe No
LICENCECODE Subscription reference number 0 No
MERCHANT_COMMERCIAL_NAME Merchant's commercial name Some company No
MERCHANT_SUPPORT_EMAIL Merchant support email address support@some-company.com No
MERCHANT_SUPPORT_PHONE Merchant support phone number 788112233 No
MYACCOUNT_URL URL for myAccount. To the BASE_URL we add /myaccount/ https://secure.2checkout.com/myaccoun...m&k=xxxxxxxxxx No
MYACCOUNT_URL_UPDATE_CC URL for updating credit card information in myAccount 0 No
MY_ACCOUNT_LOGIN_EMAIL Email address used by shopper to login/signup to myAccount client@shopper.com No
MY_ACCOUNT_LOGIN_URL 2Checkout myAccount login/sign-up URL https://secure.2checkout.com/myaccoun...m&k=xxxxxxxxxx Yes
MY_ACCOUNT_URL URL for myAccount. To the BASE_URL we add /myaccount/ https://secure.2checkout.com/myaccoun...m&k=xxxxxxxxxx No
MY_ACCOUNT_URL_UPDATE_CC URL for updating credit card information in myAccount https://secure.2checkout.com/myaccoun...m&k=xxxxxxxxxx No
NUMBER_OF_DAYS_UNTIL_EXPIRATION Number of days left until subscription expiration 0 No
OLD_PRODUCT_NAME Name of the old product (that will be renewed to a different version as per settings in your Control Panel) Old product name No
OLD_PRODUCT_GROUP_CODE The Product Group Code of the product currently on the subscription   No
OLD_PRODUCT_GROUP_NAME The Product Group Name of the product currently on the subscription   No
ORDER_DATE Order placement date 40544 No
ORDER_DATE_STANDARD_FORMAT Standard format used for the order placement date 42292 No
ORDER_NUMBER Indicates the reference number of the initial order that generated the licence 9xxxxx No
ORIGINAL_ORDER_REFERENCE_NUMBER Indicates the reference number of the initial order that generated the licence 9xxxxx No
PRODUCTID Product ID number 0 No
PRODUCT_EXTRA 0 0 No
PRODUCT_NAME The name of the renewal product Software Product Name No
PRODUCT_NAME_OLD Name of the old product (that will be renewed to a different version as per settings in your Control Panel) Software Product Name Old No
RENEWAL_BUY_NOW_LINK Short version of renewal buy link (prefilled with shopper information) https://secure.2checkout.com/order/ch..._ID=xxxxxxxxxx No
RENEWAL_COUPON Shows the coupon code of the discount (if the product has a renewal promotion assigned) 1 No
RENEWAL_INTERVAL Indicates the length of a billing cycle in number of days/months (as defined for the renewed product) 6 No
RENEWAL_INTERVAL_METRIC Indicates whether the renewal interval is defined in months or days 0 No
RENEWAL_PRICE The next renewal price of the renewal product 19.99 No
RENEWAL_PRODUCT_GROUP_CODE The Product Group Code of the product that the subscription will be renewing.   No
RENEWAL_PRODUCT_GROUP_NAME The Product Group Name of the product that the subscription will be renewing to   No
RENEWAL_PRODUCT_NAME The name of the renewal product Renewal product name Yes
RENEWAL_PRODUCT_RENEWAL_PRICE The next renewal price of the renewal product 19.99 Yes
RENEWAL_PRODUCT_RENEWAL_PRICE_OLD The catalog next renewal price (before discount) 30.99 No
RENEWAL_PROMOTION_DATA 0 0 No
RENEWAL_PROMOTION_DATA.Currency Currency of the renewal promotion USD No
RENEWAL_PROMOTION_DATA.Discount Discount value applied to renewals 30 No
RENEWAL_PROMOTION_DATA.DiscountType Type of renewal discount (percentage or fixed) PERCENT No
RETRYLINK Payment retry link 0 No
RETRY_LINK Payment retry link 0 No
SHOPPER_COMPANY_BILLING Shopper's company name used on the billing information User company No
SHOPPER_EMAIL_ADDRESS_BILLING Shopper's email address used on the billing information client@shopper.com No
STARTDATE Indicates the date when the subscription was purchased 40544 No
SUBSCRIPTION_EXPIRATION_DATE Indicates the date when the subscription expires 42292 Yes
TECHEMAIL Merchant support email address support@software-company-website.com No
TECHPHONE Merchant support phone number 888-xxx-xxxx No
UNSUBSCRIBE_LINK Shopper unsubscribe link 0 No
UPLOADLINK File upload link 0 No
UPLOAD_LINK File upload link 0 No
USER_EMAIL Email address used by shopper to login/signup to myAccount 0 No
WILL_CARD_EXPIRE_THIS_BILLING_CYCLE Indicates whether the payment card associated with the subscription will expire during the current billing cycle 0 No

API 5.0

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

 

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