WooCommerce

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

​

Install the Sezzle WooCommerce Extension

1. Log in to your website’s Wordpress admin
   • Ex: your-website.com/wp-admin
     
2. In the left sidebar, click Plugins > Add Plugin
3. Search for Sezzle
4. Click Install Now
   
5. Click Activate
   

​

Admin Configuration

1. In the left sidebar, click WooCommerce > Settings
2. Select the Payments tab
3. Click the Complete setup button for Sezzle
   
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, and paste them into the corresponding fields
   For Sandbox Mode, use Sandbox Keys. For more information about Sandbox testing, click here.
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
   This will only work with standard classic checkout, not with checkout blocks
   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 section for more information.
   
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. If you are using Elementor, you may need to install the script manually
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.
    
13. Check the Sezzle Logs checkbox for logging Sezzle checkout related data
    • This is helpful for debugging issues, if encountered. See logs for more details.
    
14. Click Save Changes

​

Express Checkout

1. Select the desired Express Checkout Mode: Pop Up or IFrame
   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.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.
   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
   

​

Validate

Step through a test checkout to validate the integration is properly installed.

​

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 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

​

Manual Widget Installation

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>
   
   • 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
   It is recommended to use the Copy icon in the Sezzle Merchant Dashboard 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
   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