# ACI

To start using the Checkout.com ACI plugin, you must first set up and test your integration in the sandbox environment, and then move your integration to the production environment.

The plugin supports the following payment methods:

- Card payments
- Apple Pay
- Google Pay

---

## Before you start

Before you configure the plugin, create a secret API key in the Checkout.com Dashboard.

### Create a secret API key

1. Sign in to the sandbox environment in the [Dashboard](https://dashboard.checkout.com).
2. Select _Developers_ in the left navigation bar and open the _Keys_ tab.
3. Select _Create a new key_.
4. Under _Type of key_, select _Secret API key_.
5. Give the API key a description. This helps you identify what it's used for.
6. Under _Scopes_, select _Default_.
7. Select _Create key_.
8. Copy your secret API key securely. You'll need it to configure the plugin.

> **Information**
>
> For security, you cannot view the secret API key again after you've left the _Create a new key_ page. Copy the value securely before you exit or close the window.

---

## Configure the plugin

1. Sign in to your ACI account.
2. Go to _Configuration_ > _Merchant Accounts_ > _Add Connector (CHECKOUT_DOT_COM_CI)_.
3. In the _Processing Channel ID_ field, enter the processing channel ID for your business.
4. In the _API Secret Key_ field, enter the secret key you created in the Dashboard sandbox environment.
5. In the _Client ID_ field, enter your client ID.

The following table describes the configuration fields in ACI:

| Field in ACI | Required | Description |
| :--- | :--- | :--- |
| _Processing Channel ID_ | Yes | Your processing channel ID. |
| _API Secret Key_ | Yes | Your Checkout.com secret API key. |
| _Client ID_ | Yes | Your client ID. We derive the endpoint prefix from this value. For example, in `cli_rqaangxn6rjebjfvpndid5qm6q`, the prefix is `rqaangxn`, which is the first 8 characters after `cli_`. |
| _Currency_ | No | The currency for the account. |
| _Authorization type (Pre/Final)_ | No | The type of authorization. The default is final. |

The authorization type maps to Checkout.com as follows:

| ACI value | Checkout.com authorization type |
| :--- | :--- |
| `NONE` | Final |
| `FINAL_AUTHORIZATION` | Final |
| `PRE_AUTHORIZATION` | Estimated |

---

## Test your integration

1. In your ACI account, go to _Configuration_ > _Payment Gateways_.
2. Select your Checkout.com integration, and then select _Options_ > _Test Configuration_ to confirm that ACI can communicate with your Checkout.com account.

A confirmation appears if your credentials are correct.

---

## Move your integration to the production environment

1. Sign in to the production environment in the [Dashboard](https://dashboard.checkout.com).
2. Create a secret API key, as described in [Create a secret API key](#create-a-secret-api-key).
3. In ACI, update your configuration with your production credentials.

---

## Manage refund, return, and void transaction data

You can refund, return, or void an order from the Dashboard. ACI updates the status of the order automatically.