Configure Affirm for Adobe Commerce

Learn how to configure the Affirm Adobe Commerce extension to offer Affirm as a payment option.

Find Affirm configuration options

  1. Sign in to your Magento 2 admin portal.
  2. Navigate to Stores > Configuration > Sales > Payment Methods > Affirm.

Configure Affirm settings

You can define your Affirm integration settings with the following configuration options:

  • Enabled: Enable or disable Affirm payment at checkout.
  • Region: Choose Canada or United States
  • Mode: Use Sandbox mode for development and testing.
  • API Keys: Enter your Private and Public API Keys you retrieved from your sandbox merchant dashboard. To set API keys for a different region (US or Canada), select from the Region dropdown and input the corresponding keys.
  • Payment Action: Select Authorize and Capture if your checkout process automatically captures the charge.
  • Enable Partial Capture: Enable Partial Capture only if instructed by Affirm support.
  • Order Totals: Enter the dollar amount values for Minimum Order Total and Maximum Order Total that displays Affirm as a payment option to your customers when checking out (default is 0.01 and 100000, respectively).
  • Sort Order: If you've enabled multiple payment methods, use this setting to change the order of how Affirm displays on the checkout page.
  • Plain Text Appearance: Select Yes if you want to display Affirm as text instead of the logo at checkout.
    Icon: If you want to customize the default Affirm logo, add the URL for the desired logo (requires Plan Text Appearance set to No).
  • Affirm Payment Method HTML: You can add inline HTML if you want to customize the default subtext (requires Plan Text Appearance set to No).
  • Enabled Checkout Button: Select Yes to display the Affirm button on the cart page (you can update the Affirm button URL in the Checkout Button Code).
  • Checkout Flow Type: Set to Modal unless instructed by Affirm.
  • Inline Checkout Messaging: Set to Yes to enable Inline checkout value props on the checkout page.

If these changes don't take effect immediately:

  1. In the Adobe Commerce admin panel, go to System > Cache Management.
  2. Click Flush Magento Cache.
  3. Sign out.
  4. Sign back in to reset permissions.

About Inline Checkout works

With our Inline integration, you can highlight Affirm’s value props early in the checkout flow and set clear expectations with your customers.


Inline support

  • Inline is available for our Installment, Pay in 4 and Hybrid financing options.
  • Affirm Lite is not supported at this time.

Set the Inline Checkout Messaging dropdown to Yes to enable Inline checkout value props on the checkout page.

When a customer selects Affirm as a payment option, the view expands and renders the following information in your site:

  • Value props: Highlights some of the benefits of paying with Affirm.
  • Learn more about Affirm: A learn more link that opens our educational modal.
  • Payment timelines: The timeline and amount for each payment

This image displays the Inline flow for Pay in 4 and Installment options.