{"id":407259,"date":"2026-11-20T20:56:21","date_gmt":"2026-11-20T20:56:21","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/hafiskal-loyalty-for-woocommerce\/"},"modified":"2026-11-20T20:56:12","modified_gmt":"2026-11-20T20:56:12","slug":"hafiskal-loyalty-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/hafiskal-loyalty-for-woocommerce\/","author":23539297,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.2.0","stable_tag":"1.2.0","tested":"7.1.5","requires":"5.8","requires_php":"7.4","requires_plugins":null,"header_name":"HAFiskal Loyalty for WooCommerce","header_author":"HostArena","header_description":"HA Loyalty Biz for WooCommerce: customers enter their loyalty ID at checkout, spend points as a discount and earn points on paid orders. Same loyalty program as the HAFiskal POS.","last_updated":"2026-11-20 20:56:12","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/hafiskal.rs\/ha-loyalty\/","header_author_uri":"https:\/\/hostarena.rs","rating":0,"author_block_rating":0,"active_installs":0,"downloads":56,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.2.0":{"tag":"1.2.0","author":"hostarena","date":"2026-11-20 20:56:12","revision":3814494}},"upgrade_notice":[],"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.2.0"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[331,3377,2321,294,55621],"plugin_category":[45],"plugin_contributors":[287112],"plugin_business_model":[],"class_list":["post-407259","plugin","type-plugin","status-publish","hentry","plugin_tags-discount","plugin_tags-loyalty","plugin_tags-points","plugin_tags-rewards","plugin_tags-serbia","plugin_category-ecommerce","plugin_contributors-hostarena","plugin_committers-hostarena"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/hafiskal-loyalty-for-woocommerce.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>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.<\/p>\n\n<p>In the online shop:<\/p>\n\n<ul>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>Points are added when the order is completed (or processing - configurable), and removed again if the order is cancelled or refunded.<\/li>\n<li>New customers can join with a checkbox at checkout (\"I want to join\"), automatically, or not at all - your choice.<\/li>\n<li>\"My account &gt; 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).<\/li>\n<li>The order screen shows a \"Loyalty\" box (member, points spent, points earned) and a \"Give points now\" button.<\/li>\n<li>Failed requests are retried every hour (WP-Cron).<\/li>\n<\/ul>\n\n<p>Requirements: an HAFiskal account with the \"Loyalty Biz\" module enabled and a loyalty API key (in HAFiskal: Integrations &gt; New integration &gt; type \"HA Loyalty\"). The loyalty key works only for the loyalty program; fiscalization keys are not accepted.<\/p>\n\n<p>The plugin works with the classic cart and checkout (shortcodes). The WooCommerce cart\/checkout blocks are not supported yet.<\/p>\n\n<h3>External services<\/h3>\n\n<p>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.<\/p>\n\n<h4>HAFiskal Cloud API (HostArena)<\/h4>\n\n<p>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).<\/p>\n\n<p>What is sent, and when:<\/p>\n\n<ul>\n<li>Program rules: read when the cart\/checkout box or \"My account &gt; Loyalty points\" is shown (cached for 10 minutes) and when the admin clicks \"Test connection\". No personal data is sent.<\/li>\n<li>Member lookup: when a customer enters a loyalty ID, phone number or e-mail in the cart\/checkout box, or opens \"My account &gt; Loyalty points\", that value is sent to find the member; the member's ID, name and points are returned.<\/li>\n<li>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.<\/li>\n<li>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.<\/li>\n<li>Joining from \"My account\": the customer's name, e-mail and phone are sent to create the member.<\/li>\n<li><p>Cancelled, refunded or failed orders: the random order reference is sent to return the points.<\/p><\/li>\n<li><p>Service provider: HostArena, https:\/\/hafiskal.rs<\/p><\/li>\n<li>Terms of Service: https:\/\/hafiskal.rs\/uslovi-koriscenja\/<\/li>\n<li>Privacy Policy: https:\/\/hafiskal.rs\/politika-privatnosti\/<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate the plugin.<\/li>\n<li>In HAFiskal create an integration of type \"HA Loyalty\" and copy its API key.<\/li>\n<li>Go to WooCommerce &gt; HAFiskal Loyalty and enter the key.<\/li>\n<li>Click \"Proveri vezu\" (Test connection) - it shows the program rules from HAFiskal.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"where%20do%20i%20set%20how%20many%20points%20a%20customer%20gets%3F\"><h3>Where do I set how many points a customer gets?<\/h3><\/dt>\n<dd><p>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.<\/p><\/dd>\n<dt id=\"what%20happens%20with%20points%20when%20an%20order%20is%20refunded%3F\"><h3>What happens with points when an order is refunded?<\/h3><\/dt>\n<dd><p>On \"Cancelled\", \"Refunded\" or \"Failed\" the plugin asks HAFiskal to reverse the order: earned points are removed and spent points are returned.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.2.0<\/h4>\n\n<ul>\n<li>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.<\/li>\n<\/ul>\n\n<h4>1.1.1<\/h4>\n\n<ul>\n<li>Admin notices are shown only on the Plugins screen; the settings page shows its messages inline.<\/li>\n<\/ul>\n\n<h4>1.1.0<\/h4>\n\n<ul>\n<li>Own loyalty API key (HAFiskal integration of type \"HA Loyalty\"); the key of the fiscalization plugin is no longer used.<\/li>\n<li>Clear messages when a non-loyalty key is entered.<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>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 &gt; Loyalty points\", order screen box, hourly retries.<\/li>\n<\/ul>","raw_excerpt":"Loyalty points for WooCommerce shops using HA Loyalty Biz: customers enter their loyalty ID at checkout, spend points as a discount and earn points.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/407259","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=407259"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/hostarena"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=407259"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=407259"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=407259"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=407259"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=407259"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=407259"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}