Sale Message (Tran Type 02)

Simplify supports a Sale message from the POS process.

For more information, see the Fusebox Integration Guide under Sale Transaction (02).

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 Simplify-Controlled Field Definitions.
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 Simplify-Controlled Field Definitions.
5104,xxx..Tip Settings. See Simplify-Controlled Field Definitions.
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 Simplify-Controlled Field Definitions.
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; 025 = Private Label; 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, [see value below]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
1021,N;N;N;N;Y;Transaction permission flags received from Fusebox:
  • 1,2, 3 – reserved
  • 4 – PINless Debit
  • 5 – Surcharge
1200,0000AAIssuer Network Information
1339,00EMV Response Code
1359,4EMV CVM Indicator
4747,040311Third Party Interface POS Data Code
5001,30101151010800;1640000800072727
  • 30101151010800;16 – first 8 digits of PAN and PAN length, if enabled. (301 = Tag, 011 = Length of data, 51010800 = First 8 digits of PAN, ; = Delimiter, 16 = PAN length)
  • 40000800055597 - Time in seconds till PCI reboot (400 = Tag, 008 = Length of data)
5002,80649419Device Serial Number
5004,OGEncryption Provider ID
5010,EMVDC0838EMV kernel version
5070,xxx..Simplify Information. See Simplify-Controlled Field Definitions.
5071,xxx..Defines whether card and cardholder are present. See Simplify-Controlled Field Definitions.
5104,xxx..Tip Settings. See Simplify-Controlled Field Definitions.
7007,1118074642168320Transaction Link Identifier (unique identifier to link transactions)
8002,ONGUARDLocation Name (provided by Elavon)
8006,TSTLA3Chain Code (provided by Elavon)

0651,00103@;010011759603151751260000047170500000000000419041807417117596

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 Field 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

Request

See especially API 0003, 5111.

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 Simplify-Controlled Field Definitions.
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

See especially API 0003, 1010, 5001.

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 Simplify-Controlled Field Definitions.
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-Generated Response Message
5001,300014042A18C25B6285Mifare UID
(300 = Tag, 014 = Length of data)
5002,07208937Device Serial Number
5010,EMVDC0901EMV kernel version
8002,SIMTESTLocation Name
8006,TSTLA3Chain Code

Airline Vouchers

Simplify supports airline QR vouchers as tender on camera-equipped PIN Pads. Supported Tran Types depend on the provider of the QR code. The use of QR vouchers can be enabled globally under configuration or for individual transactions by sending a “V” or “v” in API 0003. (Ignored if not camera-equipped.)

If QR voucher support is configured globally or enabled for an individual transaction, a voucher button will appear on the payment screen. Pressing this virtual button enables the camera and displays the camera (barcode) viewer used to scan the QR voucher code. If the customer scans the code, the PIN Pad will capture and read the code and send the payment data (embedded PAN and expiration date) to Fusebox in API 0003.

Simplify will set API 0647 (Partial Auth) to “1” in the Fusebox request message for all airline voucher transactions.