Skip to content

HSA / FSA Cards

Learn how to accept Health Savings Account (HSA) or Flexible Spending Account (FSA) cards at Finix and which merchant category codes (MCCs) are eligible.

To accept HSA and FSA cards, a special Merchant Category Code (MCCs) must be granted first. These healthcare-related MCCs let card networks know your products and services are directly related to the medical needs of patients.

Accepting HSA or FSA payments does not ensure cards will get processed successfully. Like other transactions, card issuers ultimately decide to authorize or decline a payment.

HSA/FSA Transaction Restrictions

Only medical service providers can process transactions made with HSA and FSA cards without Special Interest Group for IIAS Standards (SIGIS) registration and Information Approval System (IIAS) certification.

If you have any questions regarding eligibility, please reach out to your Finix point of contact or email Finix Support.

Eligible Merchant Category Codes

Merchant Category Code (MCC)Description
4119Ambulance Services (Dependent on Plan Administrator)
5047Medical, Dental, Ophthalmic, and Hospital Equipment and Supplies
5975Hearing Aids - Sales, Service, Supply Stores
7277Counseling Service - Debt, Marriage, and Personal (Dependent on Plan Administrator)
8011Doctors and Physicians (not elsewhere classified)
8021Dentists, Orthodontists
8031Osteopaths
8041Chiropractors
8042Optometrists, Ophthalmologists
8043Opticians, Optical Goods, and Eyeglasses
8049Podiatrists and Chiropodists
8050Nursing and Personal Care Facilities
8062Hospitals
8071Medical and Dental Laboratories
8099Health Practitioners, Medical Services (not elsewhere classified)

Making a Payment with HSA or FSA Cards

For a Merchant with a healthcare MCC that is outlined above, there are no additional required fields for the Authorization or Transfer request. Alternatively, for a non-healthcare MCC that has the appropriate SIGIS registration and IIAS certification, please see below for a sample request.

Creating a Sale with HSA or FSA Cards

curl -i -X POST \
  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda \
  https://finix.sandbox-payments-api.com/transfers \
  -H 'Content-Type: application/json' \
  -H 'Finix-Version: 2022-02-01' \
  -d '{
    "additional_healthcare_data": {
      "clinic_amount": 50,
      "dental_amount": 200,
      "prescription_amount": 300,
      "vision_amount": 300
    },
    "amount": 950,
    "currency": "USD",
    "merchant": "MUmfEGv5bMpSJ9k5TFRUjkmm",
    "source": "PI6iQcTtJNCS8GZAVKYi5Ueb",
    "tags": {
      "order_number": "21DFASJSAKAS"
    }
  }'

A successful response returns 201, the newly created Transfer, and a PENDING response.

{
  "id" : "TRrRzWDsxPao5Wz75J38v4LJ",
  "created_at" : "2025-08-29T05:05:44.62Z",
  "updated_at" : "2025-08-29T05:05:44.62Z",
  "additional_buyer_charges" : null,
  "additional_healthcare_data" : {
    "clinic_amount" : 50,
    "dental_amount" : 200,
    "prescription_amount" : 300,
    "vision_amount" : 300
  },
  "additional_purchase_data" : null,
  "address_verification" : "POSTAL_CODE_AND_STREET_MATCH",
  "amount" : 950,
  "amount_requested" : 950,
  "application" : "APc9vhYcPsRuTSpKD9KpMtPe",
  "currency" : "USD",
  "destination" : null,
  "externally_funded" : "UNKNOWN",
  "failure_code" : null,
  "failure_message" : null,
  "fee" : 0,
  "fee_profile" : "FPuizPqrhzYLbmJm88u7aqfj",
  "idempotency_id" : null,
  "merchant" : "MUmfEGv5bMpSJ9k5TFRUjkmm",
  "merchant_identity" : "ID6UfSm1d4WPiWgLYmbyeo3H",
  "messages" : [ ],
  "network_details" : {
    "brand" : "VISA",
    "authorization_code" : "348579",
    "acquirer_reference_number" : null
  },
  "operation_key" : "CARD_NOT_PRESENT_SALE",
  "parent_transfer" : null,
  "parent_transfer_trace_id" : null,
  "raw" : null,
  "ready_to_settle_at" : "2025-08-30T05:05:45.11Z",
  "receipt_last_printed_at" : null,
  "security_code_verification" : "MATCHED",
  "source" : "PI6iQcTtJNCS8GZAVKYi5Ueb",
  "split_transfers" : [ ],
  "state" : "SUCCEEDED",
  "statement_descriptor" : "FLX*FINIX FLOWERS",
  "subtype" : "API",
  "supplemental_fee" : null,
  "tags" : {
    "order_number" : "21DFASJSAKAS"
  },
  "tip_amount" : null,
  "trace_id" : "c9bc3172-fd0a-49e6-8038-dee05a699cba",
  "type" : "DEBIT",
  "_links" : {
    "application" : {
      "href" : "https://finix.sandbox-payments-api.com/applications/APc9vhYcPsRuTSpKD9KpMtPe"
    },
    "self" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRrRzWDsxPao5Wz75J38v4LJ"
    },
    "merchant_identity" : {
      "href" : "https://finix.sandbox-payments-api.com/identities/ID6UfSm1d4WPiWgLYmbyeo3H"
    },
    "payment_instruments" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRrRzWDsxPao5Wz75J38v4LJ/payment_instruments"
    },
    "reversals" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRrRzWDsxPao5Wz75J38v4LJ/reversals"
    },
    "fees" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRrRzWDsxPao5Wz75J38v4LJ/fees"
    },
    "disputes" : {
      "href" : "https://finix.sandbox-payments-api.com/transfers/TRrRzWDsxPao5Wz75J38v4LJ/disputes"
    },
    "source" : {
      "href" : "https://finix.sandbox-payments-api.com/payment_instruments/PI6iQcTtJNCS8GZAVKYi5Ueb"
    },
    "fee_profile" : {
      "href" : "https://finix.sandbox-payments-api.com/fee_profiles/FPuizPqrhzYLbmJm88u7aqfj"
    }
  }
}

