TABLE OF CONTENTS

 

[Modules] calypso_card_pin.c

NAME

   SpringCard Calypso API :: Card command set (verify pin / change pin)

COPYRIGHT

AUTHOR

   Johann Dantant / PRO ACTIVE

HISTORY

   JDA 12/01/2010 : first public release

[Functions] CalypsoCardChangePinCipher

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

[Functions] 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

[Functions] CalypsoCardVerifyPinCipher

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

[Functions] 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

[Functions] CalypsoCardVerifyPinPlain

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

[Functions] CalypsoCardVerifyPinPlainEx

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

Generated from calypso_card_pin.c on Mon Aug 18 16:38:26 2014