NAME
SpringCard Calypso API :: Card command set (verify pin / change pin)
COPYRIGHT
(c) 2008 PRO ACTIVE SAS - See LICENCE.txt for licence information
AUTHOR
Johann Dantant / PRO ACTIVE
HISTORY
JDA 12/01/2010 : first public release
NAME
CalypsoCardChangePinCipher
DESCRIPTION
Change card's PIN (ciphered mode)
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE new_pin[4] : the new pin code
RETURNS
CALYPSO_RC : 0 or an error code
NOTES
The pin has to be ciphered by the SAM using card's ISSUER key. Therefore, this function can only be called after a previous call to CalypsoStartTransaction (or CalypsoStartTransactionEx) having key_no = CALYPSO_KEY_ISSUER This function should also follow a successfull call to CalypsoCardVerifyPinPlain (or CalypsoCardVerifyPinPlainEx or CalypsoCardVerifyPinCipher or CalypsoCardVerifyPinCipherEx)
SEE ALSO
CalypsoCardChangePinPlain
NAME
CalypsoCardChangePinPlain
DESCRIPTION
Change card's PIN
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE new_pin[4] : the new pin code
RETURNS
CALYPSO_RC : 0 or an error code
NOTES
This function must follow a successfull call to CalypsoCardVerifyPinPlain (or CalypsoCardVerifyPinPlainEx or CalypsoCardVerifyPinCipher or CalypsoCardVerifyPinCipherEx)
SEE ALSO
CalypsoCardChangePinCipher
NAME
CalypsoCardVerifyPinCipher
DESCRIPTION
Verify card's PIN (ciphered mode)
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE pin[4] : the pin code
RETURNS
CALYPSO_RC : 0 or an error code
NOTES
The pin has to be ciphered by the SAM using card's DEBIT key. Therefore, this function can only be called after a previous call to CalypsoStartTransaction (or CalypsoStartTransactionEx) having key_no = CALYPSO_KEY_DEBIT
SEE ALSO
CalypsoCardVerifyPinPlain CalypsoCardVerifyPinPlainEx CalypsoCardVerifyPinCipherEx
NAME
CalypsoCardVerifyPinCipherEx
DESCRIPTION
Verify card's PIN, returning the remaining number of tries (ciphered mode)
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE pin[4] : the pin code BYTE *remaining : the number of tries remaining
RETURNS
CALYPSO_RC : 0 or an error code
NOTES
The pin has to be ciphered by the SAM using card's DEBIT key. Therefore, this function can only be called after a previous call to CalypsoStartTransaction (or CalypsoStartTransactionEx) having key_no = CALYPSO_KEY_DEBIT
SEE ALSO
CalypsoCardVerifyPinPlain CalypsoCardVerifyPinPlainEx CalypsoCardVerifyPinCipher
NAME
CalypsoCardVerifyPinPlain
DESCRIPTION
Verify card's PIN
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE pin[4] : the pin code
RETURNS
CALYPSO_RC : 0 or an error code
SEE ALSO
CalypsoCardVerifyPinPlainEx CalypsoCardVerifyPinCipherEx CalypsoCardVerifyPinCipher
NAME
CalypsoCardVerifyPinPlainEx
DESCRIPTION
Verify card's PIN, returning the remaining number of tries
INPUTS
CALYPSO_CTX_ST *ctx : library context const BYTE pin[4] : the pin code BYTE *remaining : the number of tries remaining
RETURNS
CALYPSO_RC : 0 or an error code
SEE ALSO
CalypsoCardVerifyPinPlain CalypsoCardVerifyPinCipherEx CalypsoCardVerifyPinCipher