📍 Bolt Help / Third-Party Connectors / Payment Processors / Set Up Bolt for Adyen

Set Up Bolt for Adyen

See Set Up Bolt One-Click for BigCommerce for instructions specific to this platform.


Your Adyen account must be able to accept raw PAN information in order to integrate with Bolt. To accept raw PAN information, the Webservice User that is used for Bolt needs to have the API PCI Payments Role enabled. Please reach out to your Adyen representative to enable this role. (Learn more)

How to Integrate with Adyen

1. Obtain Adyen Keys

Key Example Where to Find It
Adyen Merchant Account Code/ID 129413 From your Adyen account:
  1. Go to Settings.
  2. Find Merchant accounts.
  3. Find your Account code/ID, then copy and paste the string into the required Bolt Set Up field.
Live URL Prefix
  • Example endpoint: https://e73e0f17d7bd00d7-BoltFinancial-checkout-live.adyenpayments.com/checkout/v1/payments
  • Example Live URL Prefix: e73e0f17d7bd00d7-BoltFinancial
From your Adyen account:
  1. Go to Developers.
  2. Go to API URLs and copy the Live URL prefix from one of the endpoints.
Adyen Webservice API Key 324fi2dg332d4r9f2hn1en23fc9c3ni9 From your Adyen account:
  1. Go to Developers, then API credentials, and select the credential username “Bolt” for your integration. If you don’t already have one, you should create a Web Service User credential.
  2. After you click on the credential you want to use, you should be taken to the Configure API Credential Page.
  3. Go to the Authentication section, under Server Settings, and select Generate New API Key.
  4. Select Save changes at the bottom of the page, then copy and paste paste the string into the required Bolt Set Up field.

2. Add Keys and Edit Payment Settings

  1. Log into the Bolt Merchant Dashboard.
  2. Navigate to Settings > Payments.
  3. Click Set Up Adyen.
  4. Add the following account keys:
    • Merchant Account Code
    • Adyen Webservice API-Key
  5. Click Next.
  6. Edit the default payment settings to customize how processing works.
  7. Click Complete Setup.


If you are using Bolt fraud and autocapture, you must leave your Adyen captures set to MANUAL CAPTURE. Bolt will authorize the order, then run it through the Bolt fraud review process, before capturing the order in Adyen.

You have now successfully linked Bolt to your Adyen account.

3. Set up Webhooks

Webhooks keep your systems in sync, allowing Bolt and Adyen to easily exchange data about transaction events and disputes. Failure to set up webhooks will result in discrepancies between your systems.

  1. Log into the Adyen Customer Area.
  2. Refer to Adyen’s Notification Webhooks article to set up standard webhooks. Enter the following:
    • URL: In the Bolt Merchant Dashboard, navigate to Settings > Payments > Manage Adyen and copy the Bolt webhook URL.
  3. For production environments: In Bolt Merchant Dashboard > Payment Settings > Adyen, enter the Live URL Prefix.
    • • You can find this value in your Adyen Customer Area: Developers > API URLs.
    • Example Live URL Prefix: e73e0f17d7bd00d7-BoltFinancial
  4. Generate an Adyen HMACKey using this Adyen guide.
  5. Save and test using Adyen’s Notification Webhooks article.

4. Enable AVS Response Mapping

  1. Go to the Adyen Customer Area.
  2. Navigate to Developers > API URLs > Additional data settings.
  3. Find the Acquirer section and select the following checkboxes:
    • Raw acquirer result
    • Acquirer result

5. Configure Adyen Risk Settings

For payments made with a card saved to a shopper’s account, Bolt does not transmit CVV match data to processors. To configure risk settings so the lack of this data does not trigger auto-declines:

  1. Go to the Adyen Customer Area.
  2. Navigate to Risk > Risk profiles and select a risk profile.
  3. Find the Risk Rules section.
  4. Use Adyen’s guide on consistency rules to set the card verification code match rule to The code doesn’t match.

With Fraud Protection

Bolt’s fraud detection engine uses advanced risk signals to protect your business from fraud. Since Bolt checkout doesn’t require shoppers to enter a billing address, Address Verification System (AVS) mismatch settings often trigger automatic declines on transactions from real shoppers with an otherwise low risk score.

Use the Adyen guide on AVS settings to allow all transactions where the shipping and billing address do not match.

Without Fraud Protection

Contact your fraud solutions provider to inform them that payments transmitted via this processor will not provide CVV match information.

6. Set Up Chargeback Notifications

Set up your communication preferences in Adyen to receive digital notifications for new chargebacks. This ensures that you have enough time to submit the dispute and respond with evidence.

Optional Setup

Real Time Account Updater

Use the Real Time Account Updater to instantly check with Visa and Mastercard for the most up-to-date card details whenever shoppers submit a payment that gets refused. If updated payment details exist for that shopper, Adyen retries the payment using the updated card details while the payment is still being processed (meaning it is experienced as one single transaction).

  1. Reach out to your Adyen representative and express your interest in enabling this feature.
  2. Confirm with Adyen that they are using the correct RSA public key for credit card JSON Web Encryption (JWE).
  3. Request that Real Time Account Updater (RTAU) be enabled on your account.
  4. Follow the setup steps found in Adyen’s RTAU setup guide.
  5. Submit a request to your Bolt CSM to confirm setup was successful.

Chargeback Handling


See Adyen’s test card documentation to test your setup in sandbox or staging.

📖On This Page
Filter by Section
Filter by Topic