Tusher Ikbal

<p>ZenCoupon AI Assistant is a powerful WordPress plugin that integrates with WooCommerce and AI providers to help you generate and manage coupons using simple, natural language commands.</p>
<h3>External Services</h3>
<p>This plugin connects to external AI APIs (Groq and Google Gemini) to process natural language commands and generate WooCommerce coupon configurations.</p>
<ul>
<li>Data Sent: User-provided natural language prompts describing coupon requirements. No user personal data, customer data, or store financial data is transmitted.</li>
<li>Groq AI: Service provided by Groq, Inc. Endpoint: https://api.groq.com/openai/v1/chat/completions. <a href="https://groq.com/terms-of-service/" rel="nofollow ugc">Terms of Service</a> | <a href="https://groq.com/privacy-policy/" rel="nofollow ugc">Privacy Policy</a></li>
<li>Google Gemini: Service provided by Google LLC. Endpoint: https://generativelanguage.googleapis.com/v1beta/models/. <a href="https://policies.google.com/terms" rel="nofollow ugc">Terms of Service</a> | <a href="https://policies.google.com/privacy" rel="nofollow ugc">Privacy Policy</a></li>
</ul>
<h3>Features</h3>
<ul>
<li><strong>AI-Powered Coupon Generation:</strong> Create coupons using natural language instructions</li>
<li><strong>Multiple AI Providers:</strong> Support for Groq and Google Gemini AI. Currently working with Groq AI only, others will be added soon.</li>
<li><strong>Easy Management:</strong> List, delete, and manage your AI-generated coupons</li>
<li><strong>Flexible Discount Types:</strong> Percent or fixed amount discounts</li>
<li><strong>Advanced Settings:</strong>
<ul>
<li>Minimum/Maximum cart amounts</li>
<li>Product and category restrictions</li>
<li>Email restrictions</li>
<li>Usage limits per user</li>
<li>Free shipping options</li>
<li>Expiration dates</li>
<li>Exclude sale items</li>
<li>Individual use settings</li>
</ul>
</li>
<li><strong>HPOS Compatible:</strong> Full support for WooCommerce High-Performance Order Storage</li>
<li><strong>REST API:</strong> JSON-RPC 2.0 compatible API for integration</li>
</ul>
<h3>Supported AI Providers</h3>
<p><strong>Groq AI</strong> (Recommended for speed)<br />
* Model: llama3-8b-8192<br />
* Fast inference with excellent accuracy</p>
<h3>Requirements</h3>
<ul>
<li>WordPress 5.0 or higher</li>
<li>PHP 7.4 or higher</li>
<li>WooCommerce 3.0 or higher</li>
<li>Active API key from Groq or Google Gemini</li>
</ul>
<h3>From WordPress Plugin Directory</h3>
<ol>
<li>Go to <strong>Plugins > Add New</strong> in your WordPress admin</li>
<li>Search for “ZenCoupon AI Assistant”</li>
<li>Click <strong>Install Now</strong> and then <strong>Activate</strong></li>
</ol>
<h3>Manual Installation</h3>
<ol>
<li>Download the plugin as a ZIP file</li>
<li>Go to <strong>Plugins > Add New > Upload Plugin</strong></li>
<li>Choose the ZIP file and click <strong>Install Now</strong></li>
<li>Click <strong>Activate Plugin</strong></li>
</ol>
<h3>Configuration</h3>
<h3>1. Get API Keys</h3>
<p><strong>For Groq AI:</strong><br />
* Visit <a href="https://console.groq.com" rel="nofollow ugc">console.groq.com</a><br />
* Create an account or sign in<br />
* Generate an API key</p>
<h3>2. Configure Plugin</h3>
<ol>
<li>In WordPress admin, go to <strong>WordPress Dashboard > ZenCoupon AI</strong></li>
<li>Select your preferred AI provider (Groq or Gemini)</li>
<li>Enter your API key</li>
<li>(Optional) Change the model name</li>
<li>Click <strong>Save Settings</strong></li>
</ol>
<h3>Usage</h3>
<h3>Via REST API</h3>
<p>The plugin provides a JSON-RPC 2.0 compatible REST endpoint at:<br />
    POST /wp-json/zencoupon/v1/mcp</p>
