☰ Menu · Changelog
More

Changelog

What changed in the API, newest first.

7 October 2026

  • Venue rules for registers: redemption through holds, check numbers per register, a limit for late checks, cashback limits per check and per day, card scan required, manual adjustments. Each key can have its own values. GET /v1/account returns the rules in settings.
  • Holds: POST /v1/holds, capture with hold_id, release, automatic expiry.
  • POST /v1/checks/calculate shows what a check would do without writing anything.
  • Partial refunds: POST /v1/transactions/{external_id}/refunds.
  • Catalogue: upload products by SKU; the owner sets per category whether it earns cashback, whether it can be paid with cashback, and its own percent.
  • Members show cashback levels, next_level, held and available.
  • Every check, scan and calculation has display with ready text for the cashier and the receipt.
  • New scopes members:adjust, catalog:read, catalog:write; new events transaction.refunded, balance.adjusted.

6 October 2026

  • API v1 at /api/v1, for every program type: cashback, stamps, visit discounts, VIP levels.
  • Members: enrol with your own card number, look up by card, barcode, phone or id, history, reward redemption.
  • Card barcode format per program: QR or Code 128 with the card number, or QR with the serial.
  • Transactions with line_items, voids, cashback redemption with the program's caps.
  • Kiosks and scanners: POST /v1/scans, POST /v1/visits, the devices:write scope.
  • Menu API with your SKUs in external_id, bulk price and stop-list sync.
  • Table orders from the QR menu with statuses for the POS.
  • Webhooks with signatures and retries, Idempotency-Key, cursor pagination, key scopes.
  • The earlier POS API at /api/pos/v1 keeps working.
Questions about an integration: api@loyaltyfy.io. We answer within one business day.