Funding

HSAs are primarily funded by payroll contributions and deductions. Partners are either directly integrated with an organization's payroll system, or rely on First Dollar to integrate with an organization's payroll system.

Partner payroll integration

When the partner is the one integrated with payroll, they will call the fundBenefitForIndividual API. This process will fund an account for the specified amount and reflect this activity on the account’s ledger.

mutation FundBenefitForIndividual($input: FundBenefitForIndividualInput!) {
    fundBenefitForIndividual(input: $input) {
        ... on FundBenefitForIndividualResult {
            benefitId
            individualId
            transactionId
        }
        ... on BadRequestError {
            message
            code
            retryable
        }
        ... on InternalServerError {
            message
            code
            retryable
        }
    }
}

Funds are immediately available to Cards and for Manual Claims after this API request completes successfully.

A settlement process will occur to settle the debt incurred by a successful funding request. The details of the settlement process are configurable and depend on parameters defined by the partner.

First Dollar payroll integration

Alternatively, when First Dollar is in the role of integrating with employer payroll, employers will use First Dollar's Health Wallet Manager application to link their payroll provider and link their business bank account. First Dollar will automatically pull all HSA contributions directly from the employer and disburse them into individual's accounts.

Reversing a funding

Reversing an HSA funding through the Partner API is not yet supported. Calling reverseBenefitFundingForIndividual against an HSA Benefit returns a BadRequestError. Contact [email protected] if you need to reverse an HSA funding before this is generally available. The request shape will not change when HSA reversal ships. Reversal is supported today for HRA, FSA, DSA, and LSA Benefits; see Reversing a funding for the recipe.

Individually directed HSA contributions

Outside of regularly scheduled payroll contributions, individuals can also initiate HSA contributions directly from their personal bank accounts. First Dollar currently only enables this through the Health Wallet web application, which partners can set up an SSO linkage to. Depending on a partner's use case, First Dollar can expose APIs for this as needed, or partners can use First Dollar's deposit widget. See Next Steps for more information.