
Accessed by selecting the POS API option in the Server Type drop down list.
Used to configure the settings required for the POS API Interface. The POS API (POS.Gateway.Client.exe) interface is used to process OrderAway and TouchMini Orders/Sales.
Notes...
This Interface along with the entry for the Gateway Client Service (Touch.Gateway.Client.exe) interface will automatically be added to the list of Interfaces displayed in the grid of the Interfaces List screen, when the Location (this Touch Terminal is assigned to) is activated.
Noteworthy
- Port - Defaults to 33300.
Notes...
If the default value is changed then consideration will need to be given to the fact that the new value entered here will also have to be reflected in the setting RestfullSwiftPOSAdaptor-TwaBaseUrl configured in Venue Manager's > Connect > Adaptor Settings.
- Return Receipt Text - It is recommended that this is always selected. Select to ensure that receipt information is retrieved from Touch and returned in the form of text.
- Max Width - Default is 32 characters. Displays/Enter the maximum width in characters of the generated Receipt.
Notes...
This setting was added and is recommended to be set to 32 in order to gain the best results when using Pax devices.
- Return Receipt Image - It is recommended that this is always selected. Select to ensure that receipt information is retrieved from Touch and returned in the form of an image file. Once selected, and the Receipt Peripheral:
- Is configured as Non-Graphical, then the POS API will return a Receipt Image with a default header and footer using the following variables:
- Header
- {DOCKET TYPE}
- {TRADING NAME}
- {ABNDescription}: {ABN}
- --------------------------------------
- Footer
- Receipt #: {RECEIPT #}
- Date: {LASTACTIVITYDATE} Time: {LASTACTIVITYTIME}
- Clerk: {CLERK #} {CLERK NAME}
- Terminal: {TERMINAL ID} {TERMINAL NAME}
- Header
- Is configured as Non-Graphical, then the POS API will return a Receipt Image with a default header and footer using the following variables:

An example of the default Receipt returned.
- Return Receipt Image continued ...
- Is configured as Graphical and then changed to Non-Graphical, the POS API will still return a Receipt Image based on the previous Graphical configuration. To ensure it returns Receipt Image with a default header and footer (as per above), then temporarily select the Use Graphical Printing option and clear all content in the Header and Footer and save the changes. Then unselect the Use Graphical Printing option and save again. The POS API will now return a Receipt Image with a default header and footer.
Notes...
It is recommended that both the above Return Receipt options are always selected. This will ensure accurate amounts/balances are always returned.
- Open Port for All Users - Select to ensure that all users regardless of their authorisation level (Admin rights) can run the selected Server Type. In this case POS API. By adding this option it ensures Apps are running with the highest authorisation level if required. For example, POS API requires Admin level authorisation, then make sure the required windows users are placed in the Administrative group. Application titles will append (Administrator) to the end to indicate the mode.
- URLs - Displays the URLs that need to be provided to the Client/Provider when configuring a new Web Server.
Notes...
These will automatically be populated when the interface is added. Also, to confirm that a connection has been established with POS API, copy the first URL listed (for example, http://???:33300/touchapi/v1/diagnostic) into a browser and it should return diagnostic information such as: {"LocalDateTime":"2022-09-14T11:21:45.366073+10:00","Version":"10.21.58.43","Messages":["Primary Receipt Printer: Online","Kitchen Printer: Online","Order Printer: NotFound","KVS 1: Enabled","KVS 2: Disabled","KVS 9: Disabled","KVS 11: Disabled","KVS 12: Disabled","KVS 13: Disabled","NetPOS: Online"]}. If a This site can't be reached or Unable to connect or any other similar response is returned then there is an issue with the settings configured.
Notes...
Leaving the Touch Terminal Settings screen open and NOT exiting it will generate an error in TouchMini. Refer to Touch Web Adaptor Error for more information.
End of article. ▲