![Logo|200](Pasted%20image%2020240122124624.png)

## Overview

Connecting to the [Adyen](https://docs.adyen.com/get-started-with-adyen/) payment gateway allows you to accept credit card payments in ChargeOver. 

## How to Connect

Steps to connect Adyen and ChargeOver together are below!

### In Adyen

You'll be provided with these pieces of information when by Adyen:

- Merchant Account

First, you'll want to check on several options inside of Adyen.

1. Log in to Adyen, and go to **Developers** and then **Additional data**
2. Enable the `Acquirer` options shown below

![](adyen/adyen-opt-1.png)

3. Scroll down to the `Payment` section, and enable the `Recurring details` option

![](adyen/adyen-opt-2.png)

Next, you'll need to get your API credentials from Adyen. You're going to need to get these pieces of information:

- Username
- API Key
- Live URL Prefix

1. Log in to Adyen, and go to **Developers** and then **API credentials**
2. Click the ==Create new credential== button
3. Enter `ChargeOver` for the description, and continue

![](adyen/adyen-new-creds.png)

4. On the next page, you'll be shown the `Username`, `API key`, and (if you're not in "test mode") the URL prefix.

![](adyen/adyen-cred-details.png)

Once you have all the required items, go back to ChargeOver.

### In ChargeOver

1. Go to **Settings** then ==Payment Methods==
2. Click ==Add or Configure a Payment Method or Merchant Account==
3. Select **Adyen** from the options
4. Enter in the required information
5. Scroll to the next section and designate which payment types you accept. For example, Visa, Mastercard, ACH/eCheck and more.
6. Click ==Save Settings== when finished

![](adyen/chargeover-adyen-details.png)

## Common Questions

Does the integration between Adyen and ChargeOver support…

|Feature|Supported? ✅|
|---|---|
|[Dynamic Statement Descriptors](https://help.chargeover.com/docs/getting-paid/payment-processors/stripe/#dynamic-statement-descriptors)|✖️|
|[Tokenized Payments](https://help.chargeover.com/docs/getting-paid/payment-processors/#enable-tokenization)|✖️ |
|Credit Card Payments|✅|
|ACH (USA) Payments|✖️ |
|EFT (CAD) Payments|✖️|
|ACH (AUS) Payments|✖️|
|Credit Card Refunds|✅|
|ACH Refunds|✖️ |


### Refund Processing

Adyen does not support real-time processing of refunds. When you process a refund with Adyen, the refund will be
created in a `Pending` status.

Some time later, Adyen will notify ChargeOver that the refund was completed successfully, or that it was declined, and
the refund status in ChargeOver will then be updated. Typically, the status update happens between 5 and 60 minutes
from the time the refund was requested.

### Migrating to Adyen

If you are migrating from another payment processor to Adyen, please 
for assistance.

Adyen has special requirements when migrating credit cards that have been previously processed using a different
payment gateway, and payments may fail if assistance is not requested.

## Supported Merchants Countries

These are based on where your business is located.

**Canada and United States.**

## Common Decline Messages

If you are unsure what a Adyen decline message means or what to do next, the most common error messages you might encounter are explained below.

|Error Message|What Adyen is Trying to Tell You |Next Steps|
|---|---|---|
|ERR_DECLINE|Adyen told ChargeOver the payment was declined. |You or the customer should contact Adyen to discuss the reason for the decline. |
|ERR_CREDENTIALS|Adyen told ChargeOver that your authentication credentials for Forte are incorrect. |You should contact Adyen and fix the credentials you use to connect to them. |
|ERR_EXPIRED|Adyen told ChargeOver the credit card has expired. |You should contact the customer and ask them to provide a new payment method.|
|ERR_CVV|Adyen told ChargeOver the credit card was declined due to an incorrect CVV/CVC security code. |Your customer should provide a correct CVV/CVC security code, or provide a new payment method.|

## Adyen Support

If you need to contact Adyen’s support team, you can use the information below.

**[Support Website](https://help.adyen.com/en_US/contact)**