Terminal Agent

Terminal Agent is a SensePass software designed to connect platforms to SensePass network with a range of EMV pinpads and to simplify the integration process, allowing for quick setup and deployment.

Terminal Agent also works as a proxy to all SensePass cloud API describes in this portal.

In addition, Terminal agent allows you to use specific API's created for the Terminal Agent software to reduce the integration time.

Advantages:

  1. Pairing of tags and EMV devices is already implemented

    Terminal Agent handles the pairing process for all types of terminals and tags using SensePass UI

  2. Storing API keys, Device ID's and EMV ID's is already implemented

    Terminal Agent stores all the credentials and authentication keys and append them automatically to all of your requests

  3. Implementing Web-sockets or Callback endpoint is already implemented

    Terminal Agent internal logic works with Socket.IO websockets securely, according to SensePass interface and returns synchronous response to your platform

  4. Integrating using Terminal Agent enables you to support new features and releases without any change on your end

    Most of the new features that will be released to our API will be available to you seamlessly by updating the Terminal Agent software on the POS, without having to change one line of code on your platform

  5. Integration with the Cancel API is already implemented

    Terminal Agent detects the cancel event of the HTTP request for Synchronous Payment API and calls internally to the "Cancel" API in order to revoke the pending payment request

  6. Terminal Agent software is already certified by SensePass

    Integration using Terminal Agent reduces most of the certifcation process for your platform

System Requirements: Operating System: Compatible with Windows 7, 8, 10, and newer versions.

Synchronous payment request

Terminal Agent expose synchronous payment request call that reduce the integration time and logics.

Usage Flow:

  1. Call POST request to: http://localhost:8003/api/transactions/init/sync Use the same schema as - Create a transaction

  2. DeviceId field is not required - Terminal agent will append it automatically

  3. Cancelling the payment request can be done using cancelling the HTTP request from #1

  4. On final result (Approve, timeout or Cancel) - you will get response to this request

See full docs about sync payment request

Last Transaction Status

Terminal Agent expose an API to recover from network issue while using the Sync payment API,

in event of error or closed connection, you can use this API to fetch the current status of the last transaction created.

Usage Flow:

  1. Call GET request to: http://localhost:8003/api/transactions/last Without any request payload

  2. DeviceId field is not required - Terminal agent will append it automatically

  3. Reponse will return immediately according to Transaction Status schema

See full docs about last transaction status API

Terminal Agent Key Features

  • Reduces the intergation time: Pairing, cancelling request and working with websockets logics are already embeded inside terminal agent

  • Compatibility with Various Pinpads: Terminal Agent supports a wide array of EMV pinpad models and manufacturers, enhancing its utility in diverse environments.

  • Easy Integration: Designed for effortless setup, enabling quick deployment across multiple terminals.

  • Real-time Monitoring: Ensures continuous operation with live monitoring capabilities.

  • Automatic Updates: Keeps the system up-to-date with the latest features and security patches without manual intervention.

Last updated