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

# WooCommerce Plugin

> Integrate Dodo Payments seamlessly with your WooCommerce store to accept global payments through UPI, cards, and more.

## Introduction

The Dodo Payments WooCommerce plugin provides a seamless integration with your store, enabling you to accept payments through multiple methods including UPI, cards, net banking, and digital wallets. This comprehensive guide will walk you through the installation and configuration process.

## Step-by-Step Installation Guide

1. Download the latest zip of the WooCommerce payment plugin.

   <Card title="Download Plugin" icon="download" href="https://github.com/dodopayments/dodo-woocommerce/releases">
     Get the latest version of our WooCommerce plugin
   </Card>

   Alternatively, you can install directly from the WordPress plugin directory:

   <Card title="WordPress Plugin Directory" icon="wordpress" href="https://wordpress.org/plugins/dodo-payments-for-woocommerce/">
     Install Dodo Payments for WooCommerce from WordPress.org
   </Card>

2. Log in to your WordPress website as an administrator (we assume you already have WooCommerce set up)

3. Navigate to **Plugins → Add New Plugin**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/1.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=f26041db02cf678f4785a8d72631d0e2" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="447" height="136" data-path="images/woocommerce/1.webp" />
   </Frame>

4. Click on the **Upload Plugin** button and a file selection dialog will appear

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/2.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=9f20388bab236d046cbff312646dcd98" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="433" height="75" data-path="images/woocommerce/2.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/3.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=c9cdccfe01ceda93932c9feea5ee5e65" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1313" height="356" data-path="images/woocommerce/3.webp" />
   </Frame>

5. Click **Browse…** and select the zip file you downloaded

6. Click the **Install Now** button to begin the installation process

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/4.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=3a785b07a5c0f47318893a73059875b5" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1024" height="307" data-path="images/woocommerce/4.webp" />
   </Frame>

7. After installation completes, click **Activate Plugin** or activate it from the **Installed Plugins** section

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/5.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=d7a144b16abd059e81a694585f3d6923" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="897" height="289" data-path="images/woocommerce/5.webp" />
   </Frame>

8. The plugin is now installed, but configuration is still required. Continue to the setup guide below.

## Configuration Guide

### Setting Up API Keys and Webhooks

1. Navigate to **WooCommerce → Settings → Payments** or click the **Payments** button in the left sidebar below the WooCommerce menu item

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/6.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=292552cc453ac05b4a0a368cd0d2adb8" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1887" height="958" data-path="images/woocommerce/6.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/7.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=e289459e7a2c95082504229293c0863e" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="234" height="242" data-path="images/woocommerce/7.webp" />
   </Frame>

2. Enable the **Dodo Payments** payment provider if not already enabled, then click **Manage** to configure the plugin

3. You'll see various configuration options, each with helpful explanatory text. Begin by setting up your Live API Key

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/8.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=0cad2f1d5bbba36d54e1d54e8ffb8961" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1658" height="867" data-path="images/woocommerce/8.webp" />
   </Frame>

