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

# Connecting the Affirm Payments App

Add the Affirm Payments App to your Shopify account in a few simple steps.

<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 class="product-item">
          <img src="https://files.readme.io/3ca294a1b4b8b8506c3ff32876abc6e3e33d0e65a509dab81398915094bdbc5c-61TcZ33ZrJL._AC_UY1000_.jpg" alt="Canada" class="flag-icon">

          Canada
        </div>
      </div>
    </div>

  </div>
`}</HTMLBlock>

<br />

> 🚧 API keys
>
> If your payment settings require API keys, please refer to [these steps](https://docs.affirm.com/platforms/docs/shopify-configuring-affirm).

## Overview

This guide outlines the necessary steps to add the Affirm Payments App to your Shopify account.

***

## Add the Affirm App

1\. Navigate to the **Affirm Payments App** in the [Shopify App Store](https://apps.shopify.com/affirm-payments-app) and click the **Add app** button.

![](https://files.readme.io/dcaa0fd-screencapture-apps-shopify-affirm-payments-app-2022-04-27-16_09_09-edit.png "screencapture-apps-shopify-affirm-payments-app-2022-04-27-16_09_09-edit.png")

2\. Accept the Shopify Permissions by clicking **Install app**.

![](https://files.readme.io/1b6e7eb-screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_41_48-edit.png "screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_41_48-edit.png")

3\. After accepting the Shopify permissions, select your **country/region** (US or Canada) to be redirected to the Affirm Merchant log in window.

![](https://files.readme.io/cecfec2-screencapture-jira-team-affirm-browse-DOCS-218-2022-06-01-09_00_22-edit.png)

4\. Next, you will be prompted to sign into the **Affirm Merchant Dashboard**, using your registered email address and password.

> 🚧 Do you manage multiple Shopify stores?
>
> If you manage multiple stores using separate Affirm accounts, please use a unique email login for each shop. Reach out to us using the Support widget below for assistance.

![](https://files.readme.io/e3bdde1-screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_46_54-edit.png "screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_46_54-edit.png")

5\. Navigate to the payment settings and confirm that the **Account status** shows that Affirm is connected.

![](https://files.readme.io/ebc20a0-screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_49_05-edit.png "screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_49_05-edit.png")

6\. Choose to activate Affirm **[with testing](#activate-affirm-with-testing)** or **[without testing](#activate-affirm-without-testing)**.

***

## Activate Affirm with Testing

1\. To test the integration prior to activation, keep the **Enable test mode** box checked and then click **Activate Affirm**.

![](https://files.readme.io/8f5ac75-screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_57_11-edit.png "screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_57_11-edit.png")

2\. To test the Affirm checkout, reference [this guide](https://docs.affirm.com/developers/page/upgrade-affirm-promotional-messaging-in-shopify#overview).\
3\. After testing your integration, you can disable test mode by navigating to the **Payment settings** and unchecking the **Enable test mode** box , followed by clicking **Save**.

![](https://files.readme.io/45eeef2-screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-13_00_56-edit.png "screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-13_00_56-edit.png")

The Affirm Payments app is now live and connected.

***

## Activate Affirm without Testing

To activate without testing, uncheck the “**Enable test mode**” box and click **Activate Affirm**.

![](https://files.readme.io/8252afe-screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_52_09-edit.png "screencapture-docs-google-document-d-1zb6-28t4ncJIR3XA0oE-ia3krw-zP-Sea6ADpBiBEHA-edit-2022-04-22-12_52_09-edit.png")

The Affirm Payments app is now live and connected.

# Sibling pages

* [Using the Promotional Messaging App for Shopify](https://docs.affirm.com/platforms/docs/using-the-promotional-messaging-app.md)
* [Processing transactions in Shopify](https://docs.affirm.com/platforms/docs/processing-transactions-in-shopify.md)
* [Set a Price Floor for Checkout (Shopify Plus only)](https://docs.affirm.com/platforms/docs/set-a-price-floor-for-checkout-shopify-plus-only.md)
* [Manage Affirm payment customizations for Shopify stores](https://docs.affirm.com/platforms/docs/manage-affirm-payment-customizations-for-shopify-stores.md)
* [ALA Messaging with Theme App Blocks](https://docs.affirm.com/platforms/docs/ala-messaging-with-theme-app-blocks.md)
* [Shopify FAQs](https://docs.affirm.com/platforms/docs/shopify-faq.md)
* [Uninstall the Affirm Payment Method](https://docs.affirm.com/platforms/docs/uninstall-the-existing-affirm-payment-method.md)