# Application Configuration

The PayFacto Gift application can run independently of the payment application running on your terminal or POS. If you are using PayFacto Gift as a standalone application, there are application and terminal settings you may want to configure to meet your business requirements.

These settings include:

* [Invoice Numbering](#invoice-numbering)
* [DataCandy Settings](#datacandy-settings)

***

### Invoice Numbering

For bookkeeping purposes, invoices are numbered. The numbering can be done manually or automatically. By default, the terminal numbers the invoices automatically, in sequence. If you disable automatic invoice numbering, the terminal prompts the operator to manually input an invoice number (maximum of 12 numeric characters); you cannot process a redemption transaction without an invoice number.

![Invoice number entry](https://documentation.payfacto.com/PF_GiftCard_DataCandy/UG/CA-EN/assets/images/image18.png)

#### **To enable/disable automatic invoice numbering:**

1. Touch the **Action** button on the main screen. <img src="https://documentation.payfacto.com/PF_GiftCard_DataCandy/UG/CA-EN/assets/images/image3.png" alt="Action" data-size="line">
2. Touch **Settings**. <img src="https://documentation.payfacto.com/PF_GiftCard_DataCandy/UG/CA-EN/assets/images/image19.png" alt="Transactions" data-size="line">
3. Enter the Admin password and touch **OK**.
4. In the **General** section, toggle **Automatic Invoice Number** to **On** (to the right) to enable automatic invoice numbering or toggle to **Off** (to the left) to enter the invoice number manually for every redemption transaction.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2F7OmUS9yCU5oBGGvhtNq7%2Fimage20.png?alt=media&#x26;token=ada071e6-bc94-49f5-a50e-f0462598aebb" alt=""><figcaption></figcaption></figure>

5. ,Touch the **Back** icon to return to the main screen.<img src="https://documentation.payfacto.com/PF_GiftCard_DataCandy/UG/CA-EN/assets/images/image21.png" alt="Back icon" data-size="line">

***

### DataCandy Settings

The DataCandy Settings section of the Settings page are generally configured prior to delivery or as part of the application’s setup process. They should not require modification. If your terminal is having problems communicating with the DataCandy server, you may need to adjust one or more of the fields contained in this section. Refer to the DataCandy email for the values.

{% hint style="info" %}
NOTE: You should not change any of these fields unless instructed to do so by PayFacto or DataCandy support.
{% endhint %}

The available fields include:

* **Production URL**: Touch this toggle switch to **On** (to the right) to enable the terminal to communicate with the DataCandy server. When toggled to **Off** (to the left), the terminal cannot communicate with the DataCandy server.
* **URL**: The address of the DataCandy server.
* **WSN**: The WorkStation Number; a unique value for each terminal.
* **Merchant ID**: The information in this field should correspond to the Merchant ID sent to you by DataCandy. If the Merchant ID value does not match the one from in the DataCandy email, make the necessary corrections.
* **Merchant password**: The information in this field should correspond to the Merchant password sent to you by DataCandy. If the Merchant password value does not match the one from in the DataCandy email, make the necessary corrections.
* **Version**: This is a static value that should not be changed; it should always be 2010-01-06.
* **Access key**: The information in this field should correspond to the Access key sent to you by DataCandy. If the Access key value does not match the one from in the DataCandy email, make the necessary corrections.
* **App Version**: This field displays the current version of the Gift PayFacto powered by DataCandy app installed on the terminal; the field is read-only and cannot be modified.

{% hint style="warning" %}
IMPORTANT: Changing these fields to any value other than those provided by DataCandy or PayFacto will prevent your terminal from processing gift cards.
{% endhint %}

#### **To change DataCandy settings:**

1. Touch the **Action** button on the main screen. <img src="https://documentation.payfacto.com/PF_GiftCard_DataCandy/UG/CA-EN/assets/images/image3.png" alt="Action" data-size="line">
2. Touch **Settings**. <img src="https://documentation.payfacto.com/PF_GiftCard_DataCandy/UG/CA-EN/assets/images/image19.png" alt="Transactions" data-size="line">
3. Enter the Admin password and touch **OK**.
4. Scroll to the **DataCandy Settings** section.
5. Confirm that the **Production URL** toggle switch is set to **On** (to the right).

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2F8WV93XAWflPD8X45xjp2%2Fimage60.png?alt=media&#x26;token=4c7e13f7-cfe1-4506-8e8c-5ec4fe020ddd" alt=""><figcaption></figcaption></figure>

6. Confirm that the **URL** field is set to **<https://secure.datacandy.com/>**.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FKsh1ine2YoTk64UXNGXJ%2Fimage61.png?alt=media&#x26;token=dbfd57c6-d60b-43a9-8148-d76f20269dcf" alt=""><figcaption></figcaption></figure>

If the value is different, touch the field, enter the correct value, and touch **OK**.

7. Confirm that the **Merhcant ID** field corresponds to the **Merchant ID** from the DataCandy email.<br>

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2Fw9hJXVqX7gQ43vP1GNj8%2Fimage62.png?alt=media&#x26;token=939f98e4-468c-439b-821f-672aa641928d" alt=""><figcaption></figcaption></figure>

\
If the value is different, touch the field, enter the correct value, and touch **OK**.

8. Confirm that the **Merchant password** field corresponds to the **Merchant password** from the DataCandy email.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FrLfEbXRvFtroB991xaFM%2Fimage63.png?alt=media&#x26;token=3cf8eb46-fd58-457c-a347-d05965ee3c62" alt=""><figcaption></figcaption></figure>

\
If the value is different, touch the field, enter the correct value, and touch **OK**.

9. Confirm that the **Access key** field corresponds to the **Access key** from the DataCandy email.

<figure><img src="https://3906380439-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F6flXtoPk5hDLO7lHpA2z%2Fuploads%2FhIRn2XU5LnsEUYb0VVTB%2Fimage64.png?alt=media&#x26;token=274fe240-dce2-4813-b600-2230e743c286" alt=""><figcaption></figcaption></figure>

\
If the value is different, touch the field, enter the correct value, and touch **OK**.

10. Touch the **Back** icon to return to the main screen. ![Back icon](https://documentation.payfacto.com/PF_GiftCard_DataCandy/UG/CA-EN/assets/images/image21.png)


---

# Agent Instructions: 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:

```
GET https://docs.payfacto.com/payfacto-knowledge/canada-doc-center/applications/payfacto-gift-datacandy/application-configuration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