4. Log in to your Dodo Payments dashboard in **Live Mode**, then navigate to **Dodo Payments (Live Mode) > Developer > API Keys** or visit [this direct link](https://app.dodopayments.com/developer/api-keys) and click **Add API Key**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/9.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=baa03ad325826db734456fd30e30363c" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1876" height="991" data-path="images/woocommerce/9.webp" />
   </Frame>

5. Give your API Key a descriptive name and click **Create**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/10.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=af89376b00b5265c1d375dcc6fa218f3" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="549" height="365" data-path="images/woocommerce/10.webp" />
   </Frame>

6. Copy the generated API Key and paste it into the **Live API Key** field in your WooCommerce plugin settings

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/11.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=bd998ae7bb40791d2193b807813521cb" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="570" height="491" data-path="images/woocommerce/11.webp" />
   </Frame>

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/12.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=dd3f751317c6be0401c50bde584705e2" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1395" height="115" data-path="images/woocommerce/12.webp" />
   </Frame>

7. Next, set up the Webhook Signing Key to enable payment status synchronization between Dodo Payments and WooCommerce

8. Scroll to the bottom of the plugin settings page and copy the webhook URL displayed there

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/13.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=becfefe5c5e04aeecefb8b8d126ff571" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1062" height="239" data-path="images/woocommerce/13.webp" />
   </Frame>

9. Return to your Dodo Payments dashboard and navigate to **Dodo Payments (Live Mode) > Developer > Webhooks** and click **Add Webhook**

   <Frame>
     <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/14.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=fda4e9a992317218190c439b9addb6d3" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1884" height="994" data-path="images/woocommerce/14.webp" />
   </Frame>

10. Paste the URL you copied in step 8 into the dialog and click **Add Webhook**

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/15.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=da9541f69ffaa9e37f4135c6163329c0" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="542" height="417" data-path="images/woocommerce/15.webp" />
    </Frame>

11. After creating the webhook, click the eye icon next to the redacted **Signing Key** to reveal and copy it

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/16.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=9f342ef95be984773dd065c0fd46f1a4" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1527" height="356" data-path="images/woocommerce/16.webp" />
    </Frame>

12. Paste the Signing Key into the **Live Webhook Signing Key** field in your plugin settings and save the changes

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/17.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=2cfee72402218b0170d63c2b136d9de9" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1608" height="155" data-path="images/woocommerce/17.webp" />
    </Frame>

13. Review the remaining settings such as **Global Tax Category** and **All Prices are Tax Inclusive**, as these options determine how products sync from WooCommerce to Dodo Payments. Note that **Test API Key** and **Test Webhook Signing Key** are only needed if you plan to use Test Mode

    <Frame>
      <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/18.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=746184a19efe5bfb14febfc6955c4c8e" alt="Dodo Payments for WooCommerce Plugin" style={{ maxHeight: '500px', width: 'auto' }} width="1612" height="677" data-path="images/woocommerce/18.webp" />
    </Frame>

## You're All Set!

Your WooCommerce store is now integrated with Dodo Payments! Customers can select Dodo Payments at checkout to access all supported payment methods.

<Frame>
  <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/19.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=958daded5beb84eb4e54e02c267d7ecc" alt="Dodo Payments checkout option in WooCommerce" style={{ maxHeight: '500px', width: 'auto' }} width="1864" height="913" data-path="images/woocommerce/19.webp" />
</Frame>

When customers choose Dodo Payments, they'll be seamlessly redirected to the Dodo Payments checkout page to complete their transaction.

<Frame>
  <img src="https://mintcdn.com/dodopayments/rsanoiHs7RZfcFW7/images/woocommerce/20.webp?fit=max&auto=format&n=rsanoiHs7RZfcFW7&q=85&s=a78bd2b289d9cc8df8d36da9db540c14" alt="Dodo Payments checkout page" style={{ maxHeight: '500px', width: 'auto' }} width="1887" height="1006" data-path="images/woocommerce/20.webp" />
</Frame>

## Key Features

* **Seamless Checkout Experience**: Redirect customers to a secure, optimized checkout page
* **Multiple Payment Methods**: Support for various local and international payment options
* **Real-time Status Updates**: Instant order status synchronization via webhooks
* **Detailed Transaction Records**: Comprehensive payment history in your WooCommerce dashboard
* **Multi-currency Support**: Accept payments in multiple currencies

## Troubleshooting

### Common Issues

1. **Payment Processing Failures**
   * Verify API keys are correctly configured
   * Ensure webhook URL is properly set up
   * Check that your SSL certificate is valid

2. **Webhook Synchronization Problems**
   * Confirm webhook signing key matches
   * Review server logs for potential errors
   * Verify your server can receive incoming webhook requests

### Support Resources

For additional assistance:

* Contact us at [support@dodopayments.com](mailto:support@dodopayments.com)
* Refer to our [comprehensive documentation](https://docs.dodopayments.com)

## Maintenance Best Practices

1. Regularly update the plugin for security patches and new features
2. Test all payment flows in sandbox mode before processing live transactions
3. Keep WordPress and WooCommerce updated to the latest versions
4. Implement regular site backups
5. Monitor transaction logs for any unusual activity
6. Store API keys securely and never share them publicly
