Qoliber Store Credit

Store credit that behaves like an accounting system rather than a number on a customer record. Every movement is an immutable ledger entry, balances are derived from that ledger, and the cached aggregate can be verified against it at any time.

Latest version: 1.2.1 — changelog

Why it matters

• The balance is always explainable. Every credit and debit is an append-only ledger row with a reason code and an idempotency key. You can answer "why does this customer have this balance?" from data, not inference.
• Money cannot be spent twice. Checkout takes a reservation before the order exists, so a shortfall is a validation error rather than an underpaid order. Capture and its sales projection commit together.
• Refunds go back to credit without paying out twice. The credit-memo collector deducts the credited portion from the memo total, so the payment method is never refunded for money that went to the wallet.
• Drift is detectable. storecredit:reconcile reports differences between the ledger and cached account balances without changing anything.
• Multi-currency and multi-scope. Balances are tracked per website or globally, each in its own currency, with the FX rate stamped at capture time.

What you get

• Customer wallet page with balance and full transaction history
• Apply and remove credit in the cart and at checkout
• Admin balance grid, transaction grid with CSV export, and a per-customer adjustment form with reason codes
• Refund an order to store credit instead of the original payment method
• Optional expiration with FIFO lot allocation and advance warning emails
• Balance-change, expiration-warning and refund-to-credit emails
• Header balance widget (FPC-safe) and a cart credit block
• REST and GraphQL coverage for storefront and admin operations
• Outbound webhook on every posted transaction
• Hyvä storefront and Hyvä Checkout support

Supported versions

Requirement	Supported
PHP	8.1, 8.2, 8.3, 8.4, 8.5
Magento / Mage-OS	magento/framework ^103.0 (Magento Open Source 2.4.x, Mage-OS)
Hyvä theme	1.1 – 1.5 (Tailwind 2, 3 and 4) via Qoliber_StoreCreditHyva
Hyvä Checkout	via Qoliber_StoreCreditHyvaCheckout

Next steps

• Install the extension
• Configure it
• Day-to-day usage
• What each module does
• API reference