How to integrate Spree Commerce with 2Checkout

Standard Checkout
Process credit cards for your store using 2Checkout's Hosted Checkout.
Inline Checkout
Streamline your payment process by using 2Checkout's Inline Checkout.
Payment API
Recurring Payments
Plugin Required

Spree 0.60.x, 0.70.x – Add the line below to your Gemfile.

Download at: Spree Github

	gem 'spree_two_checkout', :git => "git://", :branch => "0.7.x"


Spree 1.0.x – Add the line below to your Gemfile.

Download at: Spree Github

	gem 'spree_two_checkout', :git => "git://", branch => "1.0"


Spree 2.x – Add the line below to your Gemfile.

Download at: Spree Github

	gem 'spree_two_checkout', :git => "git://"

Spree Commerce Settings:

  1. Run Bundle Install
  2. Sign in to your Spree admin
  3. Under Configuration click Payment Methods
  4. Click New Payment Method
  5. Enter a payment method name and description
  6. Set your environment and select Yes for Active
  7. For Provider select Spree::BillingIntegration::TwoCheckout
  8. Click Create
  9. Server can be “test” or “production”
  10. Check “Test Mode” if you are placing 2Checkout demo sales or leave unchecked for live sales. (It’s really important that you have this set correctly or else the payment will never register and you will get an error on the passback.)
  11. Enter your Sid (2Checkout Account Number)
  12. Enter your Secret Word (Must be the same value entered on your 2Checkout Site Management page.)
  13. Click Update

2Checkout Settings:

In the IntegrationsWebhooks & API section in the cPanel, you will find all the necessary tools to connect your third-party store creators to your 2checkout account. From this centralized integrations section you will be able to:

  1. Set up INS/LCN/IPN (found on other third-party store creators as Global URL)
  2. Have access to your Merchant code (also referred to as Seller ID, Account ID, Merchant ID)
  3. Add Return URL with header redirect or link in Thank you page (also referred to as Return link, Approved URL, Thank you link, Given links back to my website)
  4. Generate an INS secret word (also referred to as Secret word, Secret Key)
  5. Generate private API keys, or use any API information required for your authentication

For more information visit:

About Spree Commerce

Spree is a 100% open source e-commerce platform powered by the popular Ruby on Rails framework. It was designed to make customization and upgrades as simple as possible.

Simplify the eCommerce process. Try 2Checkout.
The most flexible digital commerce platform that can give your business a real boost.