---

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

---

Prerequisites

Accept Raw PAN Information

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 about API PCI Payments

Capture Type

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

How to Integrate with Adyen

Step 1: 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.
   • • In URL, you’ll enter the Bolt webhook URL. To find this, log into the Bolt Merchant Dashboard, then navigate to Settings > Payments > Manage Adyen and copy the Bolt webhook URL.
3. Save and test using Adyen’s Notification Webhooks article.

Step 2: Obtain Adyen Keys

To connect Adyen, retrieve these credentials from your existing Adyen account.

Credential	Description	Example	Where to Find It
Adyen Merchant Account Code	A unique identifier for your Adyen account.	129413	From your Adyen account: Go to Settings. Find Merchant accounts. Find your account code, then copy the string for use in a later step.
Adyen Webservice API Key	A string created specifically for use with Bolt that allows connection between the Bolt and Adyen APIs.	324f...3ni9	From your Adyen account: Go to Developers, then API credentials, and select the web service credential that has a description of Bolt. If you don’t already have an API credential for Bolt, you should create a Web Service User credential and add Bolt in the description. When you click the credential, you’ll see the Configure API Credential Page. Go to the Authentication section, under Server Settings, and select Generate New API Key. Select Save changes at the bottom of the page, then copy the string for use in a later step.
Adyen HMAC Key	The hash-based message authentication code (HMAC) is a unique secret key that generated in your Adyen account.	44782DEF547...6BA056	You can generate and retrieve an HMAC signature by following the instructions listed in Adyen’s Verify HMAC Signatures article.
Adyen Username	The username for the Adyen API credential you use for reporting.	Report@Company.BoltFinancial	From your Adyen account: Go to Developers, then API credentials, and select the reporting credential. If you don’t already have one, you should create a Reporting credential. When you click the credential, you’ll see General Settings. Copy the value in Username for use in a later step.
Adyen Password	The password for the Adyen API credential you use for reporting.	56f3...99h6	From your Adyen account: Go to Developers, then API credentials, and select the reporting credential. If you don’t already have one, you should create a Reporting credential. When you click the credential, you’ll see General Settings. Go to the Authentication section and click Basic Auth. Click Generate password. Click Save changes at the bottom of the page, then copy the password for use in a later step.
Live URL Prefix	A unique snippet of an endpoint URL that allows Bolt to identify your Adyen account. Note: This value is only available in your live environment.	Example endpoint: https://e73e0f17d7bd00d7-BoltFinancial-checkout-live.adyenpayments.com/checkout/v1/payments Example Live URL Prefix: e73e0f17d7bd00d7-BoltFinancial	From your Adyen account: Go to Developers. Go to API URLs and copy the Live URL prefix from one of the endpoints.

Step 3: Add Keys and Edit Payment Settings

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

You have now successfully linked Bolt to your Adyen account.

Step 4: Configure Adyen Risk Settings

For payments made with a card saved to a shopper’s account, Bolt does not transmit card verification value (CVV) or address data to processors. Use this section to configure Adyen’s risk settings so the lack of this data does not trigger auto-declines.

Disable CVV 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 allow transactions where the CVV does not match.

Enable AVS Response Mapping

Address Verification System (AVS) is a fraud protection measure that verifies if the provided billing information matches the cardholder’s information. Enable AVS response mapping to receive both Adyen’s custom response codes and the standard network AVS codes.

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

With Fraud Protection

Bolt’s fraud detection engine uses advanced risk signals to protect your business from fraud. Adyen’s default risk settings may interfere with Bolt’s fraud detection rules and trigger declines on transactions from real shoppers with an otherwise low risk score. This occurs because Bolt checkout doesn’t require shoppers to enter a billing address.

If you use Bolt’s Fraud Protection, use the guide on AVS settings to allow all transactions where the shipping and billing address do not match.

Without Fraud Protection

If you don’t use Bolt’s Fraud Protection, contact your fraud solutions provider to inform them that payments transmitted via this processor will not provide CVV match information.

Step 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

• With Fraud Protection: Set up a user in Adyen so Bolt’s chargebacks team can access dispute information for representment.
• Without Fraud Protection: Follow Adyen’s chargebacks handling process.

Testing

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