Adyen is one of the most popular enterprise-grade online payment processing platforms for e-commerce. It helps merchants to accept π³ credit and debit card payments (Visa, Mastercard, Maestro, American Express, Discover and Diners, China UnionPay, JCB, Cartes Bancaires, Interac, etc.) as well as hundreds of local and alternative payment methods.
It is possible to enable payments via third-party payment services as iDEAL, Sofort, SEPA Direct Debit, Afterpay and etc. For more info about this payment provider and the payment methods this integration unlocks please visit https://docs.adyen.com/payment-methods.
In this article:
1. Pre-connection checklist
To enable Adyen as a payment gateway on your store, you must have an Adyen live account. If you do not have one, please read their Get started with Adyen.
Also note that the minimal transaction you can have on Adyen is (equivalent to) β¬0.02.
ATTENTION: Most of the payment methods require presence of shipping (details) fields. Therefore, if you are customizing the checkout's address form, keep in mind that some methods may stop working correctly because of that. Please monitor this case. If a payment method stopped working after introducing a custom shipping form for your checkout, deactivate such a method in your Adyen account or roll back to the initial version of the address form.
2. Setting up Adyen on Checkify's checkout
Visit admin > Payment methods to get started. Keep this page open in a tab.
2.1 Find your merchant account name, set up payment methods
Log in to your live Customer Area on Adyen. You can use your existing live merchant account or request a new one.
In the top left corner of the screen, you may find your merchant account name.
Copy-paste it into the appropriate field of admin.checkify > Payment methods > Adyen.
βIn your Adyen merchant account, visit Settings > Payment methods to view and select the payment methods for your Checkify - Adyen integration.
β
You can add more payment methods at any time.
2.2 Generate your API key, Client key (or use the existing) and get your API URL Prefix
Log in to your live Customer Area.
In the left column, find Developers > API credentials. Press "+ Create new credential" button.
βKeep "Web service user" as selected by default. Give an optional description, then confirm your action by pressing "Create credential" button.
βUnder Server settings > Authentication select the API key tab.
Press Generate API key button.
βSelect the copy icon and paste the key to admin Checkify > Payment methods > Adyen into the corresponding field.
Then scroll down in the same window and find Client settings > Authentication. From this section, copy your generated Client key.
β
Then paste it to Checkify into the corresponding field.Press Save changes button in your Adyen live account.
9. Proceed to Developers > API URLs > Prefix and get your Prefix:
10. Copy your prefix and paste it to Checkify into the corresponding field.
11. Once all the four fields are completed, click Connect + button to enable Adyen.
2.3 Set up terms & conditions and email
You need to configure terms & conditions in your Adyen account settings for the specific account/entity used with Checkify before the full scale launch.
Please guide them with these steps:
Log in to the Adyen Customer Area.
In the left navigation bar, go to Pay by Link > Settings.
Find the field labeled Terms and conditions URL.
Press "+Add"
Paste the link to the Terms & Conditions (terms of service) page of your store.
βAgree to the requirements and click Accept.
On the same page, add your merchant email into the appropriate field for greater transparency and compliance.
β
Once this is saved, the checkout redirection, whenever is required, should work instantly.
2.4 Additional options
When adding Adyen as a payment method on Checkify, you will also able to configure additional options:
i. Target countries
You can select specific countries or regions for which this payment method will be displayed.
ii. Hide / reveal card payments option on the checkout page.
You can visit admin.checkify > Payment methods section > Settings tab and disable displaying of the card payments form on the checkout page. If hidden, your buyers will still get the option of paying using alternative payment methods.
iii. Risk management
You can adjust your risk tolerance in Adyen > Settings > Risk (Protect).
Please note that completely disabling Adyen's risk engine may result in a higher chargeback rate. Conversely, if your business is experiencing a high number of blocked legitimate transactions, you should fine-tune your settings to be less aggressive.
Risk profiles are specific to each merchant account. The account connected to Checkify Pro can have its own unique set of policies, independent of other merchant accounts within your organization.
iv. Branding
You can further work on design and brand consistency of your payment step on Adyen-hosted pages by creating a themein Adyen > Pay by Link > Themes.
Give your theme an internal name, add the display name. Apply the design settings. And then press "Create" button.
Once saved and applied, your non-Shopify and non-Checkify pages will be consistent with the whole branding, cementing trust and improving conversions.
3. How Adyen will work on your checkout
3.1 Direct transfer of payment data
Our integration allows secure transfer of the customer's payment data directly to Adyen while using a unique design of the payment info section. The payment data fields are loaded directly from Adyenβs servers. It means that Checkify does not handle or has any access to your customers' card data.
β
You may visit our Demo store, proceed to the checkout and have a look at the example of the setup in the Payment block.
3.2 3D Secure payment protection
Adyen leverages its own 3DS Engine by default, which means that all payments are fraud-protected and compliant with the European Directives. The 3D Secure screen is shown only when requested by the bank of a customer.
3.3 Redirect and non-redirect payment methods
Adyenβs payment methods operate on the Checkify-hosted checkout page (non-redirect), or via a redirect flow. In case of the latter, the buyer leaves the checkout page, completes the transaction on the provider's site before receiving the confirmation.
Instant confirmation: If the payment is successful immediately, Checkify redirects the buyer back to its thank you (order confirmation) page. It is typical for card payments.
Delayed confirmation: If the payment gateway requires extra time to process confirmation signals, the buyer will not be automatically redirected to Checkify's confirmation page. Once Adyen displays a success message, the buyer can manually return to the merchant or leave the page. They will receive their order confirmation email a bit later, once the payment is fully verified.
The Check order status button verifies if the order confirmation page is available.
If available: The buyer is automatically redirected to the order confirmation (thank you) page by Checkify.
If pending: The system returns an 'Awaiting payment confirmation' message.
The texts related to Adyen on Checkify can be edited, customized and translated (manually) in the Localization section of the admin.
All payment methods initially perform a pre-authorization of the payment sum and then, upon a successful charge on the bank's side, Adyen changes the status of the payment to either Failed or Success. In such cases payment processing may take from couple of minutes to seven days. It is being managed by Adyen and Checkify has no influence on it, and has no ability to speed it up. You can track the status of such orders in your Shopify admin. It is not recommended to ship an order to your customer when "Payment pending" status is seen. When the payment status changes to "Paid", feel free to dispatch the order:
Example of Payment pending situation. It is better to wait for the status to change
Once the processing by Adyen is over, the status on Shopify changes automatically to either Paid or Void (if Adyen returned a Failed status):
Example of Paid status in Shopify order
Example of Void (=failed and unsuccessful) status in Shopify order
4. Supported currencies and languages
Adyen currently supports about 144 currencies. You can charge customers in one of them. The full list is available in their technical documentation on their website.
If the checkout currency is not one of them, the Adyen integration will not work. This is not a limitation for your buyers, whose cards may still be in any other currency, even those outside the list of supported ones.
The Adyen-hosted payment page can be presented in close to 30 different languages. It is fewer than the total on Checkify. If the checkout page is in a language not supported by the payment provider, then its post-redirect payment elements will appear in English. Once the buyer completes the purchase, the order confirmation (thank you) page by Checkify will be displayed in their native language again.
5. Resolving common issues
π Adyen is not connected, and I get "No terms and conditions were added" error. What to do?
For "Other methods" to work, you must add your store's terms & conditions URL in the Pay by Link settings of your Adyen admin. Adyen must contain links to terms (legal docs, policies) on their hosted pages. Here, in item 2.3 of this article, we explain more.
β
π Adyen is connected properly. There is nothing in my "Payment methods" block on your checkout
If you open browser's console at the checkout page and see responses (errors in red) like this Access to fetch at ββ¦β has been blocked by CORS policy: Response to preflight request doesn't pass access control check: β¦ Failed to load resource: net::ERR_FAILED, please do the following:
Add allowed origin (your store's domain) manually to your Adyen account.
Visit Developers > API credentials, the section where you got your API credential. Scroll down this page to reach βAdd allowed originsβ (domains) field (bellow Client Key).
See the screenshot below:
π Payment pending status is for too long and it is not changing.
In case the statuses of completed orders remain pending, please visit Adyen admin and check Webhook event logs. If you encounter some failed statuses, press "Retry" as shown in the screenshot.
This operation is generally automated and there is very low probability that such manual actions may be required. But still, it is good to know and to check.
β
π My Adyen account is used elsewhere, would it be a problem?
It is a pretty common situation when an Adyen account is used in various places / businesses. We recommend to create a separate merchant account. Add "checkify" to its name in Adyen in order to see transactions only related to our checkout. Otherwise, there is a risk of accumulating a mixture of transactions. When exploring webhooks you will also encounter a mix of those related and unrelated to Checkify's operation.





















