---
updatedAt: 2025-11-13T14:10:16.000Z
agentTools:
  siteIndex: https://docs.affirm.com/llms.txt
  projectIndex: https://docs.affirm.com/platforms/llms.txt
---

# Configure Affirm in BigCommerce

Provide your customers with a flexible payment option by enabling Affirm for your BigCommerce store. Learn how to set up Affirm for your store.

<HTMLBlock>{`
<style>
  .dropdown-menu {
    font-family: Arial, sans-serif;
    max-width: 250px;
    margin-left: auto; /* Align to the right */
  	margin-right: 0; /* Ensure it's flush to the right */
    border: 1px solid #ddd;
    border-radius: 8px;
    padding: 10px;
    background: #4A4AF4;
    overflow: hidden; /* Ensure the container grows with content */
  }

  .dropdown-item {
    margin-bottom: 10px;
  }

  .dropdown-toggle {
    display: block;
    width: 100%;
    text-align: left;
    padding: 10px;
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 4px;
    cursor: pointer;
  }

  .dropdown-toggle:hover {
    background: #f0f0f0;
  }

  .dropdown-content {
    display: none;
    margin-top: 5px;
    padding: 10px;
    background: #fff;
    border: 1px solid #ddd;
    border-radius: 4px;
  }

  .dropdown-item.open .dropdown-content {
    display: block;
  }

  .flag-icon {
    width: 20px;
    height: 20px;
    margin-right: 10px;
  }

  .product-item {
    margin-bottom: 5px;
  }

  .product-icon {
    width: 20px;
    height: 20px;
    margin-right: 10px;
  }
  
  .country-title {
    font-family: Arial, sans-serif;
    font-size:20px;
    text-align: center;
    font-weight: bold;
    color: #ffffff;
  } 

</style>
  <div class="dropdown-menu">
    <p class="country-title" alt="Countries where this product is available">Country Availability</p>

    <div class="dropdown-item">
      <button class="dropdown-toggle" onclick="toggleDropdown(event)" alt="Drop down menu displaying the available countries for this product">
        <b>Country List</b> ⬇️
      </button>
      <div class="dropdown-content">
        <div class="product-item">
          <img src="https://files.readme.io/a4c8b3d6596d943e2b93c82cb1d432a2edaf6998667835c2e97ef4a31d460c7e-us-circle-01.png" alt="USA" class="flag-icon">
          USA
        </div>
      </div>
    </div>

  </div>
`}</HTMLBlock>

## Overview

This guide walks you through integrating Affirm with your BigCommerce platform.

***

## Step 1: Confirm Your Website is using Optimized One-page Checkout

Before proceeding with the integration, you'll need to ensure that the *Optimized one-page* checkout is enabled. Follow the steps below to confirm:

1. Go to **Settings > Advanced > Checkout**.
2. Check whether you can see the *Checkout Type* setting. If you can't, you already use the *Optimized one-page checkout* and can proceed to the next step.
3. If you are on a legacy checkout, you will see the *Checkout Type* field available with either *Single-page express* checkout or *Multiple-page* checkout selected.
4. To enable Affirm, you need to select **Optimized one-page checkout** and click **Save**.

> 📘 Optimized One-page Checkout
>
> For more information, see [Optimized One-Page Checkout](https://support.bigcommerce.com/s/article/Optimized-Single-Page-Checkout).

<Image align="center" src="https://files.readme.io/f20e195-Big_Commerce_Settings.png" />

***

## Step 2: Enable Affirm as an Online Payment Method

1. Go to **Settings > Setup > Payments** and scroll down to **Additional Providers**.
2. Under **Online Payment Methods**, look for **Affirm** and click the toggle button to turn it on.

<Image title="BC_Affirm_setup.jpeg" align="center" width="2000px" src="https://files.readme.io/5bb83bb-BigCommerce_enable_Affirm.png" />

3. Click on **Affirm Settings** and fill in the corresponding fields with the API key pair credentials from your Affirm merchant account.

![](https://files.readme.io/e1d1a7a-BC_affirm_settings.png "BC_affirm_settings.png")

### Affirm Settings

<Table align={["left","left"]}>
  <thead>
    <tr>
      <th>
        Field
      </th>

      <th>
        Description
      </th>
    </tr>
  </thead>

  <tbody>
    <tr>
      <td>
        **Public Key**
      </td>

      <td>
        The Public Key from your [Affirm dashboard](https://www.affirm.com/dashboard/). 
      </td>
    </tr>

    <tr>
      <td>
        **Private Key**
      </td>

      <td>
        The Private Key from your Affirm dashboard. (Need help? See the [Business Resource Hub](https://businesshub.affirm.com/hc/en-us/articles/10911416122388-Why-don-t-my-API-keys-work-with-BigCommerce).)
      </td>
    </tr>

    <tr>
      <td>
        **Minimum Order Value**
      </td>

      <td>
        The minimum order amount (before taxes and discounts) that must be met before Affirm displays as an option at checkout. If blank, Affirm will be displayed for all orders over $50.
      </td>
    </tr>

    <tr>
      <td>
        **Transaction Type**
      </td>

      <td>
        Can be set to Authorize & Capture or Authorize Only.  

        * *Authorize & Capture* will capture your Affirm charge and your order will have the status of **Awaiting Fulfillment in BigCommerce**.

        * *Authorize Only* allows you to capture the funds manually. Your order will have the status of *Awaiting Payment in BigCommerce*. Once you manually capture the order in BigCommerce, the transaction will also be captured automatically in Affirm.\
          See [Manually Capturing Transactions (Authorize Only)](https://support.bigcommerce.com/s/article/How-can-I-set-my-payment-gateway-to-only-authorize-transactions-and-not-capture-the-funds-automatically) to learn more on how to manually capture transactions within BigCommerce.
      </td>
    </tr>

    <tr>
      <td>
        **Test Mode**
      </td>

      <td>
        Determines whether your store is in sandbox or **Test Mode**. Make sure this is enabled until you are ready to take live payments. 
      </td>
    </tr>
  </tbody>
</Table>

***

# Sibling pages

* [Add Promotional Messaging to BigCommerce](https://docs.affirm.com/platforms/docs/add-promotional-messaging-to-bigcommerce.md)
* [Go-live checklist](https://docs.affirm.com/platforms/docs/bigcommerce-go-live.md)
* [BigCommerce FAQs](https://docs.affirm.com/platforms/docs/bigcommerce-blueprint-faq.md)

# Other helpful resources

Congrats! You've successfully set up your BigCommerce integration. Next, configure your promotional messaging start providing details on our flexible payment options to your customers.

* [Add Promotional Messaging to BigCommerce](https://docs.affirm.com/platforms/docs/add-promotional-messaging-to-bigcommerce.md)