Accept payments through Adyen via Hyperswitch

This section gives you an overview of how to make payments via Adyen through Hyperswitch

Adyen is a global payments company allowing businesses to accept payments on a global scale. It offers a variety of local and international payment methods. To know about more about payment methods supported by adyen via hyperswitch visit here.

Activating Adyen via Hyperswitch

I. Prerequisites

  1. You need to be registered with Adyen in order to proceed. In case you aren't, you can quickly setup your Adyen account here

  2. You should have a registered Hyperswitch account. You can access your account from the Hyperswitch control center.

  3. Request the Adyen support team to enable handling raw card data for your Adyen account via email ( This will enable Hyperswitch to securely handle your customer's payment details.

  4. The Adyen API key and Account ID are available in your Adyen dashboard under - Home page -> Developers -> API credentials.

  5. Select all the payment methods you wish to use Adyen for. Ensure that this is the same as the ones configured on your Adyen dashboard under Settings -> Payment methods

  6. To set webhooks, Navigate to the webhooks section of your Adyen dashboard (Developers -> Webhooks) and create a new standard webhook. Know more about webhook source verification key here.

Steps to activate Adyen on Hyperswitch control center.

II. Points to remember

  1. For Klarna, fields that are mandatory/recommended to improve the customer experience and conversion rates.

    • email,

    • billing.first_name,

    • billing.last_name,



    • billing.line1,

    • billing.line2,


    • order_details

  2. For Klarna, customer_id is also a required field for which you have to create a customer using Hyperswitch - Create Customer.

  3. Supported Country-Currency matrix

    Payment MethodCountryCurrency

    Credit/Debit Cards

    All enabled on your adyen account

    All enabled on your adyen account






    All enabled on your adyen account













  • If your desired country-currency combination is not listed here, please reach out to Hyperswitch Support to get it enabled.

  1. (Special Note): For Klarna and Paypal, In Adyen Sandbox environment, Automaitc Capture is not working as intended. All the payments are required to be explicitly captured, and then only refunds are processing. This might be an account configuration issue from Adyen, there is no detected bugs/issues from Hyperswitch's end. If the same behvaiour persists on production please reach out to your Adyen Support or reach out to Hyperswitch Support to stop Automatic Captures for the same.

  2. (Special Note): For Sofort, Adyen has discontinued support for Sofort as payment method, Hyperswitch provides the integration of sofort via adyen but it is subject to availabilty by adyen on your account. Some or all features might not work if adyen has not enable it for you. Please contact Adyen support to resolve the same.

Last updated