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.
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 Description | Use for EBT tenders |
---|---|---|
0001 | Transaction Type | Supported Transaction Types:
|
0017 | Cash Back Amount | Supported for EBT Cash Sale only. |
0115 | Transaction Qualifier |
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 |
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. See especially API 0115, 0119, 1085.
API Field #, Value | Description |
---|---|
0001,02 | Transaction Type |
0002,1.00 | Dollar amount to be authorized |
0007,14 | Transaction ID / Reference Number. |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
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 shown below. See especially API 0115, 0119, 1061, 1062, 1063, 1085.
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,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
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 |
5001,40000800055597 | Time in seconds till PCI reboot (400 = Tag, 008 = Length of data) |
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,xxx.. | Simplify Information. See Simplify-Controlled Field Definitions. |
7007,1110055771301925 | Transaction Link Identifier (unique identifier to link transactions) |
8002,TETRAPR | Location Name |
8006,AGILYS | Chain Code |