<h4>Creating a Coupon</h4>
<pre><code>`bash
</code></pre>
<p>curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 1,<br />
    “method”: “create_coupon”,<br />
    “params”: {<br />
      “code”: “SAVE20”,<br />
      “amount”: 20,<br />
      “discount_type”: “percent”,<br />
      “expiry_date”: “2026-12-31”<br />
    }<br />
  }’</p>
<p>Listing Coupons:<br />
 curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 2,<br />
    “method”: “list_coupons”<br />
  }’</p>
<p>Listing AI-Generated Coupons:</p>
<p>curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 3,<br />
    “method”: “list_generated_coupons”<br />
  }’</p>
<p>Deleting a Coupon:<br />
  curl -X POST <a href="https://yoursite.com/wp-json/zencoupon/v1/mcp" rel="nofollow ugc">https://yoursite.com/wp-json/zencoupon/v1/mcp</a> \<br />
  -H “Content-Type: application/json” \<br />
  -d ‘{<br />
    “jsonrpc”: “2.0”,<br />
    “id”: 4,<br />
    “method”: “delete_coupon”,<br />
    “params”: {<br />
      “coupon_id”: 123<br />
    }<br />
  }’</p>
<h3>Coupon Parameters ===ParameterTypeRequiredDescriptioncodestring✓Unique coupon codeamountfloat✓Discount amountdiscount_typestring✓percent, fixed_cart, or fixed_productexpiry_datestringDate in YYYY-MM-DD formatminimum_amountfloatMinimum cart totalmaximum_amountfloatMaximum cart totalexclude_sale_itemsbooleanExclude sale items from discountindividual_usebooleanUse coupon only onceusage_limitintTotal times coupon can be usedusage_limit_per_userintTimes per customerfree_shippingbooleanGrant free shippingemail_restrictionsarrayAllowed customer emailsproduct_idsarraySpecific product IDsexcluded_product_idsarrayExcluded product IDsproduct_categoriesarraySpecific category IDsexcluded_product_categoriesarrayExcluded category IDs</h3>
<h3>Troubleshooting</h3>
<h3>“Missing API Key” Error</h3>
<p>Solution: Ensure you have:</p>
<p>Generated an API key from your chosen AI provider</p>
<p>Entered it in the plugin settings</p>
<p>Saved the settings</p>
<h3>“API returned HTTP 429” (Rate Limited)</h3>
<p>Solution:</p>
<p>The AI provider is rate-limiting your requests</p>
<p>The plugin will automatically retry with exponential backoff</p>
<p>If it persists, try switching AI providers or wait a few minutes</p>
<p>Consider upgrading your API plan with the provider</p>
<h3>“Model not found” Error</h3>
<p>Solution:</p>
<p>The model name may be deprecated</p>
<p>The plugin auto-updates deprecated models to current versions</p>
<p>Try switching between Groq and Gemini to find a working option</p>
<h3>“Invalid JSON Response” Error</h3>
<p>Solution:</p>
<p>The AI model returned unexpected format</p>
<p>This is usually temporary – try again</p>
<p>If persistent, check your API key validity</p>
<p>Consider using a different AI provider</p>
<h3>API Response Examples</h3>
<h3>Success Response</h3>
<p>{<br />
  “jsonrpc”: “2.0”,<br />
  “id”: 1,<br />
  “result”: {<br />
    “coupon_id”: 123,<br />
    “code”: “SAVE20”,<br />
    “amount”: 20,<br />
    “discount_type”: “percent”,<br />
    “message”: “Coupon created successfully.”<br />
  }<br />
}</p>
<h3>Error Response</h3>
<p>{<br />
  “jsonrpc”: “2.0”,<br />
  “id”: 1,<br />
  “error”: {<br />
    “code”: -32600,<br />
    “message”: “Coupon code is required.”<br />
  }<br />
}</p>
<h3>Security</h3>
<p>All API keys are stored encrypted in WordPress options</p>
<p>REST endpoint requires manage_shop_coupons or manage_woocommerce capability</p>
<p>Only authenticated users with proper permissions can access the API</p>
<p>HTTPS is recommended for all API calls</p>
<h3>Performance Tips</h3>
<p>Use Groq AI for faster responses (recommended)</p>
<p>Set lower temperatures (0.0-0.3) for more consistent results</p>
<p>Batch operations when creating multiple coupons</p>
<p>Monitor rate limits and adjust request frequency</p>
<h3>Contributing</h3>
<p>Contributions are welcome! Please fork the repository and submit a pull request.</p>
<h3>1.0.1</h3>
<p>Fixed unique prefix constraints and refactored plugin structure.</p>
<p>Updated text domain to match plugin slug.</p>
<p>Added missing external services disclosure for Groq and Gemini.</p>
<h3>1.0.0</h3>
<p>Initial release</p>
<p>Groq AI integration</p>
<p>WooCommerce HPOS support</p>
<p>REST API endpoint</p>
<p>Coupon management features</p>


ZenCoupon AI Assistant

Generate and manage WooCommerce coupons using AI with natural language commands.

WPClever

<p>Let customers know when there is a variety of coupons available for their order so that they can grasp the best deal and checkout decisively to not overlook the discount. With <strong>WPC Coupon Listing for WooCommerce</strong> plugin, site owners can display a comprehensive list of available coupons per order on Fly Cart popup, on the cart and checkout pages easily.</p>
<h4>Live demo</h4>
<p>Visit our <a href="https://demo.wpclever.net/woofc/cart/?add-to-cart=96" title="live demo" rel="nofollow ugc">live demo</a> here to see how this plugin works.</p>
<p><strong>WPC Coupon Listing</strong> is designed for the purpose of increasing convenience for customers by  automatically gathering all applicable coupons to products in the shopping cart and allowing customers to effortlessly choose one or various coupons that benefit them the most. Buyers are encouraged to proceed to checkout faster knowing that they have the best deal possible and how much they have saved from the coupon application. There’s no need to enter coupons manually or waste time checking here and there to copy & paste the codes anymore.</p>
<p>Unlike other kinds of giving discounts or offers, coupons have many advantages: individual or bulk application, usage limit, usage restrictions, and can work with some special product types that do not offer any discounting or pricing method such as Smart Grouped Products. This plugin could become the greatest tool to facilitate the checkout process and increase the conversion rate when giving coupons is an irreplaceable part of the giving discounts on your site.</p>
<h4>Benefits</h4>
<ul>
<li>Incentivize customers to checkout faster & easier</li>
<li>Boost the conversion rate by automatic coupon application</li>
<li>Individual or multiple coupon application settings</li>
<li>Real-time countdown timer for coupon’s expiry date</li>
<li>Work on Fly Cart mini-cart popup & Instant Checkout form</li>
</ul>
<h4>Key Features</h4>
<ul>
<li>Select coupons that can be listed on cart and checkout pages</li>
<li>List all published or just specific public coupons only</li>
<li>Automatically gather all applicable coupons in the list</li>
<li>Show/hide discount value, description, expiry date of coupons</li>
<li>Display a real-time countdown timer for coupon’s expiry date</li>
<li>Customers can apply coupon(s) directly on cart and checkout pages</li>
<li>Single or multiple coupon applications per order</li>
<li>Customize button text and other texts in Localization tab</li>
<li>Responsive coupon popup on Fly Cart mini-cart, cart and checkout</li>
<li>Arrange the order of coupons based on filters: date, name, asc, & desc.</li>
<li>Compatible with most common WordPress themes and WooCommerce plugins</li>
</ul>
<h4>Coupon Applications</h4>
<p>In order to adjust which coupon details to be shown in the frontend, go to <strong>WPClever >> Coupon Listing</strong>. Users can even turn on countdown timers for limited-time coupons to urge customers to act fast before the coupons go invalid. Coupons can be rearranged based on date or name so that it’s easier for customers to pick up what they need.</p>
<p>Coupons can be configured to be applied individually or collectively under <strong>Marketing >> Coupons >> Usage Restriction</strong>. This setting will be automatically followed on the listing of coupons. There are labels to let customers know when multiple coupons are applied on the total of their order.</p>
<p>In cases of individual application only, customers will be able to select which coupon would grant the best discount for their order. Switching between different coupons is easy as the selected coupon will be applied directly when clicking on any item on the listing popup and any previously chosen coupon will be removed at once.</p>
<p>Under <strong>WPClever >> Coupon Listing >> Localization</strong> tab, users can change the wording of all texts in this plugin to get their message through.</p>
<h4>Mini-cart & Instant Checkout</h4>
<p><strong>WPC Coupon Listing</strong> can work well with <a href="https://wordpress.org/plugins/woo-fly-cart/" rel="ugc">WPC Fly Cart for WooCommerce</a> plugin, which adds more powerful features that are not available in the default WooCommerce mini-cart.</p>
<p>Users can enable or disable display the list of available coupons right on the mini-cart of the Fly Cart popup in the plugin settings. When Instant Checkout is enabled, customers can even choose the coupons to be applied right from the checkout form without leaving where they are. There’s no need to open the cart page or click on Proceed to checkout in order to choose the coupons and fill them manually. This, thus, improves the checkout process a great deal for buyers’ convenience.</p>
<h4>Not what you needed?</h4>
<p>Please try other plugins from us:</p>
<ul>
<li><a href="https://wordpress.org/plugins/wpc-order-tip/" rel="ugc">WPC Order Tip</a></li>
<li><a href="https://wordpress.org/plugins/wpc-free-gift-coupons/" rel="ugc">WPC Free Gift Coupons</a></li>
<li><a href="https://wordpress.org/plugins/wpc-free-shipping-bar/" rel="ugc">WPC Free Shipping Bar</a></li>
<li><a href="https://wordpress.org/plugins/wpc-smart-upsell-funnel/" rel="ugc">WPC Smart Upsell Funnel</a></li>
<li><a href="https://wordpress.org/plugins/wpc-checkout-restrictions/" rel="ugc">WPC Checkout Restrictions</a></li>
</ul>


WPC Coupon Listing for WooCommerce

WPC Coupon Listing will display coupons in a list on the cart and checkout page for the buyer easy to use.

ZenCoupon AI Assistant vs WPC Coupon Listing for WooCommerce