You're viewing documentation for our latest API. This will not impact your integration, but you will need the documentation relevant to you. If you have an account with Checkout.com you have received an email confirming which version to use.
Unsure which version you need? Contact Support
Find information on how to integrate, configure, and troubleshoot ecommerce platforms.
Our plugin is built following Magento's standards. So, if the One Step Checkout plugin you use follows the standards as well, they should be compatible. If you’re having an issue, contact the support team for the plugin you use. If after that you’re still having issues, email our Support team at [email protected].
Apple Pay only works on Safari on compatible Apple devices. Also, make sure you have a card configured in your Apple Pay wallet.
If you want to use alternative payment methods, we first need to enable them on your account. To get this done, either contact your Account Manager or email our Support team at [email protected]. Also, some local payment methods only work in certain currencies, so they won't be displayed if you use a different currency in your store. For example, for Sofort, you need to use EUR to see it as a payment option on your checkout page.
The plugin depends on our PHP software development kit (SDK). Make sure you use composer to install the plugin, so it can also install the SDK.
To get the necessary merchant ID and certificates, create an Apple Developer account and then follow the Apple Pay set up guide.
A likely fix for this issue is to enter the following CLI commands into your terminal:
bin/magento setup:upgrade && bin/magento setup:di:compile
To ensure your payments work in the live environment, follow the checklist below when moving from sandbox to live:
This is likely because Checkout.com has not been set as the default payment method. Set Checkout.com as the default method and see if the issue persists.
Your API keys may be incorrect, or you may be in the wrong environment. Check that your API keys (public, secret and private shared keys) are correct, and that you are using the right environment (sandbox or live/production).
If a transaction is stuck with a 'pending' status after the transaction is completed, first check that your API keys (private, public and private shared keys) are correct, and then that your webhooks are configured correctly. If they are, check that you have selected the correct API version (v2.0) for your webhooks, and that (if you have it set) auto capture/capture delay is set to at least 0.02.
To download our plugin:
Our extension is compatible with Salesforce Commerce Cloud version 16.2 and later.
For Salesforce Commerce Cloud, we need to enable the full API at our end. To get this done, either contact your Account Manager or email our Support team at [email protected].
If you use our onsite Shopify integration and want to use 3DS authentication, Shopify requires you to use Cardinal Commerce as a third-party 3DS provider.
If you use the offsite Shopify integration, we can activate 3DS for you for all your transactions, or you can enable risk rules that only trigger 3DS for certain cases. For help with this, either contact your Account Manager or email our Support team at [email protected].
By default, our plugin does not offer this functionality. However, as we follow Shopify’s standards, you may be able to use third-party plugins to achieve this with our onsite integration.
You can accept alternative payment methods through our offsite integration. Our integration supports the following: Boleto, iDEAL, Sofort, and PayPal.
Shopify limits third-party payment providers from offering features like Apple Pay and Google Pay, so you can't use them with our plugin. However, if you are using Shopify Plus, you can build the integration with us and add Apple Pay and Google Pay. You will need a Shopify developer to set this up.
These cannot be enabled. Our onsite Shopify integration does not support three-digit currencies.
Mada cards are only supported on our offsite Shopify integration. If you want to accept Mada cards, you will need to contact your Account Manager or else email our Support team at [email protected] so we can enforce 3DS authentication (which is required for all Mada card payments). You will also need a Mada-capable payment processor to process Mada cards locally.
You either used a card scheme that is not enabled for your account, or a currency that is not enabled on your account. For help with this, either contact your Account Manager or email our Support team at [email protected].
You are using our onsite Shopify integration, for it to work we need to enable it at our end. To do this, either contact your Account Manager or email our Support team at [email protected].
For the offsite integration, you need to configure the following URLs and webhooks in the Dashboard account. Go to Settings > Channels to set them up. When setting up the webhook URL, select API - v1.0.
For the sandbox environment:
For the live environment:
For plugin versions 4.0 or later, you need to set the following URLs in your Dashboard account (replacing 'example.com' with your site’s URL):
Your API keys may be incorrect or you may be in the wrong environment. Check that your API keys (public, secret, and private shared keys) are correct and that you are in the right environment (sandbox or production/live).
You need plugin version 4.1.12 or later for this functionality. Either download the latest version from the WordPress Plugin Directory, or else download it as a .zip file from GitHub.
Also, make sure that you've deactivated or deleted any previous versions of the plugin you may have installed.
You can refund a payment either through your ecommerce platform or via the Dashboard.
Learn more about refunding payments.