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 - 2.0.0 - 2026-10-27

The 2.0.0 release for Store Credit changes the storefront URLs, which is why its major version changes. It adds no features.

Changed

  • Action required for hardcoded links: the storefront URLs start with store-credit/ instead of storecredit/. The Store Credit page in My Account is now at store-credit/account, and the cart panel posts to store-credit/cart/apply and store-credit/cart/remove. The old URLs return a 404, so update links to them in CMS content, menus, emails and custom templates.
    • The route ID is still storecredit, so URLs built with getUrl('storecredit/...') and layout handles such as storecredit_account_index keep working without changes.
    • The module's sections.xml now declares the cart actions as store-credit/cart/apply and store-credit/cart/remove. A custom sections.xml that declares more sections for these actions under their old names must use the new ones.

Hyva_StoreCredit - 1.0.1 - 2026-10-15

Changed

  • Compatible with PHP 8.5.

Hyva_StoreCredit - 1.0.0 - 2026-10-12

Changed

  • Checkout shows the full store credit balance
  • Separate Email copy method sends a separate email per address
  • Email templates can be set per store view
  • Admin balance adjustment accepts four decimals
  • Store credit apply and remove state changes are announced to screen readers

Fixed

  • Extension attributes populated on orders, invoices, credit memos, and cart totals
  • base_currency_code and updated_at returned on balances
  • Existing balances without a currency get the website base currency on upgrade

Hyva_StoreCreditGraphQl - 1.0.0 - 2026-10-12

Fixed

  • Mutations reject guests with GraphQlAuthorizationException

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 credit history limited to 50 entries
  • 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