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.

error_outline
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.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.10 3 Fields 1074,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 Fields 1074,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 Field 1074,00;4S;840;C;35.25