Manage Affirm payment customizations for Shopify stores

Overview

As of August 2024, Shopify retires the checkout.liquid file for customizing payment methods, such as setting a price floor for checkout or hiding Affirm for certain SKUs.

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. For multiple SKUs, separate each SKU by a comma. Example: sku1,sku2,sku3
    The Payment Customization tab in the Affirm Pay-over-time Messaging app with informational text that says, “Affirm’s Payment Customization allows you to hide Affirm as a payment option. Configure the minimum cart size and/or restricted SKUs as a comma-separated value below.” Below the text is a Minimum Cart Size text field and a Disallowed SKUs text field.
  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.
    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.

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.
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.

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.
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.