Upgrade your Magento 2 integration to Flow
Last updated: January 28, 2026
Follow this guide to upgrade your Magento 2 plugin to Flow.
- Ensure that your WordPress and Magento 2 instances are up to date.
- You need the following Checkout.com API credentials:
- Public key
- Secret key
- Signature key
To upgrade your Magento 2 integration, follow these steps:
- Install the updated plugin.
- Configure the plugin.
- Test your updated integration.
You can install the plugin in the following ways:
- Using Composer
- Using Magento Marketplace
Go to the root directory of your Magento 2 server.
Use the following commands to install the plugin:
composer require checkoutcom/magento2:7.0
You receive a success message confirming the installation of Checkout.com's PHP SDK and plugin.
Recompile your Magento 2 installation and clear the cache before configuring it. Enter the following commands in order:
php bin/magento setup:upgraderm -rf var/cache var/generation/ var/diphp bin/magento setup:di:compilephp bin magento cache:clean
- Install the plugin from Magento Marketplace.
- Follow the installation instructions on the checkout page.
- Sign in to your Magento Admin Panel.
- Go to Stores > Configuration > Sales > Payment Methods.
If successful, Checkout.com appears in the list of payment methods.
- Sign in to your Magento Admin Panel.
- Go to Stores > Configuration > Sales > Payment Methods.
- Find the Checkout.com plugin and select Configure.
In the configuration panel, go to Configuration > Global Settings.
Make sure Environment is set to Test so you can start testing card payments.
Select the Payment Action:
- The Authorize and Capture option means that the charge is authorized and captured (that is, the money due from the customer's account is moved into your account) at the same time.
- The Authorize option only authorizes the charge. You have to capture the payment manually.
If you're unsure, we recommend Authorize and Capture.
- In the configuration panel, go to Configuration > Account Settings.
- Enter your Secret Key and Public Key. When testing, make sure you use the sandbox API keys.
- In the Authorization Header Key field, copy and paste the authorization header key from the Developers > Keys section of your Checkout.com Dashboard.
- Select Set Webhooks to automatically register your webhooks in the Checkout.com Dashboard.
- Select Save Config.
Follow the Magento 2 test instructions and validate that the order updates correctly on your Magento 2 dashboard.
After ensuring that your integration works, you can move your integration to production:
- Switch the Environment to Production in the plugin's settings.
- Replace the sandbox API keys in the plugin's settings with the production API keys.
- Configure the webhook URLs in your live Dashboard account.