Skip to main content

Configuring Adyen as Payment Integration

Adyen option as payment integration is not publicly available (yet), and you should contact our customer success team in order to enable it for your account.

Autohost Adyen Configuration​

Follow the steps below to setup an Adyen Merchant account in Autohost:

The Adyen account can be connected via the Security Deposit configuration in the Autohost Dashboard (if you don't see the Adyen option reach out to our customer success team to configure it to your account):

configuring-adyen

Autohost requires the highlighted (in red) fields to successfully connect to Adyen.

Note: the Live Endpoint URL Prefix field is ONLY required for the production environment.

Merchant Account Name​

To ensure you use the correct Adyen merchant's name, follow the steps below:

  1. Log in to Adyen Customer Area.
  2. Go to Settings > Merchant accounts
  3. The Merchant Account Name is the information on the Account Code
  4. Copy this name and paste it to the Merchant Account Name field in Autohost

API Key​

Autohost uses the API Key to perform authenticated actions on Adyen.

To generate an API key, you must have one of the following user roles in Adyen:

  • Merchant admin role
  • Manage API credentials

To generate your API key:

  1. Log in to Adyen Customer Area.
  2. Go to Developers > API credentials, and select the API credential username for your integration, for example ws@Company.[YourCompanyAccount].
  3. Under Server settings > Authentication select the API key tab.
  4. Select Generate API key.
  5. Select the copy icon and paste your API key in the API Key field in Autohost.
  6. Select Save changes.

💡 When you switch to your live environment, you must generate a new API key in your live Customer Area.

You can find more information here:

API credentials | Adyen Docs

Webhook Configuration + HMAC Key​

Autohost webhook API must be configured correctly in Adyen in order to perform updates on payments originating from the platform, therefore providing a seamless experience for the user.

The HMAC key is used to verify the signature of the webhook information, this will help us to confirm that the webhook was sent by Adyen and was not modified during transmission.

To configure Autohost webhook:

  1. Log in to Adyen Customer Area. To configure webhooks for a merchant account, switch to that merchant account.
  2. Select Developers > Webhooks.
  3. Select + Webhook.
  4. Under Recommended webhooks > Standard webhook select Add.
  5. Select the toggle to make the Standard webhook Enabled.
  6. Select the edit icon for Server configuration.
  7. Enter:
  8. Select Apply.
  9. Under Security > HMAC Key, select the edit icon. Select Generate. Copy the HMAC Key using the copy icon and paste it into the HMAC Key in Autohost. Select Apply.
  10. Select Save changes.
  11. Before closing, click on *Test Configuration, select AUTHORISATION from the list, and click on Test. If the test did not succeed, please reach out to the Autohost team.

For more information on how to setup Webhooks in Adyen, access this link:

Webhooks | Adyen Docs

Client Key​

An Adyen client key is required in order to authenticate and identify the origin of the request from the screens.

Besides the client key, Adyen also requires the configuration of “Allowed Origins” which are domains from which Adyen expects to get client-side requests.

To configure the client key and origin:

  1. Log in to Adyen Customer Area.
  2. Go to Developers > API credentials, and select the credential username for your integration, for example ws@Company.[YourCompanyAccount].
  3. Under Client settings > Authentication select the Client key tab.
  4. Select Generate client key.
  5. Select the copy icon and paste it into the Client Key field in Autohost.
  6. Under Add allowed origins, enter the domains according to the environment you are configuring and select Add.
    1. DEV: https://gueststay.in
    2. PROD: https://verifyhub.org
  7. Select Save changes.

Sub-Merchant ID​

Autohost supports sub-merchant configuration in Adyen, although this field is optional. Add the sub-merchant ID if you have multiple sub-merchants under your account in Adyen, and want the transactions to be marked for a specific sub-merchant.

Live Endpoint URL Prefix​

💡 This field is only required for live (production environment) mode.

Obtain the endpoint URL prefix from your merchant account in Adyen (Live environment) and add it to the Live Endpoint URL Prefix in Autohost dashboard.

Completing the Configuration​

Click on Connect Adyen Account to complete your configuration and connect your Adyen account to Autohost. After connecting, we performed a quick validation with the merchant name and API key provided, and you should see a message confirming that the account is connected if the information provided was validated successfully with Adyen.

Additional Configuration​

In order for Autohost to perform all transaction validation and verification, there are some additional configurations that must be turned on in Adyen.

  1. Log in to Adyen Customer Area.
  2. Go to Developers > Additional Data.
  3. Toggle on the following fields:
    1. Acquirer:
      1. Acquirer result
      2. Raw acquirer result
    2. Card:
      1. Card bin
      2. Issuer Bin
      3. Card bin details
      4. Card summary
      5. Expiry date
    3. Risk:
      1. Fraud result
    4. Payment:
      1. Authorisation amount
      2. Authorisation amount (dynamic zero authorisation)
      3. Recurring details
      4. Merchant reference
      5. Include alias info

Autohost

Talk to Sales