Creating an Authorization with HSA or FSA Cards

To create an authorization with HSA or FSA cards with a non-healthcare MCC that has the appropriate SIGIS registration and IIAS certification, please see below for a sample request.

Request

curl -i -X POST \
  -u USfdccsr1Z5iVbXDyYt7hjZZ:313636f3-fac2-45a7-bff7-a334b93e7bda \
  https://finix.sandbox-payments-api.com/authorizations \
  -H 'Content-Type: application/json' \
  -H 'Finix-Version: 2022-02-01' \
  -d '{
    "additional_healthcare_data": {
      "clinic_amount": 50,
      "dental_amount": 200,
      "prescription_amount": 300,
      "vision_amount": 300
    },
    "amount": 950,
    "currency": "USD",
    "merchant": "MU7noQ1wdgdAeAfymw2rfBMq",
    "source": "PIkxmtueemLD6dN9ZoWGHT44"
  }'

Response

201 Created - Authorization Created

A successful request returns a 201 Created status code, with the response body containing the newly created authorization with the additional healthcare amounts:

{
  "id": "AU2J7hDBvWSBEnis5BHGhBCR",
  "created_at": "2024-12-04T10:12:59.44Z",
  "updated_at": "2024-12-04T10:12:59.44Z",
  "3ds_redirect_url": null,
  "additional_buyer_charges": null,
  "additional_healthcare_data": { 
    "clinic_amount": 50, 
    "dental_amount": 200, 
    "prescription_amount": 300, 
    "vision_amount": 300
  },
  "additional_purchase_data": null,
  "address_verification": "POSTAL_CODE_AND_STREET_MATCH",
  "amount": 950,
  "amount_requested": 950,
  "application": "APc9vhYcPsRuTSpKD9KpMtPe",
  "currency": "USD",
  "expires_at": "2024-12-11T10:12:59.44Z",
  "failure_code": null,
  "failure_message": null,
  "idempotency_id": null,
  "is_void": false,
  "merchant": "MU7noQ1wdgdAeAfymw2rfBMq",
  "merchant_identity": "IDjvxGeXBLKH1V9YnWm1CS4n",
  "messages": [],
  "raw": null,
  "receipt_last_printed_at": null,
  "security_code_verification": "MATCHED",
  "source": "PIkxmtueemLD6dN9ZoWGHT44",
  "state": "SUCCEEDED",
  "tags": {
    "order_number": "21DFASJSAKAS"
  },
  "trace_id": "f834fd36-6978-48e7-b0fc-a40cc208bdde",
  "transfer": null,
  "void_state": "UNATTEMPTED",
  "_links": {
    "self": {
      "href": "https://finix.sandbox-payments-api.com/authorizations/AU2J7hDBvWSBEnis5BHGhBCR"
    },
    "application": {
      "href": "https://finix.sandbox-payments-api.com/applications/APc9vhYcPsRuTSpKD9KpMtPe"
    },
    "merchant_identity": {
      "href": "https://finix.sandbox-payments-api.com/identities/IDjvxGeXBLKH1V9YnWm1CS4n"
    }
  }
}