Skip to main content

HsaContributionType

Transaction categorization for INCOMING transactions

enum HsaContributionType {
  BANK_ERROR
  CORRECTION
  HSA_T2T_TRANSFER
  HSA_TRANSFER
  NEW_DEPOSIT
  QUALIFIED_HSA_FUNDING_DISTRIBUTION
}

Values​

HsaContributionType.BANK_ERROR​

This code indicates that the transaction was basically a bank error that was corrected. For the purposes of summing transactions to get contribution totals it should just be ignored. Note only the bank or an administrator can designate a specific transaction as being a bank error, an end-user can't.

HsaContributionType.CORRECTION​

A deposit to correct for a previous unintended or unqualified withdrawal.

HsaContributionType.HSA_T2T_TRANSFER​

A trustee-to-trustee transfer, the check must be mailed directly to the bank, NOT limited to 1 per year. Note only the bank or an administrator can designate a specific transaction as being a trustee-to-trustee transfer, an end-user can't.

HsaContributionType.HSA_TRANSFER​

Note this value really signifies an HSA Rollover. A user is limited to 1 rollover per year.

HsaContributionType.NEW_DEPOSIT​

A new HSA contribution, to be counted against the users contribution maximum

HsaContributionType.QUALIFIED_HSA_FUNDING_DISTRIBUTION​

A "qualified HSA funding distribution" is a unique form of a trustee-to-trustee transfer, where the user distributes an amount of funds from a qualified IRA of theirs into the HSA. The distribution is more or less treated like a contribution and counts against the contribution limit for a user in a given tax year. Despite acting like a contribution in many ways, it is a unique transaction type with unique reporting and handling rules. We don't encode most of the rules programmatically, since this is a rare transaction type controlled by trustee's, and administrators are capable of updating these as required.

Of particular note, a user is limited to "one" of these transactions in their lifetime, except in rare circumstances where they can have "two" in a single year (and no more for life). These transactions have specific tax reporting requirements: they must be included in the tax year contributions for the 1099-SA, but in the 8889, it must be excluded from the tax year contributions and reported on its own.

Member of​

AccountTransactionNode object ● AchTransfer object ● CreateOrUpdateUserEnteredDataForTransactionInput input ● CreateOrUpdateUserEnteredDataForTransactionPayload object ● InitiateAchTransferInput input ● PendingAchTransaction object ● RemoteDepositCapture object ● SubmitRemoteDepositCaptureInput input ● UpdateUserEnteredDataForRemoteDepositCaptureInput input ● UpdateUserEnteredDataForRemoteDepositCapturePayload object ● UpdateUserEnteredDataForTransferInput input ● UpdateUserEnteredDataForTransferPayload object