# BigCommerce

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

To use the Checkout.com plugin, your BigCommerce store must use Optimized One-Page Checkout.

---

## Before you start

Before you configure the plugin, you must create a public and private key.

### Create a public 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 _Public API key_.
5. Give the API key a description. This will help you identify what it's used for.
6. Disable the _Allow any processing channel_ setting.
7. Select the processing channel you want to use for BigCommerce payments from the list.
8. Select _Create key_.
9. Copy your public API key. You'll need it to configure the plugin.

> **Information**
>
> You can view your public API key in the Dashboard at any time.

### Create a private API key

1. Sign in to the sandbox environment in the [Dashboard](https://identity-sandbox.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 will help you identify what it's used for.
6. Under _Scopes_, select _Default_.
7. Disable the _Allow any processing channel_ setting.
8. Select the processing channel you want to use for BigCommerce payments from the list.
9. Select _Create key_.
10. Copy your private API key securely. You'll need it to configure the plugin.

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

---

## Configure the plugin

In your BigCommerce dashboard:

1. Go to _Settings_ > _Payments_, and select _Set up_ next to the _Checkout.com_ option in the list of online payment methods.
2. In the Checkout.com settings page, configure your plugin using the following options:
    - _Display Name_: Enter an alphanumeric value to describe the plugin.
    - _API Private Key_: Enter the private API key you generated in the Dashboard, prefixed with `Bearer`. For example, `Bearer <SECRET_KEY>`.
    - _API Public Key_:  Enter the public key you created in the Dashboard.
    - _Transaction Type_: Select _Authorize and capture_ for auto captures, or _Authorize only_, for manual captures.
    - _Test Mode_: Enabling this option marks all transactions as tests and routes the transactions to the sandbox environment.
    - _Enable 3D Secure_: Select this option to enable 3D Secure fraud protection with Checkout.com.
    - _Stored Credit Cards_: Select _Enable stored credit cards with Checkout.com_ to store your customer's credit card details.
    - _Displayed Cards_: Select the credit card brands that you want to show next to the payment method during checkout.
3. Select _Save changes_.