| Verifone Developer Portal

Overview

Update subscription plan/product pricing using the PriceOptionsGroup and the PricingConfiguration objects.

PriceOptionsGroup

Use this object to add/create and edit/update price options for your account.

Parameters				Type/Description
PriceOptionsGroup				Object
Name				String
				Price option group name. Use this parameter when adding a new price options group. To edit the name of a price option group use the Name parameter under the Translations object.
Description				String
				Pricing option group description.
Translations				Array of objects
				Details below.
	Name			String
				Product pricing options group name, localized under Options.
	Description			String
				Product pricing options group description, localized under Options.
	Language			String
				ISO language code. (ISO 639-1 two-letter code).
Code				String
				Unique code that The 2Checkout system generates or set for each pricing options group.
Type				String
				The type of the pricing options group. Possible values: · RADIO · CHECKBOX · INTERVAL · COMBO
Options				Array of objects
				Details below.
	Name			String
				Pricing option child name.
	Description			String
				Pricing option child description.
	Translations			Array of objects
				Details above.
		Name		String
				Localized product pricing options group name under PriceOptionGroup. Localized pricing option child name under Options.
		Description		String
				Localized product pricing options group description under PriceOptionGroup. Localized pricing option child description under Options.
		Language		String
				ISO language code. (ISO 639-1 two-letter code).
	Code			String
				The code you set or that the 2Checkout system generated for each pricing option child inside a pricing options group parent.
	ScaleMin			Int
				The minimum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.
	ScaleMax			Int
				The maximum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.
	SubscriptionImpact			Object
				Details below.
	Months			String
				The value in months the 2Checkout system adds or subtracts from the initial billing cycle of a subscription.
	Impact			String
				Possible values: · ADD · SUBTRACT · LIFETIME
	PriceImpact			Object
				Details below.
		ImpactOn		String
				Possible values: BASE corresponding to impact on base price GLOBAL for impact on calculated sum.
		Impact		String
				Impact on price per unit: ADD SUBTRACT
		Percent		String
				The value of the percentage out of the price per product unit, when you use PERCENT for Method.
		Method		String
				Possible values: · PERCENT · FIXED
		Amounts		Array of objects.
				Details below.
			Currency	String
				Currency ISO code - ISO 4217.
			Amount	String
				The amount defined for each specific currency active for your account, when you use FIXED for Method.
	Default			Boolean
				TRUE for preselected options. Missing for options that are not preselected.
Required				boolean
				True if you made the pricing option group mandatory.

PriceOptionGroup

Use this object to search for, retrieve information on price option groups (including those assigned to specific products) for your account.

Parameters	Type/Description
PriceOptionGroup	Array of objects
Name	String
	Price option group name. Use this parameter when adding a new price options group. To edit the name of a price option group use the Name parameter under the Translations object.
Description	String
	Pricing option group description.
Translations	Array of objects
	Details below.
Code	String
	Unique code that The 2Checkout system generates or set for each pricing options group.
Type	String
	The type of the pricing options group. Possible values: · RADIO · CHECKBOX · INTERVAL · COMBO
Options	Array of PriceOption objects
	Details below.

Parameters	Type/Description
PriceOption	Object
Code	String
	The code you set or that the 2Checkout system generated for each pricing option child inside a pricing options group parent.
ScaleMin	Int
	The minimum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.
ScaleMax	Int
	The maximum value of a scale interval set for each pricing option child inside a pricing options group parent of the type INTERVAL.
SubscriptionImpact	SubscriptionLifetimeImpact object
	Details below.
PriceImpact	Object
	Details below.
Default	Boolean
	TRUE for preselected options. Missing for options that are not preselected.
Name	String
	Pricing option child name.
Description	String
	Pricing option child description.
Translations	Array of objects
	Details below.

Parameters	Type/Description
SubscriptionLifetimeImpact	Object
Months	String
	The value in months the 2Checkout system adds or subtracts from the initial billing cycle of a subscription.
Impact	String
	Possible values: · ADD · SUBTRACT · LIFETIME

