Unipal Discounts for WooCommerce – Installations Guide

Step 1: Download the Plugin

Get the latest version of the “Unipal Discounts for WooCommerce” plugin from the official source or your merchant dashboard.

Step 2: Log in to Your WordPress Admin

Go to your WooCommerce site’s admin panel at yourdomain.com/wp-admin.

Step 3: Upload the Plugin

In the left sidebar, navigate to Plugins > Add New, then click the Upload Plugin button at the top.

Click Choose File, select the downloaded .zip file, and then click Install Now.

Step 4: Activate the Plugin

Once installation is complete, click Activate Plugin to enable it on your store.

Step 5: Enter Your Unipal API Credentials

Go to WooCommerce > Settings > Unipal Discounts. Enter your API Key  provided by Unipal, then click Save changes.

Step 6: Create Your First Unipal Coupon

Go to Marketing > Coupons > Add New. Set up your coupon and under the “Unipal Settings” section, select the eligible member type:

  • Unipal Standard – for Standard members only
  • Unipal Premium – for Premium members only
  • None – for all users (optional)

Publish the coupon once it’s configured.

Step 7: Test the Checkout Process

Add products to your cart, go to checkout, and enter a Unipal-registered phone number to test the validation and discount application.

Unipal Discounts for WooCommerce – FAQs

  1. What is the Unipal Discounts for WooCommerce plugin?
    This plugin allows WooCommerce store owners to offer exclusive discounts to Unipal-verified students. Discounts are applied only after verifying users through their Unipal-registered phone numbers. There are two types of eligible users: Standard and Premium members.

  2. How does the plugin work?

  • Merchants register with Unipal and receive API credentials.

  • They enter these credentials in the plugin settings on their WordPress site.

  • While creating WooCommerce coupons, merchants select whether the coupon is for Unipal Standard or Premium members.

  • At checkout, users enter their phone number.

  • The plugin verifies the number with Unipal’s API.

  • If verification is successful and the user is eligible, the discount is applied.

  1. Do I need a Unipal account to use this plugin?
    Yes. You must be a registered Unipal partner to receive your API keys. You can sign up at https://business.unipal.me/en-bh

  2. Where do I enter the API keys in the plugin?
    Go to WordPress Admin > Unipal Discounts tab. Enter your API Key then save changes.

  3. How do I create a Unipal-based discount coupon?

  • Go to Marketing > Coupons > Add New

  • Create your coupon and set the discount type and value

  • In the Unipal settings section of the coupon, select the member type (Unipal Standard, Premium, or None)

  • Publish the coupon

  1. What happens if a user enters a phone number not registered with Unipal?
    The discount will not apply, and the user will see a message explaining that they are not eligible.

  2. Can I show a message if the user is not eligible for the discount?
    Yes. The plugin displays a customizable error message if validation fails.

  3. Is phone number validation secure?
    Yes. The plugin uses secure API calls to validate the phone number. No sensitive data is stored on your server.

  4. Can I restrict some products or categories from Unipal discounts?
    Yes. You can use WooCommerce’s built-in coupon restrictions to include or exclude specific products or categories.

  5. What if Unipal’s API is down?
    If the API is unavailable, phone number validation cannot be completed. The coupon will not apply, and users will see a message indicating temporary issues.

  6. Does this plugin work with other discount plugins or dynamic pricing tools?
    It works best with WooCommerce’s native coupon system. Compatibility with third-party plugins may vary.

  7. Is the plugin compatible with multi-language and multi-currency stores?
    Yes, it is compatible with popular plugins like WPML and WooCommerce Multilingual.

  8. How do I get support or report a bug?
    Please contact us through our support email or help desk. You can also refer to the plugin documentation for setup and troubleshooting.

Unipal Discounts for WooCommerce – Troubleshooting Guide (Q&A)

Q1. My coupons are not applying at checkout. What could be the issue?

There are several possible reasons:

  • The user did not enter a Unipal-registered phone number.
  • The phone number is not verified or does not match the required membership tier (Standard or Premium).
  • The API credentials are incorrect or not saved.
  • The Unipal API service may be temporarily unavailable.
Q2. I entered my API Key, but validation isn’t working.

Please check the following:

  • Ensure the API Key is correct (no extra spaces).
  • Verify that your server allows outbound requests (Unipal API requires access).
  • Make sure the plugin is up to date.
  • Test API connection using the “Test Connection” option (if available in your version).
  • Ensure your unipal merchant/partner account is active and completed the on-boarding process.
Q3. Users are getting an error saying “Unipal verification failed.”

This can happen due to:

  • Incorrect or unregistered phone number.
  • User does not belong to the selected Unipal tier for the coupon.
  • Temporary connectivity issues with Unipal API.
  • Check the API logs or error messages (enable debug logging if available).
Q4. The coupon is visible to all users, even non-Unipal members.

Visibility of coupons is controlled by WooCommerce. However, applicability is restricted by the plugin. The plugin will stop ineligible users from applying the discount, even if they see the coupon code.

Q5. How do I test the plugin without a real Unipal account?

Testing requires real Unipal API credentials and an account with registered phone numbers. For development or staging, request test credentials from Unipal support if available.

Q6. Coupon validation is slow. What can I do?

Unipal API response times may vary. You can:

  • Use caching if supported by Unipal (consult their API documentation).
  • Contact your host to check for network latency issues.
  • Avoid multiple API requests during checkout.
Q7. The plugin stopped working after a WooCommerce update.

WooCommerce updates can introduce changes in coupon handling or checkout flow. Make sure:

  • You’re using the latest version of the Unipal plugin.
  • Your theme or other plugins are not overriding the coupon validation process.
  • No JavaScript errors are preventing phone number input or API calls.
Q8. Error: “API credentials are missing”

Go to WooCommerce > Settings > Unipal Discounts and make sure:

  • Both API Key  are added and saved.
  • No spaces or invisible characters are copied during paste.
Q9. The Unipal section is missing in the coupon creation screen.

Possible reasons:

  • Plugin is not activated.
  • Your user role doesn’t have permission to edit coupons.
  • There’s a JavaScript conflict with another plugin or your theme. Check browser console for errors.
Q10. I want to reset or change my Unipal API credentials.

Go to the plugin settings (WP Admin> Unipal Discounts), update the keys, and click “Save Changes.” If you lost your credentials, contact Unipal partner support.

Q11. Users get a validation success message, but the discount isn’t applied.

Check:

  • That the selected coupon is properly configured for their Unipal membership level.
  • Product/category restrictions aren’t blocking the coupon.
  • The coupon is not expired or already used if set to single use.
Q12. Debugging tip – How to view plugin logs or errors?

If the plugin has a logging feature, enable it from settings. Otherwise:

  • Enable WP_DEBUG and WP_DEBUG_LOG in wp-config.php.
  • Check the wp-content/debug.log file after trying validation.