Affirm

  1. Installation
  2. Setup
  3. Customer Usage
  4. Order Review
  5. FAQ
  6. Troubleshooting

The Affirm plugin extends WooCommerce, allowing your store to accept payments directly via Affirm’s API.

Note: Affirm requires an SSL certificate on your site.
Note: Affirm requires your WooCommerce site to be configured for USD or CAD as its currency. Other currencies are NOT supported.
Note: The Affirm gateway is available during checkout for US customers only. Customers based in other countries will not be able to use Affirm.
Affirm supports refunds in WooCommerce 2.2+.

Installation ↑ Back to Top

  1. Unzip and upload the plugin’s folder to your /wp-content/plugins/ directory.
  2. Activate the extension through the ‘Plugins’ menu in WordPress.
  3. Install and activate the WooThemes Helper plugin
  4. Go to: Dashboard > WooThemes Helper and add your license key to activate the product for 2-click updates.
  5. Go to: WooCommerce > Settings > Checkout> Affirm to configure the plugin.

To learn more about installing and managing plugins, see Installing and Managing Plugins.

Setup ↑ Back to Top

In WooCommerce’s Checkout settings, enable Force Secure Checkout.

Force Secure Checkout.

In Affirm’s settings, enter your public key, private key, and financial product keys (obtained from your Affirm account). Once enabled, Affirm will display during checkout.

Enter keys.

Customer Usage ↑ Back to Top

First, customers (US only) select Affirm on the checkout page.

Affirm Place Order

Then they will be redirected to Affirm to complete payment and will see something like the following:

Affirm Checkout

Order Review↑ Back to Top

For your convenience, a link to the Affirm merchant portal for each order is provided at the top of the order view. You can also prompt Affirm to issue refunds from the order view.

Affirm Order View

FAQ ↑ Back to Top

The method is not showing.

Your site's currency must be set to USD or CAD. Also, customers must have a US or CA based billing address to use Affirm. Finally, in live mode, SSL must be enabled in order to use Affirm.

Nothing happens when the customer attempts to pay with Affirm

This error may be caused by non-standard/poorly coded themes and JavaScript (JS) issues. Common issues include:

  1. JavaScript errors on the checkout page – To view the error, open up your browser error console (in Chrome: View > developer > JavaScript console) and look for red errors. This should indicate where the error is located and lead you to the problem, i.e., loading jQuery incorrectly
  2. Failing to load scripts – Affirm loads JavaScript which it needs to function. If these are not loaded you will see errors. The most common reasons for not loading are:
    1. A theme missing wp_head() or wp_footer() calls
    2. Old overridden template files from WooCommerce inside your theme
    3. Loading headers/footers in a non-standard way. WooCommerce uses get_header()’s get_header action to init the checkout and load scripts. If you are not using get_header() you either need to do so, or you need to trigger the get_header action manually using: do_action( ‘get_header ); in your custom header loader.

Is it possible to override templates on the Affirm pages?

No. These pages are served by Affirm.

Troubleshooting ↑ Back to Top

The customer gets an error when attempting to pay using Affirm.

Ensure that you have input the correct keys and, if you are in live mode, you have entered live keys (not test keys).