Skip to main content

Merchant Help


Affirm Merchant Help

WooCommerce Integration


The Affirm WooCommerce extension will add Affirm to your site and your WooCommerce administration tools:

  • Enable the Affirm payment method in your checkout
  • Add Affirm promotional marketing to your product and cart pages
  • Manage orders paid with Affirm


  1. Purchase the extension:
  2. Read the documentation:
  3. Enable Affirm marketing

Test your Affirm configuration

To test in development mode which points to Affirm sandbox environment, check the Affirm Sandbox checkbox in WooCommerce > Settings > Checkout > Affirm configuration.

Test your configuration to ensure that everything is working before you go live. Email with a link to your test site so that we can verify your configuration and provide you with production keys.

  1. Add an item to the cart on your test site.
  2. Proceed to checkout.
  3. During checkout, enter valid U.S. addresses and mobile-phone information. Affirm cannot test your configuration if the address or phone information is fake.
  4. Select Affirm as the payment option.
  5. Proceed to Affirm's testing environment checkout.

Note: The URL indicates that you are in the testing environment.

6. When prompted for your security PIN, enter 1234.

7. Select terms.

8. Confirm your loan.


9. Wait to ensure that you have been redirected to your confirmation page.

10. Verify that the transaction appears in your platform's admin panel and on

Note: When a customer completes checkout with Affirm as the payment method, Affirm authorizes a charge for the amount of the order. The charge appears in a pending state on the customer’s Affirm account. Authorized transactions expire if they are not captured before the capture deadline. The default capture deadline is specified in your partnership agreement with Affirm. If you did not specify your authorization-period requirements because of inventory, pre-orders, or shipping time in your onboarding form, please email for help with completing this process.


Go live with Affirm financing

After you verify that your configuration is working properly in the sandbox environment, your partnerships team activates your production keys in the dashboard.

  1. Sign in to the Affirm dashboard.
  2. Retrieve the production API keys.
    1. Hover over the profile icon area at the lower-left of the page.
      Screen Shot 2016-03-22 at 7.56.58 AM-2.png
    2. Click the API Keys link that appears.
      Screen Shot 2016-03-22 at 7.56.20 AM.png
    3. Copy the public, private, and financial product keys.
  3. Enter the production API keys into your platform.

    Note: In Shopify, clear the Use test mode check box when you enter your production API keys.

Note: The email address that you use to access the dashboard must be registered as a Google account. Check to see if your existing email address is a Google account or create a new Google account. If you create a new account, use the same construction as the email address that you enter when you sign up without Gmail (for example, becomes so that you don't need to send us a separate address.

Note: Checkbox for Affirm Sandbox should be unchecked in WooCommerce > Settings > Checkout > Affirm configuration.