> ## Documentation Index
> Fetch the complete documentation index at: https://docs.omneo.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Givex

> The Omneo Givex extension issues Givex eCerts from Omneo Benefits and keeps Omneo Credits in step with Givex card balances.

The Omneo Givex extension connects your Omneo tenant to Givex, a gift card and stored value platform. It runs two flows, one in each direction.

## eCert issuance

When Omneo issues a **Benefit** whose Benefit Definition is tagged `issue-ecert`, the extension orders a Givex eCert (a digital gift certificate delivered by email) for the Profile that received the Benefit. Givex emails the eCert to the Profile's email address, and Omneo stores the Givex card number on the Benefit as its `external_id` and redeem codes. See [eCert issuance](/extensions/givex/ecert-issuance).

## Balance sync

When the balance of a Givex card changes, Givex sends Omneo a `BALANCE` event. The extension finds the **Credit** that represents that card and updates its remaining value and expiry. If Omneo has never seen the card and a Credit Definition can be chosen for it, the extension creates a new Credit carrying the balance and assigns it to the Profile the event identifies. See [Balance sync](/extensions/givex/balance-sync).

## What the extension does not do

The extension does not redeem, activate or void Givex cards, and it does not sync points or Transactions. Its only effect on Profiles is to match a balance event to one, and to create one when `create_profile_if_missing` is on. An eCert is redeemed in your POS or eCommerce platform using the redeem codes stored on the Benefit, and Credits are redeemed through the normal Omneo [Credits](/concepts/commerce/credits) flow.

## Next steps

<Columns cols={2}>
  <Card title="Setup" href="/extensions/givex/setup" icon="gear">
    What to supply and which settings to configure in CX Manager.
  </Card>

  <Card title="eCert issuance" href="/extensions/givex/ecert-issuance" icon="envelope">
    How a Benefit becomes a Givex eCert.
  </Card>

  <Card title="Balance sync" href="/extensions/givex/balance-sync" icon="arrows-rotate">
    How Givex balance events update Omneo Credits.
  </Card>

  <Card title="Credits" href="/concepts/commerce/credits" icon="credit-card">
    The Omneo Credit object that Givex cards map to.
  </Card>
</Columns>
