ResponsePINKey Property

PIN Encryption key to be loaded into the PIN pad device.

Object Oriented Interface

public function getResponsePINKey();

Procedural Interface

inpaydirect_ptechcanadiandebit_get($res, 25 );

Default Value

''

Remarks

PIN Encryption key to be loaded into the PIN pad device. PIN encryption key encrypted under the PIN pad master key. This key changes as required by Interac regulations, and should be loaded into the PIN pad device upon receipt. Future transactions must contain an encrypted PIN block (EncryptedPIN) that was computed by the PIN pad using this key.

Keys are required to be renewed every:

• 200 Transactions
• 24 Hours
• Each time a Batch is released for settlement
• Whenever the PIN pad loses sync with the server

When the host changes the key, a new key index is assigned and returned in the EncryptedKeyIndex property. The class needs to update the PIN pad with the ResponsePINKey and ResponseMACKey after each transaction in order to stay in sync with the host. If the keys and/or the EncryptedKeyIndex become out of sync, you must use the RequestCurrentKeys method to retrieve a valid set of keys and restore the synchronization.

If the ResponseForceKeyRequest property is True after any transaction, you must immediately perform a RequestCurrentKeys transaction before sending any more authorizations.

This property is read-only.

Data Type

String