{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-docs/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition"]},"type":"markdown"},"seo":{"title":"Terminal information and logs","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"terminal-information-and-logs","__idx":0},"children":["Terminal information and logs"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"terminal-information","__idx":1},"children":["Terminal information"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The JS library provides a diagnostic function that lets the POS check whether a given terminal is"," ","currently paired to and reachable by the POS. This is particularly useful where multiple terminals"," ","are paired to the POS and it needs to determine their status, and it's also helpful diagnostically"," ","— it helps identify any offline, disconnected, or unpaired terminals."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terminalInfo()"]}," is only available with the headless JS library:"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["<script src=\"https://iclient.tyro.com/iclient-v1.js\" type=\"text/javascript\"></script>"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"specification","__idx":2},"children":["Specification"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["terminalInfo(responseReceivedCallback, requestParams)"]}," — callback invoked when the terminal"," ","responds, called with a single object containing the following properties."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters:"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["requestParams"]}," (Object) — an object containing the following parameters:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Parameter"},"children":["Parameter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Description"},"children":["Description"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Required"},"children":["Required"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["tid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Override the configured tid for multi-merchant terminals or if your browser does not support local storage."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["mid"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Integer"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Override the configured mid for multi-merchant terminals or if your browser does not support local storage."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["integrationKey"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["String"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Supply the integration key if your browser does not support local storage."]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yes"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["responseReceivedCallback"]}," (Function) — a callback invoked to indicate the status of a pairing."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"iclient-logs","__idx":3},"children":["iClient logs"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The JS library captures all the interactions between the EFTPOS terminal and the POS, along with"," ","the POS information, in the form of logs. Contact Tyro customer support for assistance"," ","understanding these log messages. The POS has to embed the iClient logs URL"," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["https://iclientsimulator.test.tyro.com/logs.html"]}," in an iframe in its POS or PMS application."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"demo-iclient-logs-and-embedded-pairing","__idx":4},"children":["Demo (iClient logs and embedded pairing)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To learn more about the implementation of embedded pairing (see ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/docs/in-person-payments/pay-in-person/integration-guide/js-library/pairing"},"children":["Pairing"]},") and"," ","embedded iClient logs:"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://jsfiddle.net/IntegrationSupport/cqz8d7r0/"},"children":["JS Fiddle demo"]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Don't click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Save"]}," if you make changes in the JS Fiddle — click ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Run"]}," instead. Clicking Save"," ","may break the fiddle's functionality."]}]}]},"headings":[{"value":"Terminal information and logs","id":"terminal-information-and-logs","depth":1},{"value":"Terminal information","id":"terminal-information","depth":2},{"value":"Specification","id":"specification","depth":3},{"value":"iClient logs","id":"iclient-logs","depth":2},{"value":"Demo (iClient logs and embedded pairing)","id":"demo-iclient-logs-and-embedded-pairing","depth":3}],"frontmatter":{"title":"Terminal information and logs","seo":{"title":"Terminal information and logs"}},"lastModified":"2026-09-20T23:33:08.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/docs/in-person-payments/pay-in-person/integration-guide/js-library/terminal-configuration","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}