Skip to main content

Merchant Help


Affirm Merchant Help

Web Shop Manager Integration



The Affirm Web Shop Manager integration:


Please note: In order to enable Affirm in Web Shop Manager, you will need to Web Shop Manager support to enable Affirm. Please coordinate by emailing

Your Affirm Client Success Manager will activate your Affirm Live environment access. This will allow you to sign into the Live version of the Merchant Dashboard, as well as access your Live API keys.

  1. To retrieve the API Keys, go to the API keys page in the Affirm dashboard.

    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. You can link your existing work email address to a Google account by signing up without Gmail.
  2. Retrieve your live 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 keys.
  3. Your WSM account manager has to enable Affirm Monthly Payments to have it display in your Web Shop Manager admin. Once this configuration is enabled, follow the steps:
    1. In your Web Shop Manager admin, go to System → Configuration → Payment & Processing → Payment Method → Affirm
    2. Enter Affirm Public Key retrieved from Affirm dashboard
    3. Enter Affirm Private Key retrieved from Affirm dashboard
    4. (Optional) Update Minimum Price. Displays Affirm for products and carts above this value; default is set to 50.00
    5. Check Affirm Messaging checkbox and fill the input field with a data-promo-id value. Default value should be promo_set_default_fp
      • Shopping Cart Messaging - Displays Affirm monthly payment messaging on the cart page
      • Product Messaging - Affirm monthly payment messaging on the product pages
      • Category Messaging - Affirm monthly payment messaging on the category pages
    6. (Optional) Modify Affirm Promotional Messaging Customization. This modifies the Monthly payment messaging display on the cart, product, category pages:
      • Message Type (logo or text) Display
      • Affirm Logo Color (blue or black)
      • Enable Learn More Popup link
    7. Additionally, you would need to work with WSM team to add affirm_header Smarty widget tag into the <head></head> of the site's templates:
<!DOCTYPE html>
<!--[if lt IE 7]> <html class="no-js lt-ie9 lt-ie8 lt-ie7" lang="en">
<!--[if IE 7]> <html class="no-js lt-ie9 lt-ie8" lang="en">
<!--[if IE 8]> <html class="no-js lt-ie9" lang="en"> <![endif]-->
<!--[if gt IE 8]><!--> <html class="no-js" lang="en"> <!--<![endif]-->
{{ affirm_header }}

Note: After making all the configuration changes, Web Shop Manager will need to purge the cache if you are using Cloudflare CDN


Go Live with Affirm Financing

Once Affirm is enabled on your site, your Affirm Technical Contact can help place a test order.