Configuration: Affirm

Owned by Danny Koressel
Last updated: Apr 11, 2023 by Sarah Holst
5 min read

Setup Checklist

1. POS Tasks

 

1. POS Tasks

 

1. Set up Products in your POS Required

  • Configure products in your POS to be used in the Aspenware Commerce store. No special setup is required to integrate with Affirm

Prerequisite

2. Infrastructure Tasks

 

  • For RTP only: Work with your Aspenware Representative to set ‘CanUpdateAlternateIdProfile’ in rtp-config.json file to “true”. Required

Prerequisite

3. Commerce Tasks

 

1. Ensure that Affirm Payment Provider Plugin is Installed required  

2. Set the Affirm widget to Active required

3. Configure the Affirm payment method required

4. Add the Is Affirm Eligible Classification required

Prerequisite

Language String, Setting, HTML widget optional

  • Configure Affirm language strings during Commerce Prerequisite Tasks.

Prerequisite

1. Configure Affirm Product Required

2. Assign Is Affirm Eligible Product Classification required

Detailed Setup

Prerequisite Tasks

Complete contracting with Affirm

  • You must have signed a contract and been onboarded with Affirm to begin configuration. Be sure you have your API Key and Private API Key from Affirm, as well as your login to the Affirm dashboard.

  • If you’re interested in signing up with Affirm, read the attached Aspenware sales sheet below. Then, email johnston@affirm.com and copy your Aspenware client services representative to get started with the contract process. For more general information about Affirm, see https://www.affirm.com.

 

Infrastructure Tasks

RTP

  • Work with your Aspenware representative to ensure that the ‘CanUpdateAlternateIdProfile’ setting in the rtp-config.json file in Unity is set to true.

Note: Affirm requires the collection and of phone numbers, which Aspenware Commerce uses to update the POS. For RTP, failure to set this to true will result in errors on the payment step in checkout.

Commerce Tasks

1. Ensure that Affirm Plugin is Installed

  • Ensure that the Affirm plugin has been installed by your Aspenware Representative. Go to Configuration > Local Plugins search for the Affirm plugin. If plugin is not installed (matches image below), contact your Aspenware Service Representative. 

2. Set the Affirm widget to active

  • Ensure that the Affirm widget is set to active. Go to Configration > Widgets.

    • Select edit in the Affirm Payment Provider row, and check the Is active column.

3. Configure the Affirm payment method

  • Go to Configuration > Payment methods

    • Select Configure in the Affirm Payment Provider row.

  • For a test store, select Use Sandbox. For a production store, leave this deselected

  • Input your Public API Key and your Private API Key. You can find these by logging into your Affirm portal and navigating to the API Keys tab

  • Input your Minimum Cart Value into the Plugins.Payments.Affirm.Fields.MinimumCartValue field.

 

IMPORTANT: The minimum cart value will restrict customers from using Affirm if their cart total does not meet or exceed the value entered in this field.

4. Add the Is Affirm Eligible product classification

  • Add the Is Affirm Eligible classification if not already set up as a product classification. Check that the Is Affirm Eligible classification is not already set up before adding a new one.

    • Go to Aspenware Commerce > Product Classifications.

    • Select Add Classification in the upper right-hand corner.

    • Enter the following on the Classifications page:

      • Name: Is Affirm Eligible

      • Description: Assign this classification to qualifying Affirm products only

      • Is Affirm Ellible: Check

      • Leave all other checkboxes unchecked.

    • Click Add, which will appear after all the required items are complete (above).

Settings, Language Strings and/or HTML Widgets for this Feature

Language Strings

Updating the content for the area of My Account where guests can manage and view their subscription credit card.

  • Go to Configuration > Languages page in Admin.

  • Click Edit in the English row.

  • From the Edit Language details - English page, click the String Resources tab.

  • The following content is configurable through Language String resources. 

Language String

Value

Location

Language String

Value

Location

affirm.payment.paneltext

Pay over time with Affirm

Within checkout on the payment screen. This is the text associated to for the Affirm payment option.

affirm.payment.text

You will be redirected to Affirm to securely complete your purchase. Just fill out a few pieces of basic information and get a real-time decision. Checking your eligibility won't affect your credit score.

Within checkout on the payment screen. This is the description for the Affirm payment selection.

affirm.confirm.checkoutbuttontext

Pay over time with

Within the confirm Affirm payment screen. This is the button to accept Affirm payments. The Affirm logo will always display after this text.

affirm.confirm.backbuttontext

You have no subscription products.

Within the confirm Affirm payment screen. This is the button to go back to the payment screen.

affirm.confirm.text

If you finance your purchase with Affirm, the first payment date is only an estimate. Your loan and payment schedule will be finalized 5 days before delivery or 90 days after checkout, whichever comes first.

Within the confirm Affirm payment screen. This is the description for Affirm payments.

 

Detailed Setup Guide

  1. Configure Affirm Product

  2. Assign Is Affirm Eligible Product Classification

1. Configure Affirm Product

Affirm payments can be configured on almost any product in your store products are set up similarly to other products. There are no attribute or add-on requirements or disqualifiers (aside from the below).

NOTE: Remember that gift cards and resort charge products cannot be paid for with Affirm. Do not add the Is Affirm Eligible product classification to these products.

2. Assign Is Affirm Eligible Product Classification

Affirm products require the Is Affirm Eligible Product Classification is added.

  • Go to Aspenware Commerce > Product Classifications.

  • Select Add Assignment.

  • Find the desired Category and then Product from the drop-down. 

  • If the Affirm eligibility changes depending on the attribute value, check the specific attribute value (e.g. Adult) as well. 

  • Select the ‘Assign’ checkbox next to the Is Affirm Eligible classification.

  • Scroll to the bottom and click Add.