Melon X Loyalty for Woocommerce

Melon X Loyalty connects your WooCommerce store to the Melon loyalty platform. Customers earn points on every order and can redeem them as discounts at checkout.
After checkout, the order confirmation page may show Melon app download links or a partner dashboard link so customers can view earned rewards. These links are part of the loyalty program experience and are not optional plugin branding credits.

Features:
* Loyalty points earned automatically on every paid order
* Points redemption widget on checkout (classic and blocks)
* Order confirmation banner showing points earned
* App download links for the Melon consumer app

External services

This plugin connects to Melon Loyalty, a third-party loyalty platform operated by Melon Africa Limited, to award and redeem customer loyalty points at WooCommerce checkout.

The plugin does not contact external services until a store administrator saves Melon API credentials and completes the “Connect to Melon Loyalty” setup in WooCommerce → Melon Loyalty.

Consent and when data is sent
* Store administrators: By saving Melon API credentials and clicking “Connect to Melon Loyalty” in WooCommerce → Melon Loyalty, the store owner explicitly opts in to connecting this site to Melon. No data is sent to Melon until that connection is completed.
* Shoppers at checkout: The loyalty widget is shown only after the store is connected. If a customer chooses to use the widget (for example, by entering a phone number for OTP verification, checking their balance, or redeeming points), their loyalty-related data is sent to Melon as described below. The plugin does not collect or transmit shopper data in the background when the widget is not used.
* No hidden tracking: This plugin does not track site visitors or customers without interaction with the loyalty checkout widget or the administrator connection flow.
The plugin does not contact external services until a store administrator saves Melon API credentials and completes the “Connect to Melon Loyalty” setup in WooCommerce → Melon Loyalty.

When connected, the plugin and checkout widget may send:

• Store domain, API key ID, and API key secret — when creating or refreshing API tokens (server-side).
• WooCommerce REST API credentials — during the WooCommerce authorization (wc-auth) connection flow initiated by the store administrator.
• Customer phone number — when a shopper requests an OTP or verifies their loyalty account at checkout.
• Customer profile details (name, email, date of birth) — when a new loyalty customer completes registration at checkout.
• Cart and order details (cart total, currency, product IDs, names, SKUs, quantities, voucher codes, points to redeem or earn, billing email and phone) — when looking up balances, generating vouchers, redeeming points, or calculating points to earn.

These requests are sent to https://api-plugin.getmelon.co when the checkout loyalty widget is used or when the store administrator connects the plugin.

Service provider: Melon Africa Limited
Terms of use: https://www.getmelon.co/terms-of-use
Privacy policy: https://www.getmelon.co/privacy-policy

Source code

Human-readable source for compiled JavaScript in this plugin:

• WordPress plugin (PHP): PHP source is included in this plugin package.
• Checkout UI (React/TypeScript): https://github.com/Talkhut/MelonX-Checkout-Woocommerce-UI

Build instructions

1. Clone the Checkout UI repository and run npm install.
2. Run npm run build to produce the classic checkout bundle (dist/).
3. Run npm run build:blocks to produce the WooCommerce Blocks bundle (blocks-build/).
4. Copy dist/ into this plugin’s assets/dist/ folder.
5. Copy blocks-build/blocks-main.tsx.js and blocks-build/blocks-main.tsx.asset.php into blocks/build/.