HSA Card API Fields

The following table describes the API field formats for 1074 to 1083.

FieldNameLength
Type
Description
1074Request Account 1 Details0 - 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)
1075Request Account 2 Details0 - 255
alphanumeric
See Options/Description Field 1074
1076Request Account 3 Details0 - 255
alphanumeric
See Options/Description Field 1074
1077Request Account 4 Details0 - 255
alphanumeric
See Options/Description Field 1074
1078Request Account 5 Details0 - 255
alphanumeric
See Options/Description Field 1074
1079Request Account 6 Details0 - 255
alphanumeric
See Options/Description Field 1074
1080Request Account 7 Details0 - 255
alphanumeric
See Options/Description Field 1074
1081Request Account 8 Details0 - 255
alphanumeric
See Options/Description Field 1074
1082Request Account 9 Details0 - 255
alphanumeric
See Options/Description Field 1074
1083Request Account 10 Details0 - 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 ScenariosField(s)Example
Ambulance or MedicalTransit Expense1 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 ScenariosField(s)Example
Visit pharmacy and purchase 1 or more prescriptions. Total was $49.95 for total of all prescriptions2 Fields1074,00;4S;840;C;49.95
1075,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.103 Fields1074,00;4S;840;C;87.10
1075,00;4U;840;C;37.10
1076,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 Fields1074,00;4S;840;C;57.10
1075,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 Field1074,00;4S;840;C;35.25