Gift Cards

(m2-gift-cards)
30-day money back guarantee

30-day money back guarantee

Gift Cards Suite for Magento 2 & Mage-OS delivers personalized digital gift cards with scheduled email delivery, Apple and Google Wallet support, a built-in card designer, Hyvä, REST and GraphQL - backed by an append-only ledger, atomic balance reservations, safe refunds and automated recovery.
SKU m2-gift-cards

Gitlab access is only given to Agencies and Freelancers after
approval process.

Please note: we do not provide installation or implementation services for our extensions.

Installation should be handled by the developer or agency managing your store. This approach ensures:

  • Compatibility with your current setup
  • Proper configuration based on your specific version
  • Implementation by someone familiar with your codebase

Although we don’t offer installation, we maintain a curated list of recommended development agencies experienced with our solutions.

If you'd like to receive this list, please contact us at [email protected].

Partnership Inquiries

Gift Cards Suite for Magento 2 & Mage-OS — Sell Value You Can Account For | qoliber

Magento 2 & Mage-OS Gift Card Extension

Gift Cards Suite for Magento 2 & Mage-OS — Sell Value You Can Account For

qoliber Gift Cards Suite gives Magento merchants a complete digital gift-card experience while treating every issued card as the financial instrument it really is.

Shoppers can personalize a card, choose the value, recipient, message and delivery date, while recipients can receive the card by email and add it to Apple or Google Wallet. Underneath the storefront experience sits an append-only balance ledger with atomic reservations, safe refunds, replay protection and automated reconciliation.

For agencies and technical teams, that means less custom financial logic, fewer edge-case failures and a reusable gift-card platform with REST, GraphQL, Hyvä support and explicit extension points for project-specific requirements.

Platform
Magento 2 + Mage-OS
Storefront
Luma + Hyvä
APIs
REST + GraphQL
One gift card · every balance movement
Event Amount Balance
Gift card issued+100.00100.00
Order reservation−60.00 held40.00 available
Order captured−60.0040.00
Refund to gift card+20.0060.00

The important part is not the number displayed to the customer. It is the history behind it. Every movement is recorded, reservations protect concurrent checkout and replayed sales documents cannot debit or refund the same value twice.

Why Gift Cards Suite

Turn Gift Cards Into Revenue, Retention and a Better Customer Experience

Gift cards bring revenue forward, create new customer acquisition opportunities and give shoppers an easy way to buy for somebody else. The platform should make that experience simple without creating financial uncertainty behind the scenes.

Sell Value Up Front

Capture revenue before the recipient chooses what to buy and create another purchase path for customers shopping for gifts.

Bring New Customers In

Every sent gift card can introduce a new recipient to the store through a purchase funded by an existing customer.

Personalize the Gift

Let shoppers choose the value, recipient, message, delivery date and visual design instead of sending a generic voucher code.

Keep the Balance Trustworthy

Ledger-based accounting, reservations and replay protection make the financial value behind the gift card traceable and recoverable.

Magento gift card storefront

Give Shoppers a Gift Card That Feels Personal

The storefront experience covers the complete journey from choosing the value to receiving a finished digital card.

Dedicated Gift Card Product Type

Configure preset amounts or an allowed open-value range. Customers choose the recipient, personal message and delivery date as part of the product purchase.

Gift-card values are validated server-side, preventing manipulated browser requests from assigning arbitrary prices.

Built-In Card Designer

Create reusable card designs with backgrounds, gradients, icons, starter templates, personalization tokens and QR codes or barcodes.

This gives merchant teams control over seasonal, campaign and brand-specific gift cards without needing a separate image-production workflow for every variation.

What You Design Is What Gets Delivered

Delivery emails contain a server-rendered SVG based on the card design created in Magento Admin, with recipient and gift-card data inserted into the final artwork.

Digital gift card delivery

Deliver Today, on Their Birthday, or Straight Into Their Wallet

Scheduled Email Delivery

Buyers can choose a future delivery date, with scheduling resolved in the Magento store's timezone.

Claim-based processing, retries and CLI resend tooling are designed to prevent duplicate sends while giving support teams a recovery path if delivery fails.

