# Installation and Configuration

### App Installation and Configuration

If you already have your POS/payment solution installed and are adding gift card support, or want to add Freebees gift card support, you need to install and configure the application on your terminal.

This section will explain how to install and configure the Freebees app on your PAX payment terminal:

* [Download and Install the App](#download-and-install-the-app)
* [Configure the App](#configure-the-app)

***

### Download and Install the App

If the Freebees app is not already installed on your payment terminal. use the following procedure to download and install the app.

{% hint style="info" %}
NOTE: The Freebees app is only certified for use on Android-based PAX payment terminals at this time.
{% endhint %}

#### **To download and install the Freebees app on a PAX terminal:**

1. On your payment terminal, locate the **PAXSTORE** icon.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FnjKpB4yDTUSZVlCBN8cy%2FPAXstoreIcon.png?alt=media&#x26;token=6859b6b0-a449-42d6-b41b-6b7888720b9d" alt=""><figcaption></figcaption></figure>

2. Touch the **PAXSTORE** icon to launch the PAX app store.
3. Touch the search field and use the keyboard to enter **Freebees**.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FxwsRt4OzqAkULHkuGQMj%2FGetFreebeesApp.png?alt=media&#x26;token=e6d5430f-26b0-495f-83b9-5bb4e9c1286d" alt=""><figcaption></figcaption></figure>

4. When the Freebees **Gift and Loyalty** app appears, touch the **GET** button or the **download** icon.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2F33GYjehJMquIV7bKVxDl%2FPAXstoreDownloadIcon.png?alt=media&#x26;token=561332c1-d00e-4821-849f-35cf84992de4" alt=""><figcaption></figcaption></figure>

5. The app downloads and installs automatically on the terminal.
6. You can touch the **OPEN** button to launch the app or return to the terminal's main window.

***

### &#x20;Configure the App

If the Freebees app was not installed prior to receiving your payment terminal(s), you need to configure the settings to ensure proper communication with the server that authorizes gift card transactions.

{% hint style="warning" %}
IMPORTANT! When configuring the Freebees app, make sure you have the **Partner ID**, **Location ID**, and **Security key** at hand to enter your individual merchant information. You should have received this information from PayFacto or Freebees. If you do not have this information, please contact support before proceeding.
{% endhint %}

#### **To configure the Freebees app for its first use:**

1. Touch the Freebees **Gift and Loyalty** app icon on the terminal's main screen.

![Freebees icon](https://documentation.payfacto.com/PF_GiftCard/UG/CA-EN/assets/images/FreebeesAppIcon.png)

2. Touch the **ADMIN** button at the bottom of the screen.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FXbt4eja94BA0EcJCuyfB%2FAdminButton.png?alt=media&#x26;token=ae491f3a-bb5c-4bc8-94a3-f2d7d69719c7" alt=""><figcaption></figcaption></figure>

3. Scroll down to locate the **Configuration** section.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FYlx3AoN75cB5JRbhtJlO%2FConfigMenu.png?alt=media&#x26;token=92896fa2-567f-465f-9522-22cfdccd960b" alt=""><figcaption></figcaption></figure>

4. Select **Production** from the **Mode** list.
5. If you have multiple payment terminals using the Freebees app, you can enter a unique identifier for each terminal using the **Workstation** parameter; touch **Workstation** and enter your terminal's identifier in the field and touch **OK**. By default, the Workstation is set to **0**.
6. Touch **Partner ID** and enter your partner identification in the field and touch **OK**.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FIUkEQvL8A696BsrijBfI%2FConfig_PartnerID.png?alt=media&#x26;token=3412a938-3531-455c-bf5b-361077a6382f" alt=""><figcaption></figcaption></figure>

7. Touch **Location ID** and enter your location identifier in the field and touch **OK**.<br>

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FwMt7OnjbRlK4IW1ty3Be%2FConfig_LocationID.png?alt=media&#x26;token=37105498-8b0e-4245-a15e-7bec269bc045" alt=""><figcaption></figcaption></figure>

8. Touch **Security key** and enter your security key in the field and touch **OK**.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FgQNHAYCuJHJZpfX7Unxo%2FConfig_SecurityKey.png?alt=media&#x26;token=fc85127a-aedd-4b74-8350-dfb65b009102" alt=""><figcaption></figcaption></figure>

9. Touch the **Back** button to return to the Freebees main screen.   <img src="https://documentation.payfacto.com/PF_GiftCard/UG/CA-EN/assets/images/ExitIcon.png" alt="Exit icon" data-size="line">