> ## Documentation Index
> Fetch the complete documentation index at: https://cashfreepayments-d00050e9-theme-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# WooCommerce

> Easily manage checkout for your WooCommerce store with Cashfree Payments.

# WooCommerce Integration Guide

Accept payments instantly on your Woocommerce store with our no-code payment gateway. We support all major payment methods including:

* UPI
* Credit Cards
* Debit Cards
* Net Banking
* Wallets
* Buy Now Pay Later (BNPL)

***

### 1. Sign Up and Set Up

1. **[Sign up with Cashfree](https://merchant.cashfree.com/merchants/signup?source-action=docs%20page\&action=Sign%20Up\&button-id=StartNow_EcomPluginWooCom)** if you don’t have an account.
2. Submit the [required documents](https://knowledgebase.cashfree.com/support/solutions/articles/48001146022-what-are-the-documents-needed-for-activating-my-cashfree-account-).

***

### 2. Install the Cashfree Payments Plugin

1. **[Download the plugin](https://wordpress.org/plugins/cashfree)** from WordPress.
2. **Log in** to your WordPress Admin Dashboard.
3. Upload and install the plugin in `/wp-content/plugins`.
4. **Activate the Cashfree Plugin** from the Plugins page.

***

### 3. Configure Cashfree in WooCommerce

1. Go to **WooCommerce** > **Settings** > **Checkout**.
2. Select **Cashfree** under Payment Gateways.
3. Enable Cashfree by checking the **Enable/Disable** box.

***

### 4. Enter Your Credentials

1. **App ID** and **Secret Key** from Cashfree:
   * Enter your credentials in the Cashfree plugin settings.
2. Optional settings:
   * **Sandbox Mode**: Check to enable test mode.
   * **In-Context Payment**: Check to avoid redirection during payment.

**Click Save Changes** when finished.

<Warning>
  **Note**: If you encounter an "Authentication Failed" error, clear the "Enable Cashfree Sandbox" checkbox.
</Warning>

***

### 5. Whitelist Your Domain

To complete the integration, request domain whitelisting:

* Navigate to **Developers > Whitelisting** in the Cashfree Dashboard.
* Follow the [whitelisting guide](/payments/online/go-live/whitelist).

***

## BNPL Plus Integration

### 1. Setup Guide

1. **Upgrade Cashfree Plugin**: Go to **WooCommerce Admin** > **Plugins** and update to the latest version.
2. **Enable BNPL Options**: Go to Settings and activate:
   * Offers, pay later, or EMI options as desired.

![BNPL Settings Page](https://mintlify.s3.us-west-1.amazonaws.com/cashfreepayments-d00050e9-theme-update/static/payments/checkout/Screenshot_2023-02-21_at_3.42.07_PM.png)

![BNPL Plus Display on Product Page](https://mintlify.s3.us-west-1.amazonaws.com/cashfreepayments-d00050e9-theme-update/static/payments/checkout/Screenshot_2023-02-21_at_3.43.07_PM.png)

> **Done!** BNPL Plus will now display on your product pages.

***

### 2. Troubleshooting

**Common Errors and Solutions**

* **"Authentication Failed"**: Ensure Sandbox Mode is disabled in settings.
* **Domain Error**: Verify domain is whitelisted in the Cashfree Dashboard.

***

**Learn how to use other features to improve conversion using [offers](./coupons) and [cart recovery](./cart-recovery).**

***

<div class="hidden mb-4" data-table-of-contents="top">
  <iframe height="150" width="100%" class="shadow-2xl rounded-md" src="https://www.youtube.com/embed/r0c_XVhZtOY" title="Cashfree Woocommerce Integration Video" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture" allowfullscreen />
</div>

<div className="callout info">
  ### 💻 Quick dev-to-dev talk

  You clearly care about building better payment experiences for your clients, here's a quick tip: Earn additional income doing exactly what you’re doing now!

  Join the [Cashfree Affiliate Partner Program](https://partner.cashfree.com/partner-ui/authentication/signup?utm_source=dev%20docs\&utm_medium=dev%20doc\&utm_campaign=signup) and get rewarded every time your clients use Cashfree.

  What’s in it for you?

  * Earn up to 0.25% commission on every transaction
  * Be more than a dev - be the trusted fintech partner for your clients
  * Get a dedicated partner manager, your go-to expert

  What’s in it for your clients?

  * Instant activation, go live in minutes.
  * Industry-best success rate across all payment modes.
  * Effortlessly accept international payments in 140+ currencies

  Ready to push to prod? 👉 [Become a Partner now](https://partner.cashfree.com/partner-ui/authentication/signup?utm_source=dev%20docs\&utm_medium=dev%20doc\&utm_campaign=signup)
</div>