ELM Encryption Advance DDK Message (Tran Type 36-08)
Simplify supports an ELM Encryption Advance DDK message from the POS process.
The POS system can send Simplify an ELM Encryption Advance DDK request when the POS system wants to cause Simplify to have ELM advance to the next available DDK.
For a guide on when to use this command, please refer to the Verifone document:
Derived Key Merchant Implementation Overview
Care should be taken to ensure that this message is sent only once if responded to. Verifone states that there are 90 Derivation Keys configured in the PIN Pad. If the keys are changed every year, the keys should then last 90 years.
Before sending the ELM advance DDK message, please ensure that the Simplify PIN Pad has already registered with the Verifone VSP server. If the Simplify PIN Pad is able to process financial credit requests using the locator values (fields 109, 8002, 8006), then Advance DDK can be sent as long as the locator values do not change.
If an Advance DDK is sent with different values from those sent in the authorization requests, then the Simplify will register the PIN Pad to the VSP server without advancing to the next DDK.
The response for the Advance DDK will look like an approval message because Simplify will just echo a message sent by FuseBox for the Informational message. Whatever the response, please do not retry the advance DDK message as the PIN Pad has a limited number of DDK’s.
Sample Message
Request
An example of an ELM Encryption Advance DDK Request message (from the POS to Simplify) is:
API Field #, Value | Description |
---|---|
0001,36 | Transaction Type 36. Non-Financial message. |
0007,1025 | Transaction ID/Reference Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions for the use of this field. |
0013,092818 | Transaction Date (current date). MMDDYY |
0014,143034 | Transaction Time (current time). HHMMSS |
0109,TERM1 | Terminal ID (provided by Elavon) |
0110,205 | Operator ID. |
8002,RETL01 | Location Name (provided by Elavon) |
8006,TSTLAR | Chain Code (provided by Elavon) |
Response
An example of an ELM Encryption Advance DDK Response message (from Simplify to the POS) is:
API Field #, Value | Description |
0001,2 | Transaction Type 36. Non-Financial message. |
0002,3.00 | Transaction Amount |
0003,***********0017 | Masked Account data |
0004,0251 | Expiration Date MMYY |
0007,000246 | Transaction ID/Reference Number. |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions for the use of this field. |
0013,092818 | Transaction Date (current date). MMDDYY |
0014,143042 | Transaction Time (current time). HHMMSS |
0017,0.00 | Cash back amount |
0052,5 | Transponder / Proximity Indicator (0 = contact; 2 = contactless; 5 = swiped) |
0054,90 | POS Entry Mode |
0109,TERM1 | Terminal ID (provided by Elavon) |
0110,555555 | Operator ID. |
0115,010 | Transaction Qualifier (010 = credit; 030 = debit) |
0126,2 | Track Indicator (may need to appear on receipt) |
0140,USD | Fusebox – Merchant Currency |
1003,0285 | Gateway Response Code |
1004,VF-ADVANCE DDK SUCCESS | Host Response Message |
1008,***********0017 | Masked Account Number (for printing on receipt) |
1009,909 | Host Response Code |
1010,VERIFONE COMPLETE | Gateway Response Message |
5002,282555552 | Device Serial Number |
5004,V1 | Encryption Provider ID |
7007,1114030712236440 | Transaction Link Identifier (a unique identifier to link transactions) |
8002, RETL01 | Location Name (provided by Elavon) |
8006, TSTLAR | Chain Code (provided by Elavon) |