Skip to main content

2Checkout API upgrade guide

Note to userOn April 3rd, 2017, Avangate, an eCommerce and subscription billing platform, has announced its acquisition of 2Checkout, a global payment processor. As part of the acquisition process, existing 2Checkout clients have been upgraded to a new Control Panel that combines the industry’s most comprehensive product and service suite in the subscription billing and eCommerce space.


Use this guide to prepare and migrate your 2Checkout API implementation to our newest version. This document features deprecations, updates and enhancements, providing guidance on how to upgrade your implementation to the latest version of the 2Checkout API. 

Also, you can still access older versions of the 2Checkout API documentation here.

New authentication flow

 To use the latest 2Checkout API version, you need to update your authentication process. The parameters included in the authentication flow are displayed below.

Parameters Type/Description
merchantCode Required (String)
  Your merchant identification code. Can be found in your Admin Area, in the System Setting section.
date Required (String)
  GMT ISO Date format (e.g. 2010-01-01 12:13:14)
hash Required (Object)
  Calculated HMAC_MD5 signature based on merchantCode and date, using your secret key. Your secret key can be found in your System settings area.

API protocols

The latest 2Checkout version (API 5.0) is available via 3 API protocols: JSON-RPC, SOAP and REST. Check below the authentication method for each of them.

login login login

 2Checkout API methods status

2Checkout legacy method Status 2Checkout new API method
detail_sale  Updated. Use: getOrder
list_sales  Updated. Use: Instant Search Order Export
refund_invoice  Updated. Use: Instant Refund
refund_lineitem  Updated. Use: Instant Refund
stop_lineitem_recurring  Updated. Use: disableRecurringBilling 
reauth  Deprecated N/A
mark_shipped  Deprecated N/A
create_comment  Updated. Use: addSubscriptionAdditionalInformationField 
list_products  Updated. Use: searchProducts 
detail_product  Updated. Use: getProductById 
create_product  Updated. Use: addProduct 
update_product  Updated. Use: updateProduct
delete_product  Deprecated N/A
list_options  Updated. Use: getAssignedPriceOptionGroups 
detail_option  Updated. Use: getPriceOptionGroup 
create_option  Updated. Use: addPriceOptionGroup 
update_option  Updated. Use: updatePriceOptionGroup 
delete_option  Deprecated N/A
list_coupons  Updated, but for promotions. Use: searchPromotions 
detail_coupon  Updated, but for promotions. Use: getPromotion 
update_coupon  Updated. Use: updatePromotionCoupon 
delete_coupon  Updated. Use: deletePromotionCoupon 
detail_company_info  Deprecated N/A
detail_contact_info Deprecated N/A
detail_pending_payment  Updated. Use: getOrder
list_payments  Deprecated N/A


  • Was this article helpful?