Our direct integration with BigCommerce allows you to configure the connection to Adyen directly in the BigCommerce control panel. Once you're set up, you can accept credit card and debit card payments in multiple currencies in your BigCommerce store, without redirecting to an external website. Apart from credit card payments, we support many local payment methods, and are actively adding support for more.
We securely collect sensitive cardholder data, which reduces your PCI DSS-compliance requirements. The integration supports stored card details, native 3D Secure 2 authentication and includes Address Verification System (AVS) checks.
Before you begin
Before you begin to configure your BigCommerce store to use the Adyen payments platform, make sure that you have performed the following steps:
- Sign up for a test account with Adyen at https://www.adyen.com/signup.
- Apply for a live account with Adyen. For more information, refer to Apply for a live account.
Step 1: Generate an API key in Adyen Customer Area
To authenticate API requests from BigCommerce, you need to provide an API key. If you have more than one BigCommerce store set up, make sure that each store has a separate API key.
To generate an API Key:
- Log in to your Customer Area.
- Go to Account > API credentials, and select the credential for your integration, for example ws@Company.[YourCompanyAccount].
- Under Authentication, select Generate New API Key.
- Copy and securely store the API key in your system — you won't be able to restore it later.
If your API key is lost or compromised, you need to generate a new one. - Select Save at the bottom of the page.
You will need the API key when setting up the BigCommerce control panel in Step 2.
Step 2: Set up in the BigCommerce control panel
- Log in to your BigCommerce control panel.
- Go to Store Setup > Payments, and then select Online Payment Methods.
- Find Adyen and select Set up.
- In the Adyen Settings tab, fill out the following fields:
| Field | Description |
|---|---|
| Merchant Account | Name of your Adyen merchant account for which the payments will be processed. |
| Live API Key | Your API key from Adyen live Customer Area. Fill out this key when you're ready to go live. |
| Live URL Prefix | The URL prefix [random]-[company name] from your Adyen live Customer Area > Account > API URLs. For more information, refer to Checkout endpoints. Fill out this field when you're ready to go live. |
| Test Mode | Select Yes when you're configuring the connection to Adyen, select No when you're ready to process payments and go live. |
| Transaction Type | Select the transaction type that you want to enable. The recommended setting is Authorize & Capture. This setting will automatically and immediately capture authorised payments. The setting Authorize only requires that you manually capture authorised payments in BigCommerce. If you use Authorize only, you have to set the Capture Delay to manual in the Adyen Customer Area under Account > Settings. |
| Test API Key | Your API key from Adyen test Customer Area. This API key is only needed when you're configuring the connection to Adyen. |
- Select Save. New fields will appear and you can continue your setup. In the Stored Credit Cards section, configure the following:
| Field | Description |
|---|---|
| Enable stored credit cards with Adyen | Turn on if you want to store credit card details for your Adyen account. |
| Require CVV when using a stored credit card | Turn on if you want shoppers to enter their CVV code when using a stored credit card. |
- In the Notification Settings section, copy the URL and fill out the following fields:
| Field | Description |
|---|---|
| Notification URL | The notification URL that you copy to your Adyen Customer Area. |
| Notification Username | This can be any username, as long as it matches the username for basic authentication that you enter in your Adyen Customer Area. |
| Notification Password | This can be any password, as long as it matches the password for basic authentication that you enter in your Adyen Customer Area. |
- Select Save.
Step 3: Set up notifications
Adyen uses notification webhooks to inform the BigCommerce platform of payment status changes.
To receive notifications:
- Log in to your Customer Area with your company-level account.
- Go to Account > Server Communication, and select Add next to Standard Notification.
- Under Transport:
- Go to URL and enter the URL that you can retrieve from the Notification Settings the BigCommerce control panel.
- Select the Active check box.
- Set Method to JSON.
- Under Authentication:
- Go to the User Name and Password fields to enter a username and password for basic authentication. Use the same credentials as you used for the Notification Settings in the BigCommerce control panel.
- Select Save Configuration at the bottom of the page.
Refunds
To issue an order refund:
- Log into your BigCommerce control panel.
- In the menu, go to Orders > View.
- Find the order you want to refund and select Action > Refund.
- In the Refund view, select Refund order.
- Review the customer details and the order summary. Under Refundable items, choose one of the following:
- Refund individual items to refund specific line items within the order.
- Refund entire order to refund all line items within the order.
- Apply an order level refund to refund a custom value.
- Select the items that you want to refund and select Continue.
- In the Confirm refund view:
- Review the refund summary.
- Select the preferred refund method.
- Optionally, fill out the reason for the refund.
- Select Confirm Refund.
The refund will now be sent to Adyen for processing. The time it takes to process the refund depends on the selected refund method.
Test and go live
Once you have the credentials for your Adyen live account:
- Generate an API key in your live Adyen Customer Area.
- In your BigCommerce control panel, under the Adyen Settings:
- Enter the Live API Key.
- Enter the Live URL Prefix.
- Set Test Mode to No.
- Select Save.
If you experience any issues, contact our Support Team.