How to Understand PSAM Card Exceptions in Q2/Q3 Series: Difference between revisions

From wizarPOS
No edit summary
No edit summary
Line 1: Line 1:
Here are two cases will throw this exception in Q2/Q3 series when using SmartCardReaderDevice.open method:
== Overview ==
* No inserted physical SAM card, it will throw this exception.
This section details the common exceptions encountered when using the SmartCardReaderDevice.open method in Q2/Q3 series devices for PSAM cards.
* After insert PSAM card to the terminal, please restart the device, because the PSAM card reader can not support hot plug. If don't restart the device, the PSAM card can not be identified, it will throw this exception.
== Common Exception Scenarios ==
# '''No Physical SAM Card Inserted:'''
#* When attempting to open the PSAM card reader without a physical SAM card inserted, the system will throw an exception.
#* Exception Details: ''''Code:-6 com.cloudpos.DeviceException: Operation error! Error code = -1, Error message = Operation not permitted''''.
# '''Device Restart Required After PSAM Card Insertion:'''
#* Inserting a PSAM card into the terminal does not support hot plugging. Therefore, the device needs to be restarted after insertion.
#* If the device is not restarted, the PSAM card will not be recognized, leading to an exception.
#* Same exception details as above will apply in this scenario.
== Important Notes ==
* It is essential to ensure that a PSAM card is physically present in the reader before attempting to use the SmartCardReaderDevice.open method.
* Always restart the device after inserting a PSAM card to ensure proper recognition and functionality.

Revision as of 22:04, 6 January 2024

Overview

This section details the common exceptions encountered when using the SmartCardReaderDevice.open method in Q2/Q3 series devices for PSAM cards.

Common Exception Scenarios

  1. No Physical SAM Card Inserted:
    • When attempting to open the PSAM card reader without a physical SAM card inserted, the system will throw an exception.
    • Exception Details: 'Code:-6 com.cloudpos.DeviceException: Operation error! Error code = -1, Error message = Operation not permitted'.
  2. Device Restart Required After PSAM Card Insertion:
    • Inserting a PSAM card into the terminal does not support hot plugging. Therefore, the device needs to be restarted after insertion.
    • If the device is not restarted, the PSAM card will not be recognized, leading to an exception.
    • Same exception details as above will apply in this scenario.

Important Notes

  • It is essential to ensure that a PSAM card is physically present in the reader before attempting to use the SmartCardReaderDevice.open method.
  • Always restart the device after inserting a PSAM card to ensure proper recognition and functionality.