Apple & Google Wallet

Recipients can keep the gift card in their phone wallet instead of searching for an old email when they are ready to purchase.

Wallet integrations use your own Apple Pass Type ID certificate and Google service account configuration, with signed passes and expiring HMAC-protected links.

Customer Account

Logged-in customers can see gift cards they purchased or received, review balances and access available wallet actions from their Magento account.

Gift-card codes remain masked in account and administrative surfaces.

Financial integrity

Gift Cards Are Money. The Architecture Treats Them That Way.

The storefront feature is only half of a gift-card implementation. The harder part is protecting the balance when checkouts race, refunds are replayed or an operation crashes halfway through.

Atomic Reservations

Prevent two carts from spending the same balance.

Gift-card value is reserved during order placement through a conditional balance update. If another checkout has already consumed the available value, the second attempt is rejected before payment is taken.

Refund Integrity

Do not refund money that has already been spent.

When a purchased gift card is refunded, spent and reserved value is excluded from the refundable amount. Refunds involving currently reserved cards are stopped before an external payment gateway moves funds.

Append-Only Ledger

Every movement has a history.

Balance changes append audit records rather than rewriting financial history. Separate sales-document ledgers provide replay protection so repeated invoice or credit-memo processing becomes a no-op instead of a second debit or refund.

Crash Recovery

Recover from interrupted workflows automatically.

Reconciliation runs every 15 minutes and can recover missed issuance, scheduled deliveries, stale reservations and missing order-ledger operations.

Secure Gift Card Codes

Treat redemption codes like credentials.

Codes are stored as peppered hashes, transmitted in POST requests, displayed masked and protected by a throttling mechanism against repeated guessing attempts.

Tender or Discount Accounting

Match the financial model to the merchant.

Configure gift-card redemption as tender/payment or as a subtotal discount per store view, allowing projects to align checkout totals with their accounting requirements.

Magento gift cards in production

Where Gift Card Extensions Usually Go Wrong

01

Two Checkouts, One Card

Without protection: both orders spend the same balance.

Atomic reservation logic makes available balance a concurrency-safe resource rather than a number read independently by two checkout requests.

02

The Credit Memo Runs Twice

Without idempotency: the same money can be returned twice.

Per-document gift-card ledgers make repeated processing of an already handled sales document harmless.

03

A Request Crashes Mid-Flow

Without reconciliation: balance or delivery state can be stranded.

Automated reconciliation looks for incomplete issuance, stale holds, missed deliveries and missing accounting operations.

04

Refund After Redemption

Without validation: the merchant can return more value than still exists.

Refund calculations account for value that has already been redeemed or is currently reserved.

05

Gift Card Code Guessing

A gift-card balance is effectively money behind a token.

Pepper-hashed codes, masking and lookup throttling reduce exposure if somebody tries to enumerate valid card codes.

06

Scheduled Delivery Runs Twice

A birthday message should arrive once.

Claim-based delivery processing prevents multiple workers from independently sending the same scheduled gift card.

Built for agencies

One Gift Card Service Layer Across Every Storefront

The same financial logic powers Luma, Hyvä and API consumers, so agencies do not need separate implementations of redemption rules for each frontend.

REST & GraphQL

Balance lookup, application, removal and customer gift-card operations are available through REST and GraphQL over the same service contracts used by the storefront.

Native Hyvä Module

A dedicated Hyvä package provides Tailwind/Alpine product and balance experiences rather than relying on a Luma compatibility layer.

Explicit Extension Points

Code generation, artwork rendering, delivery links, design validation, restriction rules and lookup protection are interfaces with default implementations, giving agencies supported seams for client-specific customisation.

Magento gift card extension comparison

qoliber Gift Cards Suite vs Typical Magento Gift Card Extensions

Gift-card products are widely available in the Magento ecosystem. The differences become more important once a project requires concurrency safety, auditability, wallet delivery, recovery tooling and predictable developer extension points.

