Description
HA Loyalty Biz is the loyalty program of the HAFiskal invoicing and fiscalization service (https://hafiskal.rs/ha-loyalty/). One program works in the physical shop (HAFiskal POS: scan the loyalty QR or enter the loyalty ID) and in the online shop (this plugin), so a customer collects and spends the same points everywhere.
In the online shop:
- Cart and checkout show a “Loyalty program” box: the customer enters a loyalty ID, phone number or e-mail and sees their points and their value.
- The customer can spend points as a discount. The limits (minimum points, maximum percentage of the order, value of one point) come from the program rules set in HAFiskal. The discount is applied as a cart coupon, so it is spread over the order items and the totals (and the fiscal receipt, if you use “HAFiskal for WooCommerce”) stay correct.
- Spent points are reserved when the order is placed and finally deducted when the order is paid; if the order is cancelled or never paid, they are returned to the customer.
- Points are added when the order is completed (or processing – configurable), and removed again if the order is cancelled or refunded.
- New customers can join with a checkbox at checkout (“I want to join”), automatically, or not at all – your choice.
- “My account > Loyalty points” shows the customer’s loyalty ID and balance, lets them join or link an existing loyalty ID (e.g. from the shop’s POS).
- The order screen shows a “Loyalty” box (member, points spent, points earned) and a “Give points now” button.
- Failed requests are retried every hour (WP-Cron).
Requirements: an HAFiskal account with the “Loyalty Biz” module enabled and a loyalty API key (in HAFiskal: Integrations > New integration > type “HA Loyalty”). The loyalty key works only for the loyalty program; fiscalization keys are not accepted.
The plugin works with the classic cart and checkout (shortcodes). The WooCommerce cart/checkout blocks are not supported yet.
External services
This plugin connects to one external service, the HAFiskal Cloud API. Nothing is sent until a loyalty API key is entered in the plugin settings. Without a key the plugin makes no requests.
HAFiskal Cloud API (HostArena)
What it is: HAFiskal is a Serbian invoicing, fiscalization and loyalty service provided by HostArena (https://hafiskal.rs). The plugin talks to the HAFiskal Cloud API at the address set in the settings (default https://api.hafiskal.rs).
What is sent, and when:
- Program rules: read when the cart/checkout box or “My account > Loyalty points” is shown (cached for 10 minutes) and when the admin clicks “Test connection”. No personal data is sent.
- Member lookup: when a customer enters a loyalty ID, phone number or e-mail in the cart/checkout box, or opens “My account > Loyalty points”, that value is sent to find the member; the member’s ID, name and points are returned.
- Spending points: when an order with spent points is placed, the member’s loyalty ID, the number of points, the order total and a random order reference are sent to reserve the points.
- Earning points: when an order is completed (or processing, if so configured), the random order reference and the order amount are sent, together with the member’s loyalty ID; for a customer who chose to join (or with automatic joining), the billing e-mail, phone and name are sent instead, to find or create the member.
- Joining from “My account”: the customer’s name, e-mail and phone are sent to create the member.
-
Cancelled, refunded or failed orders: the random order reference is sent to return the points.
-
Service provider: HostArena, https://hafiskal.rs
- Terms of Service: https://hafiskal.rs/uslovi-koriscenja/
- Privacy Policy: https://hafiskal.rs/politika-privatnosti/
Installation
- Install and activate the plugin.
- In HAFiskal create an integration of type “HA Loyalty” and copy its API key.
- Go to WooCommerce > HAFiskal Loyalty and enter the key.
- Click “Proveri vezu” (Test connection) – it shows the program rules from HAFiskal.
FAQ
-
Where do I set how many points a customer gets?
-
In HAFiskal: Loyalty Biz (points per 100 RSD, value of one point, minimum points to spend, maximum % of an order, welcome bonus). The plugin always uses these rules.
-
What happens with points when an order is refunded?
-
On “Cancelled”, “Refunded” or “Failed” the plugin asks HAFiskal to reverse the order: earned points are removed and spent points are returned.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“HAFiskal Loyalty for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “HAFiskal Loyalty for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.2.0
- Gift cards: customers enter a gift card code (PK-XXXX-XXXX) in the cart or at checkout; the card balance is applied as a discount (partial use is supported, the rest stays on the card). The card is charged in HAFiskal when the order is paid.
1.1.1
- Admin notices are shown only on the Plugins screen; the settings page shows its messages inline.
1.1.0
- Own loyalty API key (HAFiskal integration of type “HA Loyalty”); the key of the fiscalization plugin is no longer used.
- Clear messages when a non-loyalty key is entered.
1.0.0
- First version: loyalty ID in cart and checkout, spending points as a discount with reservation, earning points on paid orders, reversal on cancel/refund, “My account > Loyalty points”, order screen box, hourly retries.