Gift Card Messages
Simplify supports Gift Card messages from the POS process. As indicated in the following 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 the Fusebox Integration Guide under Gift and Stored Value Cards for additional sample messages and a complete description of Gift Card message types and fields.
Sample Card Issuance Message
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. |
0013,022519 | Transaction Date (current date) – MMDDYY |
0014,131535 | 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,PLSNTN | Location Name (provided by Elavon) |
8006,TSTLAR | Chain Code (provided by Elavon) |
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:1120106195107475 | Account Token (returned by Fusebox) |
0004,1218 | Expiration Date – MMYY |
0006,001000 | Authorization Code (returned by Fusebox) |
0007,1025 | Transaction ID/Reference Number |
0011,xxx.. | User Data. See Simplify-Controlled Field Definitions. |
0013,022519 | Transaction Date (current date) – MMDDYY |
0014,131535 | 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 |
0109,RETAIL | Terminal ID (provided by Elavon) |
0110,00000301 | Cashier ID |
0112,34 | Fusebox – Processor ID |
0115,050 | Transaction Qualifier (010 = credit; 030 = debit) |
0117,2 | Stored Value Function |
0125,111293621357294 | Retrieval Reference Number (may need to appear on receipt) |
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 |
5001,40000800055597 | Time in seconds till PCI reboot (400 = Tag, 008 = Length of data) |
5002,169018710 | Device Serial Number |
5004,G2 | Encryption Provider ID |
5010,EMVDC0838 | EMV 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. |
7007,1111293621357294 | Transaction Link Identifier. A unique identifier to link transactions |
8002,PLSNTN | Location Name (provided by Elavon) |
8006,TEST | Chain Code (provided by Elavon) |