qoliber Gift Cards Suite compared with typical Magento gift card extensions
Capability qoliber Gift Cards Suite Competing modules
Balance architectureAppend-only ledger with document-level replay protectionImplementation varies
Concurrent checkoutAtomic balance reservationOften not publicly documented
Refund protectionSpent and reserved value excluded before gateway refundVaries by implementation
Crash recoveryAutomated reconciliation every 15 minutesRarely documented publicly
Gift-card designerBuilt-in admin canvas with server-rendered artworkVaries
Wallet supportApple Wallet + Google WalletVaries by vendor
Scheduled deliveryClaim-based delivery, retries and CLI resendCommon feature; reliability architecture varies
HeadlessREST + GraphQL over shared service contractsSupport varies
HyväDedicated Tailwind / Alpine moduleVaries by vendor
Published test coveragePlaywright E2E + PHPUnit + Magento integration + PHPStan 8Usually not published

“Typical Magento Extension” describes common market characteristics rather than any individual vendor. Capabilities and technical implementations vary between products. Where something is described as not publicly documented, that is not a claim that no competing product provides it.

Engineering quality

Verified, Not Asserted

18
Playwright end-to-end tests
L8
PHPStan static analysis
external production-readiness review rounds before 1.0.0
0
reported static-analysis / coding-standard gate issues

Test coverage spans storefront purchase, scheduled delivery, redemption, refunds and Magento Admin workflows. Unit and Magento integration suites accompany the end-to-end coverage, together with Magento coding standards, PSR-12 and PHPMD checks.

Technical specifications

Built for Modern Magento & Mage-OS Projects

Platform

Magento Open Source, Adobe Commerce and Mage-OS.

PHP

PHP 8.2 – 8.4.

Storefront

Luma and dedicated Hyvä Tailwind/Alpine implementation.

Headless

REST + GraphQL using the same underlying service contracts.

In the box

  • Dedicated Magento gift card product type
  • Preset and open-range gift card values
  • Recipient name, message and scheduled delivery date
  • Admin gift card artwork designer
  • Server-rendered personalized card artwork
  • QR code and barcode support
  • Apple Wallet integration
  • Google Wallet integration
  • Scheduled email delivery
  • Customer gift-card account area
  • Atomic balance reservation
  • Append-only transaction ledger
  • Refund and replay protection
  • Automated reconciliation and crash recovery
  • Pepper-hashed and masked gift-card codes
  • Tender or discount redemption mode
  • REST API
  • GraphQL API
  • Dedicated Hyvä module
  • Replaceable service interfaces for agency customisation
Magento Gift Cards FAQ

Questions

Can customers choose their own Magento gift card amount?

Yes. A gift-card product can use predefined values or an allowed open-value range. The amount is validated on the server so a modified browser request cannot set a value outside the merchant's configuration.

Can customers schedule a gift card for a future date?

Yes. The buyer can select a delivery date and the email is sent according to the store timezone. The delivery process uses claim-based processing with retries and a CLI resend option.

Does Gift Cards Suite support Apple Wallet and Google Wallet?

Yes. The suite supports signed Apple and Google Wallet passes using credentials configured by the merchant, together with expiring HMAC-protected access links.

Can two customers spend the same gift card at the same time?

The balance is protected with atomic reservations during order placement. If one checkout has already reserved the available value, another checkout cannot independently spend the same funds.

How are Magento gift card refunds protected?

Refund calculations account for value already spent or reserved. The suite also records sales-document activity so replaying an already processed invoice or credit memo does not apply the same balance movement again.

Does Gift Cards Suite work with Hyvä?

Yes. A dedicated Hyvä module provides Tailwind and Alpine storefront components for gift-card purchasing and balance-related experiences.

Does it support headless Magento storefronts?

Yes. REST and GraphQL operations expose gift-card balance, application, removal and customer-card functionality using the same service layer as the Magento storefront.

What happens if gift card issuance or delivery fails?

Automated reconciliation runs every 15 minutes and looks for missed issuance, deliveries, stale reservations and incomplete order-ledger operations so interrupted workflows can be recovered.

Gift Cards Suite for Magento 2 & Mage-OS — Sell Value You Can Account For