Multiple Financing Programs in Adobe Commerce
Overview
Multiple Financing Programs (MFPs) in Adobe Commerce enables you to selectively offer a specific custom financing program to consumers based on product or category attributes in your catalog, and site-wide, time-based programs.
Financing programs are defined by the following inputs:
- Interest rate (APR) range: APR, or Annual Percentage Rate, is the cost of credit (i.e., interest) as a yearly rate.
- Range of loan term lengths: The loan term length is the number of months that a customer has to repay the loan.
- Merchant fee (MDR): The merchant fee is a percentage of the purchase price that gets deducted from the settlements made to the merchant.
How do I start using Multiple Financing Programs?
If you're looking to offer financing options that are tailored to your store, we can help! Just connect with our Affirm Support team and we'll work together to create custom financing solutions that suit your needs. However, please keep in mind that not all merchants are eligible for these tailored financing programs.
Once your financing program is established, you'll receive a financing program ID and Promo ID, which will be very important in the next steps of implementing the MFP. The Affirm Promo ID ensures that the terms are accurately represented in our marketing communications, monthly payment breakdowns, and the checkout modal. Meanwhile, the financing program value determines these terms at checkout.
Get started with MFP
Once you have named your financing program, you're all set to set up the Affirm Adobe Commerce extension to activate that program based on certain conditions. To help you get started, we've provided some examples of how to fill in the necessary fields for a particular promotion and what you can expect as a result.
How are different rules ranked?
This chart illustrates the relative ranking of the financing programs that are defined in Magento:
| Ranking | Type of financing program | Options |
|---|---|---|
| 1 | Product-level | Inclusive |
| 2 | Product-level | Exclusive |
| 3 | Category-level | Inclusive |
| 4 | Category-level | Exclusive |
| 5 | Cart-size | |
| 6 | Date | |
| 7 | Default |
| Site-level programs | Items in cart | Financing programs (ranked) |
|---|---|---|
| * Cart-size | - Item 1 - Product 1 - financing program (inclusive) = "product_program" - Category 1 - financing program (inclusive) = "category_program" - Item 2 - Product 1 - no financing programs | 1. product_program 2. category_program 3. cart_program 4. date_program 5. default_program |
Financing programs
Offer a financing program only for specific products
- Go to the Affirm MFP settings: System -> Configuration -> General -> Affirm Promos -> Multiple Financing Program.
- All Financing Program fields here should be blank. All other fields on that page that are not related to Financing Programs should be untouched.
- Navigate to the product where you want to offer this financing program and edit the product.
- Go to the bottom of the page and fill in these fields:
- Financing Program Value
- Inclusive or Exclusive
- Priority
- Time based
- Affirm Promo ID
- Save your configuration.
Scenarios
| Scenario | Cart item 1 | Cart item 2 | Program selected |
|---|---|---|---|
| Consumer picks out two products, one with an inclusive product-level program and one without a financing program. | Product 1 - financing program = "zero_percent" - inclusive - priority 1 | Product 3 Has no financing program | zero_percent |
| Consumer picks out one product, one with an exclusive product-level program. This is the only scenario where this exclusive program is applied. | Product 2 - financing program = "zero_percent" - exclusive - priority 1 | No product | zero_percent |
| Consumer picks out two products, one with an exclusive product-level program, and one without a financing program. | Product 2 - financing program = "zero_percent" - exclusive - priority 1 | Product 8 has no financing program | none |
Offer a financing program for a weekend
- Go to the Affirm MFP settings: System -> Configuration -> General -> Affirm Promos -> Multiple Financing Program
- Fill in these fields for offering a financing program for all the products for a weekend
- Financing Program Name
- Start date for Financing Program Value
- End date for Financing Program Value
- Affirm Promo ID
- All other fields on that page that are not related to Financing Programs should be untouched.
- Save your configuration.
Scenarios
| Scenario | Cart item 1 | Cart item 2 | Program selected |
|---|---|---|---|
| - Consumer picks out products with no financing programs. - Current date is inside the financing program's date range. - (financing program = "zero_percent") | Product 1 no financing programs | Product 3 no financing programs | zero_percent |
| - Consumer picks out products with no financing programs. - Current date is outside the financing program's date range. - (financing program = "zero_percent") | Product 2 no financing programs | Product 2 no financing programs | none |
Offer a financing program for an entire category of products
- Go to the Affirm MFP settings: System -> Configuration -> General -> Affirm Promos -> Multiple Financing Program.
- All Financing Program fields here should be blank. All other fields on that page that are not related to Financing Programs should be untouched.
- Navigate to the category where you want to offer this financing program and edit the category: Catalog -> Manage Categories -> General Information.
- Go to the bottom of the page and fill in these fields:
- Financing Program Value
- Inclusive or Exclusive
- Priority
- Time based
- Affirm Promo ID
- Save your configuration> Offer financing program on a weekend in addition to product-specific financing programs.
Scenarios
| Scenario | Cart item 1 | Cart item 2 | Program selected |
|---|---|---|---|
| Consumer picks out two products, one with an inclusive product-level program and one without a financing program. | Product 1 No financing program Category 1 - financing program = "zero_percent" - inclusive - priority 1 | Product 3 - no financing program Category 1 no financing program | zero_percent |
| Consumer picks out one product, one with an exclusive product-level program. This is the only scenario where this exclusive program is applied. | Product 2 No financing program Category 1 - financing program = "zero_percent" - exclusive - priority 1 | No product | zero_percent |
| Consumer picks out two products, one with an exclusive product-level program, and one without a financing program. | Product 2 no financing program Category 1 - financing program = "zero_percent" - exclusive - priority 1 | Product 8 has no financing program Category 2 - financing program = "zero_percent" - exclusive - priority 1 | none |
| Consumer picks out two category, one with an exclusive category-level program, and one without a financing program. | Product 2 no financing program Category 1 - financing program = "zero_percent" - exclusive - priority 1 | Product 8 no financing program Category 2 - financing program = "zero_percent" - exclusive - priority 1 | zero_percent |
Offer financing program on a weekend in addition to product-specific financing programs
- Go to the Affirm MFP settings: System -> Configuration -> General -> Affirm Promos -> Multiple Financing Program.
- Fill in these fields:
- Financing Program Name
- Start date for Financing Program Value
- End date for Financing Program Value
- All other fields on that page that are not related to Financing Programs should be untouched.
- Save your configuration.
- Navigate to the product where you want to offer this financing program and edit the product.
- Go to the bottom of the page and fill in these fields:
- Financing Program Value
- Inclusive or Exclusive
- Priority
- Affirm Promo ID
- Save your configuration.
Scenarios
These are some common scenarios that illustrate which financing program would be chosen based on the products that are in cart.
| Scenario | Cart item 1 | Cart item 2 | Program selected |
|---|---|---|---|
| Consumer picks out two category, one with an inclusive product-level program, and one no financing programs. Current date is inside the financing program's date range. (financing program = "zero_percent") | Product 2 - financing program = "zero_percent" - inclusive - priority 1 | Product 8 - no financing program | zero_percent_plus |
| Customer selects two products, with an inclusive product-level program, and one no financing programs. Current date is inside the financing program's date range. (financing program = "zero_percent") | Product 2 - financing program = "zero_percent" - exclusive - priority 1 | Product 8 - no financing program | zero_percent |
| Customer selects one product with an exclusive product-level program. Current date is inside the financing program's date range. (financing program = "zero_percent") | Product 2 - financing program = "zero_percent" - exclusive - priority 1 | No product | zero_percent_plus |
Offer a financing program only for large carts, or for specific products
- Go to the Affirm MFP settings: System -> Configuration -> General -> Affirm Promos -> Multiple Financing Program.
- Scroll to the 'Cart-size Financing program value' field.
- Enter the financing program here that will be offered for all purchases over a given amount.
- Now enter the minimum and maximum cart amounts that will receive this program.
- Save your configuration and navigate to the product where you want to offer this financing program and edit the product.
- Go to the bottom of the page and fill in these fields:
- Financing Program Value
- Select Inclusiveor Exclusive
- Priority
- Affirm Promo ID
- Save the configuration.
Scenarios
| Scenario | Cart item 1 | Cart item 2 | Program selected |
|---|---|---|---|
| Consumer picks out products from two categories, one with an inclusive category-level program and one without a financing program. | Product 1 No financing program Category 1 - financing program = "zero_percent" - inclusive - priority 1 | Product 3 - no financing program Category 1 no financing program | zero_percent |
| Consumer picks out one category, one with an exclusive category-level program. This is the only scenario where this exclusive program is applied. | Product 2 No financing program Category 1 - financing program = "zero_percent" - exclusive - priority 1 | No product | zero_percent |
| Consumer picks out two category, one with an exclusive category-level program, and one without a financing program. | Product 2 no financing program Category 1 - financing program = "zero_percent" - exclusive - priority 1 | Product 8 has no financing program Category 2 - financing program = "zero_percent" - exclusive - priority 1 | none |
| Consumer picks out two category, one with an exclusive category-level program, and one without a financing program. | Product 2 no financing program Category 1 - financing program = "zero_percent" - exclusive - priority 1 | Product 8 no financing program Category 2 - financing program = "zero_percent" - exclusive - priority 1 | zero_percent |
Tutorial
Install the latest extension
- Install Adobe Commerce.
- Create rules
There are fields for 'Financing program values' in three areas of the Magento 2 admin tools, where priority based rules (Product-level > Category-level > Cart-size > Time-based > Default) are defined:
- Affirm MFP Configuration:
- Stores -> Configuration -> General -> Affirm Promos -> Multiple Financing Program
- Default Financing Program Value
- Date range rule
- Cart-size rule
- Product Editor: Catalog -> Manage Products -> Action -> Edit
- Catalog Editor: Catalog -> Manage Categories -> General Information
Depending on what the conditions are for a particular financing program, you will need to make edits to these areas of your Affirm configuration and product catalog.
Note
This assumes you already have been provided with a financing program ID and Promo ID. If you have not received one, please contact [email protected]. Financing programs cannot be based on any other term or condition at this time.
Site-wide financing programs:
- Visit System > Configuration > General -> Affirm Promos -> Multiple Financing Program.
- Enter the Default Financing Program value.
- Visit System > Configuration > General -> Affirm Promos -> As Low As Functionality.
- Enter the Default Affirm Promo ID.
Date-range financing programs:
- Visit System > Configuration > General -> Affirm Promos -> Multiple Financing Program.
- Enter the following:
- Financing Program value
- Start date for Financing Program value
- End date for Financing Program value
- Affirm Promo ID
Cart-size financing programs:
- Go to System > Configuration > Payment Methods (under Sales) > Affirm.
- Enter the following details:
- Cart-size Financing Program value
- Financing Program Minimum Order Total
- Financing Program Maximum Order Total (maximum Affirm loan is $17,500, so anything above that will require a downpayment)
- Cart-size Affirm Promo ID
Category-level financing programs
Category-level financing programs will apply a financing program to a customer's cart when one or more items are from that category. The financing program will apply to the customer's entire cart, even items in the cart which may not qualify for a financing program on their own.
- Visit Products > Categories > Select a Category > Custom.
- Enter the Multiple Financing Program ID you were provided by Affirm Client Success into the 'Multiple Financing Program value' field.
- Enter the Affirm Promo ID you were provided by Affirm Client Success into the 'Affirm Promo ID' field.
Product-level financing programs:
Product-level financing programs will apply a financing program to a customer's cart when the product is included in the cart. The financing program will apply to the customer's entire cart, even items in the cart which may not qualify for a financing program on their own.
- Visit Products > Catalog > Action > Edit .
- Scroll to the bottom of the page to Enter the Multiple Financing Program ID you were provided by Affirm Client Success into the Multiple Financing Program Value field.
- Enter the Affirm Promo ID you were provided by Affirm Client Success into the 'Affirm Promo ID' field.
If you have any questions about offering financing programs, please contact us.
Logic for selecting a financing program
The Affirm Adobe Commerce extension allows you to define multiple financing programs at many different levels, and the application of those rules is such that the default program will be used if there is any ambiguity as to which program has priority (Product-level > Category-level > Cart-size > Time-based > Default).
The table details some scenarios where different financing programs could be applied, and what the result for the cart in Adobe Commerce would be:
| Scenario | Cart Item 1 | Cart Item 2 | Program |
|---|---|---|---|
| Consumer picks out two products, one with an inclusive product-level program and one without a financing programs. | Product 1 - financing program = "zero_percent" - inclusive - priority 1 | Product 3 has no financing program | zero_percent |
| Consumer picks out two products, one with an inclusive product-level program, and one with an exclusive product-level program. | Product 1 - financing program = "zero_percent" - inclusive - priority 1 | Product 4 - financing program = "increased_approvals" - exclusive - no priority | zero_percent |
| Consumer picks out two products, one with an inclusive product-level program, and one with an inclusive product-level program of a lower priority. | Product 1 financing program = "zero_percent" inclusive * priority 1 | Product 5 financing program = "18_months" inclusive * priority 2 | zero_percent |
| Consumer picks out two products, one with an inclusive product-level program, and one with an inclusive product-level program with the same name and priority. | Product 1 financing program = "zero_percent" inclusive * priority 1 | Product 6 financing program = "zero_percent" inclusive * priority 1 | zero_percent |
| Consumer picks out two products, one with an inclusive product-level program, and one with an inclusive product-level program with a different name but the same priority. This is a priority conflict and is intended functionality. This would be how you setup inclusive programs that are not compatible with one another. | Product 2 financing program = "zero_percent" inclusive * priority 1 | Product 7 financing program = "zero_percent_2" inclusive * priority 1 | none |
| Consumer picks out two products, one with an exclusive product-level program, and one without a financing program. | Product 2 financing program = "zero_percent" exclusive * priority 1 | Product 8 no financing program | none |
| Consumer picks out one product, one with an exclusive product-level program. This is the only scenario where this exclusive program is applied. | Product 2 financing program = "zero_percent" exclusive * priority 1 | No product | zero_percent |
| Consumer picks out one product, one with an exclusive product-level program. This is the only scenario where this exclusive program is applied. | Product 2 financing program = "zero_percent" exclusive * priority 1 | No Product | zero_percent |
| Consumer picks out one product, one with an exclusive product-level program. This is the only scenario where this exclusive program is applied. | Product 2 financing program = "zero_percent" exclusive * priority 1 | No product | zero_percent |
Compliance with Consumer Protection Laws and Requirements
MFPs must comply with applicable federal, state, and local fair lending laws, regulations, and regulatory guidance. The purpose of fair lending standards is to ensure that individuals seeking financing are treated fairly and consistently. Generally, financing options must be offered to all qualified consumers without discrimination on the basis of race, color, religion, national origin, sex, marital status, age (provided that the applicant has the capacity to enter into a binding contract), the applicant's receipt of income through a public assistance program, the applicant's good faith exercise of a right under the federal Consumer Credit Protection Act, military status, sexual orientation, and other factors that may be prohibited under applicable state and local requirements. For example: merchants whose MFPs exclusively provide promotional pricing on items that appeal more to female customers than male customers may be found to be in non-compliance with fair lending requirements.
MFPs must also comply with the prohibitions in Title X of the Dodd-Frank Act and Section 5 of the Federal Trade Commission Act relating to unfair, deceptive, and abusive acts or practices. In essence, terms and conditions of financing programs must be clearly and accurately communicated to consumers.
Affirm reserves the right to request modifications to a financing program if it determines that the program may run afoul with applicable consumer protection requirements. Violating any applicable consumer protection requirement is a breach of your agreement with Affirm and can be grounds for termination as an Affirm merchant (and may result in legal action).
Reporting
In your settlement reports, we will include the financing program name that was active for a given transaction.
Updated 4 months ago