Configure Affirm in BigCommerce
Integrate Affirm into your BigCommerce platform.
Overview
This guide walks you through integrating Affirm with your BigCommerce platform.
Using Blueprint?
Checkout out our documentation on integrating Affirm on BigCommerce Blueprint.
Sandbox development
You should have received an email inviting you to create an Affirm account. Click here for information about accessing your account.
Develop and test the Affirm integration in your development environment connected to our sandbox. To use our sandbox, retrieve your sandbox API keys at https://sandbox.affirm.com/dashboard/#/apikeys .
After development and testing, you will need to update your integration to use your live API keys, which can be found at https://affirm.com/dashboard/#/apikeys.
Step 1: Confirm your website is using Optimized one-page checkout
First, confirm that the Optimized one-page checkout is enabled. The Affirm integration for BigCommerce requires the use of the Optimized one-page checkout.
Go to Advanced Settings > Checkout. If you do not see the Checkout Type setting, that means you are already using the Optimized one-page checkout and can proceed to the next step.
If you are on a legacy checkout, you will see the Checkout Type field available with either Single-page express checkout or Multiple-page checkout selected. To enable Affirm, you will need to select Optimized one-page checkout and click Save. (Details on Optimized one-page checkout can be found here)
Step 2: Enable Affirm as an online payment method
1. Go to Store Setup › Payments and find Affirm on the list of Online Payment Methods.
2. Click Set up.
3. From the Affirm Settings tab, enter the API key pair credentials from your Affirm merchant account into the corresponding fields.
| Field | Description |
|---|---|
| Public Key | The Public Key from your Affirm dashboard. |
| Private Key | The Private Key from your Affirm dashboard. |
| Minimum Order Value | The minimum order amount (before taxes and discounts) that must be met before Affirm displays as an option at checkout. If blank, Affirm will be displayed for all orders over $50. |
| Transaction Type | Can be set to Authorize & Capture or Authorize Only. - Authorize & Capture will capture your Affirm charge and your order will have the status of Awaiting Fulfillment in BigCommerce. - Authorize Only allows you to capture the funds manually. Your order will have the status of Awaiting Payment in BigCommerce. Once you manually capture the order in BigCommerce, the transaction will also be captured automatically in Affirm. See Manually Capturing Transactions (Authorize Only) to learn more on how to manually capture transactions within BigCommerce. |
| Test Mode | Determines whether your store is in sandbox or Test Mode. Make sure this is enabled until you are ready to take live payments. |
Step 3: Install the Affirm Marketing App
You can find the Affirm Marketing App for BigCommerce on the BigCommerce marketplace. You can also install the app from your BigCommerce dashboard by going to Apps and searching for Affirm. Once you click on install and confirm the terms and conditions, the Affirm Marketing App will be installed onto your store.
Updated 3 months ago
Congrats! You've successfully set up your BigCommerce integration. Next, configure your promotional messaging start providing details on our flexible payment options to your customers.