Configure Text-to-Pay in Simphony

Last updated
Save as PDF

Description: Learn how to configure Simphony for xDine Text-to-Pay, including the interface, extension application, menu item, and testing.

Overview of Text-to-Pay Configuration in Simphony

This article describes how to configure Simphony for xDine Text-to-Pay. Complete the sections in order, starting from the enterprise level in EMC. Log in to EMC before you begin.

Enable SIM File Access in Enterprise Parameters

From the enterprise level in EMC, go to Setup > Enterprise Parameters.
Select the Security tab.
Ensure that Enable SIM File Access Service is checked.

Create the Text-to-Pay Interface in EMC

From the enterprise level in EMC, go to Setup > Interfaces.
Insert a new record with a name of xDineTextToPay.
Double-click the record and configure the options in the following table.

Tab Name	Option Name	Value
GENERAL	System Name:	xDineTextToPay (or anything else you want)
GENERAL	Communication Name:	X_PHONE_NUM Note: If this is set incorrectly and saved, you have to delete the interface and create a new one. Simphony allows you to change the value, but the change doesn't actually take effect.
GENERAL	Interface Type:	0 - PMS/SIM
GENERAL	Communications Type:	1 - TCP
GENERAL	Backup Interface:	0 - None
GENERAL	Offline Posting Link:	0 - None
GENERAL	SIMDB Link:	0 - None
GENERAL	Encoding Type:	0 - ASCII
GENERAL	Timeout:	5
GENERAL	Ping Frequency:	0
GENERAL	ISL Script Name:	T2P.isl (or anything else that you want)
OPTIONS	Options	Make sure the following are checked: 2 - Enable Interface Log 5 - On = Use 9 digits for Terminal IDs
OPTIONS	TCP Host Name:	Enter the IP that transaction services runs on (that is, where the xDine.exe is installed).
OPTIONS	Port Number:	5013
PROPERTIES	Select all properties the interface should be available to
SERVICE HOST TAB	Configure which Service Host the SIM will communicate with

Create the Extension Application in EMC

From the enterprise level in EMC, go to Setup > Extension Application.
Select Insert from the EMC menu and enter the Record Name. For consistency, use the same name you used for System Name in the interface (xDineTextToPay).
From the main Extension Application list screen:
- Add a Description to the entry that will allow others to know what its purpose is.
- Under Interface, select xDineTextToPay, which is what you set GENERAL > System Name to.
- Set the Option Bits as 2 - Allow running extension applications on application servers.
- Leave all other settings and option bits as their default value.
Double-click the entry. This should load the General tab.
Select Insert Application Content. This will open a popup.
- Set the Zoneable Key to X_PHONE_NUM.
- Add a Description to the entry that will allow others to know what its purpose is, then select OK.
- Set the Disk File Name to X_PHONE_NUM.isl.
- Set the Option Bits as 2-Main SIM Content.
- If you want to control which properties or workstation types you send this to, you can configure as needed under Target.
Select the Designer tab.
- Select Import from a file.
- Import the file provided by Eigen.

Note: The Option Bits configured inside the extension application are NOT the same as the Option Bits configured on the main Extension Application list screen. Both Option Bits need to be defined separately.

Link the SIM Service Host in Property Parameters

Select the property you want to configure, then select Setup > Property Parameters.
Select the Workstations tab.
Confirm that the SIM File Access Service is set to the same Service Host that you configured on the interface.
Keep the default Port and URL.

Link the Interface in RVC Parameters

Select the RVC you want to configure, then select Setup > RVC Parameters.
Select the Interfaces tab.
Use the next available slot to add your new interface.

Create the Text-to-Pay Item in Simphony

You need to create an item for Text-to-Pay. Servers will submit that item to an order and attach a phone number to it.

Create a Menu Item Class that has Options > 5 Reference Entry Required checked. There may be one that you already have, or you can create a new one. If you do not have one, create a new one and name it any way you like.
Create an item and set its menu item class to the one you just set up.
Add that item to a screen.
Save all configuration.
Run update database on a workstation to pull in the new item.
Start an order and select the item. It should open a dialog asking for a reference entry. If it does, then you have successfully configured the item.
Note the item number in Simphony. Eigen will need the item.

Update the Terminal

Restart Host Service on your workstation and run an Update DB.

Set Up xDine for Text-to-Pay

You need to configure xDine with hours of operation listed under table service. Contact Eigen if you are unsure how to do this.

Notify Eigen

Once the setup is complete, notify Eigen and provide them the item number.
Eigen will need to complete back end setup for the item.
Eigen will notify you when it is ready to test.

Test Text-to-Pay in Simphony

Start an order.
Order the Text-to-Pay item.
Enter your phone number on the reference entry screen.
Send the order to the kitchen.
You should get a text message to pay for the order.
When you get the text message, select the link and pay for the order.
The order should close out on Simphony.

Configure Text-to-Pay for Multiple Locations

If you have multiple locations and each location requires a different value for TCP Host Name, you have to:

Create a separate interface.
Create an extension application for each location at the enterprise level, or define one at each location in EMC.