Auto-Substantiation

An Auto-Substantiation transaction is applied to either a CreditAuth or to a CreditSale transaction. The first additional amount must be the "Total_Healthcare_Amt" followed by up to three additional optional data amount elements, which include the amount type and the amount. Valid amount types are as follows:

Total_Healthcare_Amt—Indicates the total of all healthcare amounts.
Subtotal_Prescription_Amt—Indicates the subtotal amount of prescriptions.
Subtotal_Vision_Optical_Amt—Indicates the subtotal amount of vision/optical.
Subtotal_Clinic_Or_Other_Amt—Indicates the subtotal amount of clinic and other qualified medical.
Subtotal_Dental_Amt—Indicates the subtotal amount of dental.

The value supplied in the Total_Healthcare_Amt is the combined total of the four subtotal amounts. The Total_Healthcare_Amt can include over-the-counter (OTC) amounts only or, if there are other healthcare expenses, the total of all categories: OTC, prescriptions, vision, clinic, and dental.

The total amount of the associated transaction must be at least equal to (not less than) the Total_Healthcare_Amt. It can be greater than the Total_Healthcare_Amt if non-healthcare items are also being purchased as part of the transaction.

The Auto-Substantiation data also includes a field containing the Merchant Verification Value. It is not necessary to submit this field. It is populated from the merchant profile by Heartland for merchants processing on the Exchange Authorization Platform.

Merchants using an Inventory System (IIAS) to flag HSA-eligible items are required maintain the BIN files within the Point of Sale to identify HSA cards. An HSA card may only be used to purchase eligible items.

It is the merchant's responsibility to maintain their IIAS software with up-to-date healthcare BIN file definitions. Work with your software provider as needed to ensure the files are up to date.

See the AutoSubstantiation Complex Type in the Portico Schema. Applicable to US merchants only.