Skip to main content

Shift4Shop

warning

Only 3D Cart legacy merchants can use Sezzle at the moment.

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

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

Integration Steps Overview​

  1. Install and configure the Sezzle Shift4Shop App
  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 Shift4Shop Extension​

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

  2. Get the app here.

  3. Copy+paste your Store URL into the input area, then click Proceed. application-authorization

  4. Check the PCI Compliance box, then click Acknowledge and Authorize the App to start the installation.

Admin Configuration​

  1. In your Shift4Shop admin, go to Settings > Payment.

  2. Click Select Payment Methods.
    select-payment-methods

  3. Turn the Sezzle switch to On.

  4. Copy your Public Key from your Sezzle Merchant Dashboard, and paste it into the corresponding field in the Sezzle configuration page of your Shift4Shop admin.

  5. Next to Private Key, click Change. Then, copy your Private Key from your Sezzle Merchant Dashboard, and paste it into the corresponding field in the Sezzle configuration page of your Shift4Shop admin.

  6. Click Save.
    payment-methods

  7. To restrict Sezzle usage by country, click the Exclude List hyperlink under the Sezzle switch.

  8. Click Add Location.

  9. Select the desired country, then click Add.
    exclude-list

  10. Installation is complete.

Validate​

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

Troubleshooting​

If testing was unsuccessful, review the following:

  • Sezzle Shift4Shop extension is the most updated version.
  • Sezzle payment method is enabled.
  • 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.
  • 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.

Manual Theme Integration​

If the Shift4Shop 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. From your Shift4Shop admin, go to Settings > Design > Themes & Styles.
  2. In your Current Theme, click the button labeled More then select Edit Template(HTML).
  3. Find the copy of your theme under Go to Folder.
  4. Click the gear icon next to the product_items.html file, then click Edit.
  5. When the dashboard asks if you want to edit your theme files, click the Edit Theme Files button.
  6. In the Source Code text area, copy+paste the script at the very beginning of the file.
  7. Click Save.

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>

Note: Update {sezzle_merchant_uuid} in the above script template to reflect your site’s Merchant ID (removing the curly brackets), which can be found in the Sezzle Merchant Dashboard.

Example:

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

Instructions may vary slightly depending on your active plug-ins. For assistance with widget configuration, click Request Addition of Widgets in the widget step of your Sezzle Merchant Dashboard Setup Checklist.

Uninstall Steps​

  1. Go to Settings > Payment.
  2. Click Select Payment Methods.
  3. Under the Sezzle App, click the gear icon then click Delete.