> ## Documentation Index
> Fetch the complete documentation index at: https://docs.slm.m1amdocs.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Adyen Configuration
| Payment Provider | Geographies | Currencies | Payment Methods | Retain Support | Automatic Chargeback Feed | Account Updater | API Version | Microservice? |
| - | - | - | - | - | - | - | - | - |
| Adyen Payment Provider | [Supported Countries Listed Here](https://www.adyen.com/payment-methods-guides/) | [Supported Currencies Listed Here](https://docs.adyen.com/account/supported-currencies) | \*\*Credit/Debit Cards -\*\**Yes* **SEPA DD**- *No* **Tokenized Credit Card**- *Yes* **Hosted Pages** - *No* **Alternative Payments** - *No* **Digital Wallets** - *No* | **Tokenized Credit Card** - *Yes* **Detokenize PAN** - *No* **Detokenize BIN**- *No* **Partial Auth** - *Yes* **Forced Deposit** - *No* | Yes | No | V68 | No |
## Required Merchant Information
\[
]\(../images/Adyen.xlsx)
| Name | Expected Value | Value | Description |
| - | - | - | - |
| Adyen:merchantAccount | | | Merchant Account id defined at the processor |
| Adyen:password | | | Password for above account |
| Adyen:username | | | Username for above account |
| Does provider need to whitelist IPs | No | | |
| Does merchant need to grant access to Vindicia | No | | |
| Chargeback feed | Yes | | |
| Account Updater | No | | |
## Desired Merchant Configuration
| Name | Value | Comments |
| - | - | - |
| Adyen:notificationAuth | Example: “Ayden:Callback” | This is the basic auth username:password for our callback listener ([Adyen Callback Listener](https://secure.vindicia.com/billinginterface/adyen/callback.html)). The merchant must config their Adyen instance with our webhook listener (aka callback listener) and configures basic auth for it. They need to give us this username:password and we add it to the config. **For staging, the callback listener is:** [Adyen Staging Callback Listener](https://secure.staging.us-west.vindicia.com/billinginterface/adyen/callback.html) |
| Adyen:autoCapture | 0/1 | Adyen can be configured with an immediate or manual capture configuration. With Manual being used we need to issue both an Auth and a separate Capture call to Adyen. When using Immediate we only need to send an Auth as the capture is performed automatically by Adyen. This Delay Capture configuration item needs to be identified with the merchant before the trial can be run so that the correct configuration can be applied to CashBox. When set to “1”, if we get a successful auth, we will set the auth\_response\_code to ‘Success’. Otherwise we set status to ‘Pending’ and wait for the manual capture request. **Recommended value is 1**. |
| Adyen:initialSelectTransactionIdForReferenceCode | 0/1 | If enabled, we will send original failed transaction ID as reference field in the request to Adyen. **Recommended value is 1**. |
| Adyen:auth\_response\_priority | | The order that authorization response codes are prioritized when deciding to retry Transactions. Supported Authorization Response Codes: Payment Provider Response (P) and MAC (M) |
* **[Adyen Merchant Setup Instructions](../topics/adyenConfiguration_r#)**
* **[Adyen Detailed Information on Integration](../topics/adyenConfiguration_r#)**
**Parent topic:**[Payment Provider Specific Configuration](../topics/PaymentProvidersSpecificConfiguration)
## Adyen Merchant Setup Instructions
The following Instructions are written for Vindicia CTS and services delivery staff.
To configure a merchant to use Adyen payment provider:
### Merchant Payment Providers
1. In Subscribe Portal 1.0, using you’re admin account, go to **Admin** > **Merchant Configurations**.
2. Select the relevant **Merchant** from the drop-down list.
3. Click **Edit Merchant Configurations**.
4. Enter the **Jira Ticket #** for configuring your merchant payment setup.
5. Add Adyen to **Merchant Payment Providers**:
| Payment Provider Name | Account Number | PP Type | Active |
| - | - | - | - |
| Adyen (1037) | \ | BRD(1) | 1 |
1. Select **Adyen (1037)** as the payment provider and click **ADD**.
2. Leave **Account Number** blank.
3. Set **PP Type** as **BRD**.
4. Set **Active** to **1**.
### Routing Rule
1. Add a **Routing Rule** for Adyen.
| Ordinal | Payment Provider | Value | Rule Method | Active |
| - | - | - | - | - |
| 1 | Adyen (1037) | | default\_method(1) | 1 |
1. Select **Adyen (1037)** as the payment provider and click **ADD**.
2. Add an **Ordinal** value of **1**.
3. Leave **Value** blank.
4. Add a **Rule Method** value of **default\_method(1)**.
5. Set **Active** to **1**.
**Note:** If the test payment provider is configured, set its **Active** value to **0**.
**Note:** If a merchant account is set up with several payment providers, the payment provider with highest **Ordinal** value has priority. If routing will be shared amongst payment providers, see [Configuration Method - Payment Providers Routing Rules](routingRulesAbout) for examples of possible configurations.
### Name/Value Pairs
Add the required configuration details in **Name/Value Pairs** for the Adyen configuration.
**Note:** The **ID** is automatically generated and **Value** for each **Name/Value Pair** is unique and must be provided by the merchant. The following is an **example** of **Name/Value Pairs** for an Adyen configuration.
| ID | Name | Value |
| - | - | - |
| 100022062 | Adyen:merchantAccount | |
| 100022063 | Adyen:username | |
| 100022064 | Adyen:password | |
| 100022065 | Adyen:notificationAuth | candy:bar |
| 100071243 | Adyen:initialSelectTransactionIdForReferenceCode | 0 |
| 100074269 | Adyen:autoCapture | 1 |
| 100082230 | Adyen:allowPartialAuth | 0,1This enables partial auth. Use 0 to disable partial authorization and 1 if you want to enable partial authorization. |
| **Parent topic:**[Adyen Configuration](../topics/adyenConfiguration_r#) | | |
## Adyen Detailed Information on Integration
Vindicia supports the following Payment Operations for Adyen:
| Payment Operation | Yes/No | Notes |
| - | - | - |
| **Standard Implementation Features** | | |
| Verification (no Auth) | Yes | |
| Minimal Authorization (\$0) policies, by card type) | Yes | |
| AVS check with standard result mapping | Yes | |
| CVV/CVN check with standard result mapping | Yes | |
| Support real-time authorization (stand-alone Auth) | Yes | |
| Void | Yes | |
| Cancel/reverse authorization | Yes | |
| Conditional deposit (auth and capture combination) | Yes | |
| Capture (stand-alone capture) | Yes | |
| One-time transactions (real-time) | Yes | |
| Recurring transactions (flagged recurring) | Yes | |
| Refunds - Full | Yes | |
| Refunds - Partial | Yes | |
| 3DS | No | |
| CITMIT/Card On File | Yes | |
| Map error/response/result codes to standard actions (Success/Decline/Reject) | Yes | |
| **Special Implementation Features** | | |
| Implemented via Payments Microservice | No | |
| Retrieve and store paymentProcessorTransactionId | Yes | |
| Retrieve and store Extended Card/Auth Attributes | No | |
| Support tokenization (for Retain) | Yes | |
| Support BIN/Last-4/Expiry Retrieval from external Token | No | |
| Support detokenization (Subscribe retrieves full PAN/CC details | No | |
| Support Card Type identification (from BIN or API) | No | |
| Support Visa/general "Stored Credential" flags | Yes | |
| Account Updater/Amex Card refresher | No | |
| Automated/manual chargeback feed | Yes | |
| **Retain Support** | | |
| Support token as payment method | Yes | |
| Support detokenization to full PAN | No | |
| Support detokenization to get BIN | No | |
| Support Partial Authorization | Yes | Use merchant NVP `Adyen:allowPartialAuth` with value 1. |
| Support Balance Retrieval | No | |
| Support Forced Deposit | No | |
### Payment Provider Documentation
Link to docs: [https://docs.adyen.com/](https://docs.adyen.com/)
**Parent topic:**[Adyen Configuration](../topics/adyenConfiguration_r#)
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.