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

# Install the Affirm Extension on Adobe Commerce (Magento)

Offer Affirm as a payment option for your customers. Learn how to install and upgrade the Affirm Adobe Commerce (Magento) extension.

<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

This guide describes how to integrate Affirm into your Adobe Commerce (Magento) platform and offer Affirm as a payment option to your customers.

***

## Install the Extension

You have two options for installing the [Adobe Commerce (Magento) Affirm extension](https://github.com/Affirm/Magento2_Affirm/releases). Both options also upgrade the extension using the exact same steps described below.

### Install Using Composer

1. [Retrieve your Adobe Commerce (Magento) authentication keys](https://devdocs.magento.com/guides/v2.0/install-gde/prereq/connect-auth.html).
2. In the **Magento 2 root directory**, enter the following commands using the command line:

```php Terminal
composer require affirm/magento2
composer update
php bin/magento setup:upgrade
php bin/magento setup:di:compile
```

3. Clear the Adobe Commerce cache to use the default Magento 2 Affirm configuration. For Magento 2.2 and lower an Affirm Module version 2.1.5 will be used.

***

### Install Using Command Line

1. [Download the extension](https://github.com/Affirm/Magento2_Affirm/archive/master.zip).
2. If it doesn't exist, create the directory `Magento2_root/app/code/Astound/Affirm/`.
3. Unzip the extension and move all the files to `Magento2_root/app/code/Astound/Affirm/`.
4. In the **Magento 2 root directory**, run the following command to verify that `Astound_Affirm` exists in **List of disabled modules**:

```php Terminal
php bin/magento module:status
```

5. In the Adobe Commerce root directory, run the following commands:

```php
php bin/magento module:enable Astound_Affirm
php bin/magento setup:upgrade
```

6. Clear the Adobe Commerce cache to use the default Affirm configuration.

# Sibling pages

* [Configure Affirm for Adobe Commerce (Magento)](https://docs.affirm.com/platforms/docs/magento-2-configure-affirm.md)
* [Add Affirm Promotional Messaging to Adobe Commerce (Magento)](https://docs.affirm.com/platforms/docs/add-affirm-promotional-messaging.md)
* [Processing Affirm Transactions in Adobe Commerce (Magento)](https://docs.affirm.com/platforms/docs/processing-affirm-transactions-in-magento-2.md)
* [Multiple Financing Programs in Adobe Commerce (Magento)](https://docs.affirm.com/platforms/docs/magento-2-multiple-financing-programs.md)
* [Adobe Commerce (Magento) FAQ](https://docs.affirm.com/platforms/docs/magento-faqs.md)
* [How Does the Chrome SameSite Cookie Policy Affect my Adobe Commerce (Magento) Integration?](https://docs.affirm.com/platforms/docs/how-does-the-chrome-samesite-cookie-policy-impact-your-magento-integrations.md)
* [Adobe Commerce (Magento) Telesales Integration](https://docs.affirm.com/platforms/docs/magento-2-telesales-integration.md)