Skip to main content

Product SKU

Overview

Stock keeping unit or SKU is a number assigned to a particular product by a digital or physical retail store for easy identification and inventory tracking purposes. The SKU number is a string of alphanumeric characters that uniquely identify details such as price, product options, and manufacturer of a particular product or service. SKUs are used in order notifications, electronic delivery, export files, etc.

SKU Management

For companies that manage large product catalogs with defined SKUs and that make regular changes to their prices and products (new versions, new options), the manual process performed in the Merchant Control Panel needs to be supported by an automatic solution as well. By using an automated flow, merchants decrease the time needed for this process, and also reduce the risk of human errors associated with the manual process.

In the 2Checkout platform, SKUs can be associated with a unique combination made up of:

  • Product identification element
  • Pricing configuration
  • Plus minimum one of the following:
    • Currency – defined as applicable to all currencies or only to specific ones
    • Volume Discounts – defined as specific quantity or intervals (applicable only according to the volume discounts that are defined at pricing configuration level)
    • Purchase Types – possible values: new purchase, renewal, upgrade, and trial
    • Pricing Options – will be available considering the pricing option groups assigned to the selected pricing configuration

 

 

 

Accessing 2Checkout myAccount

Overview

Your shoppers have access to the 2Checkout myAccount customer portal where they can view information about the orders/transactions they performed using our platform, they can download keys/invoices if applicable, and even manage automatic renewal and payment-related information for their recurring subscriptions.

Availability

All shoppers have self-service and free access to the 2Checkout myAccount portal, regardless of the business model that merchants have chosen to use when partnering with us and regardless of the commercial terms applied.

The only requirement is to have at least one order placed using the myAccount platform or at least one subscription managed through the 2Checkout platform.

How to access 2Checkout myAccount