Parameters	Type/Description
PriceImpact	Object
ImpactOn	String
	Possible values: BASE corresponding to impact on base price GLOBAL for impact on calculated sum.
Impact	String
	Impact on price per unit: ADD SUBTRACT
Percent	String
	The value of the percentage out of the price per product unit, when you usePERCENT for Method.
Method	String
	Possible values: · PERCENT · FIXED
Amounts	Array of objects.
	Details below.

Parameters	Type/Description
Amount	Object
Currency	String
	Currency ISO code - ISO 4217.
Amount	String
	The amount defined for each specific currency active for your account, when you use FIXED for Method.

Parameters	Type/Description
Translations	Object
Name	String
	Localized product pricing options group name under PriceOptionGroup. Localized pricing option child name under Options.
Description	String
	Localized product pricing options group description underPriceOptionGroup. Localized pricing option child description under Options.
Language	String
	ISO language code. (ISO 639-1 two-letter code).

PricingConfiguration

Use this object to add/create and update/edit pricing configurations for your account. You can assign one or multiple price option groups to pricing configurations.

You identify a pricing configuration using its unique identifier: Code.

Parameters				Type/Description
PricingConfiguration				Object
Name				String
				Pricing configuration name.
Code				String
				System-generated identifier. Read-only.
Default				Boolean
				True for the default pricing configuration
BillingCountries				Array of strings
				ISO codes of the countries assigned to the pricing configuration. Empty unless a pricing configuration has specific countries assigned.
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. Use -1 to delete it.
		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
				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.
			Options	StringArray
				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. Use -1 to delete it.
		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.
PriceOptions				Array of 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 – you set the price options group as required during the purchase process. false - you did not set the price options group as required during the purchase process.

Overview

Use the Product object to create/add, update/edit and retrieve subscription plans/products for your account. You can control:

Product information
Pricing
Subscription plan settings and renewal configuration
Subscription plan recurring billing
Fulfillment
Shipping classes
Localization

Parameters	Type/Description
Product	Object
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.
ProductType	String
	REGULAR or BUNDLE
ProductName	String
	The name of the product
ProductVersion	String
	The product version number
GroupName	String
	The name of the Product Group to which the product belongs
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
	The product's short description
