Configuring Affirm for SFCC

Learn how to add Affirm as a payment method to SFCC.

🚧

Supported Versions

In-line checkout is only available on version 20.1.0 and above.

Configuration

After installation, enable Affirm as a payment method by updating these configurations:

1. In the Business Manager go to Merchant Tools > Site Preferences > Custom Preferences > AFFIRM_PAYMENT.
2. Set Affirm Online Status to Yes.
3. Enter the Affirm Public Key and Affirm Private Key (Affirm Financial Product Key is deprecated) you retrieved from the Affirm sandbox merchant dashboard.
4. Set Affirm Mode to Sandbox for testing.
5. If your checkout process automatically captures the charge, set Affirm Payment Action to Authorize and Capture.
6. Enter the dollar amount values for Payment Min Total and Payment Max Total that displays Affirm as a payment option to your customers when checking out.
7. Set Checkout Flow to Redirect (default) or Modal to control the Affirm checkout flow.
8. Set Enable Affirm Analytics to Yes to enable analytics tracking for the order confirmation page.

📘

  • VCN Payment Instrument should be disabled unless virtual card integration is enabled for your merchant account
  • Leave the Financing program fields blank. This is now managed by Affirm unless you are offering multiple financing programs on a SKU, category or product level. To learn more about MFPs and how to set them up in Commerce Cloud, contact your Client Success Manager.

9. In the Business Manager, go to Administration > Operations > Services > Service Credentials.
10. Choose New.
11. Enter the following details:

  • Name: Affirm
  • User: Affirm Public Key
  • Password: Affirm Private key

Add Affirm promotional messaging

Add Affirm promotional messaging ---which includes monthly payment messaging and educational modals---on your product, category, and cart pages.

1. In the Business Manager main page, go to Merchant Tools > Site Preferences > Custom Site Preferences > Affirm.
2. Set the following to Yes to display messaging on those pages:

  • Product Promo Message (product pages)
  • PLP Promo Message (category pages)
  • Cart Promo Message (cart page)

3. Enter a Promo Min Total value to set the minimum threshold dollar amount that will display monthly payment messaging (e.g., setting the Promo Min Total to 100 will only display monthly payment messaging for products above $100)
4. If you have been provided with a Promo ID by the Affirm team, you can optionally enter a Promo ID value, to customize messaging (prepend the Promo ID value with default|data-promo-id and set Default financing program to default). Otherwise, leave all the "Financing Program" related field blank.


Enable Inline checkout

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

How it works

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 Split pay and Installment options.This image displays the Inline flow for Split pay and Installment options.

This image displays the Inline flow for Split pay and Installment options.

Enable Inline Checkout Messaging

1. In the Business Manager main page, go to Merchant Tools > Site Preferences > Custom Site Preferences > Affirm.
2. Set the Show Affirm Inline Checkout Messaging to Yes.


Using Multiple Financing Programs

Multiple Financing Programs (MFPs) allow you to offer custom financing programs to your customers based on rules you define in Salesforce Commerce Cloud. To learn more about MFPs and how to set them up in Commerce Cloud, contact your Client Success Manager.


Related topics

You're all set! Next you can learn about setting up your OMS and processing transactions with us. If you're ready to get up and running, head over to our testing & deployment docs.

Did this page help you?