Configuration
Enable gift card selling, set the gift card product SKU, configure the validity period, and connect a gift card provider.
Gift card functionality in the In-Store App is controlled by a combination of tenant settings and a configured gift card provider. This page covers what an administrator needs to set up before cashiers can sell or redeem gift cards.
Tenant settings
The following settings are found in the Omnium OMS under Settings → Order Settings.
Gift Card Enabled
Setting: giftCardEnabled
Enables the Sell Gift Card tile on the home screen of every device on the tenant. When set to false (or left unconfigured), the tile is hidden and cashiers cannot sell gift cards from the POS.
Disabling this setting only hides the selling tile. Existing gift cards can still be redeemed at checkout as long as a gift card payment method is configured.
Gift Card SKU
Setting: giftCardSku
The product code (SKU) used when adding a gift card line to a cart. This must match a product that exists in your product catalogue.
The same SKU is used to identify gift card lines in orders — the system looks for this SKU when processing orders to know which lines should trigger gift card activation.
If this setting is blank, the Sell Gift Card tile is hidden even if Gift Card Enabled is set to true. Both settings must be configured.
Gift Card Valid Months
Setting: giftCardValidMonths
How many months from the date of purchase the gift card is valid. If not set, the default is 12 months.
The expiry date is calculated at the time the order is processed and sent to the gift card provider during activation. It is also printed on the receipt if the provider returns it.
Adding the Sell Gift Card tile to the home screen
Once the tenant settings above are configured, the Sell Gift Card tile can be added to any device's home screen through Settings → Home Items on that device.
- Open Settings and tap Home Items.
- Tap the + button in the top-right corner.
- Select Add Sell Gift Card.
- The tile is added to the grid. Tap it to reorder, resize, or customise its colour.
Each device manages its own home screen layout independently. Add the tile on every device where cashiers should be able to sell gift cards.
See Home Blocks for full details on managing the home screen layout.
Gift card provider
Gift card activation (and balance management for redemptions) is handled by a gift card provider configured in OMS. The In-Store App itself does not manage gift card codes — it passes the sale details to the provider, which activates the card and returns the code.
For instructions on setting up a gift card provider, see the OMS Gift Card documentation.
At least one gift card provider must be configured in OMS for selling or redeeming gift cards to work. Contact your Omnium system administrator if no provider has been set up.
Redemption — accepting gift cards as payment
Accepting gift cards as payment at checkout requires a GiftCard payment method to be configured in the Omnium OMS. This is separate from the sell-side configuration above.
When the payment method is present, the Gift card / Credit note tile appears in the payment dialog during checkout. See Paying with a Gift Card for the cashier-facing flow.