LongDescription	String
	The 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.
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.
	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 puyrchase process.
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: 0 (zero represents a 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.

Overview

Leverage 2Checkout's Monetization Platform to sell in over 200 countries and territories, in over 45 payment methods and 100 billing currencies.

Availability

Online Payment Methods

All online payment methods are available for 2Monetize.

Online payment methods marked with * are available for 2Sell and 2Subscribe in all listed currencies.

Offline Payment Methods

Offline payment methods marked with ** are available for 2Sell and 2Subscribe only in USD, and in all other listed currencies for 2Monetize.

Online Payment Methods

Credit/Debit Cards (With/Without Installments) Payment Methods

Payment method	Availability	Renewal support/recurrent billing	Currencies
Visa*	Worldwide	Yes	All from list
Visa Electron* (debit card)	Worldwide	No	All from list
MasterCard*	Worldwide	Yes	All from list
Maestro*	Worldwide	No	All from list
Eurocard (Mastercard)	Scandinavia, Baltic countries	Yes	EUR
American Express* (credit card)	Worldwide	Yes	USD, EUR, GBP, AUD, CAD, JPY, MXN
Discover/Novus* (credit card)	Worldwide (Primarily issued in USA America, it can be processed worldwide)	Yes	USD
Dankort /VISA (debit card)	Denmark	Yes	EUR, DKK
Bancontact	Belgium	No	EUR
Postepay (Visa)	Italy	Yes	EUR
JCB (Japan Credit Bureau)* (credit card)	Austria, Bahrain, Bangladesh, Bulgaria, China, Germany, Hong Kong, Indonesia, Japan, Lebanon, Mongolia, Pakistan, Philippines, Russia, Singapore, Spain, Taiwan, Thailand, Vietnam, Laos, USA, South Korea	Yes	USD, EUR, JPY
CB/Carte Bancaire (local debit card, formerly Carte Bleue)	France	Yes	EUR
UnionPay	China, Macau, Hong Kong, Singapore, and other markets, mostly in APAC	Yes	CNY/RMB, USD, EUR, GBP, AUD, CAD, CHF, JPY, PLN, SEK, RUB, BRL, ZAR
Local cards in Turkey (Visa/MasterCard)	Turkey	Yes	TRY
Local cards in Brazil (Visa/MasterCard)*	Brazil	Yes	BRL
Local Cards with installments in Turkey (Bonus, World, CardFinans, BankAsya, Paraf, Maximum, Axess)	Turkey	Not in combination with installments.	TRY
Local Cards with installments in Brazil (Elo Card, Hipercard)*	Brazil	Elo Card & Hipercard support recurring billing but not in combination with installments.	BRL
Local cards in India (Visa/MasterCard)*	India	Yes	INR
RuPay	India	Yes	INR

Digital Wallets Payment Methods

Payment method	Availability	Renewal support/recurrent billing	Currencies
PayPal*	Worldwide	Yes	All from list
PayPal Express*	Worldwide	Yes	All from list
Alipay	China, Hong Kong, Taiwan	Yes	CNY, USD
Apple Pay	Check here the list of countries where Apple Pay is available.	Yes	All from list
MobilePay	Denmark	No	DKK
Vipps	Norway	No	NOK
Webmoney	All countries and regions with some exceptions*	No	EUR
WeChat Pay	China, Hong Kong	No	USD, CNY, HKD
Skrill Wallet	Worldwide (except Japan)	Yes	EUR, USD, GBP
Neteller	Worldwide (except Japan)	No	EUR, USD, GBP

*All countries and regions except for the following: Afghanistan, American Samoa, Antarctica, Bangladesh, Bouvet Island, Central African Republic, China, Christmas Island, Cocos (Keeling) Islands, Crimea, Cuba, Donetsk People's Republic (DPR), Equatorial Guinea, Ghana, Guam, Haiti, Heard Island and McDonald Islands, Iran, Iraq, Kosovo, Lebanon, Liberia, Libya, Luhansk People's Republic (LPR), Macau, Micronesia, Myanmar, North Korea, Northern Mariana Islands, Palestine, Pakistan, Puerto Rico, Russia, Sao Tome and Principe, South Sudan, Sudan, Syria, Turkey, U.S. Virgin Islands, United Republic of Tokelau, United States Minor Outlying Islands, Western Sahara.

Online Banking Payment Methods

Payment method	Availability	Renewal support/recurrent billing	Currencies
SOFORT Banking	Germany, Austria, Belgium, Switzerland, The Netherlands	Auto-renewal supported through Direct Debit.	EUR
Giropay	Germany	No	EUR
iDEAL	The Netherlands	Auto-renewal supported through Direct Debit.	EUR
OP-Pohjola	Finland	No	EUR
Nordea	Finland	No	EUR
Danske	Finland	No	EUR
Trustly	Austria, Belgium, Bulgaria, Croatia, Cyprus, Czech Republic, Denmark, Estonia, Finland, Germany, Hungary, Ireland, Italy, Latvia, Lithuania, Netherlands, Poland, Romania, Slovakia, Slovenia, Spain, Sweden, UK.	No	CZK, DKK, EUR, GBP, HUF, PLN, RON, SEK
QR code bank transfer	Czech Republic	No	CZK
Netbanking	India	No	INR

Direct Debit Payment Methods

Payment method	Availability	Renewal support/recurrent billing	Currencies
Direct Debit SEPA	Germany, Austria, Spain, Belgium, France, the Netherlands	Yes	EUR
Direct Debit UK	UK	Yes	GBP
eCheck/ACH	United States of America	Yes	USD

Offline Payment Methods

Payment method	Type	Availability	Renewal support / recurrent billing	Currencies
Wire/Bank transfer - SEPA countries**	bank transfer	Austria, Belgium, Cyprus, Estonia, Finland, France, Germany, Greece, Ireland, Italy, Latvia, Lithuania, Luxembourg, Malta, Netherlands, Portugal, Slovakia, Slovenia, Spain	No	EUR
Wire/Bank Transfer - non-SEPA countries**	bank transfer	Rest of the world	No	USD, EUR, GBP, RON, TRY
Purchase Order	purchase order	Worldwide	No	USD, EUR, GBP, RON, TRY
Boleto/Pix*	cash/online	Brazil	No	BRL

The payment currencies available for Wire/Bank transfer depend on your merchant setup, shopper location, and payment methods. Please check with the Verifone support team on your current settings.

API 4.0

API 3.0

October 2018

Date	Feature/Patch/Bug fix	Type	Documentation
October 9, 2018	We just made it easier for you to create order exports for certain affiliates, by adding a new filter to ISE for affiliate ID.	Feature	Click m e
October 12, 2018	You can now benefit from capture delay capabilities to support your use of the payment delay flow.	Feature	Click me
October 17, 2018	We are constantly adjusting our platform to the latest regulations, so we’ve added a field for the VAT in the invoices issued to shoppers in the UAE market.	Feature	-
October 18, 2018	Your B2B shoppers in Belarus now benefit from a new field in the ConvertPlus shopping cart, as we've added the VAT option that makes them compliant with the latest financial regulations in the country.	Feature	-
October 25, 2018	You can curb cart abandonment by including retry payment links into unfinished payments follow-up emails based on the origin (custom shopping cart, API or ConvertPlus) of the order.	Feature	Click me
October 25, 2018	We’ve added mandatory fields in the shopping cart for B2B orders so that you are compliant with the latest financial regulations of the Turkish government.	Feature	-
October 30, 2018	We want to make your work easier, so we’ve added a new parameter during the ConvertPlus manual renewal process that allows you to add product options and quantity.	Feature	Click me
October 17, 2018	Now you can benefit from a new Webhooks and API section in the cPanel, which will ease the integration of your eCommerce platform to 2Checkout, and will help you activate notifications like IPN, LCN, and INS in one single space with just a few clicks.	Patch	-
October 17, 2018	We’re constantly keeping you up to date with the latest tax regulations, so we’ve added two mandatory fields (GSTIN and District) for B2B orders from India.	Patch	-

Sample Refund 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 can write your own, if you choose so.

Refund Policy

The refund policy explains how you handle returns, refunds, and exchanges. You can display this policy on either the product page or the checkout page of your website. 2Checkout makes every effort to refer refund requests to you, the seller, but reserves the right to issue a refund if necessary.

Though “No Refund” Policies are generally permitted, 2Checkout strongly recommends against this business practice because it often leads to high customer chargebacks. There are certain situations where 2Checkout cannot permit “No Refund” Policies. If this applies to you, 2Checkout will let you know.

Sample Refund Policy (for Goods)

This is a sample that you can use to create/customize the refund policyfor goods to be displayed on your website:

If you are not 100% satisfied with your purchase, you can either return your order for a full refund or exchange it for something else. You can return or exchange your purchase for up to 120 days from the purchase date. Returned or exchanged products must be in the condition you received them and in the original box and/or packaging.

Sample Refund Policy (for Services)

This is a sample that you can use to create/customize the refund policy for services to be displayed on your website:

If you are not 100% satisfied with your purchase, within 120 days from the purchase date, we will fully refund the cost of your order.

January 2021

Date	Release description	Type	Documentation
January 7, 2021	Merchants are now able to search through the available products and bundled products on bundle set-up so that they can easily manage the products to be included in the bundle.	Feature	Click here
January 7, 2021	Created a new upgrade price model supporting the scenario where a shopper would pay a prorated upgrade price calculated using the most recent costs incurred by that customer.	Patch	Click here
January 13, 2021	Merchants selling in Europe can now unlink the customers' credit cards in order to perform a GDPR wipe-off of all their data.	Feature	Click here
January 21, 2021	Extended the 2Pay.js prefill function to also include the expiration date and cardholder name fields prefilled with data existing in the shopper’s browser so that checkout steps are reduced.	Feature	Click here
January 26, 2021	Implemented right to left languages support so that merchants can expand localization capabilities for InLine themes and increase conversion.	Feature	-

API 6.0 Error Codes

Learn how to handle APIv6 error codes.

Promotion

Overview

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

Promotion object

Parameters		Type/Description
CouponCodes		Array of strings
		Array of coupon/voucher codes when Coupon / Voucher type is Multiple. Otherwise, empty array.
ChannelType		String
		Possible values: ECOMMERCE CHANNEL_MANAGER ALL
CouponType		String
		Possible values: SINGLE MULTIPLE
DiscountType		String
		Possible values: FIXED PERCENT
Type		String
		REGULAR GLOBAL SPECIAL_PRICE
PriceMatrix		Array of objects (only for SPECIAL_PRICE type of promotion)
		Is generated by the getPriceMatrix call and used to set promotion special prices.
ProductCode		String
		Code of the product that is used by promotion.
PricingConfigurationCode		String
		Code of pricing configuration used by promotion; must be related to the product.
OptionHash		String
		Unique identifier of one combination of price configuration options.
Options		Array of objects
		Describes price configuration options identified by OptionHash.
GroupName		String
OptionText		String
Prices		Array of objects
		Promotion prices by currency; the price for default currency is required.
Value		Int/Required
		Decimal
Currency		String
		ISO code
Discount		Int
		The value of the discount. Example, for a $30 USD discount 2Checkout returns the value 30 and for a 25% price cut, 2Checkout returns 25.
Products		Array
		Array of product codes for the products impacted by the promotion.
Name		String
		Promotion name.
Description		String
		Promotion description.
StartDate		String
		Starting date. The date when you set the promotion to start. Is NULL for promotions that start immediately after they're created.
EndDate		String
		Ending date. The date when you set the promotion to end. Is NULL for promotions that you want active indefinitely.
MaximumOrdersNumber		Int
		When the maximum number of orders is reached the promotion stops. Can be NULL if you want the promotion to apply to an unlimited number of orders.
MaximumQuantity		Int
		Discount only applies to a specific number of product, smaller than the maximum quantity you defined. Can be NULL if you want the promotion to apply to an unlimited number units. Any extra quantity added to the cart will be sold at full price.
InstantDiscount		Boolean
		Selecting the instant discount option will auto-apply the discount for ALL the selected products for all shoppers, without the need to enter the discount coupon.
Coupon		String
		The promotion/voucher for which you are extracting the information.
DiscountLabel		String
		Discounts can be set as a percentage from the product price or as a fixed amount in the chosen currency.
Enabled		Boolean
		Can be TRUE if promotion is enabled, or FALSE if otherwise.
Currency		String
		Currency code available for the default currency of FIXED promotions. Missing for PERCENT promotions.
DefaultCurrency		String
		Required for SPECIAL_PRICE promotions, represents the default currency of the promotion.
Code		String
		Unique, system-generated identifier 2Checkout associates with promotion campaigns.
PriceThreshold		Object
		Limits discount use only when total order value (taxes included) exceeds the threshold you configure.
	Amount	Decimal
		The minimum threshold you defined for the default currency.
	Currency	String
		Currency code available for the default currency of custom threshold settings.

Overview

PriceOptionsGroup

PriceOptionGroup

PricingConfiguration

Overview

Overview

Availability

Online Payment Methods

Offline Payment Methods

Online Payment Methods

Credit/Debit Cards (With/Without Installments) Payment Methods

Digital Wallets Payment Methods

Online Banking Payment Methods

Direct Debit Payment Methods

Offline Payment Methods

Overview

Refund Policy

Sample Refund Policy (for Goods)

Sample Refund Policy (for Services)

Overview

Promotion object

Need help?

Not yet a Verifone customer?