X-Cart Version Requirements

Your X-Cart store must be on version 5.4.1 or above to integrate with Affirm.

You can find the current version of your X-Cart Store by logging in following these steps: <https://support.x-cart.com/en/articles/5019167-admin-area-home-page#h_f96185d794>

For additional information on updating your X-Cart store, you can contact X-Cart support or visit the following URL: <https://support.x-cart.com/en/articles/4479959-update-step-1-checking-for-updates>

## Download Affirm App

Please take a look at [X-Cart's installation guide](🔗) for detailed, step-by-step instructions.

## Enable and Configure Affirm

  1. Go to **Store Setup > Payment Methods**.

  2. Locate Affirm in the list of payment methods and click **Configure** .

  3. Enter your API keys:

    • **Sandbox API Public Key** (optional) - If sandbox testing, enter the Public Key from your [Affirm sandbox dashboard](🔗)

    • **Sandbox API Private Key** (optional) - If sandbox testing, enter the Private Key from your [Affirm sandbox dashboard](🔗)

    • **API Public Key** - Enter the Public Key from your [Affirm dashboard](🔗)

    • **API Private Key** - Enter the Private Key from your [Affirm dashboard](🔗)


    Enable Affirm in Canada

    To enable Affirm in Canada, please ensure that **CAD** is configured in the **X-Cart default currency settings**. For guidance on configuring your store's currency in X-Cart, please refer to this [link](🔗).

  4. Configure _Other settings_.

**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 _Paid_ in X-Cart. **Authorize Only** allows you to capture the funds manually. Your order will have the status of _Authorized_ in X-Cart. _(If you select \_Authorize Only_, once you manually capture the order in X-Cart, the charge will be captured automatically in Affirm. Click [here](🔗) to to learn more on how to manually capture transactions within X-Cart.)\_
**Checkout Mode**Can be set to Modal Form or Redirect to Affirm **Modal Form** triggers a pop-up during checkout **Redirect to Affirm** takes the customer offsite to check out If unsure, leave _Modal Form_ selected
**Test/Live Mode**Can be set to Sandbox or Live **Sandbox** should be selected only if performing sandbox testing **Live** should be selected when going live with Affirm.
**Minimum Order Amount**_Optional field_ 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.
  1. Configure _Affirm promo messaging_ settings.

Show on CartEnable Affirm's promotional messaging on your cart page under the cart total (recommended)
Show on CheckoutEnable Affirm's promotional messaging on your checkout page under the Affirm payment option (recommended)
Show on Product pagesEnable Affirm's promotional messaging on your product pages under the product price (recommended)
Show in Product listsEnable Affirm's promotional messaging on your product list (category) pages (recommended)
Enable Enhanced AnalyticsIf you enable Enhanced Analytics, Affirm's tracking pixels are enabled to track specific customer actions in your store across all payment methods. This helps you build a comprehensive picture of your eCommerce site to better understand your customers and fully optimize their shopping experience. If you're unsure whether to enable or disable this feature, leave this feature disabled.
  1. Scroll to the top once you've configured your settings and click **On** underneath the Affirm Settings header. The button will turn green, Affirm will be enabled on checkout, and promotional messaging will be enabled on the pages selected.

(Script tags will be stripped)