Skip to main content

WooCommerce

This guide describes how to integrate Sezzle into your WooCommerce website so that you can provide Sezzle as a payment option for your customers. After integrating Sezzle, your WooCommerce site will:

  • offer Sezzle as a payment option on the following checkout pages -
  • refund Sezzle payments from your WooCommerce order management system.
  • display Sezzle promotional messaging.
  • authorize and capture payments.

Integration Steps Overview​

  1. Install and configure the Sezzle WooCommerce extension
  2. Test your integration

Before You Begin​

  1. You should have a Sezzle merchant account.

    • Please visit our signup page if you don't have an account.

  2. Make sure you have the following Sezzle details handy.

  3. Familiarize yourself with the transaction flow when buying with Sezzle.

Install the Sezzle WooCommerce Extension​

  1. Log in to your website's Wordpress admin.

    • Ex: your-website.com/wp-admin

    admin-login

  2. In the left sidebar, click Plugins > Add New.

  3. Search for Sezzle.

  4. Click Install Now. search-sezzle

  5. Click Activate. activate-sezzle

Admin Configuration​

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

  2. Select the Payments tab. go-to-payment-settings

  3. Click the Manage button for Sezzle. select-sezzle

  4. Check the Enable/Disable checkbox for enabling Sezzle.

  5. Check the Payment option availability in other countries if you want to allow Sezzle outside of US and Canada.

    • Note, Sezzle operates only in US and Canada. Be sure to check this option.

  6. Set Merchant ID as received from the Business section of Sezzle Merchant Dashboard.

  7. Copy your Private Key and Public Key from your Sezzle Merchant Dashboard, and paste them into the corresponding fields.

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

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

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

  11. Check the Show Sezzle widget in product pages checkbox for adding widget script in the Product Display Page, which allows enabling Sezzle Widget Modal in PDP. After saving if you don't see the widget in PDP, try installing it manually.

  12. Configure the installment plan widget under Installment Plan Widget Configuration settings

  13. Check the Enable Installment Widget Plan in Checkout page checkbox for enabling installment widget plan.

  14. Set the Order Total Container Class Name. Default is woocommerce-Price-amount.

  15. Set the Order Total Container Parent Class Name. Default is order-total.

  16. Check the Enable Logging checkbox for logging Sezzle checkout related data. This is helpful for debugging issues, if encountered.

  17. Click Save Changes.

Validate​

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

Important Note on Order Fulfillment​

Before shipping the order, ensure that the Order Notes in the WooCommerce interface show the order status is Processing and include Payment approved by Sezzle. When these notes exist, you know that the customer completed the checkout at Sezzle, and you will be paid for the order.

WooCommerce will create an order regardless of whether the customer completes the checkout at Sezzle. Check the Order Notes and do not fulfill orders where the Sezzle checkout is not completed.

Manual Widget Installation​

info

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, please 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:

  • Sezzle WooCommerce extension is the most updated version.
  • Go to Plugins > Installed Plugins, then click View Details next to the Sezzle WooCommerce Payment. If there is an option to upgrade, do so now.
  • Sezzle extension is activated.
  • Go to WooCommerce > Settings and ensure the switch is turned On.
  • Merchant ID was entered correctly.
  • API Keys were entered correctly.
  • It is recommended to use the Copy icon in the Sezzle Merchant Dashboard to avoid typos or extra spaces.
  • If you have multiple accounts with Sezzle, the merchant ID and API Keys are tied to only one URL.
  • Show Sezzle widget in product pages box is checked.
  • Widget script is present on your website and reflects the Merchant ID from your Sezzle Merchant Dashboard.
  • Go to a product page on your website.
  • Right-click then select Inspect.
  • 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.