HSA/FSA Card Acceptance

Health Savings Account (HSA) and Flexible Spending Account (FSA) cards are commonly used to pay for qualified medical, health, and wellness-related expenses. With this capability, healthcare providers (e.g., clinics, dental offices, pharmacies) can process payments for eligible services and products directly using HSA/FSA cards.

Follow the steps and references outlined in this section to accept and transmit HSA/FSA card data from the integrated Dejavoo payment terminal to the payment processor.

Request Body

application/xml

PaymentType*string

EDC type for the transaction.

TransType*string

Must be Sale — HSA/FSA amounts are only valid on a Sale transaction.

Value in"Sale"

Amount*string

Total dollar amount of the transaction.

Tip?string

Dollar amount of the tip.

CashbackAmount?string

Cashback amount. Only valid on Debit or EBT payment types.

CustomFee?string

Dollar amount considered as custom fee.

RefId*string

Alphanumeric reference field

RegisterId*string

Alphanumeric reference field identifying the register/POS.

AuthKey*string

Authorizes the Host system to use the SPIn Web Service.

PrintReceipt?string

Receipt printing behavior.

Value in"No" | "Merchant" | "Customer" | "Both"

SigCapture?string

Whether to capture a signature.

Value in"Yes" | "No"

HSA_TotalAmount?number

Total HSA/FSA-eligible amount of the transaction.

HSA_RxAmount?number

Portion of the amount for prescription costs.

HSA_ClinicAmount?number

Portion of the amount for clinic/visit costs.

HSA_DentalAmount?number

Portion of the amount for dental costs.

HSA_VisionAmount?number

Portion of the amount for vision costs.

IsTxnStatusScreenRequired?boolean

Indicates whether the terminal should display the transaction status screen after processing.

Response Body

`application/xml`

curl -X GET "https://example.com" \  -H "Content-Type: application/xml" \  -d '<request>    <PaymentType>Credit</PaymentType>    <TransType>Sale</TransType>    <Amount>50.00</Amount>    <Tip>0.00</Tip>    <CashbackAmount>0.00</CashbackAmount>    <CustomFee>0.00</CustomFee>    <RefId>1</RefId>    <RegisterId/>    <AuthKey/>    <HSA_TotalAmount>30</HSA_TotalAmount>    <HSA_RxAmount>10</HSA_RxAmount>    <HSA_ClinicAmount>10</HSA_ClinicAmount>    <HSA_DentalAmount>10</HSA_DentalAmount>    <HSA_VisionAmount>10</HSA_VisionAmount>    <PrintReceipt>No</PrintReceipt>    <SigCapture>No</SigCapture>    <IsTxnStatusScreenRequired>true</IsTxnStatusScreenRequired>  </request>'

<response>
  <Message>yourMessage</Message>
  <RefId>yourRefId</RefId>
  <RegisterId>yourRegisterId</RegisterId>
  <ResultCode>yourResultCode</ResultCode>
  <PaymentType>yourPaymentType</PaymentType>
  <TransType>yourTransType</TransType>
  <SN>yourSN</SN>
  <ExtData>yourExtData</ExtData>
</response>

HSA/FSA Card Acceptance

Request Body

Response Body

200application/xml

`application/xml`