WooCommerce

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:

  1. Offer Sezzle as a payment option on the checkout page.
  2. Refund Sezzle payments from your WooCommerce order management system.
  3. Display Sezzle promotional messaging.
  4. Authorize and capture payments.

Integration Steps Overview

  1. Install and configure the Sezzle WooCommerce extension
  2. Test your integration
  3. (Optional) Sandbox Testing

Before You Begin

  1. You should have a Sezzle merchant account.
  1. Make sure you have the following Sezzle details handy.

US/CA

EU

  1. 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
    wordpress loginwordpress login
  1. In the left sidebar, click Plugins > Add New.
  2. Search for Sezzle.
  3. Click Install Now.
    search sezzlesearch sezzle
  4. Click Activate.
    activate sezzleactivate sezzle

Admin Configuration

  1. In the left sidebar, click WooCommerce > Settings .
  2. Select the Payments tab.
    payment settingspayment settings
  3. Click the Manage button for Sezzle.
    select sezzleselect 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.
  1. Set Merchant ID as received from the Business section of Sezzle Merchant Dashboard.
  2. Copy your Private Key and Public Key from your Sezzle Merchant Dashboard (US/CA) or Sezzle Merchant Dashboard (EU), and paste them into the corresponding fields.
  3. Set Minimum Checkout Amount if you want to restrict Sezzle based on a minimum order total.
  4. Set the Transaction Mode as Live for production and Sandbox for sandbox testing mode.
  5. 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.
  6. Configure the installment plan widget under Installment Plan Widget Configuration settings
  7. Check the Enable Installment Widget Plan in Checkout page checkbox for enabling installment widget plan.
  8. Set the Order Total Container Class Name. Default is woocommerce-Price-amount.
  9. Set the Order Total Container Parent Class Name. Default is order-total.
  10. Check the Enable Logging checkbox for logging Sezzle checkout related data. This is helpful for debugging issues, if encountered.
    sezzle page overviewsezzle page overview
  11. Click Save Changes.

WooCommerce Sandbox Testing

  1. In the Sezzle configuration page of your WooCommerce admin, enter the Sandbox API Keys from your Sezzle Merchant Sandbox Dashboard (US/CA) or Sezzle Merchant Sandbox Dashboard (EU) and set the Transaction Mode to Sandbox, then save the configuration. Make sure you are doing this on your dev/staging website.
  2. On your website, add an item to the cart, then proceed to Checkout and select Sezzle as the payment method.
  3. Click Place Order, and you should be redirected to the Sezzle checkout page. If prompted, sign in.
    select sezzle paymentselect sezzle payment
  4. Enter the payment details using test data, then click Complete Order.
  5. After the payment is completed on Sezzle, you should be redirected back to your website and see a successful payment page.
  6. Sandbox testing is complete. You can log in to your Sezzle Merchant Sandbox Dashboard to see the test order you just placed.

WooCommerce Live Checkout

  1. In the Sezzle configuration page of your WooCommerce admin, enter the API Keys from your Sezzle Merchant Dashboard (US/CA) or Sezzle Merchant Dashboard (EU) and set the Transaction Mode to Live, then save the configuration.
  2. On your website, add an item to the cart, then proceed to Checkout and select Sezzle as the payment method.
  3. Click Place Order.
    select sezzle paymentselect sezzle payment
  4. If you are redirected to the Sezzle checkout page, your integration is complete. Congratulations!
  5. Warning Don't complete the payment. Your checkout is now live, so you will be charged if you complete.

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.

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 (US/CA) or Sezzle Merchant Dashboard (EU) 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 (US/CA) or Sezzle Merchant Dashboard (EU).
  • 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.