EBT Messages (Tran Types 02, 09, 11, 17, 24)

Simplify supports EBT Food Stamp and EBT Cash tenders (swiped only).

As described below, for online EBT transactions, tender types can be sent from the POS process or selected on the PIN Pad.

Online EBT

The following table describes requirements for selected fields used in processing online EBT tenders:

API Field # Field Description Use for EBT tenders
0001 Transaction Type Supported Transaction Types:

02 – Sale

09 – Refund

11 – Void Transaction

17 – Void Return

24 – Balance Inquiry

0017 Cash Back Amount Supported for EBT Cash Sale only.
0115 Transaction Qualifier 040 – EBT

This value can be sent in the POS request.

If this field is not sent and EBT is enabled, a tender selection screen including EBT will be displayed on the PIN Pad.

0119 EBT Qualifier 10 – EBT Food Stamp

40 – EBT Cash

This value can be sent in the POS request.

If this field is not sent and EBT is sent from the POS or selected on the PIN Pad, an EBT type selection screen will be displayed on the PIN Pad.

1085 Eligible EBT Food Stamp Amount This field is required from the POS for an EBT Food Stamp tender. The value must be less than or equal to the total transaction amount sent in API 0002.

The amount of an EBT Food Stamp tender must be less than or equal to the value in API 1085.

EBT Food Stamp Vouchers

Simplify supports vouchers (if enabled) for EBT Food Stamp only. Vouchers are subject to the above rules for EBT, and the usual rules for Stand-In and Store and Forward processing, with the following exceptions:

API Field # Field Description Use for EBT Food Stamp vouchers
0001 Transaction Type Must be set to 07 in request.
0006 Voice Authorization Required in request (from original transaction).
0115 Transaction Qualifier Must be set to 040 in request.
0119 EBT Qualifier Must be set to 10 in request.
1060 Voucher Number Required in request (from original transaction).

Sample EBT Food Stamp Sale Message

Request

An example of a possible Sale Request for EBT Food Stamp (from the POS to Simplify) is shown below. Fields and values pertaining to EBT are shown in bold.

API Field #, Value Description
0001,02 Transaction Type
0002,1.00 Dollar amount to be authorized
0007,14 Transaction ID / Reference Number.
0011,35 User Data. See Field 11 (User Data) .
0013,022420 Transaction Date (current date) – MMDDYY
0014,132507 Transaction Time (current time) – HHMMSS
0017,0.00 Cash Back Amount
0109,PRRTL01 Terminal ID (provided by Elavon)
0110,205 Cashier ID
0115,040 Transaction Qualifier (040 = EBT)
0119,010 EBT Qualifier (10 = EBT Food Stamp; 40 = EBT Cash)
0201,0.00 Tip Amount
1085,1.00 EBT Food Stamp Amount
8002,TETRAPR Location Name (provided by Elavon)
8006,AGILYS Chain Code (provided by Elavon)

Response

An example of a possible Sale Response for EBT Food Stamp (from Simplify to the POS) is:

API Field #, Value Description
0001,02 Transaction Type
0002,1.00 Transaction Amount
0003,****5179 Account Token (returned by Fusebox )
0004,1224 Expiration Date (MMYY)
0006,777524 Authorization Code (returned by Fusebox)
0007,14 Transaction ID / Reference Number
0009,001 Fusebox – Host Batch Number
0011,35?V15N-OG-2.02B02707 User Data. See Field 11 (User Data) .
0013,022420 Transaction Date (current date) – MMDDYY
0014,132507 Transaction Time (current time) – HHMMSS
0017,0.00 Cash Back Amount
0018,**** PIN Block
0019,T Key Serial Number
0021,AT Network ID
0023,02 Debit Account Type
0030,1 Fusebox – Online Indicator
0032,022420 Fusebox – Authorization Transaction Date
0033,162530 Fusebox – Authorization Transaction Time
0035,0000 Validation Code
0036,59130 Host Transaction Identifier
0037,Y Fusebox - Authorizer
0043,777524 System Trace Audit Number
0047,M;1;1;1;0;1;2;1;3;1;3;C;0;4 POS Data Code
0052,5 Transponder / Proximity Indicator (0 = contact; 2 = contactless; 5 = swiped)
0054,90 POS Entry Mode
0109,PRRTL01 Terminal ID
0110,205 Cashier ID
0112,400 Fusebox – Processor ID
0115,040 Transaction Qualifier (040 = EBT)
0119,010 EBT Qualifier (10 = EBT Food Stamp)
0125,224212530 Retrieval Reference Number (may need to appear on receipt)
0126,2 Track Indicator (may need to appear on receipt)
0127,0 Processor – Compliance Data
0129,0 Fusebox – Compliance Data
0130,1.00 Authorized Amount
0140,USD Merchant Currency
0163,en Cardholder Language Preference
0180,EG Control Prefix (EG = Elavon)
0183,1KMUG2J3LB Control Number (assigned to transaction)
0201,0.00 Tip Amount
0651,12003A Reversal data (for reversal, if needed)
1000,EB Card Type
1001,EBT Card Name
1003,0000 Gateway Response Code
1004,APPROVAL Host Response Message
1005,0019260008025050074410 Merchant Number
1008,XXXXXXXXXXXX5179 Masked Account Number (for printing on receipt)
1009,AA Host Response Code
1010,COMPLETE Gateway Response Message
1012,0016 Gateway Batch Number
1061,02 Number of Balances Returned
1062,98;02;840;C;000000020000 EBT Food Stamp Balance
1063,96;02;840;C;000000030000 EBT Cash Balance
1085,1.00 EBT Food Stamp Amount
1200,0000AA Issuer Network Information
1339,00 EMV Response Code
4747,050312 Third Party Interface POS Data Code
5002,07225281 Device Serial Number
5004,OG Encryption Provider ID (OG = On-Guard)
5006,FFFF4D4D4D0000200009050006 Terminal KSN (only used for On-Guard)
5007,N PCI P2PE-validated solution indicator (N = non-validated)
5010,EMVDC0901 EMV kernel version
5070,Merchant: Demo;Simplify: N-OG-2.02.02707;PARM: 2.27.1;TENDERDEF: 2.27.1;EMVPARM: EMVPARM-E4-2-nocert;TMS: 88802022;Package: 2.27.1 Simplify Information. See Appendix F.
7007,1110055771301925 Transaction Link Identifier (unique identifier to link transactions)
8002,TETRAPR Location Name
8006,AGILYS Chain Code