Set up Adyen
Connect Adyen to your Bolt merchant account.
Connect Adyen to Bolt so Bolt can authorize and capture payments through your Adyen account.
Before you begin
Accept raw PAN information
Your Adyen account must accept raw PAN information. The Webservice User used for Bolt needs the API PCI Payments Role. Contact your Adyen representative to enable it. Learn more about API PCI Payments.
Capture type
If you use Bolt Fraud Protection with autocapture, set Adyen captures to Manual capture. Bolt authorizes the order, runs fraud review, then captures in Adyen.
Step 1: Set up webhooks
Webhooks keep Bolt and Adyen in sync for transaction and dispute events.
- Log into the Adyen Customer Area.
- Follow Adyen's Notification Webhooks guide.
- For URL, use the Bolt webhook URL from the Bolt Merchant Dashboard: Settings > Payments > Manage Adyen.
- Save and test using Adyen's webhook documentation.
Step 2: Obtain Adyen keys
| Credential | Description | Where to find it |
|---|---|---|
| Merchant Account Code | Unique Adyen account ID | Settings > Merchant accounts |
| Webservice API Key | API key for the Bolt web service user | Developers > API credentials > Bolt web service user > generate API key |
| HMAC Key | Secret for webhook signature verification | Follow Adyen HMAC signatures |
| Username | Reporting API credential username | Developers > API credentials > reporting credential |
| Password | Reporting API credential password | Same reporting credential > Basic Auth > generate password |
| Live URL Prefix | Live endpoint prefix (production only) | Developers > API URLs |
Step 3: Add keys and edit payment settings
- Log into the sandbox or production Merchant Dashboard.
- Go to Settings > Payments.
- Click Set Up Adyen.
- Enter Merchant Account Code, Webservice API Key, HMAC Key, Username, Password, and Live URL Prefix.
- Click Next.
- Edit payment settings, then click Complete Setup.
Expected result: Adyen is linked and listed under Settings > Payments.
Step 4: Configure Adyen risk settings
For saved cards, Bolt does not transmit CVV or address data to processors.
Disable CVV auto-declines
- Go to the Adyen Customer Area.
- Go to Risk > Risk Profiles and select a profile.
- Use Adyen's consistency rules to allow CVV mismatches.
Enable AVS response mapping
- Go to Developers > API URLs > Additional data settings.
- Under Acquirer, enable Raw acquirer result and Acquirer result.
With Fraud Protection
Use Adyen's AVS settings to allow shipping and billing address mismatches.
Without Fraud Protection
Tell your fraud provider that payments through this processor will not include CVV match information.
Step 5: Set up chargeback notifications
Configure Adyen communication preferences for digital chargeback notifications.
Optional: Real Time Account Updater
- Ask your Adyen representative to enable Real Time Account Updater.
- Confirm Adyen uses the correct RSA public key for card JWE.
- Follow Adyen's RTAU setup guide.
- Ask your Bolt CSM to confirm setup.
Chargeback handling
- With Fraud Protection: Set up a user in Adyen so Bolt's chargebacks team can access dispute information.
- Without Fraud Protection: Follow Adyen's chargebacks process.
Testing
Use Adyen's test cards in sandbox or staging.