This sections of the DynaFamily Programmer's Manual details notifications that come strictly from external banking sources.
Applies to: All DynaFamily products
Notification
When it fires
This notification reports information about progress and state changes involving the device’s Banking Functions modules.
This notification reports information about progress and state changes that occur during interaction with the Banking Functions modules.
This notification reports information about progress and state changes involving the device’s Banking Functions modules.
For this notification, Notification Detail described in section 3.2.2.3 Notification Message contains one byte each, shown in Table - Notification Detail Codes, to indicate:
The Payment Technology (PT) involved
The Reason (Rsn) for the notification
Detail (Det) about the notification that has different meanings depending on the Reason, and
An Extra field (Ext) that has different meanings depending on the Reason.
Payment Technology 0x07 Manual Card Entry (MCE) contains transaction notification detail codes involving manual card entry (MCE Only).
Reason 0x01 = Card Event
Reason 0x08 = Data Update
Reason 0x10 = State Update
07
01
01
00
Manual Card Entry (MCE), Card Event, Data Entered, Reserved
Payment Technology 0x08 Magnetic Stripe Reader (MSR) contains transaction notification detail codes involving magnetic stripe cards (MSR Only).
Reason 0x01 = Card Event
Reason 0x08 = Data Update
Reason 0x10 = State Update
08
01
01
00
MSR, Card Event, Swiped, Reserved (MSR Only)
08
01
02
00
MSR, Card Event, Inserted, Reserved (MSR Only)
08
01
03
00
MSR, Card Event, Removed, Reserved (MSR Only)
08
01
04
00
MSR, Card Event, Detected, Reserved (MSR Only)
Payment Technology 0x10 EMV Contact contains transaction notification detail codes involving contact chip cards (EMV Contact Only).
Reason 0x01 = Card Event
Reason 0x08 = Data Update
Reason 0x10 = State Update
10
01
02
00
EMV Contact, Card Event, Inserted, Reserved (EMV Contact Only)
10
01
03
00
EMV Contact, Card Event, Removed, Reserved (EMV Contact Only)
10
01
04
00
EMV Contact, Card Event, Detected, Reserved (EMV Contact Only)
Payment Technology 0x20 EMV Contactless contains transaction notification detail codes involving contactless cards and contactless payment devices. (EMV Contactless Only)
Reason 0x01 = Card Event
Reason 0x08 = Data Update
Reason 0x10 = State Update
20
01
03
00
EMV Contactless, Card Event, Removed, Reserved (EMV Contactless Only)
20
01
04
00
EMV Contactless, Card Event, Detected, Reserved (EMV Contactless Only)
20
01
05
00
EMV Contactless, Card Event, Collision, Reserved (EMV Contactless Only)
This notification reports information about progress and state changes that occur during interaction with the Banking Functions modules.
For this notification, Notification Detail described in section 3.2.2.3 Notification Message contains one byte each to indicate:
The User Interface Module (UI) involved
The Reason (Rsn) for the notification (UI Event)
Detail (Det) about the notification that has different meanings depending on the Reason, and
An Extra field (Ext) that has different meanings depending on the Reason.
Beginning of Notification Message
Beginning of Notification Message
FC
var
Decrypted Data Container
Module 0x01 Touchscreen contains UI notification detail codes that are specific to the touchscreen module (Touch Only)
Reason 0x01 = Signature Capture
Reason 0x02 = PIN Entry (Banking Functions Only)
01
02
01
01
(Banking Functions Only) Touchscreen, PIN Entry, Success, Data Attached — In this case, the device includes additional data defined in Table XXX, or in Table XXX if the device is including account data with PIN data.
01
02
02
01
(Banking Functions Only) Touchscreen, PIN Entry, Operation Failed, Timeout
01
02
02
02
(Banking Functions Only) Touchscreen, PIN Entry, Operation Failed, Hardware Not Available
01
02
02
03
(Banking Functions Only) Touchscreen, PIN Entry, Operation Failed, Canceled
01
02
02
04
(Banking Functions Only) Touchscreen, PIN Entry, Operation Failed, Error
01
02
02
05
(Banking Functions Only) Touchscreen, PIN Entry, Operation Failed, PIN Verify Failed
01
02
02
06
(Banking Functions Only) Touchscreen, PIN Entry, Operation Failed, Account Data Capture Failed
0205 = User Interface Operation Complete
84
var
Notification Payload
B
R
/F5
var
Container for Encrypted PIN Data
B
R
//DF71
01
PIN Block Format
0x00 = ISO Format 0
0x01 = ISO Format 1
0x03 = ISO Format 3
0x04 = ISO Format 4
B
R
//99
var
Encrypted PIN Block — ISO Formats 0, 1, and 3 are 8 bytes; ISO Format 4 is 16 bytes
B
R
//DFDF41
var
PIN Key Serial Number (KSN)
B
R
//DFDF42
01
PIN Encryption Type — See section 4.4 Encryption Type for a list of valid values.
B
R
End of Notification Message
0205 = User Interface Operation Complete
84
var
Notification Payload
B
R
/DFDF59
var
Encrypted Data Primitive — Decrypt the value of this TLV data object using the algorithm and variant specified in the Encrypted Data KSN parameter and the Encrypted Data Encryption Type parameter to read its contents. The format of the decrypted data is shown in Table XXX.
B
R
/DFDF56
var
Encrypted Data KSN
B
R
/DFDF57
01
Encrypted Data Encryption Type — See Encryption Type for a list of valid values.
B
R
/F5
var
Container for Encrypted PIN Data
TC
R
//DF71
01
PIN Block Format
0x00 = ISO Format 0
0x01 = ISO Format 1
0x03 = ISO Format 3
0x04 = ISO Format 4
B
R
//99
var
Encrypted PIN Block — ISO Formats 0, 1, and 3 are 8 bytes; ISO Format 4 is 16 bytes
B
R
//DFDF41
var
PIN KSN
B
R
//DFDF42
01
PIN Encryption Type — See Encryption Type for a list of valid values.
B
R
End of Notification Message
T
R
/DF42
var
MSR Track 2 Clear Text Data
B
O
/57
var
Track 2 Equivalent Data
B
O
/5A
var
Primary Account Number
B
O
Padding to force DFDF59 plus padding to be a multiple of 8 bytes