![]() |
Not Supported in European Union (EU) This Payment Provider will no longer be supported by Checkfront for accounts in the European Union (EU) once PSD2/SCA is enforced on September 14, 2019. |
If you've created your 2Checkout account recently, you may notice a fresh new look in 2Checkout's UI! Not to worry, all of your settings are still available they just have new homes. Please follow this guide on how to connect Checkfront to 2Checkout with their new layout.
2Checkout is in the middle of updating their UI and as a result, there may be discrepancies between this article and the UI. If you experience any problems, please contact support and we will update this article as soon as possible.
Setup in 2Checkout
Back to topBefore enabling 2Checkout, there are a couple of things that need to be done in your account. Login to your 2Checkout account, and navigate to Integrations > Webhooks & API.

In this section, there are various settings you will need to set up in order to get 2Checkout ready to process your transactions.
Scroll down and you will find the Redirect URL section. Into the Approved URL section type in https://YOURACCOUNT.checkfront.com/notify/2checkout/ where "YOURACCOUNT" is replaced with the beginning to your account URL. Then set the Return Method to Header Redirect and click Update.
Now that you have 2Checkout configured, scroll up to the API section and copy your Merchant Code, your Publishable Key, and your Private Key to your clipboard.
Scroll back down to the Secret Word section. Instead of creating a secret word, you will be provided with one. Click the eye icon to view the secret word and copy it into your clipboard as well. You can also edit the secret word or generate a new one. If you do so please make sure you update your settings in Checkfront.
Once you have everything copied, you can return to your Checkfront account and continue setting up your Payment Provider!
Setup in Checkfront
Back to topTo enabled the 2Checkout extension login to your Checkfront account, and navigate to the Manage > E-Commerce screen. From there you will see a list of available payment modules. Select the 2Checkout tile and supply the required credentials:
• 2CO Account #: Your 2Checkout Merchant Code.
• 2CO Secret Word: The secret word as set up in your 2Checkout account (not your password)
• API Username & Password: If you wish to process refunds directly through Checkfront, you must have an account at 2Checkout with API access. Enter the login details here.
• Payment API Public & Private Keys: These are your Publishable and Private API keys, as collected above.
• Enable Demo Mode: Enable demo transactions for testing.
• Checkout Mode: To use the inline payment form within Checkfront, select Payment API. Direct Checkout will redirect your users to 2Checkout to make their payment, while Dynamic Checkout will display the form in a pop-up window.
The most reliable and consistent method is Payment API and we recommend you choose this as your setting. Make sure you have enabled payment processing and set up any appropriate taxes and e-commerce settings under in the Manage / E-Commerce section of Checkfront.
Demo Mode
Back to topIt's highly recommended that you do an end-to-end test of your checkout before putting your site live. To do so, follow the setup instructions above and check "Demo mode". Create a transaction as a customer and check to see that it shows up in your Checkfront account as paid and within 2Checkout. If you don't have a website to test on yet, use the hosted booking page (eg: https://your_account.checkfront.com/reserve/) to test. * Always remember to take your account out of test mode when you are finished.
Notes
Back to top2Checkout is a hosted payment processor. The customer is sent from the booking invoice to the 2Checkout payment page, and then back to Checkfront for the booking receipt. There is no support for virtual terminal payments. For more information please see www.2checkout.com.