Gift Cards

Gift card gateway providers must first be set up in the Gift Card panel for guests’ redemption.

The feature setting named Gift Card must be enabled to proceed with the configuration. The following permissions are required to enter or edit gift card configurations:

  • GiftCardConfiguration (Default Role: System Administrator)

  • ReadGiftCard (Default Role: GSA, GSA Supervisor)

Currently, the following gift card providers are supported:

  • Givex

  • Shift4

Configuring Givex

Perform the following steps to set up the Givex gift card gateway:

Navigate to Settings ➜ All Settings ➜ Accounting ➜ Agilysys Pay Setup.

Click the Select Gateway Provider link in the Gift Card panel.

Select Givex in the Gift Card Gateway Providers pop-up screen.

Click Ok. The settings that are applicable for Givex are displayed on the Gift Card panel

Enter the details as given in the table below:

Field

Description

Client URI

The client URL and the port as provided by Givex.
Usually, it is https://dc-us1.givex.com:50019.

Client Backup URI

The failover or backup URL and the port as provided by Givex.
Usually, it is https://dc-us1.givex.com:50019.

User ID

The user ID provided by Givex to access their endpoints.

Password

The password provided by Givex.

Select Transaction Item

The transaction item to be associated with gift card-related transactions.

Search for House Account

A house account to associate all transactions related to gift cards. The field is optional.

Click Save to complete settings.

Maintain Gift Card Configurations in Stay or Pay Portal

Stay allows users to choose if the gift card configurations for the property must be maintained in Stay or in the Pay Portal.

This feature is available for GiveX gift cards only. Contact Agilysys to enable the GiveX gift card integration for the property.

To use this feature, users must enable the Utilize Configuration from Pay Portal flag in the Gift Card section of the Agilysys Pay Setup screen (All Settings ➜ Accounting ➜ Agilysys Pay Setup). This flag is disabled by default. When enabled, the following fields are hidden in the UI and the values for the fields are retrieved from the Pay Portal:

  • Client URL

  • Client Backup URL

  • User ID

  • Password

When the flag is disabled, the mentioned are displayed in the UI and users can configure values for the fields, thereby allowing users to maintain the gift card configurations in Stay.

A screenshot of a computer Description automatically generated

Enter Pin for Gift Card Redemption

Stay allows properties to choose if a pin must be entered when redeeming gift cards in Stay.

This feature is available for GiveX gift cards only. Contact Agilysys to enable the GiveX gift card integration for the property.

To use this feature, users must enable the Require Pin for Redemption flag in the Gift Card section of the Agilysys Pay Setup screen (All Settings ➜ Accounting ➜ Agilysys Pay Setup). When enabled, users are prompted to enter a PIN number when making payments using gift cards.

A screenshot of a computer AI-generated content may be incorrect.

Configuring Shift4

Perform the following steps to set up the Givex gift card gateway:

Navigate to Settings ➜ All Settings ➜ Accounting ➜ Agilysys Pay Setup.

Click the Select Gateway Provider link in the Gift Card panel.

Select Shift4 in the Gift Card Gateway Providers pop-up screen.

Click Ok. The settings that are applicable for Shift4 are displayed on the Gift Card panel.

Enter the details as given in the table below:

Field

Description

Access Token

The access token generated while installing the Agilysys Pay Shift4 Agent.

Host

The following URLs:
Production - https://dotn.shift4api.net/api/s4tran_action.cfm

Testing - https://cfapi.shift4test.com/api/S4Tran_Action.cfm

Select Transaction Item

The transaction item to be associated with all gift card related transactions.

Search for House Account

A house account to associate all transactions related to gift cards. This field is optional.

Click Save to complete settings.