Ambikly Docs

Appearance

Loyalty Points PRO ​

Customers earn points on paid orders and redeem them as a cart discount.

Category: Marketing · Enable at: Ambikly → Add-ons → Loyalty Points

What it does ​

An append-only ledger makes every credit and debit auditable, with balances derived by walking batches oldest-first so expiry only removes genuinely expired points. Points are awarded when an order is paid, and redemption is applied through cart totals and debited under a per-customer lock once payment lands. Refunds reverse both earning and redemption, once.

Capabilities ​

  • Append-only ledger with oldest-first batch expiry
  • Earn rate per currency unit and redeem value per point
  • Minimum points to redeem and a maximum share of the order points may cover
  • Per-customer lock prevents double-spend across devices
  • Offline-payment orders earn and debit on status change
  • Refunds reverse earnings and credit redeemed points back, idempotently
  • Customer balance and history endpoints; manual adjustment for managers

Turn it on ​

  1. Make sure Ambikly Pro is active and your license is activated under Ambikly → Settings → License.
  2. Go to Ambikly → Add-ons, find Loyalty Points and switch it on. There is nothing else to install.
  3. Open its settings panel and set the options listed below.
  4. Visit your storefront to confirm the new surface appears: [ambikly_loyalty_balance] shortcode.

Settings ​

Open the add-on's settings panel from Ambikly → Add-ons → Loyalty Points.

  • Points earned per currency unit
  • Currency value per point
  • Minimum points to redeem
  • Max % of order redeemable
  • Expire points after N days (0 = never)

Where it appears ​

On the storefront

  • [ambikly_loyalty_balance] shortcode
  • Loyalty redemption line in cart totals
  • Apply / remove points at checkout

In the admin

  • Manual points adjustment
  • Per-customer balance and history

For developers ​

REST routes

  • POST /ambikly-pro/v1/cart/loyalty
  • DELETE /ambikly-pro/v1/cart/loyalty
  • GET /ambikly-pro/v1/loyalty/balance
  • GET /ambikly-pro/v1/loyalty/history
  • POST /ambikly-pro/v1/loyalty/adjust

Every route enforces the same capability checks as the rest of the API — see the REST API guide.

Core hooks it listens to

  • ambikly_order_created
  • ambikly_order_paid
  • ambikly_order_status_changed
  • ambikly_order_refunded
  • ambikly_cart_totals
  • rest_api_init

The full list is in the hooks reference.

Questions ​

Do points expire? ​

Optionally, after the number of days you set. Expiry is applied per earn batch, oldest first, so spending old points never wrongly expires newer ones.

Can a customer redeem the same points on two orders? ​

No. The debit is re-validated against the live balance inside a per-customer lock.

How much of an order can points cover? ​

Up to the maximum share you set (default 50%), and never more than the cart total.

Works well with ​

Store Credit Wallet · Gift Cards

Turning it off ​

Switch the add-on off from Ambikly → Add-ons. Its settings and data stay in the database, so turning it back on restores exactly what you had. A lapsed license pauses it the same way — the store keeps selling on the free core, and nothing is deleted.

PROLoyalty Points is part of Ambikly Pro

One license covers all 35 add-ons — $199 a year or $549 once for a single site. Nothing here is sold separately.

See pricing →