Performs a key exchange operation to establish a secure session and obtain an authentication token. This endpoint is used after client registration to set up secure communication.
Endpoint
GET /isw/auth/keyExchange
Authentication
May require authentication depending on system configuration.
Response
Returns a system response containing key exchange details wrapped in a standard response structure.
Status code of the response
Human-readable message describing the response
Key exchange response dataAuthentication token for subsequent API requests
response.serverSessionPublicKey
Server’s session public key for encrypting requests
Token expiration timestamp
Indicates whether OTP verification is required
Terminal-specific key for additional security
Example request
curl --request GET \
--url http://localhost:8081/isw/auth/keyExchange
Example response
{
"responseCode": "00",
"responseMessage": "Successful",
"response": {
"authToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"serverSessionPublicKey": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA...",
"expireTime": "2026-03-03T12:00:00Z",
"requiresOtp": false,
"terminalKey": "TERM_KEY_12345"
}
}