Handling Response

Interpreting responses with accuracy and ease.

The response-handling APIs enables the POS application to retrieve, validate, and decode responses sent from the Smart Terminal after a transaction request. It provides mechanisms to confirm the integrity of the response data and convert it into an accessible format, typically a key-value map keyed by standardized tags. This allows the POS to easily interpret and use the terminal’s response data for further processing or user display.

Sequence Flow

Process Flow

1. Smart Terminal sends a response to the SDK after processing the request.
2. POS calls receiveResponse() from the SDK to retrieve the terminal’s response.
3. SDK checks if a response has been received.
4. If response is received :
   • SDK notifies POS that the response was received successfully.
   • POS calls verifyResponse() to ensure the response’s integrity.
   • SDK validates the response.
   • If response is valid:
     • SDK returns the validated response string to POS.
     • POS calls decodeResponse() to decode the string.
     • SDK decodes the response into a key-value map (tag-value pairs).
     • SDK returns the response map to POS.
     • POS accesses a specific value using ReaderTag.
     • POS displays the result to the user
   • If response is invalid, SDK returns an invalid response error to POS.
   • If no response is received, SDK returns failure error or a timeout to POS.