Skip to content

Changelog - Store Credit

All notable changes to Store Credit are documented in this file.

The format is based on Keep a Changelog.

Hyva_StoreCredit - 0.1.0 - 2026-09-30

The 0.1.0 release for Store Credit is the initial (beta) release.

Added

  • Append-only store credit ledger with a per customer and website balance projection, a balance SQL view, and a verifiable balance_after chain
  • Store credit balances held per website in the website base currency
  • Idempotency keys on every ledger write, so retried checkouts, replayed save events, and redelivered API calls cannot double-spend or double-credit
  • Balance overview grid under Customers → Store Credit, with a link through to balance management
  • Balance management panel with current balances, an adjustment form, and the full credit history, available both standalone and as a Store Credit tab on the customer edit page
  • Separate internal and external reasons on every adjustment, with only the external reason reaching the customer
  • Per-adjustment Notify Customer control, independent of the website email settings
  • Five ACL resources: view balances, adjust balances, refund to store credit, refund above order value, and manage configuration
  • Apply and remove panel on the cart page and in the cart drawer
  • Apply and remove panel in the Hyvä Checkout order summary, as a Magewire component that refreshes on shipping, payment, coupon, and address changes
  • Store credit balance link in the header account menu
  • Store Credit page in My Account with the balance and a paginated credit history
  • Store credit spent on order placement, reverted on payment failure and on order cancellation, tracked on invoices, and refunded through credit memos
  • Refund to Store Credit and Extra Store Credit (%) fields on the credit memo form, with a return ceiling and a separate permission for refunding above the order value
  • Only Zero Subtotal Checkout offered when store credit covers an order in full
  • Negative Store Credit totals line on order, invoice, and credit memo views in the admin and the storefront, and on their PDFs
  • base_store_credit_amount and store_credit_amount extension attributes on order, invoice, credit memo, and cart totals
  • Balance change emails for credit received and credit spent, with configurable sender, copy-to addresses, copy method, and templates
  • CSV export of all balances, and a Store Credit Balances import entity for seeding balances on migration
  • REST API: five admin routes for reading and changing any balance, and four customer routes for the logged-in customer's balance and cart
  • Five Magento events for extending the read and write paths, documented in the Event Reference
  • bin/magento hyva:store-credit:rebuild-balances to replay the ledger into the projection and verify both the projection and the ledger chain

Hyva_StoreCreditGraphQL - 0.1.0 - 2026-09-30

The 0.1.0 release for Store Credit GraphQL is the initial (beta) release and contained as a separate module to avoid hard dependencies on GraphQL.

Added

  • GraphQL API: storeCreditBalance and storeCreditHistory queries, applyStoreCredit and removeStoreCredit mutations