Adyen
Adyen is a global payment company that allows businesses to accept payments in a single system.
note
The integration is using Adyen Checkout API v71
| Payment method | Recurring payments | Recurring retries | Delayed capture | Partial refunds |
|---|---|---|---|---|
| Credit cards | Yes | Yes | Yes | Yes |
| Apple Pay | Yes | Yes | Yes | Yes |
Adyen account setup
important
You need to contact Adyen support to enable some of the roles, such as "API PCI Payments role". You may also be asked to submit Odus PCI documentation, in which case please contact Odus support.
- Ensure you have a merchant account
- (Adyen Live only) Obtain your Live URL Prefix.
- Set up the Additional Data by going to Developers > Additional Data and enabling:
- Recurring details
- Recurring contract information
- Enable payment method tokenization by going to Settings > Payments > Checkout and enabling "Payout" under the "Tokenization" section.
- Create an API credential with the following roles and save the API key:
- API PCI Payments role
- Checkout webservice role
- Merchant PAL Webservice role
- Merchant Recurring role
- (Optional, for Apple Pay) API Clientside Encryption Payment role
Gateway profile setup
| Field | Required | Description |
|---|---|---|
| Integration | Yes | Adyen |
| Environment | Yes | Must match the type of your Adyen account |
| Merchant Account | Yes | Your Adyen merchant account name |
| API Key | Yes | API Key with the roles listed above |
| Live URL Prefix | Yes (Live only) | Live URL Prefix provided by Adyen |
Next steps
- Setting up Webhooks — Configure Adyen to send webhook notifications to Odus for reversal failure detection.
- Setting up Apple Pay — Accept Apple Pay payments via Adyen.