Skip to main content

February 2021

Date

Release description

Type

Documentation

February 2, 2021 Optimized the Merchant Control Panel search experience so that merchants don’t have to scroll down anymore in order to see all the search results. Feature

Click here

February 8, 2021 Merchants can now create and delete upsell campaigns via API so that they are able to synchronize their systems easier. Feature
February 9, 2021 Added Lithuanian, Latvian and Estonian languages to the shopping cart frontend and shopping cart API to improve the user experience for the Baltic countries and help merchants selling in this region increase their conversion rates. Feature

-

February 9, 2021 Via getDealInfo API method, merchants can now retrieve details of existing subscriptions while requesting a simulation of an upgrade price considering custom details. Calculation of the upgrade price and the prorated amount is done by considering also the taxes applicable for the specific transaction. Feature Click here
February 21, 2021 Added documentation for API 6.0 error handling for the placeOrder call. Patch Click here
February 23, 2021 Added support for order promotions for catalog products in ConvertPlus so that merchants can offer order discounts also, not only product level discounts, as supported currently via regular promotions and special price promotions. Feature Click here
February 25, 2021 Merchants can now receive the product pricing options selected on a license in the LCN payload. Feature Click here
February 26, 2021 Increased platform security by enabling merchants to use 2-factor authentication when changing sensitive data within the Merchant Control Panel on the IP tools page. Patch Click here

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.”

 

 

November 2020

Date

Release description

Type

Documentation

November 3, 2020 Updated API 6.0 to support pricing options type scale pay-per-usage. Feature Click me
November 5, 2020 We’ve updated the API 6.0 documentation to include support for CancelURL. Patch

Click me

November 9, 2020 Added Settled (reconciliation) date to Order search in the Merchant Control Panel, so that orders can be searched based on settled date (reconciliation date) and merchants will have a new way of filtering the order information. Feature -
November 10, 2020 Added information about the latest change in Renewal type (from automatic to manual and vice-versa) to the Subscription Export CSV from the Merchant Control Panel. This helps merchants identify when voluntary churn occurs and allows them to take action to fight it. Feature -
November 10, 2020

We’ve updated the setPromotionDiscount API call to support type Global as well.

Patch Click me
November 11, 2020 Implemented special price promotions via API, so that merchants are able to add special price promotions and thus increase customer retention. Feature

Click me

Click me

November 17, 2020 Merchants can now process SOFORT payments via API 6.0. Feature

Click me

Click me

November 26, 2020 We’ve optimized the myAccount interface by adding a few changes to the dashboard, orders listing, manage password page, GDPR cookies, so that shoppers benefit from an updated and enhanced platform navigation Feature -

November 2018

Date

Feature/Patch

Type

Documentation

November 15, 2018 Increase the security of your shopping cart details by adding a new ConvertPlus buy-link parameter for dynamic products. This parameter passes information on the product options. Patch Click me
November 15, 2018 We've added a new parameter ("order-ext-ref") for the Inline Cart template that helps you track your shoppers' orders. This parameter is optional in the buy-link. Patch Click me
November 16, 2018 As we are constantly improving our processes, new vendors now benefit from a smooth and seamless onboarding process where they are redirected to their new Control Panel accounts right from sign-up. Feature Click me
November 19, 2018 You can now benefit from a new ConvertPlus feature that allows you to save the association between the order reference and the shopping cart template so that for manual renewal and/or unfinished payments your shoppers' experience will be recreated. Feature Click me
November 19, 2018 You can now use the ConvertPlus unfinished payments leads to address your customers via Leads Management. Feature Click me
November 19, 2018 Merchants on the PSP business model can now sign an electronic agreement during their onboarding process. Feature -
November 20, 2018 We’ve implemented the authentication between the website and merchant API that will increase communication security between website and platform backend through merchant API. Patch -
November 20, 2018 We’ve added a ‘request activation button’ in the Control Panel sidebar for new sign-ups to further ease their onboarding process. Patch -
November 28, 2018 Have better and more effective control over your affiliate network and affiliate commissions with an additional URL parameter. If you add this parameter to the buy-link when the order is placed, the Avangate Affiliate cookie will be ignored and the order will be processed and reported as a vendor sale. Feature -
November 28, 2018 Merchants can now restrict their shoppers from changing the product options and quantity in ConvertPlus in case of custom manual renewal for better control over shopping actions. Feature -
November 30, 2018 We implemented the Print Package Slip functionality so that PSP merchants can offer a customized experience to their shoppers. Feature -

December 2020

Date

Release description

Type

Documentation

December 17, 2020 Added the UpSellSettings object to update the merchant's displayType via the 2Checkout API. Merchants can use displayType to extract or update information for upselling display type for their campaigns. Feature

Click here

 

Click here

December 17, 2020 We've further expanded the CPQ capabilities by adding several API enhancements: added subscriptionReference in Proposal object, added support for TaxExemptionId, included VATCode to the SellTo object, included proration date in the LineItem object. Feature

Click here

 

Click here

 

Click here

December 18, 2020 European merchants on the PSP business model with the Payout at cashed date option enabled can now search for orders using the Settled Date filter in their Merchant Control Panel, thus increasing their information accuracy. Feature Click here
December 18, 2020 Merchants can now filter their subscriptions by partnerCode so that they can better manage their partnership program. Patch Click here
December 22, 2020 Merchants using the 2Checkout API are now able to create and assign PAYPERUSE price options to their portfolio. Feature

Click here

 

Click here

 

Click here

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.

 

IsBackupMedia 

Boolean

 

 

True or False. Depending on whether you configure the delivery of backup media 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

 

BackupMedia 

Object (can be NULL)

 

 

Details below.

 

Code 

String

 

 

The unique backup media identifier.

 

Name 

String

 

 

Name of the backup CD/DVD.

 

Type 

String

 

 

Media type: CD

 

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.

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