Skip to main content

Merchant Help


Affirm Merchant Help

3dcart Integration


The Affirm 3dcart integration:

  • Enables the Affirm payment method in your checkout
  • Adds Affirm promotional marketing to your product and cart pages
  • Manages orders paid with Affirm

Retrieve keys

  1. Sign in to
  2. Retrieve 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.

Install Affirm

  1. Open the 3dcart Online Store Manager
  2. Go to Settings >Payment
  3. Click Select Payment Methods


  4. Click Add New


  5. Enter the following information:
    • Payment Method: Affirm 
    • Country: United States (Affirm is currently only supported in the U.S.)
    • State: All 
    • Order Amount: Enter a minimum and maximum Affirm order size if you want to add these restrictions
    • Customer Group: None (or choose a customer group to limit Affirm availability to that group)


  6. Enter your Affirm account information and then click Add New
  7. Configure the following Affirm settings:
    • Caption: Affirm Monthly Payments
    • ON: Check this box to make Affirm visible on your site 
    • Test Mode: Check this box when you test with Sandbox API keys. Clear this box when you input your Production API keys
    • Public Key: Retrieved from Affirm Dashboard
    • Private Key: Retrieved from Affirm Dashboard
    • Financial Product Key: Leave this field black as this is now deprecated
    • Authorize-only: Check this box to authorize only when the order is created
      Note: Affirm recommends that you use this setting to authorize when the order is created and then capture when you ship the item
    • Add Affirm Monthly Payment Messaging:
      • Show Monthly Payment Messaging: Set this to "All" to display monthly payment messaging on both product and cart page
      • Data Promo ID: Add a promo-id value provided by the Affirm Client Success Team (Optional)



If you are using a custom template for your product or cart pages, the above configuration Monthly Payment Messaging may not work depending on your template version. In this case, to include promotional messaging on both product and cart pages, you would add the following code into your template files:

  _affirm_config = {
    public_api_key:  "XXXXXXXXXXXXXXXX",
    script:          ""
  (function(l,g,m,e,a,f,b){var d,c=l[m]||{},h=document.createElement(f),n=document.getElementsByTagName(f)[0],k=function(a,b,c){return function(){a[b]._.push([c,arguments])}};c[e]=k(c,e,"set");d=c[e];c[a]={};c[a]._=[];d._=[];c[a][b]=k(c,a,b);a=0;for(b="set add save post open empty reset on off trigger ready setProduct".split(" ");a<b.length;a++)d[b[a]]=k(c,e,b[a]);a=0;for(b=["get","token","url","items"];a<b.length;a++)d[b[a]]=function(){};h.async=!0;h.src=g[f];n.parentNode.insertBefore(h,n);delete g[f];d(g);l[m]=c})(window,_affirm_config,"affirm","checkout","ui","script","ready");
  // Use your live public API Key and script to point to Affirm production environment.
 <div class="affirm-as-low-as" data-amount="" id="as-low-as-refreshable"></div>
    var refreshable = document.getElementById('as-low-as-refreshable');
    if (refreshable){
    var amount = "[price]".replace(/[^0-9]+/g,"");
    refreshable.setAttribute('data-amount', amount);

Note: [price] variable for listing page can be found here.

Test your 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 Affirm Sandbox environment, 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.

Retrieve Live API keys

  1. Go to the API keys page in the Affirm dashboard.
  2. Retrieve your live API keys.
  3. Enter the live API keys into your integration/platform.

Update Affirm URL and script references

  1. Affirm JS URL:
  2. Affirm API base URL:

Note: Ensure that the "Test Mode" checkbox is unchecked in the Affirm Payment method configuration settings when production API keys are used.