There are two ways to access the 2Checkout myAccount customer portal:

  1. Shoppers can use the link that takes them to the customer portal (https://secure.2co.com/myaccount/ or a customized link if you use a custom domain)
  2. You can redirect and log in shoppers automatically from your system into their myAccount customer portal, based on the subscription/customer reference number via Single Sign-On, an API-based method.

Access the myAccount Customer Portal by using a link

The link (https://secure.2co.com/myaccount/) shoppers need to use to access myAccount is included in the automatic emails that the 2Checkout system sends after several events/actions, such as order or payment confirmation/receipt, electronic delivery, renewal reminders, follow-ups for unfinished automatic charges, etc.

If you customize your shopping cart or your emails, you can also include this link wherever you feel it is relevant for your shoppers.

If you use a custom domain, part of this link will be replaced with your domain (e.g. https://store.custom.com/myaccount/).

How can shoppers log in into the myAccount portal

Once clicked, the link takes shoppers to the myAccount portal access page, where they have two options:

1. Log in using either the email address associated with the order/subscription in our platform or the reference number for the order placed through our platform (without the need to set a password). To do so, shoppers need to:

  • Fill in either the email address or the order reference number.
  • Click on the Send access link action button (an email will automatically be sent to the email address if this is associated with an order/subscription in our platform).
  • The email includes an access link that logs the shopper straight into the 2Checkout myAccount (for security reasons, the link is valid for 1 hour and can be used one time only)
  • Once logged in, shoppers have the option to set a password (by accessing the Manage password tab on the menu).

Accessing 2Checkout myAccount - by link

 

Overview - personal information password management

 

2. Log in using the email address (associated with the order/subscription in our platform) and a password. To do this, shoppers need to:

  • Have previously set a password for the 2Checkout myAccount portal.
  • If they forget the password, shoppers can click on the Forgot your password link, which will redirect them to the flow described at #1 above (where an access link is sent to the email address).

Accessing 2Checkout myAccount - by email and password

Access the 2Checkout myAccount shopper portal via Single Sign-On

You can redirect and log in shoppers automatically from your website to their 2Checkout myAccount based on subscription information or customer reference number (either from the 2Checkout system or external customer reference number) by using the Single Sign-On API call.

This is useful if you already have a customer portal on your website and only need to direct shoppers to the 2Checkout myAccount shopper portal to specific pages (such as subscriptions or subscription listing, order look-up, payment methods, manage password, etc.).

For detailed information on how to do this, check the API Integration area.

 

Trial canceled

Use the variables in the list below to customize the Trial 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

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 delivery information

[John

No

LANGUAGE

Order language (abbreviated) selected by shopper

en

No

LASTNAME

Shopper's last name used on the delivery information

Doe]

No

PRODNAME

Product name

[Test product name]

No

PRODUCTS[index1].LICENSE_TYPE

Type of purchased subscription

0

No

TECHEMAIL

Merchant support email address

support@software-company-website.com

No

TECHPHONE

Merchant support phone number

[888-xxx-xxxx]

No

TRIALEND

Expiration date of trial licence.

[Trial expiration date]

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

Customer

Overview

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

Input parameters

Parameters Type/Description

ExternalCustomerReference

Optional (string)

 

Unique customer alphanumeric (string) identifiers you control. Aggregate subscriptions under the same Customer account by adding the CUSTOMERID (case sensitive) parameter to Buy links.

FirstName

Required (string)

 

Customer's first name. 

LastName

Required (string)

 

Customer's last name.

Company

Optional (string)

 

Company name.

FiscalCode

Optional (string)

 

Can be null for end users. For companies, it needs to be the VAT ID, which 2Checkout validates.

2Checkout throws an error if the VAT ID is invalid/incorrect. When present, you also need to provide the company name.

 

Can be null for end users.

Address1

Required (string)

 

Customer's address.

Address2

Optional (string)

 

Customer's address.

City

Required (string)

 

Customer's city.

State

Optional (string)

 

Customer's state. For example, "Alabama","Alaska","Arizona".

Zip

Required (string)

 

Zip code.

CountryCode

Required (string)

 

Customer's country code (ISO 3166 two-letter code).

Phone

Optional (string)

 

Customer's phone number.

Fax

Optional (string)

 

Customer's fax number.

Email

Required (string)

 

Customer's email.

Enabled

Optional (boolean)

 

true or false, depending on whether the customer account is active or inactive. An active customer account features at least one Active or Past due subscription. Possible customer statuses:

 

  • Active - Customer account status is Active even if Trial and Cancelled/Expired subscriptions exist for the customer, along as there's at least one Active subscription. Customers with a single subscription featuring the Past due status (expired but in the grace period) are considered Active.
  • Inactive - All subscriptions associated to this Customer account are cancelled, expired or both.
  • Trial - Customer account status is Trial if all Active subscriptions for this customer are trials, regardless of any Cancelled/Expired subscriptions.

Trial

Optional (boolean)

 

true or false, depending on whether the customer account features only trials or also paid subscriptions.

Language

Optional (string)

 

ISO 639-1 two-letter code. Example: “en.”

 

 

Sample Privacy Policy

Overview

Due to industry regulations, all websites must have a viewable privacy policy and refund policy. We have created sample policies for you to use, or you may write your own.

Privacy Policy

This policy explains to your customers how you will use their information.

Sample Privacy Policy

You can use the sample Privacy Policy below or you can write your own.

This policy covers how we use your personal information. We take your privacy seriously and will take all measures to protect your personal information.

Any personal information received will only be used to fill your order. We will not sell or redistribute your information to anyone.

Product

Overview

This object is returned directly or within a successful response from the following API requests:

Product object

Parameters Type/Description
AvangateId String
  Unique, system-generated 2Checkout product ID. Read-only.
ProductCode String
  The product code that you can define for each of your offerings. Needs to be unique.
ExternalReference String
  External reference that you control when defining the product.
ProductType String
  REGULAR or BUNDLE
ProductName String
  The name of the product
ProductVersion String
  The product version number
PurchaseMultipleUnits Boolean
 

Possible values:

  • TRUE - customers can purchase multiple units of this product.
  • FALSE - customers can purchase only one unit at a time.

 

The default value is TRUE.

 ​​​​​

Tangible Boolean
 

Possible values:

  • TRUE - for physical products
  • FALSE - for digital products 
TangibleDetails Object
  Only for physical products. Contains information related to product's physical setup.
  UnitDetails Array of objects
    Details on tangible setup.
                    Type String
    Product physical configuration type. Example: "WEIGHT".
                    Amount String
    Product's tangible weight. Example: "5".
  Fee Array of objects
    Details on handling fees associated with a tangible product.
                     Currency String
    Currency of the handling fee. Example: "USD"
                     Amount String
    Handling fee amount defined on the tangible product. Example: "5".
ProductGroup Object
  Product group information.
  Name String
    Product group name
  Code String
    Product group code generated when you create the group
  TemplateName String
    Default cart template used when generating buy links for products from this group. 
  Description String
    Product group description.
ShippingClass Object
  Existing shipping class object with the structure detailed below.
  Name String
    The name of the shipping class
  Amount Decimal
    The shipping costs
  Currency String
    The currency ISO code used for shipping costs - ISO 4217.
  ApplyTo String
   

Possible values:

• PRODUCT

• ORDER

  Type

Possible values:

• FIXED

• PERCENT

GiftOption Boolean
  True or false depending on whether the product can be gifted or not.
ShortDescription String
  Product's short description.
LongDescription String
  Product's long description.
SystemRequirements String
  System requirements
ProductCategory String
  Product category
Platforms Array of Platform objects
  Array of objects detailing the platforms supported by the application. Details below.
  PlatformName String
    The label of the platform per the product configuration.
  Category String
    Platform category per product configuration. 
ProductImages Array of Image objects
  Image object. Details below. Read-only.
  Default Boolean
    True or False depending on whether you set the image stored at the address in the URL parameter as default or not.
  URL String
    The location of the image on the 2Checkout system.
TrialUrl String (anyURI)
  The URL from where shoppers can download trial software.
TrialDescription String
  Descriptive text entered for trials.
Enabled Boolean
  True/false depending on whether the products are active or disabled. When empty, 2Checkout marks the product as disabled.  
AdditionalFields Array of AdditionalFieldAssigned objects
  Array of existing additional fields assigned to products. Details below.
  Label String
    The name of the additional field assigned to a product.
  Code String
    The code of the additional field assigned to a product.
  Enabled Boolean
    True or false depending on whether the assigned product field is enabled or not.
  Required Boolean
    True or false depending on whether the assigned product field is required or not.
  URLParameter String
    The value of the system generated URL parameter for the product field that can be used in Buy Links.
  Display Array of Objects
    Contains the display settings (Active/Required) for Order/Download pages (see Type property below)
 

Type

String
    Values: Download/Order
 

Active

Boolean
    True or false depending on whether the assigned product field is active or not.
 

Required

Boolean
    True or false depending on whether the assigned product field is required or not.
Translations Array of ProductTranslation objects
  Details below.
  LongDescription String
    The translated long description in the language corresponding to the Translation object.
  TrialUrl String
    The trial URL for users speaking the language corresponding to the Translation object.
  TrialDescription String
     
  SystemRequirements String
    Localized system requirements.
  Name String
    Localized product name.
  Description String
    Localized product short description.
  Language String
    ISO 639-1 two-letter code.
PricingConfigurations Array of PricingConfiguration objects
  Details below. 2Checkout creates pricing configurations during the process when you add a product.
  Name String
    Pricing configuration name
  Code String
    System-generated identifier.
  Default boolean
    True for the default pricing configuration
  BillingCountries Array of strings
   

ISO codes of the countries assigned to the pricing configuration.

Empty unless specific countries are assigned to a pricing configuration.

  UseOriginalPrices Boolean
    True or False
  PricingSchema String
   

DYNAMIC – With a base price

FLAT – Without a base price

  PriceType String
    Possible values:  NET / GROSS
  DefaultCurrency String
    The ISO code of the default currency for the pricing configuration
  Prices Object
    Details below.
 

Regular

Array of objects

 

 

Details below.

 

Amount

Int

 

 

The price of the product.

 

Currency

String

 

 

ISO code of the currency for the product price.

 

MinQuantity

Int

 

 

The minimum quantity of volume discounts. Default is 1.

 

MaxQuantity

Int

 

 

The maximum quantity of volume discounts. Default is 99999.

 

OptionCodes

Array of objects

 

 

Details below.
 

Code

String

 

 

Price option identifier.

 

Options

Array of strings

 

 

The pricing options group option code you configured that the 2Checkout system uses to calculate product prices for pricing configurations without a base price.
 

Renewal

Array of objects

 

 

Details below.
 

Amount

Int

 

 

The price of the product.

 

Currency

String

 

 

ISO code of the currency for the product price.

 

MinQuantity

Int

 

 

The minimum quantity of volume discounts. Default is 1.

 

MaxQuantity

Int

 

 

The maximum quantity of volume discounts. Default is 99999.

 

OptionCodes

Array of PriceOptionCode objects

 

 

Details below.
 

Code

String

 

 

Price option identifier.

 

Options

Array of strings

 

 

The pricing options group option code you configured that the 2Checkout system uses to calculate product prices for pricing configurations without a base price.
  PriceOptions Array of AssignedPriceOptionGroup objects
    Details below.
 

Code

String

 

 

System generated pricing options group code (you can also configure it) that the 2Checkout system uses to calculate product prices for pricing configurations without a base price.

 

Required

Boolean

 

 

True or False depending on whether you want to make it mandatory for shoppers to select the price option during the purchase process.
 

CustomImpactOnPrice

Boolean
    True or False
BundleProducts Array of BundleProductCode objects  
  Details below.
  ProductId String
    Unique, system-generated product ID.
  ProductCode String
    Editable product code that you control.
Fulfillment String
 

BY_AVANGATE

NO_DELIVERY – The 2Checkout system finalizes orders immediately after it receives payment confirmation.

BY_VENDOR – you are responsible for delivering/fulfilling orders

Prices Array of Price objects
  Use this object only when Pricing Configurations are not available for your account. Details below.
  Amount Int
    The price of the product.
  Currency String
    ISO code of the currency for the product price.
  MinQuantity Int
    The minimum quantity of volume discounts. Default is 1.
  MaxQuantity Int
    The maximum quantity of volume discounts. Default is 99999.
  OptionCodes Array of objects
    Details below.
 

Code

String

 

 

Price option identifier.

 

Options

Array of strings

 

 

The pricing options group option code you configured that the 2Checkout system uses to calculate product prices for pricing configurations without a base price.
GeneratesSubscription Boolean
 

TRUE or FALSE depending on whether you set the product to generate subscriptions or not.

 

NULL for bundles for which you set the following subscription management option: “Use the subscription settings of each product in the bundle”

SubscriptionInformation ProductSubscriptionInformation Object
  Details below. NULL for bundles which you set to use the renewal settings of child products and not of the parent bundle.
  DeprecatedProducts Array
    Deprecated products.
  BundleRenewalManagement String
   

Possible values:

  • GLOBAL
  • INDIVIDUAL

Can be NULL.

  BillingCycle String
   

The number of subscription billing cycle units (months or days).  Possible values:

  • -1 (-1 represents the one-time fee)

Days

  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14

 

Months

  • 1
  • 2
  • 3
  • 6
  • 12
  • 15
  • 18
  • 24
  • 36 (max)
  BillingCycleUnits String
   

The units of the billing cycle:

  • M - months
  • D - days
  IsOneTimeFee Boolean
    True or False depending on whether the subscription is evergreen or not.
  ContractPeriod Object
    Details below.
 

Period

Int

 

 

The contract period in months or days. -1 for unlimited contracts.

 

PeriodUnits

String

 

 

The contract period units

days | months

 

IsUnlimited

Boolean

 

 

This flag is true if the contract is for an unlimited period

 

Action

String

 

 

The action performed after the subscription expires.

Possible values CANCEL | RESTART

 

EmailsDuringContract Boolean

 

 

True or False depending on whether you suppress renewal notification emails throughout the duration of the contract or not.
  UsageBilling Int
   

The usage billing interval must be smaller than or equal to the grace period.

 

Interval of time within the grace period, when the 2Checkout system attempts to automatically charge customers for recurring costs and additional metered usage fees (in arrears). 2Checkout renews subscriptions only after subscribers make all outstanding payments per the renewal settings (from the expiration or the renewal date). If automatic renewal and usage charges fail, subscriptions can be manually renewed only by the end of the grace period, after which they expire.

 

Can be NULL.

  GracePeriod Object
 

Type

String

 

 

CUSTOM – you configured grace period setting at product level.

GLOBAL – global grace period settings apply.

 

Period

String

 

 

Number of days set for the grace period.

 

PeriodUnits

String

 

 

D - Days.

 

IsUnlimited

Boolean

 

 

TRUE or FALSE depending on whether you set the grace period to unlimited or not.
  RenewalEmails Object
    Details below. Can be NULL. Available only in Product API 2.5 and later.
 

Type 

String

 

 

GLOBAL - Send emails according to the global renewal notification settings.

CUSTOM – per product renewal notification settings

 

Settings

Object (can be NULL)

 

 

Details below.
 

ManualRenewal

Object (can be NULL)

 

 

Details below.
 

Before30Days 

Boolean

 

 

True or False.

 

Before15Days 

Boolean

 

 

True or False.

 

Before7Days 

Boolean

 

 

True or False.

 

Before1Day 

Boolean

 

 

True or False.

 

OnExpirationDate 

Boolean

 

 

True or False.
 

After5Days

Boolean

 

 

True or False.

 

After15Days 

Boolean

 

 

True or False.
 

AutomaticRenewal

Object (can be NULL)

 

 

Details below.
 

Before30Days 

Boolean

 

 

True or False.

 

Before15Days 

Boolean

 

 

True or False.

 

Before7Days 

Boolean

 

 

True or False.

 

Before1Day 

Boolean

 

 

True or False.

 

OnExpirationDate 

Boolean

 

 

True or False.

 

After5Days

Boolean

 

 

True or False.

 

After15Days 

Boolean

 

 

True or False.
FulfillmentInformation Object
  Details below. Can be NULL. Available only in Product API 2.5 and later.
  IsStartAfterFulfillment  Boolean
    True or False. Depending on whether you want the subscription lifetime to start afther the completion of the fulfillment process or not.
  IsElectronicCode  Boolean
    True or False. Depending on whether you configure the delivery of keys/codes for the product or not.
  IsDownloadLink  Boolean
    True or False. Depending on whether you configure the delivery of a product file or not.
  IsDownloadInsuranceService  Boolean
    True or False. Depending on whether you enable the Download Insurance Service or not, for a product for which you configure a product file.
  IsInstantDeliveryThankYouPage  Boolean
    True or False. Depending on whether you enable instant delivery in the Thank You page or not.
  IsDisplayInPartnersCPanel  Boolean
    True or False. Depending on whether you share access to the product file with your channel partners or not.
  ReturnMethod Object
    Information on the customer redirect method after a successful purchase.
  Type String
   

Possible values:

  • DIRECT_RETURN
  • HEADER_REDIRECT
  • HTML_LINK
  URL String
    Website to which customers are redirected after a successful purchase. Example: "http://mySuccessURL.com"
  CodeList  Object (can be NULL)
    Details below.
 

Code 

String

 

 

The unique code list identifier.

 

Name 

String

 

 

Name of the code list.

 

Type 

String

 

 

Code list type:

  • STATIC
  • DYNAMIC
  ProductFile Object (can be NULL)
    Details below.
 

Code 

String

 

 

Unique product file identifier.

 

Name 

String

 

 

Display name.

 

File 

String

 

 

Name of the product file.

 

Version 

String

 

 

File version.

 

Size

String

 

 

File size.

 

Type 

String

 

 

File type.

 

LastUpdate 

String

 

 

YYYY-MM-DD HH-MM-SS. Date time stamp when you last updated the file.

 

AdditionalInformationByEmail 

String (can be NULL)

 

 

The text you set up in the Additional fulfillment information - by email area.

 

AdditionalInformationEmailTranslations 

Object (can be NULL)

 

 

Array of localized Additional fulfillment information - by email texts.

 

AdditionalThankYouPage 

String (can be NULL)

 

 

The text you set up in the Additional fulfillment information - "Thank you" page area.

 

AdditionalThankYouPageTranslations 

Array (can be NULL)

 

 

Array of localized Additional fulfillment information - "Thank you" page texts.

 

 

Activate and set up your 2Checkout account

Overview

After you create your account with 2Checkout, you need to request the activation of your live account by completing a form and providing information that will help us verify the business and identity of the individuals involved in your business.

   Your activation request will be analyzed manually by 2Checkout’s Underwriting team and it is a mandatory step before you can start selling. Do make sure you check your email for any requests you may get from 2Checkout that are needed to finish the activation process.

Activate your 2Checkout account

1. Activate your 2Checkout account by clicking on the Start activation button, as shown below. 

2. Upon clicking on the Start activation button you'll be prompted with an application form that you need to fill out to provide information about your business.

All application fields are mandatory. It will take you about 5–10 minutes to complete the form. In case you don’t have all the information at hand, you can always save the application and continue at a later stage.

Make sure that you have the following documents ready to upload during the application process:

  • company registration document (chamber of commerce extract or articles of incorporation)
  • A valid passport or official identity card (not a driver’s license) of the person signing the contract and of shareholders who, directly or indirectly, have 10% or more of the shares or voting rights. (Note that the MRZ code needs to be clearly visible.)

3. If you haven't started the account activation, you will see an orange button that displays the text “Demo mode” at the top of your Merchant Control Panel and asks you to "Add information about your business to activate your account and start selling".

new Control Panel flow_pending merchant_1.png

4. If you are on the PSP business model (2Sell or 2Subscribe accounts), the Start selling steps in the drop-down will look like this:

new Control Panel flow_PSP.png

Fill in the application form

After hitting the Start activation button as described above, you'll need to fill out the activation form in order to be able to sell with us. 

Before you start filling out the form, you'll be prompted with a page that:

  • informs you about your pricing plan
  • states the purpose of the form
  • explains the activation process

new form request activation 1

Once you click Next, you can see all the required info and also how to fill out the form.

About your business

Tell us the basics of your business.

  1. Let us know what is the Trade name of your business. This can be your business registered name or your full name as seen in your National ID if your business is not registered yet. The name of your business will be displayed to your customers during checkout.
  2. Select the Business type for your company from the drop-down list:
    • Individual or Sole proprietorship – your business is unincorporated and you are the only person responsible and liable for all your company’s profit and debts
    • Partnership – your company’s profit and debts are owned and/or shared by two or more individuals
    • Private corporation – your company’s shares are not publicly traded and are held by a small number of stockholders (shareholders)
    • Public corporation – your company’s shares are publicly traded and are held by a large number of stockholders (shareholders)
    • Limited Liability Corporation (LLC)
    • Non-profit – your company serves the public interest and runs charitable activities or is raising funds from the public
    • Other
  3. If you select the business type as Individual, you need to add your personal details (date of birth, ID number as printed on your national identification documents, such as ID-card, passport or residents permit, and your phone number), and your fiscal address details (country, city, address, ZIP/postal code). In the unlikely event that we need to contact you, a phone number is our preferred alternative to email. Verifone will not spam you.
  4. If you select any of the other business types, you need to provide the company registration date (date when your business was established) and the Registered business address (country, city, address, ZIP/postal code). The company address cannot be from a Virtual Box or a P.O. Box.

new form request activation 2

5. Click Next to continue with the Financial details of your business. Verifone needs this information to assess your company financially from a risk standpoint. You need to provide the following details:

  • Company Registration ID
  • Tax registration number – Same with company registration ID in some cases. Depending on your country, the tax registration can have different names (Tax ID in USA, VAT in EU, GST in India, etc.). The Tax or Value Added Tax number (VAT) is issued by the Tax Office at the moment of registration of the business. You can provide your Tax or Employer Identification Number, or, in case you use your Social Security Number for business tax purposes, you can provide that instead.
  • Annual online transacted volumes (in US dollars) – for start-ups with no processing history, we recommend entering $10,000 - $30,000 or less, unless you have some special circumstances around your launch. Otherwise, use your current processing statements as a guide.
  • Average order value (in US dollars)
  • Chargeback rate for the past 12 months and an estimation for the next 12 months

new form request activation 3

6. Click Next to provide details about the Stakeholders. To be compliant with financial regulations and anti-money-laundering laws, 2Checkout is required to know the identity of the individuals who substantially control or own your company.  

Click Add stakeholder to provide details either about yourself and/or about any beneficiary having 10% or more voting rights, shares, or other direct or indirect control in your company.

  • First name
  • Last name
  • Stakeholder type – Owner/Legal representative or both
  • Role – The position/role the stakeholder has within your company.
  • Ownership share – Share percentage that the stakeholder has in the company.
  • Email
  • Phone
  • Country
  • City
  • Address
  • ZIP/Postal code
  • Date of birth
  • National identification number – This is your national identification number and depending on your country it can have different names. This will be used for identity verification and soft credit check that will not affect your credit score.

new form request activation 4

About your products

Tell us more about the products and services you provide. The information you provide will help us to verify and understand what your customers will receive.

You need to add information about:

  • Product or services category
    • Online services – Selling access to online services without physical or digital delivery, either software as a service such as hosting or access to educational content
    • Digital goods/software – Selling digitally deliverable goods, such as software licenses or access to files (such as PDF) downloads
    • Offline services – Offline services such as yoga classes
  • Have you processed online transactions before for this type of business?
  • Product access instruction for review
    • We need access to your product in order to understand what you sell and to test your product for compliance purposes. For most popular product types, access can mean:
      • Username & password (for SaaS products)
      • Download URL + username & password and license key if applicable (for products that can be downloaded)
   Your business must operate within the permitted use of Verifone services outlined in our Acceptable Use Policy.

new form request activation 9

Account settings

Select the payout method you would like Verifone to use for issuing your transfers. These are the possible values:

  • Wire Transfer – requires bank information such as bank name, city, currency, and bank account number
  • PayPal – requires a payout currency and PayPal address
  • Payoneer – requires a payout currency and a Payoneer ID. You can apply for a 2Checkout MasterCard powered by Payoneer right from your Merchant Control Panel.

new form request activation 6

Documents

After saving your account settings you can proceed with uploading the necessary documents to prove your identity and thus, be able to sell with us. For this, you need to upload a a copy for each of the below document types:

   Accepted formats for documents to be uploaded are: .docx, .jpg, .png, .pdf, and .gif (<10MB).
  • Valid government-issued ID – This can ID card, passport. Make sure the uploaded file includes your photo.
  • Valid proof of address – Name, full residential address, and date of issue should appear on the document to be acceptable. Utility bills and bank statements should not be older than 3 months.
  • Business documents
    • Company ownership documents – Certified Certificate of Incorporation or equivalent registration document
    • Tax identification documents – For Europe, TIN, or other relevant documentation, and for the United States, SSN/TIN/PTIN or other relevant documentation.
    • Valid proof of address – This can be an electricity bill or telephone bill that states your name, full residential address, and date of issue. Utility bills and bank statements should be not older than 3 months.

You can also upload any other valid and relevant documents that can prove your identity and offer proof of ownership for your company.

 new form request activation 7

Summary

Once you upload the required documents and before hitting Submit, you can have a look at your application form and update/edit the missing details or modify the incorrect or incomplete information highlighted in red. 

new form request activation 8

Application review process

After filling in your information, you can submit the application for review. If there are any empty fields or missing information, you will not be able to click the Submit button.

Once submitted, Verifone's Underwriting team will review your application and will contact you, in case additional more details are needed or notify you about the resolution.

If additional information is required:

  • You will receive an email notification
  • The first activation step on your Dashboard will display the message “Action required"
  • You can update your request and provide the additional information requested by Verifone's underwriting team by clicking on the Add required information button

new Control Panel flow_awaiting merchant information_3.png

Upon submitting the required information, your Dashboard will clearly display messages that your application is currently "In review", and you can view it by clicking on the View application button.

new Control Panel flow_awaiting UW merchant_4.png

Sign the contract and go live!

By submitting the application for review you will also acknowledge and accept the Terms and Conditions and Services Agreement that will become your binding contract as soon as the application is approved by Verifone's underwriting team.

Once your application is approved, your account is live and can be used for real transactions. Verifone strongly recommends that you test your integration one last time before you publish your buying links and start processing live payments.

Your Dashboard will continue to display sample data until you process your first real transaction.

 

Cross-sell

Overview

Use this object to retrieve information about the cross-sell campaigns you configured for your account. 

Parameters

Parameter Type/Description

MasterProducts

Array

 

Array of product codes for the items you set to trigger the cross-sell campaign.

DisplayType

String

 

  • cart – Shopping cart
  • review – Review page
  • finish – Thank you page

DisplayInEmail

Boolean

 

True or false depending on whether you set the cross-sell campaign to display in payment receipt emails or not.

Products

Array of objects

 

Details below

 

ProductCode

String

 

 

Product code for the item you set as recommended for the cross-sell campaign.

 

Discount

String

 

 

Value of the discount. This is a percentage.

 

DiscountType

String

 

 

PERCENT – you can only set discounts as a percentage from the product price.

  Type String
    Example: Own
  AutoAdded Boolean
  DiscountedPrice Array of objects
    Details below.
                            Currency String
                            Price Float
  BasePrice Array of Objects
                            Currency String
                            Price Float

CampaignCode

String

 

Unique, system-generated cross-sell campaign code.

Name

String

 

Campaign name.

StartDate

String

 

YYYY-MM-DD. The start date you set for the cross-sell campaign.

EndDate

String

 

YYYY-MM-DD. The end date you set for the cross-sell campaign.

CampaignStatus String
  The status of the cross-sell campaign.
CampaignOwnerType String
  Campaign owner type: Can be either MERCH or AFF.

Abandoned cart

Overview

Use the variables in the list below to customize the Abandoned cart shopper email according to your needs. Check the 'Mandatory' column to see the variables required in your customized version of the e-mail.

Variable name Description Test value Mandatory

2CHECKOUT_CITY

2Checkout city

Amsterdam

No

2CHECKOUT_COMPANY_NAME

2Checkout company name

Avangate BV

No

2CHECKOUT_COUNTRY

2Checkout country

Netherlands

No

2CHECKOUT_OPERATIONAL_EMAIL

2Checkout operational email address

support@2checkout.com No

2CHECKOUT_STATE

2Checkout state

0

No

2CHECKOUT_WEBSITE

2Checkout website

https://www.2checkout.com

Yes

2CHECKOUT_ZIP_CODE

2Checkout ZIP code

1075 BD

No

BUSINESS_CITY

2Checkout city

Amsterdam

No

BUSINESS_COMPANY

2Checkout company name

Avangate BV

No

BUSINESS_COUNTRY

2Checkout country

Netherlands

No

BUSINESS_OPEMAIL

2Checkout operational email address

support@2checkout.com

No

BUSINESS_STATE

2Checkout state

0

No

BUSINESS_ZIP

2Checkout ZIP code

1075 BD

No

BUY_NOW_LINK

Short version of renewal buy link (prefilled with shopper information)

https://secure.2checkout.com/order/ch..._ID=xxxxxxxxxx

Yes

BUY_NOW_LINK_RAW

Renewal link prefilled with shopper information (long version)

0

No

DISCOUNT_TYPE

Promotion discount type: percentage or fixed

%

No

ENCRYPTED_MERCHANT_CODE

Encrypted merchant code

0

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

HAPPY_HOURS

Promotion length (hours)

6

No

HAS_PROMOTION

Indicates whether there is a promotion associated to the lead management campaign

1

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

MERCHANT_COMMERCIAL_NAME

Merchant's commercial name

Software Company Name

No

MERCHANT_SUPPORT_PHONE

Merchant support phone number

888-xxx-xxxx

No

ORDER_WEBSITE

Website where the shopper placed the order

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

Yes

PRODUCTS

Products data.

0

No

PRODUCTS[index1].CURRENCY

Currency applied to the abandoned cart

USD

No

PRODUCTS[index1].HAS_PROMOTIONAL_PRICE

Indicates whether the product is included in a lead management discount campaign

0

No

PRODUCTS[index1].NAME

Product name

Test product name7

 

PRODUCTS[index1].PROMOTIONAL_PRICE

Price of the product discounted as per lead management promotion campaign

8.5

No

PRODUCTS[index1].REGULAR_PRICE

Catalog price for the product included in the abandoned cart

10

No

PRODUCTS[index1].SHORT_DESCRIPTION

Short product description

Product short description

No

PRODUCTS_DATA

0

0

No

PRODUCTS_DATA[index1].IdProduct

Product ID number

4605247

No

PRODUCTS_DATA[index1].PRICE_CURRENCY

Currency applied to the abandoned cart

USD

No

PRODUCTS_DATA[index1].PRODUCT_IMAGE

0

box-sz-av.jpg

No

PRODUCTS_DATA[index1].PRODUCT_NAME

0

Test product name7

No

PRODUCTS_DATA[index1].PRODUCT_SHORT_DESCRIPTION

Short product description

Product short description

No

PRODUCTS_DATA[index1].PROMOTIONAL_PRICE

Price of the product discounted as per lead management promotion campaign

8.5

No

PRODUCTS_DATA[index1].REGULAR_PRICE

Catalog price for the product included in the abandoned cart

10

No

PRODUCT_NAME

The name of the renewal product

Test

No

PROMOTION_COUPON

Discount coupon (if applicable)

COUPON

No

PROMOTION_DISCOUNT

Value of the promotional discount associated to the lead management campaign. Use it in conjunction with DISCOUNT_TYPE

7

No

RETRYLINK

Payment retry link

0

 

RETRY_LINK

Payment retry link

0

No

SELLERCOMPANY

Merchant's company name

Software Company Name

No

TECHPHONE

Merchant support phone number

888-xxx-xxxx

No

UNSUBSCRIBE_LINK

Shopper unsubscribe link

https://secure.2checkout.com/order/un...p?q=xxxxxxxxxx

No

UPLOADLINK

File upload link

0

No

UPLOAD_LINK

File upload link

0

No

WEBSITE

Website where the shopper placed the order

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

No

Managing product SKUs

Overview

Stock keeping unit or SKU is a number assigned to a particular product by a digital or physical retail store for easy identification and inventory tracking purposes. The SKU number is a string of alphanumeric characters that uniquely identify details such as price, product options and manufacturer of a particular product or service. SKUs are used in order notifications, electronic delivery, export files, etc.

SKU Manager

Managing product SKUs in the 2Checkout Platform is possible both via the Merchant Control Panel.

For companies managing large product catalogs with defined SKUs and that are making regular changes to their prices and products (new versions, new options), the manual process performed in Merchant Control Panel needs to be supported by an automatic solution as well. By using an automated flow, merchants decrease the time needed for this process, and also reduce the risk of human errors associated with the manual process.

In the 2Checkout platform, SKUs can be associated with a unique combination made up of:

  • Product identification element
  • Pricing configuration
  • Plus minimum one of the following:
    • Currency – defined as applicable to all currencies or only to specific ones
    • Volume Discounts – defined as specific quantity or intervals (applicable only according to the volume discounts that are defined at pricing configuration level)
    • Purchase Types – possible values: new purchase, renewals, upgrade and trial
    • Pricing Options – will be available considering the pricing option groups assigned to selected pricing configuration

SKU Schema

1. To import an SKU schema or to create a new one, go to your Merchant Control Panel and navigate to Dashboard → Setup → Products:

SKU1.png

2. Scroll to the product list and click on the Edit button.

SKU2.png

3. In the 'Edit product - Information' page, click on the SKU Manager link.

SKU3.png

4. In the 'SKU Manager' page, click on the Create tab to import an SKU schema or to add a new one.

SKU4.png

5. To create a new SKU schema, define the combination criteria from the Settings section below. The SKU number is a unique combination of Product ID (Product Code) plus all or one of the following: Currencies/Volume Discounts/Purchase Types/Pricing Options.

  • Click on View/Edit SKU details.
  • Input SKUs manually, then click on Save SKU schema.

SKU5.png

6. To import an SKU schema, export the .csv file, input the SKUs in your system.

SKU6.png

7. Then import back the file and the schema will be saved automatically.

SKU7.png

8. View the SKU schema with pricing (compiled automatically) in the SKU list tab.

The SKU code is recorded on each sale and sent via IPN and in email notifications, and also displayed in the 'View order' page.

Working with SKUs is especially useful when products have complex pricing options, many currencies, etc., or when working with power affiliates/price comparison portals.

Once you have your SKU schema in place, you will be able to modify or export it at any time.

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