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.

WPCodelibrary

<p>Setup discounts for specific payment methods is selected on checkout. Just set amount and discount type from settings page for specific payment method.</p>
<h4>Plugin Functionality:</h4>
<ul>
<li>Setup discounts for specific payment methods is selected on checkout.</li>
</ul>
<h4>Try WooCommerce Advanced Discounts and Fees:</h4>
<h4>Benefits of WooCommerce Advanced Discounts and Fees</h4>
<h3>Boost site revenue</h3>
<ul>
<li>You can earn additional revenue by adding customer fees.</li>
</ul>
<h3>Incentivize use of specific payment gateway(s)</h3>
<ul>
<li>To encourage customers to use your preferred payment gateway, you can charge a payment gateway fee or give discount<br />
on specific payment gateways.</li>
</ul>
<h3>Increase cart total value</h3>
<ul>
<li>Encourage your customers to make X amount of order value and get discount or avoid additional fees.</li>
</ul>
<h3>Usere role specific fees and discounts</h3>
<ul>
<li>Give a special discount or charge fees to specific user role.</li>
</ul>
<h3>Categories specific fees and discounts</h3>
<ul>
<li>Encourage your customers to purchase products from specific categories to get massive discount. Either you can also charge an additional fees for special categories product in cart.</li>
</ul>
<h3>Shipping method specific fees and discounts</h3>
<ul>
<li>You can earn additional revenue by adding shipping method fees when customer choose a particular shipping method during checkout.</li>
</ul>
<h4>Key Features of WooCommerce Advanced Discounts and fees</h4>
<ul>
<li>Option to set fees or discount based on payment gateway.</li>
<li>Option to set fees or discount based on shipping method</li>
<li>Option to set fees or discount based on cart total value</li>
<li>Option to set fees or discount based on user role</li>
<li>Option to set fees or discount based on products from specific categories in the cart.</li>
<li>Option to set fees or discount based either fixed amount of percentage base.</li>
<li>Option to set label for each fees or discounts.</li>
<li><a href="https://codecanyon.net/item/woocommerce-advanced-discounts-and-fees/19009855" rel="nofollow ugc">Download WooCommerce Advanced Discounts and Fees</a></li>
</ul>
<h4>Try our other premium plugins :</h4>
<ol>
<li><a href="https://codecanyon.net/item/woocommerce-custom-related-products-pro/17893664?s_rank=2&ref=wpcodelibrary" rel="nofollow ugc">Woocommerce Custom Related Products Pro</a></li>
<li><a href="https://codecanyon.net/item/woocommerce-estimated-delivery-date-per-product/18309929?s_rank=1&ref=wpcodelibrary" rel="nofollow ugc">Woocommerce Estimated Delivery Date Per Product</a></li>
<li><a href="https://codecanyon.net/item/cashback-coupon-for-woocommerce/28516866" rel="nofollow ugc">Cashback Coupon for WooCommerce</a></li>
<li><a href="https://codecanyon.net/item/product-faqs-for-woocommerce/28640974" rel="nofollow ugc">Product Faqs for WooCommerce</a></li>
<li><a href="https://codecanyon.net/item/dynamic-pricing-per-product-for-woocommerce/29117132" rel="nofollow ugc">Dynamic Pricing Per Product for WooCommerce<br />
</a></li>
</ol>


Discounts Per Payment Method for WooCommerce

Setup discounts for specific payment methods is selected on checkout.

ZenCoupon AI Assistant vs Discounts Per Payment Method for WooCommerce