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.

YITHEMES

<h4>The easy way to sell gift cards in your shop</h4>
<p>According to a study by Allied Market Research, gift cards turnover will register a record of $16 billion by 2028. And, by 2030, gift cards sold online will reach the $1.1 trillion threshold.</p>
<p>Gift cards are a powerful marketing tool to increase sales (especially during the holidays) and build customer loyalty over time.</p>
<p>Think about it: it could be a Christmas gift for a friend, a birthday gift for a family member, or Christmas bonuses for your employees… a gift card is always the best choice!</p>
<p>By offering your customers the opportunity to purchase a gift card that can be redeemed in your store, you can gain new customers (those who receive the gift card will know about your products and place an order, which means you will be able to push them to buy again and build their loyalty over time) and significantly increase your revenue.</p>
<p>YITH WooCommerce Gift Cards is an easy and free solution to start selling gift cards in your e-commerce store.</p>
<h4>How does it work?</h4>
<p>You only have to install the plugin, create your first gift card and publish it: a few-minutes process that will let you start offering gift cards immediately to your customers.</p>
<p>The user’s interface is very easy and inspired by Amazon’s one: your customers can choose one of the amounts you set, select an image to customize the gift card (our plugin is the only one that lets you upload an unlimited image gallery!), insert the receiver’s details, add a message and, finally, purchase the gift card like any other product on your ecommerce store.</p>
<h4>Main features</h4>
<ul>
<li>Create unlimited virtual gift cards. A virtual gift card will be sent to the recipient email address</li>
<li>Create unlimited physical gift cards with one or multiple fixed amounts. Physical gift cards can be printed and shipped to the customers</li>
<li>The admin can create, edit and disable the gift cards manually from the backend</li>
<li>Create a gallery of images to assign to specific gift cards or specific categories of gift cards. (Example: Christmas, Thanksgiving, Wedding, etc.)</li>
<li>The user can enter the sender’s name and a customized message</li>
<li>The user can choose one of the images available in the gallery</li>
<li>Send automatically the gift card via email to the recipient</li>
<li>The admin can verify the email sending status of the gift code</li>
<li>Show the ‘apply gift card code’ form in Cart and Checkout pages</li>
<li>Allow user to use the gift card to pay the order even if its balance doesn’t cover the total amount</li>
<li>Allow user to use the gift card as many times as they want, based on the available balance</li>
<li>Allow the user  to verify the status and the amount of the gift cards he/she owns</li>
<li>The admin can update the gift card balance from the backend without creating a new order</li>
<li>The admin has access to a table with all gift cards (to check balance, related orders and so on)</li>
</ul>
<p><strong><a href="https://plugins.yithemes.com/yith-woocommerce-gift-card-free/" rel="nofollow ugc">Check the live demo ></a></strong></p>
<h4>Need more? Get premium!</h4>
<p>Free version of our plugin works like a charm, but the premium one is a very powerful tool to increase sales and conversions.</p>
<p><strong>With the premium version you can:</strong></p>
<ul>
<li>Generate and send multiple gift cards through a bulk action</li>
<li>Import and export gift cards into a CSV file</li>
<li>Set an optional expiration date for the gift card (gift card will expire on a specific date, like January 01, or after a specific time after the purchase, like 3 months after)</li>
<li>Manage stock of each gift card product</li>
<li>Enable an optional QR code in gift cards</li>
<li>Allow users to specify more recipients for the same gift card (an email with a code of the same amount will be sent to each recipient)</li>
<li>Allow users to choose a delivery date and time for the gift card</li>
<li>Allow users to upload or drag & drop a custom image or photo to customize the gift card in the modal window</li>
<li>Allow users to enter a custom gift card amount (and optionally set the minimum amount that users can enter)</li>
<li>Attach a PDF to gift card email (and customize the PDF name)</li>
<li>Notify the sender via email when the gift card is delivered to recipient</li>
<li>Notify the sender via email when the recipient uses the gift card for a purchase in your shop</li>
<li>Choose the position of form in Cart and Checkout pages</li>
<li>Allow users to enter the gift card code into the standard coupon code field (instead of showing two different forms in cart and checkout)</li>
<li>Set a minimum requested amount in the cart to apply the gift card and exclude specific categories from gift card redemption</li>
<li>Create and sell a gift card linked to a specific product of the shop: the gift card will be of the same value of the product that will be recommended in the email</li>
<li>Choose the action to trigger when the gift card order gets the “Cancelled” status or it is refunded: suspend or disable the gift card (in this case, it cannot be used for any other purchases)</li>
</ul>
<h4>Integrations</h4>
<ul>
<li>Compatibility with YITH WooCommerce Multi Vendor: users can apply the gift card codes only on products of vendors to which the gift cards have been assigned by the global admin</li>
<li>Integration with WC Smart Coupons: convert Store Credit / Gift Certificate coupons created with it into new Gift Cards</li>
<li>Integration with YITH Multi Currency Switcher for WooCommerce</li>
<li>
<p>Integration with YITH Booking and Appointment for WooCommerce</p>
<p><strong><a href="https://yithemes.com/themes/plugins/yith-woocommerce-gift-cards" rel="nofollow ugc">GET PREMIUM VERSION HERE with a 100% Money Back guarantee ></a></strong></p>
</li>
</ul>
<h4>Documentation</h4>
<p>Please, read the <strong><a href="http://yithemes.com/docs-plugins/yith-woocommerce-gift-cards" rel="nofollow ugc">official documentation of YITH WooCommerce Gift Cards</a></strong> to learn more about all plugin features.</p>
<h3>Translators</h3>
<p>Want to add a new language to our YITH WooCommerce Gift Cards? Learn how to contribute <a href="https://translate.wordpress.org/projects/wp-plugins/yith-woocommerce-gift-cards/" rel="nofollow ugc">in this page</a>.</p>


YITH WooCommerce Gift Cards

The essential tool for selling gift cards in your store, increasing your conversion rate and attracting new customers.

ZenCoupon AI Assistant vs YITH WooCommerce Gift Cards