---
updatedAt: 2025-11-13T14:36:06.000Z
agentTools:
  siteIndex: https://docs.affirm.com/llms.txt
  projectIndex: https://docs.affirm.com/developers/v1.0-Global-Integration/llms.txt
---

# Installation

## Overview

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

> 📘 Recommendations
>
> * Install the extension in your sandbox or staging environment before pushing it live
> * Keep a copy of your Adobe Commerce (Magento) store and database to ensure you can revert to the original version prior to the installation
> * You may need to re-index all the product and category tables after extension installation

***

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

> 📘
>
> Please see the additional instructions [for Adobe Commerce (Magento) 2.2 and lower.](https://docs.affirm.com/developers/v1.0-Global-Integration/docs/faq#how-do-i-get-affirm-checkout-to-work-with-magento-22-or-lower)

### 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 **Adobe Commerce (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 (Magento) cache to use the default Adobe Commerce (Magento) Affirm configuration. For Adobe Commerce (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)

> 📘
>
> Ensure the correct release is compatible with your version of Adobe Commerce (Magento)

2\.  If it does not 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 Magento 2 root directory, run the following commands:

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

6\. Clear the Magento 2 cache to use the default Magento 2 Affirm configuration.

# Sibling pages

* [Processing Affirm Transactions in Adobe Commerce (Magento)](https://docs.affirm.com/developers/v1.0-Global-Integration/docs/processing-affirm-transactions-in-magento-2.md)
* [Configure Affirm](https://docs.affirm.com/developers/v1.0-Global-Integration/docs/magento-2-configure-affirm.md)
* [Add Affirm Promotional Messaging to Adobe Commerce (Magento)](https://docs.affirm.com/developers/v1.0-Global-Integration/docs/add-affirm-promotional-messaging-to-magento.md)
* [FAQ](https://docs.affirm.com/developers/v1.0-Global-Integration/docs/faq.md)
* [Adobe Commerce (Magento) Telesales Integration](https://docs.affirm.com/developers/v1.0-Global-Integration/docs/magento-2-telesales-integration.md)