---
updatedAt: 2026-09-04T11:22:21.000Z
agentTools:
  projectIndex: https://docs.us.zip.co/llms.txt
---

# WooCommerce

For WooCommerce stores, Zip offers a plugin for integrating Zip into your store. If you don't have a merchant account with Zip, please navigate to [Zip for Business](https://zip.co/us/for-businesses) to become a merchant partner.

Once you've become a Zip merchant partner, you can refer to this guide as you integrate via the Zip onboarding flow. If you've previously been a Zip partner or are encountering technical issues please utilize this guide or reach out  to [Partner Support](mailto:partners@us.zip.co) for assistance.

# Zip for WooCommerce 1.9.0

<br />

1. Login to your **WordPress Admin Dashboard**, scroll down and click on **Plugins** and then **Add New Plugin**.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/cfee90a-Screenshot_2024-06-05_at_4.58.25_PM.png",
        "Admin Dashboard.jpg",
        ""
      ],
      "align": "center",
      "sizing": "250px"
    }
  ]
}
[/block]

<br />

2. Search for **Zip US Gateway** in the search bar on the right.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/3b18ad9-Screenshot_2024-06-05_at_4.02.16_PM.png",
        "Add New Plugin.jpg",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

<br />

3. Click on **Install Now** and then **Activate** the plugin.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/fb8c588-Screenshot_2024-08-16_at_3.26.56_PM.png",
        "Upload Plugin.jpg",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

<br />

4. Go back to the **Dashboard** and select **Plugins**.\ <br />\
   The **Zip US Gateway for WooCommerce** plugin now appears in the list of **Installed Plugins**.  To configure, click on **Settings**.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/9f65f2b-Screenshot_2024-06-05_at_4.06.50_PM.png",
        "browse_install.png",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

<br />

## Configuration

1. Check **Enable Zip**.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/9c373e9-Screenshot_2024-06-05_at_4.14.44_PM.png",
        "browse_install.png",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

<br />

2. Confirm **Territory** is set to **United States** and **Mode** dropdown selector is set to **Production**.
3. Copy and paste your credentials into the **Client ID**, **Client Secret**, and **Merchant ID** fields. You can find your credentials in the **Settings** tab of the [Zip Merchant Portal](https://merchant.us.zip.co/).

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/148a4e7-Screenshot_2024-06-05_at_4.32.28_PM.png",
        "settings_screen.png",
        1160
      ],
      "align": "center",
      "sizing": "100"
    }
  ]
}
[/block]

<br />

4. To display the **Zip widget**, check **Enable Product Page Widget**, **Enable Cart Page Widget**, and **Enable Checkout Page Widget**

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/118cb71-Screenshot_2024-06-05_at_5.08.08_PM.png",
        "settings_screen.png",
        1160
      ],
      "align": "center",
      "sizing": "100"
    }
  ]
}
[/block]

<br />

5. Scroll down and click **Save**.

> 👍 Congratulations!  Well done!
>
> You have successfully integrated the **Zip Widget** and **Payment Gateway** into your shop.
>
> Please review how the widget looks on your product pages.  If you require further widget customization, that is possible and covered below under "[Widget Customization](https://docs.us.zip.co/docs/woocommerce#widget-customization)."
>
> Lastly, though not required, we suggest doing a quick end-to-end test by creating a small **Zip** transaction and voiding thereafter.

<br />

## Widget Customization

For guidance on customizing the widget, please find a list of supported [attributes](https://docs.us.zip.co/docs/zip-widget#customization).

These attributes can be set in WooCommerce Admin by going back to the **Dashboard** and selecting **Plugins**.

The **Zip US Gateway for WooCommerce** plugin appears in the list of **Installed Plugins**.  To customize, click on **Settings**.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/e21d428-Screenshot_2024-06-05_at_4.42.30_PM.png",
        "widget_customization.png",
        ""
      ],
      "align": "center"
    }
  ]
}
[/block]

<br />

# Issuing Refunds

Issuing refunds for Zip orders is straightforward with the following instructions.

1. In the WordPress Admin Dashboard, go to **WooCommerce** > **Orders**.

2. Find and click on the order to refund.

3. Click the **Refund** button.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/6aaee6c-Screenshot_2024-06-05_at_4.48.14_PM.png",
        "woo_to-refund.PNG",
        724
      ],
      "align": "center",
      "sizing": "80"
    }
  ]
}
[/block]

<br />

4. Input the quantities and amounts to refund. Provide an optional description. Click the **Refund via Zip - Pay over time** button.

[block:image]
{
  "images": [
    {
      "image": [
        "https://files.readme.io/573b379-Screenshot_2024-06-05_at_4.51.14_PM.png",
        "Woo Refund.png",
        1950
      ],
      "align": "center",
      "sizing": "80"
    }
  ]
}
[/block]

<br />

> ❗️ Refund via Zip
>
> If you issue a refund using the **Refund Manually** button, Zip will not receive any notification of the refund and your customer will not receive a refund from Zip.

<br />

5. Zip will automatically credit the customer's existing and/or future installments as needed. Verify the order status both by noting the Status of the order in the Dashboard and also in the [Zip Merchant Portal](https://merchant.us.zip.co/).