HSA Card API Fields
The following table describes the API field formats for 1074 to 1083.
| Field | Name | Length Type | Description |
|---|---|---|---|
| 1074 | Request Account 1 Details | 0 - 255 alphanumeric | Request Tableized Data - Semi-colon, “;”, delimited field used to hold account balance information returned by TPP. Data returned may differ by TPP. Currently specified to be: Account Type Length 2 Field Type N (00 – Not specified) Amount Type Length 2 Field Type N 4S = Medical 4U = RX 4V = Vision/Optical 4W = Clinic/Other Med 4X = Dental 4T = Transit 40 = Cash 02 = Deposit Accounts/Credit Card Accounts/Spending Power Accounts 57 = Not Specified Currency Type Length = 3 Field Type N Sign Amount Field Length = 1 Field Type AN Balance Amount Field Length = 12 Field Type Numeric (N) (will include decimal) |
| 1075 | Request Account 2 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1076 | Request Account 3 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1077 | Request Account 4 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1078 | Request Account 5 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1079 | Request Account 6 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1080 | Request Account 7 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1081 | Request Account 8 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1082 | Request Account 9 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
| 1083 | Request Account 10 Details | 0 - 255 alphanumeric | See Options/Description Field 1074 |
Transit Expenses
Transit amount type would be for an ambulance or medical transit to a hospital, medical facility or doctor’s office.
note
This type of expense will never be on the same transaction as other medical expenses and will be a stand-alone entry utilizing only API Field 1074.
| Transit Scenarios | Field(s) | Example |
|---|---|---|
| Ambulance or Medical | Transit Expense | 1 Field 1074,00;4T;840;C;100.00 |
Medical Expenses
Medical expenses are handled as a combination with a rolled up amount of general medical expenses. This is handled by a total for medical expenses in API Field 1074 followed by fields with the subtotal amounts.
Note that if there is a medical expense that does not fit one of the categories identified, the sub-amount in API Field 1074 may be greater than the total of all of the defined entries.
| Medical Scenarios | Field(s) | Example |
|---|---|---|
| Visit pharmacy and purchase 1 or more prescriptions. Total was $49.95 for total of all prescriptions | 2 Fields | 1074,00;4S;840;C;49.951075,00;4U;840;C;49.95 |
| Visit to pharmacy with visit to clinic for $50.00 charge and prescription charge for $37.10 with a total $87.10 | 3 Fields | 1074,00;4S;840;C;87.101075,00;4U;840;C;37.101076,00;4W;840;C;50.00 |
| Visit to pharmacy with charge for a medical expense not mapped to one of the valid values for $20.00 and have a prescription charge for $37.10 for a total of $57.10. | 2 Fields | 1074,00;4S;840;C;57.101075,00;4U;840;C;37.10 |
| Visit to pharmacy/medical facility with a generic expense that does not map to one of the valid values for a total of $35.25. | 1 Field | 1074,00;4S;840;C;35.25 |