Simplify-Controlled Field Definitions
This appendix describes fields whose definition is controlled by Simplify.
Since Fusebox does not modify these fields (and in some cases, does not receive them), they allow the POS and Simplify to communicate with each other with no concern for how Fusebox might affect the data.
On this page:
Field 11 (User Data)
Structure of field
For added flexibility, this field contains two data areas, a Command Area for non-tokenized data and a Token Area for tokenized data (“TAG Length Data Structure”). These data areas are used as follows:
The Command Area contains subfields required in the request. Some or all of these subfields may be echoed in the response. In Non-Financial Messages, the Command Area in the response may contain a Completion Code indicating the outcome of the request (see under Command Area-Financial Messages for details).
The Token Area is informational. It can be used to inform the POS of error conditions and/or Simplify version data.
- Exception: In the Allow Pre-Tendering (36-40) Message, data is required in both the Command and Token areas of the request.
The generic format of field 11 is as follows:
Subfield Name | Description | Offset | Length |
---|---|---|---|
Command Area | The format of fields in the Command Area depends on the Transaction Type (and Message Type for Transaction Type = 36). The Maximum Length of this area is currently 11 characters. | 0 | VAR |
Field Separator | The character ‘?’ is used to separate the Command Area from the Token Area | VAR | 1 |
Token Area | The Token Area contains Tokenized fields in the format “TLLDDD…” where:
| VAR | VAR |
Command Area
As shown in the following tables, the use of the Command Area can vary by Tran Type and (for Non-Financial Messages) by Message Type. Since the use of this field for Financial Messages is totally distinct from that for Non-Financial Messages, the following discussion will be broken down by these two categories.
Command Area - Financial Messages
The following subfield is used in the Command Area of field 11 for Financial Messages.
Bytes | Subfield Name | Use |
---|---|---|
1-3 | Switch Timeout Value | Defines host timeout value used by Simplify. |
Field 11 Command Area subfields are used in Financial Messages as follows:
- Switch Timeout Value – Three-digit field (right-justified / zero-filled) controls how long (in seconds) Simplify will wait for a response from Fusebox.
note
The length of this timeout value must be shorter than the POS timeout value.
Command Area - Non-Financial Messages
The purpose of a Non-Financial Message (Tran Type 36) is defined by its Message Type (field 11 bytes 1-2). The structure of the Command Area for field 11 on a Non-Financial Message can vary depending on the Message Type (bytes 1-2), but the following subfields are typical:
Bytes | Subfield Name | Use |
---|---|---|
1-2 | Message Type | Defines purpose of message. |
3-5 | Transaction Sequence Number | POS transaction sequence number. |
6-8 | Screen ID | Used in request to define PIN Pad screen to be displayed (may be blank or not used). |
9-11 | Completion Code | Used in response to inform POS of request outcome. |
Variations from the above structure are illustrated in the following table (see below) showing supported Command Area subfields for each defined Message Type. Except where indicated, the Command Area in the response echoes the request.
Tran Type | Message Name | bytes 1-2 (Message Type) | bytes 3-5 | bytes 6-8 | bytes 9-11 |
---|---|---|---|---|---|
36 (all messages) | Signature Request | 01 | Transaction Sequence # (all messages except as noted) | Screen ID | |
Signature Response | 02 | Screen ID | Completion Code | ||
Version Number Inquiry Request/Response ** | 06 | ||||
Load Simplify File via Secure File Transfer Request/Response | 07 | ||||
ELM Encryption Advance DDK Request/Response | 08 | Timeout Value for Advance DDK message to host | |||
ELM Diagnostic Request/Response | 09 | ||||
Scrolling Receipt Request | 10 | ||||
Scrolling Receipt Stop | 11 | ||||
(Reserved for Bridge) ** | 13 | ||||
Informational Prompt Request/Response | 14 | Screen ID (not used) | Timeout/ Completion Code | ||
System Command Request/Response (future use) | 15 | Command | |||
Allow Pre-Tendering Request/Response ** | 40 | Completion Code (only in response) | |||
Status Inquiry | 51 | Status Identifier |
** Note concerning the following Non-Financial Message Types:
Message Type 06 (Version Number Inquiry) – Transaction Sequence Number is followed in the response by variable-length Version and Build Information (preceded by a “?”).
Message Type 13 (SAF Done Message) – Reserved for Bridge. Not used by POS.
Message Type 40 (Allow Pre-Tendering) – Data is also required in the Token Area (Q token).
The values 13, 16-21 for Message Type are reserved.
Subfields
Field 11 Command Area subfields are used in Non-Financial messages as follows:
Message Type – Two-digit field used along with the Tran Type to identify the purpose of the message. Always present for Tran Type = 36.
Transaction Sequence Number – Three-byte field containing POS transaction sequence number. This field is echoed back in the response. Always present for Tran Type = 36.
Screen ID – Three-digit field in Signature Request used to indicate which screen should be displayed when prompting for the customer’s signature. This field is echoed back in Signature Response. (Designed for future use. Currently only ID = 001 is in use.) This field is also present in the Informational Prompt Request/Response, but is not used.
Completion Code – Three-digit field in the Signature, Informational Prompt, Allow Pre-Tendering, or Fast Graphics Download response indicating the outcome of the request.
Completion Code Outcome 000 In Informational Prompt and Allow Pre-Tendering responses: Successful 004 DONE/ACCEPT key pressed with Signature data present 006 ABORT/CANCEL key pressed twice with no detectable signature 008 Signature entry aborted by Simplify 009 Signature entry aborted due to memory being exceeded 010 Memory exhaustion 099 Customer pressed CANCEL after starting to sign. (NA 006 will be sent if cannot detect signature) 100 - Transaction not allowed for device.
- PIN Pad is currently busy.
- For signature capture: Unable to create sigcap object or signature too small two times.
- In Allow Pre-Tendering response: error (e.g. Pre-Tendering not enabled).
112 In Fast Graphics Download response: Download error. 113 In Fast Graphics Download response: File error. 131 In Allow Pre-Tendering Response response: Customer pressed Cancel. 132 In Allow Pre-Tendering Response response: Bad Card Type 133 In Allow Pre-Tendering Response response: Transaction not allowed. 200 EMV card still inserted 998 Invalid format 999 Timed out Version Build Information – Simplify version and build information.
Timeout Value for advance DDK message to host – How long Simplify will wait for a host response to an advance DDK request.
Timeout – Screen timeout in seconds. (000 = No timeout)
Command – System command from POS to Simplify. Currently supported command:
Command Requested Action 001 PIN Pad reboot Status Identifier – Three-digit transaction status code sent from Simplify to POS in Status Messages. A table included in a Simplify parameter file indicates which status identifiers are enabled. The following status identifiers are currently enabled:
Status Identifier PIN Pad Status 001 Processing Please Wait 002 Slide Card 003 Enter PIN 004 Amount OK 005 Enter Tender Type (Debit / Credit) 006 Cash Back 007 Enter Account Number 008 Enter Expiration Date 009 Enter CVV 010 Enter ZIP Code (AVS Data) 011 Cash Back Other 012 – 016 [Reserved] 017 EMV AID list 019 EMV Account Type Selection 021 EMV card has been removed 022 Swiped not allowed, must use chip 023 EMV fallback
Sample Field 11
The following sample of field 11 is for a Signature Response message sent in response to a Signature Request:
0011,02555001004
This value is broken down as follows:
Bytes | Subfield value | Subfield description |
---|---|---|
0-1 | 02 | Message Type (02 = Signature Response) |
3-5 | 555 | Transaction sequence number (echoed from Signature Request message) |
6-8 | 001 | Screen ID (echoed from Signature Request message) |
9-11 | 004 | Completion Code (004 = DONE/ACCEPT key pressed w/ Signature data present) |
Token Area
Defined Tokens for the Token Area are as follows:
Token (Case Sensitive) | Description | Usage | Max Length |
---|---|---|---|
V | Simplify Version | Simplify response to POS | 10 |
S | Identifies the Source Routine of the Error | Simplify error response to POS | 40 |
R | Return code from Source Routing | Simplify error response to POS | 20 |
E | Actual Error if different from ‘R’ | Simplify error response to POS | 20 |
Q | Transaction Type and Tender Type (data is optional) | POS Allow Pre-Tendering request to Simplify, echoed in response | 20 |
With the exception of the Q token, the above tokens are for informational purposes only.
Q token
The Q token must be present in order for Simplify to approve an Allow Pre-Tendering (36-40) request. The format of the Q token is as follows:
QaabbFScccFS, where:
Q = Allow Pre-Tendering token
aa = Length of the following data (including field separators)
bb = Optional Transaction type (01=Auth, 02=Sale, 09=Refund)
FS = Field separator (1 byte)
ccc = Optional Tender type (e.g. 010=Credit, 030=Debit)
FS = Field separator (1 byte)
A sample Allow Pre-Tendering request, showing the Command Area, ‘?’ separator and Token Area for field 11 is as follows:
API Field #, Value | Description |
---|---|
0001,36 | Transaction Type |
0011,40001000000?Q0402FSFS | User Data |
This request is for a Sale (=02) transaction. (Tender Type not specified.)
Field 5001 (Non-Financial Data)
Field 5001 is used in the following types of messages as follows:
- In Non-Financial Messages (Tran Type 36):
- Used in requests and/or responses for most Message Types:
- In request, used to define display or screen operation.
- In response, used to indicate outcome of requested operation. In Informational Prompting Messages (36-14), this field returns customer feedback.
- Details are message-specific. For more information, see the formats and sample messages given under Non-Financial Messages and Informational Prompting.
- Used in requests and/or responses for most Message Types:
Field 5071 (Card/Cardholder Present?)
Field 5071 is used in financial requests from the POS to inform Simplify whether the card and cardholder were present for the transaction. This field is only used by Simplify to help set field 47, and is not sent to Fusebox. If sent in the request, this field will be echoed in the response.
Supported values are:
- 0 - neither present (including all manual entry with cardholder not present)
- 1 - both present
- 2 - only cardholder present
If the value in 5071 is invalid or not present, Simplify will use a default value of 1. However Elavon recommends sending this field in all financial requests, using the value that reflects the actual transaction environment.
Field 5104 (Tip Prompting)
Simplify can be configured to automatically prompt for a Tip amount. The configured Tip setting can be overridden for a transaction by including Field 5104 in the Financial Request. If sent in the request, this field will be echoed in the response.
The format of this field is aa;bb;ccFSd where:
aa, bb and cc are reserved for future use.
d is the Tip prompting flag (0=No, 1=Yes).
The semi-colons (;) and FS (1 byte field separator) are required even if aa, bb and cc are not present.
A sample field value is: 5104,;;FS1