> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sezzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

> [!NOTE]
>
> Sezzle [Express Checkout](#express-checkout) is now available on `Sezzle WooCommerce Payments` plugin version 6.1.x or later.
>
> The documentation below is based on plugin version 7.x.x or later.

This guide explains how to add Sezzle as a payment option on your WooCommerce website, enabling customers to use Sezzle at checkout.

[YouTube video player](https://www.youtube.com/embed/12PBN0ZlXSg?si=jiTzoJiCgx1K5ouL)

### Install the Sezzle WooCommerce Extension

1. Log in to your website's Wordpress admin
   * Ex: `your-website.com/wp-admin`

     ![1 Login Pn](https://mintcdn.com/sezzle/GHl_qCHt6kQvq9Ws/images/docs/plugins/woocommerce/1-login.png?fit=max\&auto=format\&n=GHl_qCHt6kQvq9Ws\&q=85\&s=eb6df7a0cb4506f165451b2943c8ed0a)
2. In the left sidebar, click `Plugins` > `Add Plugin`
3. Search for `Sezzle`
4. Click `Install Now`

   ![2 Install Sezzle Pn](https://mintcdn.com/sezzle/GHl_qCHt6kQvq9Ws/images/docs/plugins/woocommerce/2-install-sezzle.png?fit=max\&auto=format\&n=GHl_qCHt6kQvq9Ws\&q=85\&s=4b6536f9470996bfdd7f79af05e0cb32)
5. Click `Activate`

   ![3 Activate Sezzle Pn](https://mintcdn.com/sezzle/GHl_qCHt6kQvq9Ws/images/docs/plugins/woocommerce/3-activate-sezzle.png?fit=max\&auto=format\&n=GHl_qCHt6kQvq9Ws\&q=85\&s=ae449572c0e997a8e775e56d6fdf799a)

### Admin Configuration

> [!NOTE]
>
> You can now jump to Sezzle Settings from `Plugins` > `Installed Plugins`, scroll to `Sezzle WooCommerce Payment` and click `Settings`.

1. In the left sidebar, click `WooCommerce` > `Settings`

2. Select the `Payments` tab

3. Click the `Complete setup` button for Sezzle

   ![4 Woo Payments Sezzle Pn](https://mintcdn.com/sezzle/sSlZ0BQ91SJaDreP/images/docs/plugins/woocommerce/4-woo-payments-sezzle.png?fit=max\&auto=format\&n=sSlZ0BQ91SJaDreP\&q=85\&s=7603227c652d150effc849ba431920ba)

4. Set the `Transaction Mode` as `Live` for production and `Sandbox` for sandbox testing mode

5. Copy your `Public Key` and `Private Key` from your [Sezzle Merchant Dashboard](https://dashboard.sezzle.com/merchant/settings/apikeys), and paste them into the corresponding fields
   > [!NOTE]
   >
   > For Sandbox Mode, use [Sandbox Keys](https://sandbox.dashboard.sezzle.com/merchant/settings/apikeys). For more information about Sandbox testing, [click here](https://docs.sezzle.com/docs/api/environments.md).

6. Check the `Enable Sezzle` checkbox to activate the payment option at checkout

7. Set `Minimum Checkout Amount` if you want to restrict Sezzle based on a minimum order total

8. Optional: Check the `Create order post checkout completion` checkbox for enabling WooCommerce order creation only after Sezzle checkout is successfully completed
   > [!NOTE]
   >
   > This will only work with standard classic checkout, not with checkout blocks
   > [!WARNING]
   >
   > Enabling this feature may result in higher uncaptured orders, especially if your store offers add-ons such as shipping insurance. Please refer to the [Order Fulfillment](#important-note-on-order-fulfillment) section for more information.
   ![5 Sezzle Settings Pn](https://mintcdn.com/sezzle/sSlZ0BQ91SJaDreP/images/docs/plugins/woocommerce/5-sezzle-settings.png?fit=max\&auto=format\&n=sSlZ0BQ91SJaDreP\&q=85\&s=cda9519ebeabe2c08e90041bbd56bfbb)

9. The `Merchant ID` will auto-populate once you save your API keys. If you are testing in sandbox mode, the value can be overridden manually to the production ID required for widgets to render.

10. Check the `Product Page Widget` and `Cart Page Widget` checkboxes as desired to display the Sezzle on-site messaging.
    * After saving if you don't see the widget in PDP, contact [merchantsupport@sezzle.com](mailto:merchantsupport@sezzle.com). If you are using Elementor, you may need to [install the script manually](#manual-widget-installation)

11. Under `Checkout Installments Plan`, click `Enable` to display Sezzle installments messaging on the checkout page below the Sezzle payment option.

12. The `Order Total Container Selector` defaults based on the store's theme (Classic or Blocks). If the installments widget does not appear, update this value to the class name or path of the checkout total.

    ![6 Widget Settings Pn](https://mintcdn.com/sezzle/sSlZ0BQ91SJaDreP/images/docs/plugins/woocommerce/6-widget-settings.png?fit=max\&auto=format\&n=sSlZ0BQ91SJaDreP\&q=85\&s=fc34cd14279ff543571c947d0e33b349)

13. Check the `Sezzle Logs` checkbox for logging Sezzle checkout related data
    * This is helpful for debugging issues, if encountered. See [logs](#logs) for more details.
    ![7 Log Settings Pn](https://mintcdn.com/sezzle/sSlZ0BQ91SJaDreP/images/docs/plugins/woocommerce/7-log-settings.png?fit=max\&auto=format\&n=sSlZ0BQ91SJaDreP\&q=85\&s=c6828a9d22077b21244f0e3b602e9077)

14. Click `Save Changes`

### Express Checkout

> [!NOTE]
>
> Currently, the Express Checkout feature is only available for select merchant IDs. Please contact Sezzle Merchant Support if you wish to participate in the beta testing.
>
> Merchant ID and API keys must be entered and saved before this feature will become visible in your Sezzle settings.

> [!WARNING]
>
> Express checkout is not currently compatible with:
>
> * Products which require age verification, such as alcohol, tobacco, cannabinoids, or firearms
> * Shipping protection or other selections that alter the order total during checkout
> * Upsell apps that alter the order total post-checkout
>
> Note: coupon codes can still be used with Express Checkout (cart page only), but must be applied on the merchant's site before the shopper proceeds to Sezzle.

1. Select the desired `Express Checkout Mode`: `Pop Up` or `IFrame`

   > [!NOTE]
   >
   > **popup** mode will work out-of-the-box. No additional configuration is required to use **popup**. Sezzle currently recommends **popup** mode.
   >
   > **iframe** mode will not work properly without first contacting Sezzle. For security reasons, Sezzle must enable **iframe** for your domain(s). To have it enabled, please submit a request with your Sezzle Merchant UUID and a list of domains to be allowed per environment (production and sandbox). For example, [*please enable uat1.mysite.com, uat2.mysite.com in sandbox and www.mysite.com, mysite.com in production*](http://www.mysite.com).
   >
   > The integration for **popup** and **iframe** are identical, aside from the mode. Using **popup** mode will expedite your development. Upon completing the integration, if **iframe** is a requirement, then contact Sezzle to enable your domain(s) and switch the mode to **iframe**.
2. If you do not have any shipping options configured because your store is **exclusively** digital products, buy online pick up in store (BOPIS), or in-person services, check the `I never ship physical products` checkbox.
   > [!WARNING]
   >
   > If this box is checked, an Express Checkout session will **never** prompt the shopper to select a shipping method nor capture fees associated with shipping. If any products may require shipping, the box should remain unchecked.
3. Under `Product Page Button`, check the `Enable Button` checkbox
4. The `Container Selector` defaults based on the store's theme (Classic or Blocks). If the express checkout button does not appear as expected, update this value to the class name or path of the parent element where you want the button to appear.
5. The remaining fields allow you to style the button to suit your theme. These fields accept any standard CSS values for that attribute.
6. Repeat steps 3-5 for `Cart Page Button`
7. Click `Save Changes`

   ![8 Express Settings Pn](https://mintcdn.com/sezzle/sSlZ0BQ91SJaDreP/images/docs/plugins/woocommerce/8-express-settings.png?fit=max\&auto=format\&n=sSlZ0BQ91SJaDreP\&q=85\&s=a81e9603337ace208e7b632c5b47d1f2)

### Validate

Step through a [test checkout](https://docs.sezzle.com/docs/api/test-cards.md#checkout-testing) to validate the integration is properly installed.

> [!WARNING]
>
> **Using a CDN, caching, security or firewall plugin** such as Cloudflare, Litespeed, WP Rocket, W3 Total Cache? You may need to allowlist `/wc-api/wc_gateway_sezzlepay/` or create a redirect rule to `/index.php?wc-api=WC_Gateway_Sezzlepay`.

### Important Note on Order Fulfillment

After the shopper completes checkout, orders will be validated to ensure the Sezzle authorized total matches the order total in Woocommerce prior to payment capture. Uncaptured orders should remain in the `Pending Payment` stage in WooCommerce. However before shipping the order, ensure that the Order in the WooCommerce interface show the order status is `Processing` and reflects the Note `Payment approved by Sezzle`. When these notes exist, Sezzle successfully captured the payment and you will be paid for the order.

Do not fulfill orders where the Sezzle payment was not captured. Please provide the [logs](#logs) to Sezzle Merchant Support for further investigation.

### Logs

1. From your WP admin, go to WooCommerce > Status
2. Click the Logs tab
3. In the `All Sources` dropdown, select `sezzlepay` then click `Filter`
4. Select the files for all dates for the investigation
5. In the `Bulk Actions` dropdown, select `Download` then click `Apply`

### A Guide to Order Reference IDs

| Setting | Format | Description |
| - | - | - |
| Standard checkout with`Create Order Post Checkout Completion`: ON | 6903bd4e9a370 | unique ID; order ID # not yet assigned |
| Standard checkout with`Create Order Post Checkout Completion`: OFF | 6903bd072eef3-103 | unique ID + order ID # |
| Express checkout with`Create Order Post Checkout Completion`: ON | 7373a6360061102dcc43e03fc473da28 | Cart Hash; Order Key not yet assigned |
| Express checkout with`Create Order Post Checkout Completion`: OFF | wc\_order\_rq9mAmVMhMfdh | Order Key |

### Manual Widget Installation

> [!NOTE]
>
> #### Using Elementor?
>
> Within the Elementor Page Builder, drag and drop the Custom HTML block type into the site footer, adding the widget script snippet into the code box, then save and publish changes.

1. In your WooCommerce account, go to `Appearance`, and then `Theme Editor`
2. Click `Theme Footer` to the right of the page
3. In the Content text area, insert the script on the last line of the code, and click `Update File`

   * The script below is what you will need to insert:

   ```
   <script src="https://widget.sezzle.com/v1/javascript/price-widget?uuid={sezzle_merchant_uuid}"></script>
   ```

   > [!NOTE]
   >
   > * You will need to update the `{sezzle_merchant_uuid}` in the above script to reflect your store’s UUID.
   > * You can find your UUID in your Sezzle dashboard, under `Settings`, and then `Business`.
   > * When you enter your UUID, please make sure that you remove the `{}` surrounding it.

### Troubleshooting

If testing was unsuccessful, review the following:

1. Sezzle WooCommerce extension is the most updated version
   1. Go to `Plugins` > `Installed Plugins`
   2. Click `View Details` next to the `Sezzle WooCommerce Payment`
   3. If there is an option to upgrade, do so now
2. Sezzle extension is activated
   1. Go to `WooCommerce` > `Settings`
   2. Select the `Payments` tab and open the Sezzle settings
   3. Ensure the `Enable/Disable` checkbox is checked
3. Merchant ID populated with production ID
4. API Keys were entered correctly

   > [!TIP]
   >
   > It is recommended to use the Copy icon in the [Sezzle Merchant Dashboard](https://dashboard.sezzle.com/merchant/settings/apikeys) to avoid typos or extra spaces
5. If you have multiple accounts with Sezzle, the merchant ID and API Keys are tied to only one URL
6. `Product Page Widget` and/or `Cart Page Widget` checkboxes are checked
7. Widget script is present on your website and reflects the Merchant ID from your [Sezzle Merchant Dashboard](https://dashboard.sezzle.com/merchant/settings/business)
   1. Go to a product page on your website
   2. Right-click then select `Inspect`
   3. In the `Elements` tab, search for `widget.sezzle`

### Uninstall Steps

1. Go to `Plugins` > `Installed Plugins`
2. Under `Sezzle WooCommerce Payment`, click `Deactivate` then click `Delete`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.