> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sezzle.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Shopify Payments

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

<iframe width="560" height="315" className="rounded-xl" src="https://www.youtube.com/embed/krWzQiIatBU?si=E5v4SCVo8EV18SC4" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen />

### Install the Sezzle Payments App

1. Log in to your website's Shopify admin
2. Install the [Sezzle Payments app](https://apps.shopify.com/sezzle-payments)
   1. Go to `Settings` > `Payments`
   2. Under `Additional Payment Methods`, click `Add Payment Method`
   3. Search for `Sezzle`
   4. Click the result in the dropdown, then click `Sezzle Payments`
   5. Click `Manage Account`
   6. Click `Install`
3. Enter your production Sezzle public and private API keys
   * For most merchants, we are able to pre-fill the public and private API keys based on the Shopify store
   * If we cannot uniquely identify the merchant based on the Shopify store, you will be required to fill in the keys
4. Click `Save` to verify your Sezzle account
   * You will be redirected to the payment settings page, where you will need to activate Sezzle Payments for your store
5. Click `Activate`
6. Verify Sezzle is available as a payment method for your store

   <Frame>
     <img src="https://mintcdn.com/sezzle/WWvtQJ-zXjzjnMaw/images/docs/plugins/shopify/payments/1-select-sezzle-checkout.png?fit=max&auto=format&n=WWvtQJ-zXjzjnMaw&q=85&s=97747bb392913cd9b69491e78d1c0b07" alt="1 Select Sezzle Checkout Pn" width="585" height="384" data-path="images/docs/plugins/shopify/payments/1-select-sezzle-checkout.png" />
   </Frame>

<Note>
  You should see `Sezzle Payments` installed in your `Settings` > `Payments`
</Note>

<Warning>
  Without activating Sezzle Payments, Sezzle will not appear in the checkout, and the installation process is not complete. Verify this step has been completed.
</Warning>

<Frame>
  <img src="https://mintcdn.com/sezzle/WWvtQJ-zXjzjnMaw/images/docs/plugins/shopify/payments/2-activate.png?fit=max&auto=format&n=WWvtQJ-zXjzjnMaw&q=85&s=e22b870c5ac61e0cc5158727ba827f86" alt="Activate Sezzle" width="671" height="717" data-path="images/docs/plugins/shopify/payments/2-activate.png" />
</Frame>

### Validate

For Sandbox testing, do this step first

1. Navigate to `Settings` > `Payments` > `Sezzle Payments`
2. Click `Manage`, check `Enable test mode`, and click `Save`
3. Click the `Manage` button in Sezzle Payments, enter your sandbox API keys in the test tab
4. Click `Update settings`

For Live testing, do this step first

1. In the Sezzle configuration page of your Shopify admin, enter the API keys from your [Sezzle Merchant Dashboard](https://dashboard.sezzle.com/merchant/settings/apikeys)
2. Uncheck the `Enable Test Mode` checkbox
3. Save the configuration

<Tip>
  Step through a [test checkout](/docs/api/test-cards#checkout-testing) to validate the integration is properly installed.
</Tip>

### Adding the Sezzle Tile to Accepted Payment Methods Footer

The Shopify "Accepted Payment Methods" footer widget does not support third-party payment apps by default. To show Sezzle in this section, follow the [instructions provided by Shopify](https://help.shopify.com/en/manual/online-store/themes/themes-by-shopify/vintage-themes/customizing-vintage-themes/add-credit-card-icons), adding `'sezzle'` to the list.

### Troubleshooting

If testing was unsuccessful, review the following:

**Sezzle Payments Shopify extension is the most updated version**

* Go to `Apps` > `Sezzle Payments`, 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**

* 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

### Uninstall the Sezzle Payments App

1. Go to `Apps`
2. Find `Sezzle Payments` and click `Delete`

   <Frame>
     <img src="https://mintcdn.com/sezzle/WWvtQJ-zXjzjnMaw/images/docs/plugins/shopify/payments/3-delete.jpg?fit=max&auto=format&n=WWvtQJ-zXjzjnMaw&q=85&s=abb3e3ecc5d7e886ae1adde91d9b5c6c" alt="3 Delete Jp" width="1399" height="1123" data-path="images/docs/plugins/shopify/payments/3-delete.jpg" />
   </Frame>

### FAQs

<AccordionGroup>
  <Accordion title="I have my Shopify Payment Capture set to Manual. What do I need to do?">
    Sezzle aligns with your Shopify `Payment Capture` settings. If set to `Manual`, you must manually capture payments for Sezzle orders. Authorization periods differ by merchant, so check the expiration in the Sezzle Merchant Dashboard under [Settings > eCommerce](https://dashboard.sezzle.com/merchant/settings/ecommerce) and adjust as needed.
  </Accordion>

  <Accordion title="I have multiple stores on Shopify. What do I do?">
    Install using an incognito browser. Go to `https://your-store.myshopify.com/admin/settings/payments/alternative-providers/1057901`, replacing `your-store.myshopify.com` with your store’s URL. Log in and follow the steps to complete installation. For another store, close and start a new incognito session.
  </Accordion>

  <Accordion title="The order number in Shopify appeared in the merchant dashboard on Sezzle. I don't see it anymore?">
    In Shopify, open the order and select `Information from the gateway`. The payment ID will match the Reference-ID in the Sezzle Merchant Dashboard.

    <Frame>
      <img src="https://mintcdn.com/sezzle/WWvtQJ-zXjzjnMaw/images/docs/plugins/shopify/payments/4-order-reference-id.png?fit=max&auto=format&n=WWvtQJ-zXjzjnMaw&q=85&s=fc7c3baa0921ef896d0a8d2c9091f9ae" alt="Order Reference ID" width="694" height="517" data-path="images/docs/plugins/shopify/payments/4-order-reference-id.png" />
    </Frame>

    <Frame>
      <img src="https://mintcdn.com/sezzle/WWvtQJ-zXjzjnMaw/images/docs/plugins/shopify/payments/5-reference-id-dashboard.png?fit=max&auto=format&n=WWvtQJ-zXjzjnMaw&q=85&s=ed78d6de328abb259a47817a9610d0c4" alt="Reference ID Dashboard" width="871" height="101" data-path="images/docs/plugins/shopify/payments/5-reference-id-dashboard.png" />
    </Frame>

    You can also search Shopify Admin using `receipt.payment_id:<payment_id>`.

    <Frame>
      <img src="https://mintcdn.com/sezzle/WWvtQJ-zXjzjnMaw/images/docs/plugins/shopify/payments/6-orders.png?fit=max&auto=format&n=WWvtQJ-zXjzjnMaw&q=85&s=3efed0d7d595181cae67e50456615d73" alt="Orders Search" width="1665" height="342" data-path="images/docs/plugins/shopify/payments/6-orders.png" />
    </Frame>
  </Accordion>

  <Accordion title="I have the Sezzle inventory locking feature enabled today. Will this be enabled with the new app?">
    No, Sezzle lacks permissions to view or modify Shopify inventory, so this feature is not supported with the new payment app.
  </Accordion>
</AccordionGroup>