Gift Card Messages (Tran Types 01, 02, 07, 09, 11, 17, 24)
Simplify supports Gift Card messages from the POS process. As indicated in the table, supported Gift Card messages are identified as follows:
All Gift Card messages send a value of 50 in Field 115 (Transaction Qualifier).
The type of Gift Card transaction is indicated by Field 1 (Tran Type) and Field 117 (Stored Value Function).
Type of Transaction | Field 1 (Tran Type) | Field 115 (Transaction Qualifier) | Field 117 (Stored Value Function) |
---|---|---|---|
Auth Only | 01 | 50 | n/a |
Redemption/Redemption with Cash Back | 02 | 50 | 5 |
Redemption with Cash Out/Cash Out | 02 | 50 | 6 |
Prior Auth / Voice Auth | 07 | 50 | 7 |
Card Activation | 09 | 50 | 1 |
Card Issuance | 09 | 50 | 2 |
Card Reload | 09 | 50 | 3 |
Return | 09 | 50 | 4 |
Void Redemption | 11 | 50 | 5 |
Void Activation | 17 | 50 | 1 |
Void Issuance | 17 | 50 | 2 |
Void Reload | 17 | 50 | 3 |
Void Return | 17 | 50 | 4 |
Balance Inquiry | 24 | 50 | n/a |
A sample Card Issuance request/response is shown below. Please refer to Gift and Stored Value Cards in the Fusebox Integration Guide for additional sample messages and a complete description of Gift Card message types and fields.
Sample Card Issuance Request
An example of a Card Issuance Request message (from the POS to Simplify) is:
API Field #, Value | Description |
---|---|
0001,09 | Transaction Type of 9, in combination with Field 115 of 050 and Field 117 of 2, indicates a Gift Card Issuance |
0002,50.00 | Dollar amount to be authorized |
0007,1025 | Transaction ID / Reference Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions for the use of this field for this field |
0013,092818 | Transaction Date (current date) – MMDDYY |
0014,131605 | Transaction Time (current time) – HHMMSS |
0109,RETAIL | Terminal ID (provided by Elavon) |
0110,00000301 | Cashier ID |
0115,050 | Transaction Qualifier (050 = Gift / Stored Value) |
0117,2 | Stored Value Function. A Value of 2 indicates a Card Issuance |
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. |
8002,RETL01 | Location Name (provided by Elavon) |
8006,TEST | Chain Code (provided by Elavon) |
Sample Card Issuance Response
An example of a Card Issuance Response message (from Simplify to the POS) is:
API Field #, Value | Description |
---|---|
0001,09 | Transaction Type |
0002,000050.00 | Transaction Amount |
0003,ID:1113183303629317 | Account Token (returned by Fusebox) |
0004,1218 | Expiration Date – MMYY |
0006,001000 | Authorization Code (returned by Fusebox) |
0007,1025 | Transaction ID / Reference Number |
0009,1784 | Fusebox – Host Batch Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions for the use of this field |
0013,092818 | Transaction Date (current date) – MMDDYY |
0014,131611 | Transaction Time (current time) – HHMMSS |
0043,500586 | System Trace Audit Number |
0052,5 | Transponder / Proximity Indicator (0 = contact; 2 = contactless; 5 = swiped) |
0054,01 | POS Entry Mode |
00109,RETAIL | Terminal ID |
0110,00000301 | Cashier ID |
0112,34 | Fusebox – Processor ID |
0115,050 | Transaction Qualifier (050 = Gift / Stored Value) |
0117,2 | Stored Value Function. |
0126,0 | Track Indicator (may need to appear on receipt) |
0140,USD | Merchant Currency |
1000,SV | Card Type |
1001,SVS | Card Name |
1003,0000 | Gateway Response Code |
1004,01 – APPROVAL | Host Response Message |
1005,061286 | Merchant Number |
1008,600649*********1083 | Masked Account Number (for printing on receipt) |
1009,01 | Host Response Code |
1010,COMPLETE | Gateway Response Message |
1012,1784 | Gateway Batch Number |
5002,169018710 | Device Serial Number |
5004,V1 | Encryption Provider ID |
5010,L27.0.2 | EMV Kernel Version |
5071,xxx… | Defines whether card and cardholder are present. See Simplify-Controlled Field Definitions. |
7007,1111293621357294 | Transaction Link Identifier (a unique identifier to link transactions) |
8002,PLSNTN | Location Name |
8006,TEST | Chain Code |