ACI
Last updated: October 7, 2026
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 configure the plugin, create a secret API key in the Checkout.com Dashboard.
- Sign in to the sandbox environment in the Dashboard.
- Select Developers in the left navigation bar and open the Keys tab.
- Select Create a new key.
- Under Type of key, select Secret API key.
- Give the API key a description. This helps you identify what it's used for.
- Under Scopes, select Default.
- Select Create key.
- 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.
- Sign in to your ACI account.
- Go to Configuration > Merchant Accounts > Add Connector (CHECKOUT_DOT_COM_CI).
- In the Processing Channel ID field, enter the processing channel ID for your business.
- In the API Secret Key field, enter the secret key you created in the Dashboard sandbox environment.
- 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 |
- In your ACI account, go to Configuration > Payment Gateways.
- 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.
- Sign in to the production environment in the Dashboard.
- Create a secret API key, as described in Create a secret API key.
- In ACI, update your configuration with your production credentials.
You can refund, return, or void an order from the Dashboard. ACI updates the status of the order automatically.