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

# Manage Affirm payment customizations for Shopify stores

Learn about configuring and managing Affirm payment customizations for your Shopify 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 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>

## Overview

As of August 2024, Shopify retires the *checkout.liquid* file for customizing payment methods, such as [setting a price floor for checkout](https://docs.affirm.com/platforms/docs/set-a-price-floor-for-checkout-shopify-plus-only) or [hiding Affirm for certain SKUs](https://docs.affirm.com/platforms/docs/hide-affirm-for-certain-skus-shopify-plus-only).

Instead, you can use the **Affirm pay-over-time messaging** Shopify app to control the appearance of the Affirm payment option at checkout for your Shopify store. You can set a minimum cart total or add disallowed SKUs that determine when a customized payment method displays.

***

## Prerequisites

To use this feature, you must have the **Affirm Payments App** and **Affirm pay-over-time messaging** app installed on your store.

> 🚧 Important
>
> If you previously installed the Affirm pay-over-time messaging app on your store, you must reinstall it to use this feature.

***

## Create a Payment Customization

1. Open your Shopify admin dashboard (<https://admin.shopify.com/store/>\<your\_store>).
2. In the **Affirm Pay-over-time Messaging** app, open the **Payment Customization** tab.
3. Enter a value in 1 or both of these fields:

   1. **Minimum cart size**: Enter a numeral value.
   2. **Disallowed SKUs**: Choose the SKU you want to disallow from the Available SKUs options.  You can search by product title, sku title or sku.

      <Image align="center" width="400px" src="https://files.readme.io/835d8bb8c6b3212ce45b57e87b448e6b3c7ea29675eed4b21a03e20fad6d7c46-updated_guide_0.png" />

      1. You can choose multiple SKUs.
      2. Chosen SKUs will be displayed as tags under the Disallowed SKUs label (see image below). Any tag could be easily deleted from the Disallowed SKUs set (click on “x”).

      <Image align="center" src="https://files.readme.io/4e9995a115f1868cc5dcbf748905b8e63a6b544f8316c1d0b2aeb3ec26841929-updated_quide_1.png" />
4. Click **Save**.
5. (Optional) Confirm that the payment customization was added by:

   1. Selecting **Settings** > **Payments** in the Shopify admin dashboard.
   2. Locating the **Payment method customizations** section.
   3. Verifying that you see the **Hide Affirm by cart total or SKU** payment customization.

   <Image alt="The Payment Method Customization section in the Shopify admin dashboard. Under the section title, it says, “Control how payment methods appear to your customers at checkout.” Below the text, we see the configured payment customization titled Hide Affirm by cart total or SKU, with a status of Active." align="center" className="border" border={true} src="https://files.readme.io/cda2fda-settings_payments_pc.png" />

<br />

***

## Test a Payment Customization

**Minimum Cart Size:**

1. Open the checkout page for a cart with less than the minimum cart size.
2. Verify that the **Affirm - Pay Over Time** payment option is hidden at checkout.

**Disallowed SKU:**

1. Open the checkout page for an item with a disallowed SKU.
2. Verify that the **Affirm - Pay Over Time** payment option is hidden at checkout.

***

## Update a Payment Customization

1. Open the Shopify admin dashboard.
2. In the **Affirm Pay-over-time Messaging app**, open the **Payment Customization** tab.
   * On the tab, we display a warning and populate the fields with the values from the existing payment customization.
3. Update the fields, as needed.
4. Click **Save**.

<Image alt="On the Payment Customization tab in the Affirm Pay-over-time Messaging app, a banner displays warning message that reads, “Affirm Payment Customization is already configured for the store. Update the customization below and click Save to apply your changes. You can delete the customization in your store's payment customization settings.” The Minimum Cart Size field is populated with a value of 100.00 and three SKUs are populated in the Disallowed SKUs field." align="center" src="https://files.readme.io/9a3fad1db43729803b6166dd7be652f595588ad8e6ea7df1e7c7aaec587be72a-updated_guide_3.png" />

<br />

***

## Activate, Deactivate, or Delete a Payment Customization

1. Open the Shopify admin dashboard.
2. Select **Settings** > **Payments**.
3. In the **Payment method customizations** section, click **Manage**.
4. Select the checkbox for the payment customization you want to activate, deactivate, or permanently delete.
   * The Affirm payment customization is named **Hide Affirm by cart total or SKU**.
5. Click the **Delete**, **Activate**, or **Deactivate** button.

<Image alt="The Payment Customizations page in the Shopify admin dashboard. A user has selected the checkbox for the Hide Affirm by Cart Total or SKU payment customization. The payment customization is active, so only the Deactivate and Delete buttons display." align="center" className="border" border={true} src="https://files.readme.io/f2fc68f-manage_pc.png" />

# Sibling pages

* [Connecting the Affirm Payments App](https://docs.affirm.com/platforms/docs/connecting-the-affirm-payments-app.md)
* [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)
* [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)