> For the complete documentation index, see [llms.txt](https://docs.flowretail.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flowretail.com/docs/extensions-addons/flow-gift-card/configuration.md).

# Configuration

## You need this before you start

Please ensure you have all the necessary details, which you can obtain from customer service.

* **Flow Gift Card Merchant Token**
  * Example: `F3dMeyJhbGIUzI1NiIsInR5cCI6IkpXVCJ9.eyJtaWQjfh333pYXQiOjE3MTAzMzU23zZ9.1wNyBgC23ffyaqCFFbxk2AWu2Rbeeffdf22OvHjxmlE`
* **Flow Gift Card Merchant ID**
  * Example: **531**
* **Flow Gift Card Brand ID**
  * Example: **837**

## Enabling and configuring the Flow Gift Card service

To begin selling and accepting gift card payments, follow these initial setup steps.

{% stepper %}
{% step %}

### Enable the extension

Make sure the Flow Gift Card extension is installed and activated.
{% endstep %}

{% step %}

### Create the Flow Gift card product

1. Go to **Backoffice** > **Products** > **Products**
2. Add a product with product type GIFTCARD
   1. Simply call it "Gift Card", and add proper details in the required fields
   2. We recommend adding such products to a specific "Services" Product Group
   3. Set 0 (zero) in the price field
   4. Make sure its 0% VAT (you will get an error if you try to set VAT on GIFTCARD products, as the system won't allow for that)

{% hint style="info" %}
We recommend adding the gift card to the "PLU" shortcuts, so its super-easy to add it to a new sale from the "quick-add" section in Touch mode in sale.
{% endhint %}
{% endstep %}

{% step %}

### Enable the Flow Gift Card extension on the wanted store(s)

Go to **Backoffice** > **Stores** > **\[your store]** > **Services** > **Flow Gift Card**

Make sure the configuration is set up, and that the extension is enabled.

{% hint style="warning" %}
If you are using Flow Gift Card on multiple stores, you must use different merchants for each store. Contact customer service for adding more mercants to the issuer account.
{% endhint %}
{% endstep %}

{% step %}

### Enable the Flow Gift Card payment method 

Go to **Backoffice** > **Stores** > **\[your store]** > **Payment**

Add and Enable the Flow Gift Card payment method from the list of available payment methods.
{% endstep %}
{% endstepper %}

Congratulations! You are now ready to both sell and accept gift cards in your store(s)!


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flowretail.com/docs/extensions-addons/flow-gift-card/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.