Skip to main content

​
Purpose

Boost conversions and increase average order value by showcasing Sezzle’s financing options to shoppers as they browse your site.

​
Overview

The Sezzle promotional messaging widget displays available financing options on product and cart pages, encouraging purchases. Follow the installation instructions below to add the widget to your website. Attachment(1) Pn

​
Installation

  • One-Click Installation: Many leading platforms offer one-click installation with Sezzle. Check for compatibility with your platform.
  • Manual Installation: If one-click installation is unavailable or incompatible with your theme, refer to the manual installation guide or contact [email protected] for assistance.

​
Customization

Sezzle provides extensive configuration options to tailor the widget to your site’s needs. Our engineering team is available to ensure seamless integration with your website’s design and functionality.

​
HTML required

<script src="https://widget.sezzle.com/v1/javascript/price-widget?uuid={merchant_id}"></script>
Replace {merchant_id} with your 36-character value from your Merchant Dashboard.

​
Merchant Configured

Configuration is required prior to invoking the price widget script.

​
document.sezzleConfig Options

  • Template
  • Example
  • Options
<script type="text/javascript">
    document.sezzleConfig = {
      configGroups: [
        {
          "targetXPath": string,
          "renderToPath": string,
          "urlMatch": string,
          "theme": string,
          "ignoredPriceElements": [string],
          "ignoredFormattedPriceText": [string],
          "alignment": string,
          "alignmentSwitchMinWidth": number,
          "alignmentSwitchType": string,
          "containerStyle": {
            "property": string,
          },
          "textStyle": {
            "property": string,
          },
          "logoStyle": {
            "property": string,
          },
          "hideClasses": [string],
          "relatedElementActions": [{
            "relatedPath": string,
            "initialAction": function(r,w){}
          }]
        }
      ],
      "language": string,
      "apDualInstall": boolean,
	  "klarnaDualInstall": boolean,
      "minPrice": number,
      "maxPrice": number,
      "observeElements": [
        {
          "eventType": string,
          "element": string
        }
      ]
    }
</script>

​
Simple Example

  • Template
  • Example
<script type="text/javascript">
    document.sezzleConfig = {
        configGroups: [
            {
                targetXPath: string,
            },
        ],
    };
</script>

​
Rendering the Widgets

After building the config, it is time to upload the widgets to your webpages! The SDK needs to be called in the HTML of the webpage for the widgets to be rendered. Place the config and the widget script at the bottom of the code file for the HTML page, and you should be all set! A pre-populated snippet should be provided in your Sezzle Merchant Dashboard Setup Checklist. When using this snippet to add the widget script to your site, you must replace {merchant_id} with the 36-character Sezzle Merchant ID found in the Business Settings of your Sezzle Merchant Dashboard for the applicable store. Please do not re-use IDs across multiple URLs.
The script with the applicable merchant ID must be included after document.sezzleConfig is defined.

​
HTML Needed

<script src="https://widget.sezzle.com/v1/javascript/price-widget?uuid={merchant_id}"></script>
Replace {merchant_id} with your 36-character value from your Merchant Dashboard.