Configuration¶
All credentials are stored in the WordPress database via the WooCommerce gateway settings. Configure them under WooCommerce → Settings → Payments → Credit Card (Adyen).
Never commit credentials to the repository.
Settings¶
| Setting | Key | Description |
|---|---|---|
| Enable | enabled | Enable/disable the gateway |
| Sandbox | sandbox | Use Adyen test environment |
| Alternative Developer URL | dev_url | Override the site URL for webhook endpoint (local dev) |
| Merchant Account | merchant_account | Your Adyen merchant account name |
| Live URL Endpoint | live_endpoint_url_prefix | Live endpoint prefix (e.g. 224d9350dc2d3afa-MerchantName) |
| API Key | api_key | Adyen API key — obtain from Customer Area → API credentials |
| Origin Key | origin_key | Legacy origin key for Drop-in SDK (deprecated in favour of Client Key) |
| Client Key | client_key | Client key for Adyen Web Drop-in / Components |
| HMAC Key | hmac_key | HMAC key for validating incoming webhook notifications |
Obtaining credentials from Adyen Customer Area¶
- Log in to the Adyen Customer Area.
- API Key: Go to Developers → API credentials, select your web service user, and generate a key under Authentication.
- Client Key: Go to Developers → API credentials → Client settings and add your origin domain. The client key is shown after saving.
- HMAC Key: Go to Developers → Webhooks, edit your standard notification webhook, and generate an HMAC key under Security.
- Live URL Endpoint prefix: Found on the Account → API URLs page (format:
{random}-{MerchantName}).
Sandbox vs. live¶
When Sandbox is enabled, the plugin uses the Adyen test environment (checkout-test.adyen.com). Use a separate set of test credentials from the Adyen test Customer Area (ca-test.adyen.com).
Webhook URL¶
Register the following URL in the Adyen Customer Area under Developers → Webhooks as a Standard Notification:
For local development, set Alternative Developer URL to a tunnelled URL (e.g. via ngrok) so Adyen can reach your local environment.