Sale Message (Tran Type 02)

Simplify supports a Sale message from the POS process.

Sample Message

Request

The following table shows an example of a Sale Request message (from the POS to Simplify).

API Field #, ValueDescription
0001,02Transaction Type
0002,1.00Transaction Amount
0007,55Transaction ID / Reference Number
0011,xxx..User Data. See Field 11 (User Data).
0013,022519Transaction Date (current date)– MMDDYY
0014,105007Transaction Time (current time) – HHMMSS
0017,0.00Cash Back Amount
0109,Term02Terminal ID (provided by Elavon)
0110,205Cashier ID
0201,0.00Tip Amount
1008,ID:Set to ‘ID:’ to request that an account Token be returned by Fusebox
5071,xxx…Defines whether card and cardholder are present. See Field 5071 (Card/Cardholder Present?).
5104,xxx…Tip Settings. See Field 5104 (Tip Prompting).
8002,ONGUARDLocation Name (provided by Elavon)
8006,TSTLA3Chain Code (provided by Elavon)

Response

The table below is an example of a Sale Response message (from Simplify to the POS).

API Field #, ValueDescription
0001,02Transaction Type
0002,1.00Transaction Amount
0003,ID:4476082153699999Account Token (returned by Fusebox)
0004,0119Expiration Date (MMYY)
0006,419039Authorization Code (returned by Fusebox)
0007,55Transaction ID / Reference Number
0009,001Fusebox – Host Batch number
0011,xxx..User Data. See Field 11 (User Data).
0013,022519Transaction Date (current date) – MMDDYY
0014,105007Transaction Time (current time) – HHMMSS
0017,0.00Cash Back Amount
0030,1Fusebox – Online Indicator
0032,022519Fusebox – Authorization Transaction Date
0033,135016Fusebox – Authorization Transaction Time
0035,5245Validation Code
0036,018031513501628Host Transaction Identifier
0037,0Fusebox - Authorizer
0043,117595System Trace Audit Number
0047,M;1;1;1;0;1;2;5;4;1;3;C;0;4POS Data Code
0052,5Transponder / Proximity Indicator (0 = contact; 2 = contactless; 5 = swiped)
0054,90POS Entry Mode
0062,154Service Code
0109,TERM02Terminal ID (provided by Elavon)
0110,205Cashier ID
0112,400Fusebox – Processor ID
0115,010Transaction Qualifier (010 = credit; 030 = debit; 040 = EBT; 050 = Gift Card; 085 = Cash Tender)
0125,315175016Retrieval Reference Number (may need to appear on receipt)
0126,2Track Indicator (may need to appear on receipt)
0129,0Fusebox – Compliance Data
0130,1.00Authorized Amount
0140,USDMerchant Currency
0201,0.00Tip Amount
0651,00003@;010011759503151
750160000047170500000000000
419039807417117595
Reversal data (for reversal, if needed)
0738,106781MMCC539137 Y 0225Recurring Compliance Data
1000,VICard Type
1001,VISACard Name
1002,CERTIFICATION-VISA/ELAVONCardholder Name
1003,0000Gateway Response Code
1004,APPROVALHost Response Message
1005,0010600008014593613999Merchant Number
1008,************9999Masked Account Number (for printing on receipt)
1009,AAHost Response Code
1010,COMPLETEGateway Response Message
1012,0039Gateway Batch Number
1200,0000AAIssuer Network Information
1339,00EMV Response Code
1359,4EMV CVM Indicator
4747,040311Third Party Interface POS Data Code
5002,80649419Device Serial Number
5004,OGEncryption Provider ID
5010,EMVDC0838EMV kernel version
5070,Merchant: Demo;Simplify: V-OG-2.02.02124;PARM: 2.21.1;TENDERDEF: 2.21.1;EMVPARM: EMVPARM-E4-1Simplify Information. See Field 5070 (Simplify Load Information).
5071,xxx…Defines whether card and cardholder are present. See Field 5071 (Card/Cardholder Present?).
5104,xxx…Tip Settings. See Field 5104 (Tip Prompting).
7007,1118074642168320Transaction Link Identifier (unique identifier to link transactions)
8002,ONGUARDLocation Name (provided by Elavon)
8006,TSTLA3Chain Code (provided by Elavon)

Mifare Tap

The POS can activate Mifare tap by sending a request to Simplify with “M” or “m” in API 0003. For a valid tap, Simplify will extract the UID, and return it to the POS in the response as token 300 in API 5001 (no Fusebox message). If API 5111 is present in the request, Simplify will display the text from this field instead of a configured message.

Sample Message Exchange

Request

API Field #, ValueDescription
0001,02Transaction Type
0002,1.00Transaction Amount
0003,M“M” requests Simplify activate Mifare tap
0007,368Transaction ID / Reference Number
0011,xxx..User Data. See Field 11 (User Data).
0013,030920Transaction Date (current date) – MMDDYY
0014,095300Transaction Time (current time) – HHMMSS
0017,0.00Cash Back Amount
0109,RETERM1Terminal ID (provided by Elavon)
0110,205Cashier ID
0115,010Transaction Qualifier (010 = credit)
0201,0.00Tip Amount
1008,ID:Set to ‘ID:’ to request that an account Token be returned by Fusebox
5111,Please Tap $25 MiFare CardText to display while waiting for Mifare tap (if present, overrides default)
8002,ONGUARDLocation Name (provided by Elavon)
8006,TSTLA3Chain Code (provided by Elavon)

Response

API Field #, ValueDescription
0001,02Transaction Type
0002,1.00Transaction Amount
0003,mMifare tap indicator (echoed from request)
0007,367Transaction ID / Reference Number
0011,xxx…User Data. See Field 11 (User Data).
0013,030920Transaction Date (current date) –
0014,102821Transaction Time (current time) – HHMMSS
0017,0.00Cash Back Amount
0109,RETERM1Terminal ID
0110, 205Cashier ID
0115,010Transaction Qualifier (010 = credit)
0201,0.00Tip Amount
1003,0000Gateway Response Code
1004,-99Host Response Message
1008,ID:Masked Account Number (for printing on receipt)
1009,-99Host Response Code
1010,*SLR MIFARE.Simplify Response Message
5001,300014042A18C25B6285Mifare UID (sent as token 300)
5002,07208937Device Serial Number
5010,EMVDC0901EMV kernel version
8002,SIMTESTLocation Name
8006,TSTLA3Chain Code