Shopify

Suggest Edits

Shopify

Download the Sezzle Shopify app from Sezzle US/CA Dashboard or Sezzle EU Dashboard.

When configuring the app, use the API keys from your Dashboard account Sezzle US/CA Dashboard or Sezzle EU Dashboard.

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

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

Integration Steps Overview

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

Before You Begin

  1. You should have a Sezzle merchant account.
  • Please visit our signup page if you don't have an 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 Shopify App

  1. Log in to your website's Shopify admin.
  2. In your Sezzle Merchant Dashboard Setup Checklist (US/CA) or Sezzle Merchant Dashboard Setup Checklist (EU), click Download Shopify App.
  3. Click Get the App.
  4. Click Install App.

    install_appinstall_app

Configure Widgets

  1. Within the Sezzle app, enter your Public API Key and click link sezzle account.

    add_public_keyadd_public_key
  2. Once your account is linked, click add widgets to add widgets to your shop. This process may take a minute.

    add_widgetsadd_widgets
  3. After widgets have been added, navigate to a product page to confirm that the Sezzle widget has been added.

    product_widgetproduct_widget
  4. If you ever need to remove Sezzle widgets from your shop, click the remove widgets button within the Sezzle app.

    remove_widgetsremove_widgets

Note: If the Sezzle app is unable to automatically add widgets to your shop, one of our team members will automatically be notified and will work to manually add widgets to your shop within 7 business days.

Install the Sezzle Payment Gateway

  1. In your Sezzle Merchant Dashboard Setup Checklist (US/CA) or Sezzle Merchant Dashboard Setup Checklist (EU), click Connect Sezzle to Shopify.
  2. Click Instructions.
  3. Click the first hyperlink on the new page to enable the gateway for your shop. If prompted, select your Shopify store.
  4. Click Install Payment Provider.

    install_payment_providerinstall_payment_provider

Admin Configuration

  1. In your Shopify admin, go to Settings > Payment Providers.

    sezzle_payment_configsezzle_payment_config
  2. Under Alternative Payment Methods, click Choose Alternative Payment.

    choose_alternative_paymentchoose_alternative_payment
  3. Search for and click on Sezzle.

    select_sezzleselect_sezzle
  4. Copy your Public Key and Private Key from your Sezzle Merchant Dashboard (US/CA) or Sezzle Merchant Dashboard (EU), and paste them into the corresponding fields in the Sezzle configuration page of your Shopify admin.
  5. Click the Activate Sezzle button.

    account_informationaccount_information
  6. Installation is complete.

Shopify Live Checkout

  1. In the Sezzle configuration page of your Shopify admin, enter the API Keys from your Sezzle Merchant Dashboard (US/CA) or Sezzle Merchant Dashboard (EU) and uncheck the Enable Test Mode checkbox, then save the configuration.
  2. On your website, add an item to your cart, then proceed to Checkout and select Sezzle as the payment method.
  3. Click Place Order.
    checkoutcheckout
  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.

Troubleshooting

If testing was unsuccessful, review the following:

  • Sezzle Shopify extension is the most updated version.
  • Go to Apps > Sezzle, then click About. If there is an option to upgrade, do so now.
  • Sezzle gateway is activated.
  • Go to Settings > Payment Providers and ensure "Sezzle is active" is listed under the Alternative Payment Methods section.
  • 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.
  • 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.

Manual Theme Integration

If the Shopify app fails to maintain the widget script on the product pages, or to add the script manually for additional pages, complete the following steps:

  1. Go to Sales Channels > Online Store > Themes.
  2. Click Actions, then select Edit Code.
  3. In the Code Explorer, go to the Templates folder and select the product.liquid file.
  4. Copy+paste the script to the very bottom of the file, then click Save.
  5. Repeat the previous step in the cart.liquid file.

Note: If you have additional custom product templates, step 4 will need to be repeated for each file, or the script added to a global file, such as layout/theme.liquid.

The script to be inserted into your webpage is as follows:

Template:

<script src="https://widget.sezzle.com/v1/javascript/price-widget?uuid={sezzle_merchant_uuid}"></script>
Update {sezzle_merchant_uuid} in the above script template with your site’s Merchant ID (removing the curly brackets), which can be found in the Sezzle Merchant Dashboard (US/CA) or Sezzle Merchant Dashboard (EU).

Example:

<script src="https://widget.sezzle.com/v1/javascript/price-widget?uuid=12a34bc5-6de7-890f-g123-4hi5678jk901"></script>

For assistance with widget configuration, click Request Addition of Widgets in the widget step of your Sezzle Merchant Dashboard Setup Checklist (US/CA) or Sezzle Merchant Dashboard Setup Checklist (EU).

Uninstall Steps

  1. Go to Apps.
  2. Under Sezzle, click Delete.
  3. Go to Settings > Payment Providers.
  4. Under Alternative Payment Methods, find Sezzle and click Edit.
  5. Click Deactivate Sezzle.
  6. Click Deactivate Sezzle to confirm.

Inventory Locking

Our Shopify integration has an optional feature to prevent overselling while a customer is checking out with Sezzle. To enable this feature, please reach out to our Merchant Success team at [email protected].

Shopify Sandbox Testing

Sezzle offers an alternate sandbox payment gateway that can be used to test your integration. If you would like to install this gateway for testing, please reach out to our Merchant Success team at [email protected].

Updated 4 months ago