EBT Messages

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.

For more information, see the Fusebox Integration Guide under EBT Transactions.

Online EBT

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

API Field #Field DescriptionUse for EBT tenders
0001Transaction TypeSupported Transaction Types:
  • 02 – Sale
  • 09 – Refund
  • 11 – Void Sale
  • 17 – Void Return
  • 24 – Balance Inquiry
0017Cash Back AmountSupported for EBT Cash Sale only.
0115Transaction 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.
0119EBT 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.
1085Eligible EBT Food Stamp AmountThis 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 DescriptionUse for EBT Food Stamp vouchers
0001Transaction TypeMust be set to 07 in request.
0006Voice AuthorizationRequired in request (from original transaction).
0115Transaction QualifierMust be set to 040 in request.
0119EBT QualifierMust be set to 10 in request.
1060Voucher NumberRequired 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. See especially API 0115, 0119, 1085.

API Field #, ValueDescription
0001,02Transaction Type
0002,1.00Dollar amount to be authorized
0007,14Transaction ID / Reference Number.
0011,xxx..User Data. See Simplify-Controlled Field Definitions.
0013,022420Transaction Date (current date) – MMDDYY
0014,132507Transaction Time (current time) – HHMMSS
0017,0.00Cash Back Amount
0109,PRRTL01Terminal ID (provided by Elavon)
0110,205Cashier ID
0115,040Transaction Qualifier (040 = EBT)
0119,010EBT Qualifier (10 = EBT Food Stamp; 40 = EBT Cash)
0201,0.00Tip Amount
1085,1.00EBT Food Stamp Amount
8002,TETRAPRLocation Name (provided by Elavon)
8006,AGILYSChain Code (provided by Elavon)

Response

An example of a possible Sale Response for EBT Food Stamp (from Simplify to the POS) is shown below. See especially API 0115, 0119, 1061, 1062, 1063, 1085.

API Field #, ValueDescription
0001,02Transaction Type
0002,1.00Transaction Amount
0003,************5179Account Token (returned by Fusebox )
0004,1224Expiration Date (MMYY)
0006,777524Authorization Code (returned by Fusebox)
0007,14Transaction ID / Reference Number
0009,001Fusebox – Host Batch Number
0011,xxx..User Data. See Simplify-Controlled Field Definitions.
0013,022420Transaction Date (current date) – MMDDYY
0014,132507Transaction Time (current time) – HHMMSS
0017,0.00Cash Back Amount
0018,****************PIN Block
0019,T KeySerial Number
0021,ATNetwork ID
0023,02Debit Account Type
0030,1Fusebox – Online Indicator
0032,022420Fusebox – Authorization Transaction Date
0033,162530Fusebox – Authorization Transaction Time
0035,0000Validation Code
0036,59130Host Transaction Identifier
0037,YFusebox - Authorizer
0043,777524System Trace Audit Number
0047,M;1;1;1;0;1;2;1;3;1;3;C;0;4POS Data Code
0052,5Transponder / Proximity Indicator (0 = contact; 2 = contactless; 5 = swiped)
0054,90POS Entry Mode
0109,PRRTL01Terminal ID
0110,205Cashier ID
0112,400Fusebox – Processor ID
0115,040Transaction Qualifier (040 = EBT)
0119,010EBT Qualifier (10 = EBT Food Stamp)
0125,224212530Retrieval Reference Number (may need to appear on receipt)
0126,2Track Indicator (may need to appear on receipt)
0127,0Processor – Compliance Data
0129,0Fusebox – Compliance Data
0130,1.00Authorized Amount
0140,USDMerchant Currency
0163,enCardholder Language Preference
0180,EGControl Prefix (EG = Elavon)
0183,1KMUG2J3LBControl Number (assigned to transaction)
0201,0.00Tip Amount
0651,12003AReversal data (for reversal, if needed)
1000,EBCard Type
1001,EBTCard Name
1003,0000Gateway Response Code
1004,APPROVALHost Response Message
1005,0019260008025050074410Merchant Number
1008,XXXXXXXXXXXX5179Masked Account Number (for printing on receipt)
1009,AAHost Response Code
1010,COMPLETEGateway Response Message
1012,0016Gateway Batch Number
1061,02Number of Balances Returned
1062,98;02;840;C;000000020000EBT Food Stamp Balance
1063,96;02;840;C;000000030000EBT Cash Balance
1085,1.00EBT Food Stamp Amount
1200,0000AAIssuer Network Information
1339,00EMV Response Code
4747,050312Third Party Interface POS Data Code
5001,40000800055597Time in seconds till PCI reboot
(400 = Tag, 008 = Length of data)
5002,07225281Device Serial Number
5004,OGEncryption Provider ID (OG = On-Guard)
5006,FFFF4D4D4D0000200009050006Terminal KSN (only used for On-Guard)
5007,NPCI P2PE-validated solution indicator (N = non-validated)
5010,EMVDC0901EMV kernel version
5070,xxx..Simplify Information. See Simplify-Controlled Field Definitions.
7007,1110055771301925Transaction Link Identifier (unique identifier to link transactions)
8002,TETRAPRLocation Name
8006,AGILYSChain Code