{"title":"FSA\/HSA healthcare payments with IIAS","category":"default","creationDate":1794830176,"content":"<div class=\"additional-info-block output-inline\">\n<h5 class=\"article__heading additional-info-block__title\">SIG-IS registration<\/h5><div class=\"additional-info-block__body\"><p>This page covers the IIAS program. If your business uses Direct Medical Services or the 90% Rule, you do not need this integration. See <a href=\"\/payment-methods\/cards\/enhanced-scheme-data\/fsa-hsa\/sig-is-setup\" target=\"_blank\">SIG-IS registration and certification<\/a>.<\/p><\/div><\/div>\n\n<p>In the US, you can use Adyen payment terminals to accept FSA\/HSA payments for eligible healthcare products if your business is SIG-IS-certified. FSA\/HSA payments are supported for US-issued Visa and Mastercard cards. Your POS app uses an Inventory Information Approval System (IIAS) to identify eligible healthcare products. This page explains how to identify FSA\/HSA cards and make FSA\/HSA payments with a Terminal API integration.<\/p>\n<h2>Requirements<\/h2>\n<p>Before you begin, take into account the following requirements, limitations, and preparations.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Requirement<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><strong>Integration type<\/strong><\/td>\n<td style=\"text-align: left;\">A <a href=\"\/point-of-sale\/design-your-integration\/terminal-api\">Terminal API<\/a> integration with payment terminals using terminal software version <strong>1.136.3<\/strong> or later.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Limitations<\/strong><\/td>\n<td style=\"text-align: left;\">FSA\/HSA payments do not support <a href=\"\/point-of-sale\/offline-payment\">offline payments<\/a>, including Store and Forward and offline EMV. See <a href=\"#limitations\">Limitations<\/a>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><strong>Setup steps<\/strong><\/td>\n<td style=\"text-align: left;\">Before you begin: <ul><li markdown=\"1\">Register or certify your business with SIG-IS. The program that applies depends on your business type. See <a href=\"\/payment-methods\/cards\/enhanced-scheme-data\/fsa-hsa\/sig-is-setup\">SIG-IS registration and certification<\/a>.<\/li><li markdown=\"1\">Contact your Adyen account manager to enable FSA\/HSA payments on your account.<\/li><li markdown=\"1\">Ensure your integration supports <a href=\"\/point-of-sale\/partial-authorizations\">partial authorizations<\/a>, to be able to process FSA\/HSA payments.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2 id=\"limitations\">Limitations and product eligibility<\/h2>\n<p>Your POS app must:<\/p>\n<ul>\n<li>Identify eligible items by checking your inventory against the <a href=\"https:\/\/sig-is.org\/eligible-product-list\/eligible-product-list-overview\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">SIG-IS Eligible Product List<\/a>.<\/li>\n<li>Calculate the eligible and ineligible totals.<\/li>\n<li>Make separate payments for eligible and ineligible items.<\/li>\n<\/ul>\n<p>Adyen does not determine product eligibility or calculate these amounts.<\/p>\n<p>FSA\/HSA payments do not support <a href=\"\/point-of-sale\/offline-payment\">offline payments<\/a>. This applies to both Store and Forward and <a href=\"\/point-of-sale\/offline-payment#offline-emv\">offline EMV<\/a>. When the terminal cannot reach Adyen's backend, it blocks the transaction instead of saving it for later. For how to handle this, see the <span translate=\"no\"><strong>Failure<\/strong><\/span> result under <a href=\"#make-an-fsa-hsa-payment\">Make an FSA\/HSA payment<\/a>.<\/p>\n<p>Payments that do not include healthcare fields keep the standard offline payment behavior.<\/p>\n<p>To refund an FSA\/HSA payment, use the standard <a href=\"\/point-of-sale\/basic-tapi-integration\/refund-payment\">refund<\/a> flows: a <a href=\"\/point-of-sale\/basic-tapi-integration\/refund-payment\/referenced\">referenced refund<\/a> or an <a href=\"\/point-of-sale\/basic-tapi-integration\/refund-payment\/unreferenced\">unreferenced refund<\/a>. Refunds have no FSA\/HSA-specific requirements.<\/p>\n<h2>How it works<\/h2>\n<p>The FSA\/HSA payment flow is as follows:<\/p>\n<ol>\n<li>The shopper presents their card to the payment terminal.<\/li>\n<li>\n<p>You make a card acquisition request to <a href=\"#identify-fsa-hsa-cards\">identify whether the shopper used an FSA\/HSA card<\/a>.<\/p>\n<p>FSA\/HSA is not a separate payment brand. Eligible cards use Visa or Mastercard. A card can be co-badged with a US Debit network, such as STAR, but Adyen processes FSA\/HSA payments only over the Visa or Mastercard network.<\/p>\n<p>If any of the card's brands is healthcare-eligible, the response returns <code>healthcareIndicator<\/code> <span translate=\"no\"><strong>true<\/strong><\/span>. Your POS app does not need to select a brand for FSA\/HSA processing.<\/p>\n<\/li>\n<li>The card acquisition response determines how you continue:\n<ul>\n<li>If the response identifies an FSA\/HSA card, your POS app identifies the eligible items and calculates the eligible and ineligible totals.<\/li>\n<li>Otherwise, your store staff asks the shopper how to continue. The shopper can continue with a regular payment using the acquired card, or use another card. If the shopper wants to use another card, you cancel the card acquisition.<\/li>\n<\/ul><\/li>\n<li>For an FSA\/HSA card, you <a href=\"#make-an-fsa-hsa-payment\">make an FSA\/HSA payment<\/a> for eligible healthcare items only.<\/li>\n<li>From the payment response you learn the amount approved by the issuer:\n<ul>\n<li>If the issuer approves the full eligible amount, the FSA\/HSA payment is complete.<\/li>\n<li>If the shopper's FSA\/HSA account does not have enough funds, it is possible that the issuer still approves part of the eligible amount.<\/li>\n<\/ul><\/li>\n<li>If the issuer approved only part of the eligible amount, <a href=\"#make-a-follow-up-payment-for-the-remaining-amount\">make a follow-up payment<\/a> to let the shopper pay the remaining amount with another card.<\/li>\n<li>If the purchase includes ineligible items, make a separate payment for them using another payment method.<\/li>\n<\/ol>\n<h2 id=\"identify-fsa-hsa-cards\">Identify FSA\/HSA cards<\/h2>\n<p>To identify an FSA\/HSA card:<\/p>\n<ol>\n<li>\n<p>Make a <a href=\"\/point-of-sale\/card-acquisition#card-acquisition-request\">card acquisition request<\/a> with:<\/p>\n<ul>\n<li>\n<p>The standard <a href=\"\/point-of-sale\/design-your-integration\/terminal-api#request-message-header\">\n  <code>SaleToPOIRequest.MessageHeader<\/code>\n<\/a> object, with <code>MessageClass<\/code> set to <span translate=\"no\"><strong>Service<\/strong><\/span> and <code>MessageCategory<\/code> set to <span translate=\"no\"><strong>CardAcquisition<\/strong><\/span>.<\/p>\n<table>\n<thead>\n<tr>\n<th>Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td><code>ProtocolVersion<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><strong>3.0<\/strong><\/td>\n<\/tr>\n<tr>\n<td><code>MessageClass<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Service<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td><code>MessageCategory<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>CardAcquisition<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td><code>MessageType<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Request<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td><code>ServiceID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (<code>POIID<\/code>) being used.<\/td>\n<\/tr>\n<tr>\n<td><code>SaleID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for the POS system component to send this request from.<\/td>\n<\/tr>\n<tr>\n<td><code>POIID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique ID of the terminal to send this request to. Format: <em>[device model]-[serial number]<\/em>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>\n<p>The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/cardacquisition\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">CardAcquisitionRequest<\/a> object with:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleTransactionID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>TransactionID<\/code>: your reference to identify a payment. We recommend a unique value for each payment.<\/li> <li markdown=\"1\"><code>TimeStamp<\/code>: date and time of the request in <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_8601#Coordinated_Universal_Time_(UTC)\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">UTC format<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>CardAcquisitionTransaction<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">A required object that can be empty or contain: <ul><li markdown=\"1\"><code>TotalAmount<\/code> (optional): the transaction amount. When you do not know the amount yet, you can omit this parameter or specify an initial amount. If you specify an initial amount, provide the final amount later in the payment request.<\/li><li markdown=\"1\"><code>PaymentType<\/code> (optional): if you intend to continue with a payment, either omit this parameter or specify <span translate=\"no\"><strong>Normal<\/strong><\/span>.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Card acquisition request'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\": {\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"CardAcquisition\\\",\\n            \\\"MessageType\\\": \\\"Request\\\",\\n            \\\"ServiceID\\\": \\\"282\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12345\\\",\\n            \\\"POIID\\\": \\\"S1F2-324688179\\\"\\n        },\\n        \\\"CardAcquisitionRequest\\\": {\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"369\\\",\\n                    \\\"TimeStamp\\\": \\\"2021-03-05T12:22:57.449Z\\\"\\n                }\\n            },\\n            \\\"CardAcquisitionTransaction\\\": {\\n                \\\"TotalAmount\\\": 45.00\\n            }\\n        }\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>When you receive the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/cardacquisition#responses-200-Response\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">CardAcquisitionResponse<\/a>, save the <code>TimeStamp<\/code> and <code>TransactionID<\/code> from <code>POIData.POITransactionID<\/code>. You will need these details if you continue with a <a href=\"#make-an-fsa-hsa-payment\">payment request<\/a> using the acquired card. The <code>Response.AdditionalResponse<\/code> field contains either form-encoded key-value pairs or a Base64-encoded JSON object. If it is Base64-encoded, decode it to get the JSON object.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Card acquisition response for an FSA\/HSA card'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"SaleToPOIResponse\\\": {\\n        \\\"CardAcquisitionResponse\\\": {\\n            \\\"POIData\\\": {\\n                \\\"POITransactionID\\\": {\\n                    \\\"TimeStamp\\\": \\\"2026-10-12T04:20:19.688Z\\\",\\n                    \\\"TransactionID\\\": \\\"8ha5001614946979001\\\"\\n                }\\n            },\\n            \\\"PaymentInstrumentData\\\": {\\n                \\\"CardData\\\": {\\n                    \\\"MaskedPan\\\": \\\"541333 **** 9999\\\",\\n                    \\\"PaymentBrand\\\": \\\"mc\\\",\\n                    \\\"SensitiveCardData\\\": {\\n                        \\\"ExpiryDate\\\": \\\"0228\\\"\\n                    }\\n                },\\n                \\\"PaymentInstrumentType\\\": \\\"Card\\\"\\n            },\\n            \\\"Response\\\": {\\n                \\\"AdditionalResponse\\\": \\\"tid=46403161&amp;message=CARD_ACQ_COMPLETED&amp;giftcardIndicator=false&amp;healthcareIndicator=true&amp;fundingSource=PREPAID&amp;cardBin=541333&amp;paymentMethod=mc\\\",\\n                \\\"Result\\\": \\\"Success\\\"\\n            }\\n        },\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"CardAcquisition\\\",\\n            \\\"MessageType\\\": \\\"Response\\\",\\n            \\\"ServiceID\\\": \\\"282\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12345\\\",\\n            \\\"POIID\\\": \\\"S1F2-324688179\\\"\\n        }\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>To find out whether the card is an FSA\/HSA card, check whether <code>AdditionalResponse<\/code> contains the <code>healthcareIndicator<\/code> key to decide on the next step:<\/p>\n<ul>\n<li>If <code>Result<\/code> is <span translate=\"no\"><strong>Success<\/strong><\/span> and <code>healthcareIndicator<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span>, the card is an FSA\/HSA card. Your POS app identifies the eligible items and calculates the eligible amount. Then <a href=\"#make-an-fsa-hsa-payment\">make an FSA\/HSA payment<\/a>.<\/li>\n<li>If <code>Result<\/code> is <span translate=\"no\"><strong>Success<\/strong><\/span> and <code>healthcareIndicator<\/code> is not present, the response does not identify the card as an FSA\/HSA card. The response never returns <code>healthcareIndicator<\/code> <span translate=\"no\"><strong>false<\/strong><\/span>. A missing key means that the card is not an FSA\/HSA card, or that the terminal cannot reach the backend. You decide whether to continue with a regular payment:\n<ul>\n<li>If the shopper wants to use the acquired card, <a href=\"\/point-of-sale\/card-acquisition#continue-with-payment\">finish the card acquisition<\/a> in the regular way with a payment request that includes <code>PaymentData.CardAcquisitionReference<\/code> but does not include healthcare fields.<\/li>\n<li>If the shopper wants to use another card, <a href=\"\/point-of-sale\/card-acquisition#cancel-completed\">cancel the card acquisition<\/a>. Then make a new card acquisition request to identify the new card, and continue based on the response.<\/li>\n<\/ul><\/li>\n<\/ul>\n<\/li>\n<\/ol>\n<h2 id=\"make-an-fsa-hsa-payment\">Make an FSA\/HSA payment<\/h2>\n<p>To make an FSA\/HSA payment for eligible items:<\/p>\n<ol>\n<li>\n<p>Configure your POS app to validate healthcare amounts before you send a payment request. See <a href=\"#healthcare-amount-rules\">Healthcare amount rules<\/a>.<\/p>\n<\/li>\n<li>\n<p>Make a <a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment\">Terminal API payment request<\/a>, specifying:<\/p>\n<ul>\n<li>\n<p>The standard <a href=\"\/point-of-sale\/design-your-integration\/terminal-api#request-message-header\">\n  <code>SaleToPOIRequest.MessageHeader<\/code>\n<\/a> object, with <code>MessageClass<\/code> set to <span translate=\"no\"><strong>Service<\/strong><\/span> and <code>MessageCategory<\/code> set to <span translate=\"no\"><strong>Payment<\/strong><\/span>.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>ProtocolVersion<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><strong>3.0<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageClass<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Service<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageCategory<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Payment<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageType<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Request<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>ServiceID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (<code>POIID<\/code>) being used.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for the POS system component to send this request from.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>POIID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique ID of the terminal to send this request to. Format: <em>[device model]-[serial number]<\/em>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>\n<p>The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentRequest<\/a> object with:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleTransactionID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>TransactionID<\/code>: your reference to identify a payment. We recommend a unique value for each payment.<\/li> <li markdown=\"1\"><code>TimeStamp<\/code>: date and time of the request in <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_8601#Coordinated_Universal_Time_(UTC)\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">UTC format<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleReferenceID<\/code><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">A unique reference that lets you identify payments that belong together.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleToAcquirerData<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Include the following parameters: <ul><li markdown=\"1\">One or more <code>healthcare<\/code> fields. See the details below.<\/li><li markdown=\"1\">The <a href=\"\/point-of-sale\/add-data\/tender-options\"><code>AllowPartialAuthorisation<\/code> tender option<\/a> to allow a partial authorization.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>PaymentTransaction.AmountsReq<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>Currency<\/code>: the transaction <a href=\"\/development-resources\/currency-codes\">currency<\/a>.<\/li><li markdown=\"1\"><code>RequestedAmount<\/code>: the total for eligible items.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>PaymentData.CardAcquisitionReference<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object referring to the <a href=\"#identify-fsa-hsa-cards\">card acquisition<\/a>: <ul><li markdown=\"1\"><code>TimeStamp<\/code>: the time stamp returned in the <code>POIData.POITransactionID<\/code> of the card acquisition response.<\/li> <li markdown=\"1\"><code>TransactionID<\/code>: the transaction ID returned in the <code>POIData.POITransactionID<\/code> of the card acquisition response.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>\n<p>The <code>healthcare<\/code> fields in <code>SaleData.SaleToAcquirerData<\/code> with amounts in <a href=\"\/development-resources\/currency-codes#minor-units\">minor units<\/a>, using the currency specified in <code>PaymentTransaction.AmountsReq.Currency<\/code>:<\/p>\n<p>Each sub-amount is required when it applies to the eligible items in this payment. This also applies to follow-up payments.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>healthcare.totalHealthcareValue<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The total FSA\/HSA-eligible amount, in minor units. Must equal <code>PaymentTransaction.AmountsReq.RequestedAmount<\/code> converted to minor units. For example, <strong>4500<\/strong> for a <code>RequestedAmount<\/code> of <strong>45.00<\/strong> USD.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>healthcare.prescriptionValue<\/code><\/td>\n<td style=\"text-align: center;\"><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;warning&quot;>\n        Conditional\n    <\/tag>\n<\/div>\n<\/td>\n<td style=\"text-align: left;\">The prescription (Rx) sub-amount, in minor units. This amount is included in <code>healthcare.totalHealthcareValue<\/code>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>healthcare.visionPrescriptionValue<\/code><\/td>\n<td style=\"text-align: center;\"><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;warning&quot;>\n        Conditional\n    <\/tag>\n<\/div>\n<\/td>\n<td style=\"text-align: left;\">The vision or optical sub-amount, in minor units. This amount is included in <code>healthcare.totalHealthcareValue<\/code>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>healthcare.dentalValue<\/code><\/td>\n<td style=\"text-align: center;\"><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;warning&quot;>\n        Conditional\n    <\/tag>\n<\/div>\n<\/td>\n<td style=\"text-align: left;\">The dental sub-amount, in minor units. This amount is included in <code>healthcare.totalHealthcareValue<\/code>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>healthcare.otherMedicalValue<\/code><\/td>\n<td style=\"text-align: center;\"><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;warning&quot;>\n        Conditional\n    <\/tag>\n<\/div>\n<\/td>\n<td style=\"text-align: left;\">The eligible medical amount not included in the prescription, vision, or dental sub-amounts, in minor units. This amount is included in <code>healthcare.totalHealthcareValue<\/code>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<p><a id=\"healthcare-amount-rules\"><\/a><\/p>\n<p>Adyen validates the healthcare amounts before authorizing the payment, and declines the payment if the amounts are invalid. The following rules apply:<\/p>\n<ul>\n<li><code>healthcare.totalHealthcareValue<\/code> must be greater than 0.<\/li>\n<li><code>healthcare.totalHealthcareValue<\/code> must not exceed the transaction amount.<\/li>\n<li>The sum of the sub-amounts must not exceed <code>healthcare.totalHealthcareValue<\/code>.<\/li>\n<li><code>healthcare.totalHealthcareValue<\/code> is required when you include any sub-amount.<\/li>\n<\/ul>\n<p>You can pass the <code>SaleToAcquirerData<\/code> fields in either of the following formats. Both examples specify USD&nbsp;45.00 in eligible healthcare amounts:<\/p>\n<ul>\n<li>\n<p><strong>Option 1: Base64-encoded JSON.<\/strong> Create the following JSON object, encode it to Base64, and use the resulting string as <code>SaleData.SaleToAcquirerData<\/code>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Healthcare amounts and tender option in JSON format'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"additionalData\\\": {\\n        \\\"healthcare.totalHealthcareValue\\\": \\\"4500\\\",\\n        \\\"healthcare.prescriptionValue\\\": \\\"1500\\\",\\n        \\\"healthcare.visionPrescriptionValue\\\": \\\"500\\\",\\n        \\\"healthcare.dentalValue\\\": \\\"1000\\\",\\n        \\\"healthcare.otherMedicalValue\\\": \\\"1500\\\"\\n    },\\n    \\\"tenderOption\\\": \\\"AllowPartialAuthorisation\\\"\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p><strong>Option 2: Form-encoded key-value pairs.<\/strong> Use the following string as <code>SaleData.SaleToAcquirerData<\/code>.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Healthcare amounts and tender option as key-value pairs'\" :id=\"''\" :code-data='[{\"language\":\"raw\",\"tabTitle\":\"\",\"content\":\"healthcare.totalHealthcareValue=4500&amp;healthcare.prescriptionValue=1500&amp;healthcare.visionPrescriptionValue=500&amp;healthcare.dentalValue=1000&amp;healthcare.otherMedicalValue=1500&amp;tenderOption=AllowPartialAuthorisation\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ul>\n<p>For more information about the formats, see <a href=\"\/point-of-sale\/add-data\">Add information to a payment<\/a>.<\/p>\n<p>The following example uses key-value pairs to send a USD&nbsp;45.00 payment for eligible items. The ineligible items, if any, need a separate payment with another payment method.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'FSA\/HSA payment request'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\": {\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"Payment\\\",\\n            \\\"MessageType\\\": \\\"Request\\\",\\n            \\\"ServiceID\\\": \\\"9267\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12345\\\",\\n            \\\"POIID\\\": \\\"S1F2-324688179\\\"\\n        },\\n        \\\"PaymentRequest\\\": {\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"6256\\\",\\n                    \\\"TimeStamp\\\": \\\"2026-10-12T04:20:44.000Z\\\"\\n                },\\n                \\\"SaleReferenceID\\\": \\\"Order-FSA-001-1\\\",\\n                \\\"SaleToAcquirerData\\\": \\\"healthcare.totalHealthcareValue=4500&amp;healthcare.prescriptionValue=1500&amp;healthcare.visionPrescriptionValue=500&amp;healthcare.dentalValue=1000&amp;healthcare.otherMedicalValue=1500&amp;tenderOption=AllowPartialAuthorisation\\\"\\n            },\\n            \\\"PaymentTransaction\\\": {\\n                \\\"AmountsReq\\\": {\\n                    \\\"Currency\\\": \\\"USD\\\",\\n                    \\\"RequestedAmount\\\": 45.00\\n                }\\n            },\\n            \\\"PaymentData\\\": {\\n                \\\"CardAcquisitionReference\\\": {\\n                    \\\"TransactionID\\\": \\\"8ha5001614946979001\\\",\\n                    \\\"TimeStamp\\\": \\\"2026-10-12T04:20:19.688Z\\\"\\n                }\\n            }\\n        }\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Check the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment#responses-200\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentResponse<\/a>:<\/p>\n<ul>\n<li>If <code>Result<\/code> is <span translate=\"no\"><strong>Success<\/strong><\/span>, the issuer approved the full eligible amount. <code>AuthorizedAmount<\/code> matches <code>RequestedAmount<\/code>.<br \/>\nSuccessful responses do not include healthcare-specific fields in <code>AdditionalResponse<\/code>.<\/li>\n<li>If <code>Result<\/code> is <span translate=\"no\"><strong>Partial<\/strong><\/span>, the issuer approved only part of the eligible amount:\n<ul>\n<li>Alert store staff that the shopper has not paid the full amount. The terminal also shows a warning, but staff can overlook it.<\/li>\n<li>Use <code>PaymentResult.AmountsResp.AuthorizedAmount<\/code> to calculate the remaining amount, then <a href=\"#make-a-follow-up-payment-for-the-remaining-amount\">make a follow-up payment<\/a>.<\/li>\n<li>If the shopper does not want to make the purchase because they do not want to pay the remaining amount, <a href=\"\/point-of-sale\/capturing-payments#cancel-authorisation\">cancel the authorization<\/a> to release the hold on the approved amount in the shopper's FSA\/HSA account. To make sure you can cancel before the amount is captured, follow the <a href=\"\/point-of-sale\/partial-authorizations\">partial authorization guidance<\/a> and configure a <a href=\"\/point-of-sale\/capturing-payments#delayed-automatic-capture\">capture delay<\/a>.<\/li>\n<\/ul><\/li>\n<li>\n<p>If <code>Result<\/code> is <span translate=\"no\"><strong>Failure<\/strong><\/span>, check <code>Response.ErrorCondition<\/code>:<\/p>\n<ul>\n<li><strong>Invalid healthcare amounts:<\/strong> <code>ErrorCondition<\/code> is <span translate=\"no\"><strong>Refusal<\/strong><\/span>, and <code>refusalReason<\/code> in the decoded <code>AdditionalResponse<\/code> is <span translate=\"no\"><strong>InvalidFieldWithReason<\/strong><\/span>. The response does not say which amount is invalid: <code>message<\/code> is <span translate=\"no\"><strong>UNKNOWN<\/strong><\/span>. Check the amounts against the <a href=\"#healthcare-amount-rules\">healthcare amount rules<\/a>, and correct them before retrying.<\/li>\n<li><strong>Adyen unreachable:<\/strong> <code>ErrorCondition<\/code> is <span translate=\"no\"><strong>UnreachableHost<\/strong><\/span>, and <code>refusalReason<\/code> in the decoded <code>AdditionalResponse<\/code> is <span translate=\"no\"><strong>Failed to go online<\/strong><\/span>. The terminal cannot reach Adyen, and FSA\/HSA payments cannot be completed offline. Have your POS app alert staff that an online connection is required, so they can offer another payment method.<\/li>\n<li><strong>Issuer unavailable:<\/strong> <code>ErrorCondition<\/code> is <span translate=\"no\"><strong>Refusal<\/strong><\/span>, and <code>refusalReason<\/code> in the decoded <code>AdditionalResponse<\/code> is <span translate=\"no\"><strong>Issuer unavailable<\/strong><\/span>. The FSA\/HSA card cannot be used for this payment. Have your POS app alert staff, so they can offer another payment method.<\/li>\n<\/ul>\n<p>For other failures, see <a href=\"\/point-of-sale\/error-scenarios\">Handle responses<\/a>.<\/p>\n<\/li>\n<\/ul>\n<p>The following tabs show response examples for a full approval, a partial approval, and a decline for invalid healthcare amounts.<\/p>\n\n<div id=\"tabgGDkT\">\n    <div data-component-wrapper=\"tabs\">\n        <tabs\n                        :items=\"[{&quot;title&quot;:&quot;Successful response&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Successful FSA\/HSA payment response&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;SaleToPOIResponse\\\\\\&quot;: {\\\\n        \\\\\\&quot;MessageHeader\\\\\\&quot;: {\\\\n            \\\\\\&quot;ProtocolVersion\\\\\\&quot;: \\\\\\&quot;3.0\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageClass\\\\\\&quot;: \\\\\\&quot;Service\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageCategory\\\\\\&quot;: \\\\\\&quot;Payment\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageType\\\\\\&quot;: \\\\\\&quot;Response\\\\\\&quot;,\\\\n            \\\\\\&quot;ServiceID\\\\\\&quot;: \\\\\\&quot;9267\\\\\\&quot;,\\\\n            \\\\\\&quot;SaleID\\\\\\&quot;: \\\\\\&quot;POSSystemID12345\\\\\\&quot;,\\\\n            \\\\\\&quot;POIID\\\\\\&quot;: \\\\\\&quot;S1F2-324688179\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;PaymentResponse\\\\\\&quot;: {\\\\n            \\\\\\&quot;POIData\\\\\\&quot;: {\\\\n                \\\\\\&quot;POIReconciliationID\\\\\\&quot;: \\\\\\&quot;1000\\\\\\&quot;,\\\\n                \\\\\\&quot;POITransactionID\\\\\\&quot;: {\\\\n                    \\\\\\&quot;TransactionID\\\\\\&quot;: \\\\\\&quot;8ha5001614946979001.HTG8QR9PGPPJK8V5\\\\\\&quot;,\\\\n                    \\\\\\&quot;TimeStamp\\\\\\&quot;: \\\\\\&quot;2026-10-12T04:20:47.105Z\\\\\\&quot;\\\\n                }\\\\n            },\\\\n            \\\\\\&quot;PaymentResult\\\\\\&quot;: {\\\\n                \\\\\\&quot;AmountsResp\\\\\\&quot;: {\\\\n                    \\\\\\&quot;AuthorizedAmount\\\\\\&quot;: 45.00,\\\\n                    \\\\\\&quot;Currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;\\\\n                },\\\\n                \\\\\\&quot;PaymentType\\\\\\&quot;: \\\\\\&quot;Normal\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;Response\\\\\\&quot;: {\\\\n                \\\\\\&quot;Result\\\\\\&quot;: \\\\\\&quot;Success\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;SaleData\\\\\\&quot;: {\\\\n                \\\\\\&quot;SaleTransactionID\\\\\\&quot;: {\\\\n                    \\\\\\&quot;TransactionID\\\\\\&quot;: \\\\\\&quot;6256\\\\\\&quot;,\\\\n                    \\\\\\&quot;TimeStamp\\\\\\&quot;: \\\\\\&quot;2026-10-12T04:20:44.000Z\\\\\\&quot;\\\\n                }\\\\n            }\\\\n        }\\\\n    }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;successful_response_0_1&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Partial response&quot;,&quot;content&quot;:&quot;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;Partial FSA\/HSA payment response&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;SaleToPOIResponse\\\\\\&quot;: {\\\\n        \\\\\\&quot;MessageHeader\\\\\\&quot;: {\\\\n            \\\\\\&quot;ProtocolVersion\\\\\\&quot;: \\\\\\&quot;3.0\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageClass\\\\\\&quot;: \\\\\\&quot;Service\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageCategory\\\\\\&quot;: \\\\\\&quot;Payment\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageType\\\\\\&quot;: \\\\\\&quot;Response\\\\\\&quot;,\\\\n            \\\\\\&quot;ServiceID\\\\\\&quot;: \\\\\\&quot;9267\\\\\\&quot;,\\\\n            \\\\\\&quot;SaleID\\\\\\&quot;: \\\\\\&quot;POSSystemID12345\\\\\\&quot;,\\\\n            \\\\\\&quot;POIID\\\\\\&quot;: \\\\\\&quot;S1F2-324688179\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;PaymentResponse\\\\\\&quot;: {\\\\n            \\\\\\&quot;POIData\\\\\\&quot;: {\\\\n                \\\\\\&quot;POIReconciliationID\\\\\\&quot;: \\\\\\&quot;1000\\\\\\&quot;,\\\\n                \\\\\\&quot;POITransactionID\\\\\\&quot;: {\\\\n                    \\\\\\&quot;TransactionID\\\\\\&quot;: \\\\\\&quot;8ha5001614946979001.HTG8QR9PGPPJK8V5\\\\\\&quot;,\\\\n                    \\\\\\&quot;TimeStamp\\\\\\&quot;: \\\\\\&quot;2026-10-12T04:20:47.105Z\\\\\\&quot;\\\\n                }\\\\n            },\\\\n            \\\\\\&quot;PaymentResult\\\\\\&quot;: {\\\\n                \\\\\\&quot;AmountsResp\\\\\\&quot;: {\\\\n                    \\\\\\&quot;AuthorizedAmount\\\\\\&quot;: 25.00,\\\\n                    \\\\\\&quot;Currency\\\\\\&quot;: \\\\\\&quot;USD\\\\\\&quot;\\\\n                },\\\\n                \\\\\\&quot;PaymentType\\\\\\&quot;: \\\\\\&quot;Normal\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;Response\\\\\\&quot;: {\\\\n                \\\\\\&quot;AdditionalResponse\\\\\\&quot;: \\\\\\&quot;posOriginalAmountValue=4500&amp;amp;posAuthAmountValue=2500&amp;amp;healthcareIndicator=true&amp;amp;paymentMethod=visa\\\\\\&quot;,\\\\n                \\\\\\&quot;Result\\\\\\&quot;: \\\\\\&quot;Partial\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;SaleData\\\\\\&quot;: {\\\\n                \\\\\\&quot;SaleTransactionID\\\\\\&quot;: {\\\\n                    \\\\\\&quot;TransactionID\\\\\\&quot;: \\\\\\&quot;6256\\\\\\&quot;,\\\\n                    \\\\\\&quot;TimeStamp\\\\\\&quot;: \\\\\\&quot;2026-10-12T04:20:44.000Z\\\\\\&quot;\\\\n                },\\\\n                \\\\\\&quot;SaleReferenceID\\\\\\&quot;: \\\\\\&quot;Order-FSA-001-1\\\\\\&quot;\\\\n            }\\\\n        }\\\\n    }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;partial_response_1_2&quot;,&quot;relation&quot;:&quot;&quot;},{&quot;title&quot;:&quot;Validation failure&quot;,&quot;content&quot;:&quot;\\n&lt;p&gt;The following example shows a payment declined because its healthcare amounts are invalid.&lt;\/p&gt;\\n&lt;p&gt;This example includes only the relevant fields from &lt;code&gt;AdditionalResponse&lt;\/code&gt;.&lt;\/p&gt;\\n&lt;div data-component-wrapper=\\&quot;code-sample\\&quot;&gt;\\n&lt;code-sample :title=\\&quot;&#039;FSA\/HSA payment response for invalid healthcare amounts&#039;\\&quot; :id=\\&quot;&#039;&#039;\\&quot; :code-data=&#039;[{\\&quot;language\\&quot;:\\&quot;json\\&quot;,\\&quot;tabTitle\\&quot;:\\&quot;\\&quot;,\\&quot;content\\&quot;:\\&quot;{\\\\n    \\\\\\&quot;SaleToPOIResponse\\\\\\&quot;: {\\\\n        \\\\\\&quot;MessageHeader\\\\\\&quot;: {\\\\n            \\\\\\&quot;ProtocolVersion\\\\\\&quot;: \\\\\\&quot;3.0\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageClass\\\\\\&quot;: \\\\\\&quot;Service\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageCategory\\\\\\&quot;: \\\\\\&quot;Payment\\\\\\&quot;,\\\\n            \\\\\\&quot;MessageType\\\\\\&quot;: \\\\\\&quot;Response\\\\\\&quot;,\\\\n            \\\\\\&quot;ServiceID\\\\\\&quot;: \\\\\\&quot;9267\\\\\\&quot;,\\\\n            \\\\\\&quot;SaleID\\\\\\&quot;: \\\\\\&quot;POSSystemID12345\\\\\\&quot;,\\\\n            \\\\\\&quot;POIID\\\\\\&quot;: \\\\\\&quot;S1F2-324688179\\\\\\&quot;\\\\n        },\\\\n        \\\\\\&quot;PaymentResponse\\\\\\&quot;: {\\\\n            \\\\\\&quot;POIData\\\\\\&quot;: {\\\\n                \\\\\\&quot;POIReconciliationID\\\\\\&quot;: \\\\\\&quot;1000\\\\\\&quot;,\\\\n                \\\\\\&quot;POITransactionID\\\\\\&quot;: {\\\\n                    \\\\\\&quot;TransactionID\\\\\\&quot;: \\\\\\&quot;8ha5001614946979001.HTG8QR9PGPPJK8V5\\\\\\&quot;,\\\\n                    \\\\\\&quot;TimeStamp\\\\\\&quot;: \\\\\\&quot;2026-10-12T04:20:47.105Z\\\\\\&quot;\\\\n                }\\\\n            },\\\\n            \\\\\\&quot;PaymentResult\\\\\\&quot;: {\\\\n                \\\\\\&quot;PaymentType\\\\\\&quot;: \\\\\\&quot;Normal\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;Response\\\\\\&quot;: {\\\\n                \\\\\\&quot;AdditionalResponse\\\\\\&quot;: \\\\\\&quot;refusalReason=InvalidFieldWithReason&amp;amp;message=UNKNOWN\\\\\\&quot;,\\\\n                \\\\\\&quot;ErrorCondition\\\\\\&quot;: \\\\\\&quot;Refusal\\\\\\&quot;,\\\\n                \\\\\\&quot;Result\\\\\\&quot;: \\\\\\&quot;Failure\\\\\\&quot;\\\\n            },\\\\n            \\\\\\&quot;SaleData\\\\\\&quot;: {\\\\n                \\\\\\&quot;SaleTransactionID\\\\\\&quot;: {\\\\n                    \\\\\\&quot;TransactionID\\\\\\&quot;: \\\\\\&quot;6256\\\\\\&quot;,\\\\n                    \\\\\\&quot;TimeStamp\\\\\\&quot;: \\\\\\&quot;2026-10-12T04:20:44.000Z\\\\\\&quot;\\\\n                }\\\\n            }\\\\n        }\\\\n    }\\\\n}\\&quot;}]&#039; :enable-copy-link-to-code-block=\\&quot;true\\&quot; :code-sample-card-size=\\&quot;&#039;fullsize&#039;\\&quot;&gt;&lt;\/code-sample&gt;\\n&lt;\/div&gt;\\n&quot;,&quot;altTitle&quot;:null,&quot;oldTabId&quot;:&quot;validation_failure_2_3&quot;,&quot;relation&quot;:&quot;&quot;}]\"\n            :should-update-when-url-changes='false'>\n        <\/tabs>\n    <\/div>\n<\/div>\n\n<\/li>\n<\/ol>\n<h2>Make a follow-up payment for the remaining amount<\/h2>\n<p>You need a follow-up payment in the following cases:<\/p>\n<ul>\n<li><strong>The eligible amount is only partially paid:<\/strong> Collect the remaining eligible amount. Make a <a href=\"#identify-fsa-hsa-cards\">card acquisition request<\/a> to identify the next card, then use an FSA\/HSA or regular payment as appropriate.<\/li>\n<li><strong>The eligible amount is fully paid, but ineligible items remain:<\/strong> Make a regular <a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment\">Terminal API payment request<\/a> for the ineligible items.<\/li>\n<li><strong>Both eligible and ineligible amounts remain:<\/strong> Make separate payments for the remaining eligible amount and the ineligible items.<\/li>\n<\/ul>\n<p>To collect the remaining eligible amount:<\/p>\n<ol>\n<li>\n<p>Calculate the remaining amount by subtracting the <code>PaymentResult.AmountsResp.AuthorizedAmount<\/code> in the partial payment response from the <code>PaymentTransaction.AmountsReq.RequestedAmount<\/code> in your initial payment request. You can also calculate the remaining amount from the <code>posOriginalAmountValue<\/code> and <code>posAuthAmountValue<\/code> keys in <code>AdditionalResponse<\/code>. Both values are in minor units.<\/p>\n<\/li>\n<li>\n<p>Make a new <a href=\"#identify-fsa-hsa-cards\">card acquisition request<\/a> to check whether the card for the remaining eligible amount is an FSA\/HSA card:<\/p>\n<ul>\n<li>If the new card acquisition identifies the card as an FSA\/HSA card, <a href=\"#make-an-fsa-hsa-payment\">make an FSA\/HSA payment<\/a> for the remaining eligible amount. Include each sub-amount that applies to the remaining amount. The partial payment response returns only totals, not the amount authorized for each sub-amount, so your POS app determines the remaining sub-amounts. Their sum must not exceed the new <code>healthcare.totalHealthcareValue<\/code>.<\/li>\n<li>If the new card acquisition does not identify the card as an FSA\/HSA card, go to the next step.<\/li>\n<\/ul>\n<\/li>\n<li>\n<p>Make a regular <a href=\"\/point-of-sale\/basic-tapi-integration\/make-a-payment\">Terminal API payment request<\/a> for the remaining amount, specifying:<\/p>\n<ul>\n<li>\n<p>The standard <a href=\"\/point-of-sale\/design-your-integration\/terminal-api#request-message-header\">\n  <code>SaleToPOIRequest.MessageHeader<\/code>\n<\/a> object, with <code>MessageClass<\/code> set to <span translate=\"no\"><strong>Service<\/strong><\/span> and <code>MessageCategory<\/code> set to <span translate=\"no\"><strong>Payment<\/strong><\/span>.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>ProtocolVersion<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><strong>3.0<\/strong><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageClass<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Service<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageCategory<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Payment<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>MessageType<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\"><span translate=\"no\"><strong>Request<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>ServiceID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (<code>POIID<\/code>) being used.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">Your unique ID for the POS system component to send this request from.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>POIID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The unique ID of the terminal to send this request to. Format: <em>[device model]-[serial number]<\/em>.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<li>\n<p>The  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentRequest<\/a> object with:<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Parameter<\/th>\n<th style=\"text-align: center;\">Required<\/th>\n<th style=\"text-align: left;\">Description<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleTransactionID<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>TransactionID<\/code>: your reference to identify a payment. We recommend a unique value for each payment.<\/li> <li markdown=\"1\"><code>TimeStamp<\/code>: date and time of the request in <a href=\"https:\/\/en.wikipedia.org\/wiki\/ISO_8601#Coordinated_Universal_Time_(UTC)\" target=\"_blank\" rel=\"nofollow noopener noreferrer\" class=\"external-link no-image\">UTC format<\/a>.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleReferenceID<\/code><\/td>\n<td style=\"text-align: center;\"><\/td>\n<td style=\"text-align: left;\">A unique reference that lets you identify payments that belong together, as described in <a href=\"\/point-of-sale\/partial-authorizations\">partial authorization guidance<\/a>. For example, <strong>Order-FSA-001-2<\/strong> links to <strong>Order-FSA-001-1<\/strong>.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>SaleData.SaleToAcquirerData<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">The <code>AllowPartialAuthorisation<\/code> tender option. Do not include healthcare fields for this regular payment.<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>PaymentTransaction.AmountsReq<\/code><\/td>\n<td style=\"text-align: center;\"><img title=\"-white_check_mark-\" alt=\"-white_check_mark-\" class=\"smileys\" src=\"\/user\/data\/smileys\/emoji\/white_check_mark.png\" \/><\/td>\n<td style=\"text-align: left;\">An object with: <ul><li markdown=\"1\"><code>Currency<\/code>: the transaction <a href=\"\/development-resources\/currency-codes\">currency<\/a>.<\/li><li markdown=\"1\"><code>RequestedAmount<\/code>: the remaining amount.<\/li><\/ul><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>PaymentData.CardAcquisitionReference<\/code><\/td>\n<td style=\"text-align: center;\"><div data-component-wrapper=\"tag\">\n    <tag :variant=&quot;warning&quot;>\n        Conditional\n    <\/tag>\n<\/div>\n<\/td>\n<td style=\"text-align: left;\">Required if you performed a new card acquisition. An object with: <ul><li markdown=\"1\"><code>TimeStamp<\/code>: the time stamp returned in the <code>POIData.POITransactionID<\/code> of the new card acquisition response.<\/li> <li markdown=\"1\"><code>TransactionID<\/code>: the transaction ID returned in the <code>POIData.POITransactionID<\/code> of the new card acquisition response.<\/li><\/ul><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/li>\n<\/ul>\n<p>The following example continues the example from <a href=\"#make-an-fsa-hsa-payment\">Make an FSA\/HSA payment<\/a>. The issuer approved USD&nbsp;25.00 of the USD&nbsp;45.00 eligible amount, so the remaining amount is USD&nbsp;20.00.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Follow-up payment for the remaining amount'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"SaleToPOIRequest\\\": {\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"Payment\\\",\\n            \\\"MessageType\\\": \\\"Request\\\",\\n            \\\"ServiceID\\\": \\\"9268\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12345\\\",\\n            \\\"POIID\\\": \\\"S1F2-324688179\\\"\\n        },\\n        \\\"PaymentRequest\\\": {\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"6257\\\",\\n                    \\\"TimeStamp\\\": \\\"2026-10-12T04:22:30.000Z\\\"\\n                },\\n                \\\"SaleReferenceID\\\": \\\"Order-FSA-001-2\\\",\\n                \\\"SaleToAcquirerData\\\": \\\"tenderOption=AllowPartialAuthorisation\\\"\\n            },\\n            \\\"PaymentTransaction\\\": {\\n                \\\"AmountsReq\\\": {\\n                    \\\"Currency\\\": \\\"USD\\\",\\n                    \\\"RequestedAmount\\\": 20.00\\n                }\\n            },\\n            \\\"PaymentData\\\": {\\n                \\\"CardAcquisitionReference\\\": {\\n                    \\\"TransactionID\\\": \\\"8ha5001614946979002\\\",\\n                    \\\"TimeStamp\\\": \\\"2026-10-12T04:22:01.688Z\\\"\\n                }\\n            }\\n        }\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<li>\n<p>Check the  <a href=\"https:\/\/docs.adyen.com\/api-explorer\/terminal-api\/latest\/post\/payment#responses-200\" class=\"codeLabel  external-link no-image\" target=\"_blank\" rel=\"nofollow noopener noreferrer\">PaymentResponse<\/a>. If <code>Response.Result<\/code> is <span translate=\"no\"><strong>Success<\/strong><\/span>, the remaining amount is paid. For other results, follow the <a href=\"\/point-of-sale\/partial-authorizations\">partial authorization guidance<\/a> or <a href=\"\/point-of-sale\/error-scenarios\">Handle responses<\/a>.<\/p>\n<p>The following example shows the response for a follow-up payment that the issuer approved in full.<\/p>\n<div data-component-wrapper=\"code-sample\">\n<code-sample :title=\"'Successful follow-up payment response'\" :id=\"''\" :code-data='[{\"language\":\"json\",\"tabTitle\":\"\",\"content\":\"{\\n    \\\"SaleToPOIResponse\\\": {\\n        \\\"MessageHeader\\\": {\\n            \\\"ProtocolVersion\\\": \\\"3.0\\\",\\n            \\\"MessageClass\\\": \\\"Service\\\",\\n            \\\"MessageCategory\\\": \\\"Payment\\\",\\n            \\\"MessageType\\\": \\\"Response\\\",\\n            \\\"ServiceID\\\": \\\"9268\\\",\\n            \\\"SaleID\\\": \\\"POSSystemID12345\\\",\\n            \\\"POIID\\\": \\\"S1F2-324688179\\\"\\n        },\\n        \\\"PaymentResponse\\\": {\\n            \\\"POIData\\\": {\\n                \\\"POIReconciliationID\\\": \\\"1000\\\",\\n                \\\"POITransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"8ha5001614946979002.VWV9PJVHZR9X2F75\\\",\\n                    \\\"TimeStamp\\\": \\\"2026-10-12T04:22:33.512Z\\\"\\n                }\\n            },\\n            \\\"PaymentResult\\\": {\\n                \\\"AmountsResp\\\": {\\n                    \\\"AuthorizedAmount\\\": 20.00,\\n                    \\\"Currency\\\": \\\"USD\\\"\\n                },\\n                \\\"PaymentType\\\": \\\"Normal\\\"\\n            },\\n            \\\"Response\\\": {\\n                \\\"Result\\\": \\\"Success\\\"\\n            },\\n            \\\"SaleData\\\": {\\n                \\\"SaleTransactionID\\\": {\\n                    \\\"TransactionID\\\": \\\"6257\\\",\\n                    \\\"TimeStamp\\\": \\\"2026-10-12T04:22:30.000Z\\\"\\n                }\\n            }\\n        }\\n    }\\n}\"}]' :enable-copy-link-to-code-block=\"true\" :code-sample-card-size=\"'fullsize'\"><\/code-sample>\n<\/div>\n<\/li>\n<\/ol>\n<h2>Testing<\/h2>\n<p>To verify your integration, test both successful and declined transactions. You can test your FSA\/HSA integration with the following test cards. Both cards are healthcare-eligible.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Card number<\/th>\n<th style=\"text-align: left;\">Card scheme<\/th>\n<th style=\"text-align: left;\">Issuing country\/region<\/th>\n<th style=\"text-align: left;\">Expiry date<\/th>\n<th style=\"text-align: left;\">Card security code<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">4001 2300 0000 0004<\/td>\n<td style=\"text-align: left;\">Visa<\/td>\n<td style=\"text-align: left;\">US<\/td>\n<td style=\"text-align: left;\">12\/2049<\/td>\n<td style=\"text-align: left;\">737<\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">2292 2400 0000 0005<\/td>\n<td style=\"text-align: left;\">Mastercard<\/td>\n<td style=\"text-align: left;\">US<\/td>\n<td style=\"text-align: left;\">12\/2049<\/td>\n<td style=\"text-align: left;\">737<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<p>These card numbers are not available on a physical test card. To use them on a test terminal, enter the card details manually: in your card acquisition request, set <code>CardAcquisitionTransaction.ForceEntryMode<\/code> to <span translate=\"no\"><strong>Keyed<\/strong><\/span>, then enter the card number, expiry date, and security code on the terminal. Manual key entry must be enabled for your test account. See <a href=\"\/point-of-sale\/enter-payment-manually\">Manual Key Entry<\/a>.<\/p>\n<p>Then test the following scenarios.<\/p>\n<ul>\n<li><a href=\"#happy-flow\">Happy flow<\/a>: Successful card acquisitions and payments, including a partial authorization. To trigger a partial authorization in test, use an amount ending in <strong>139<\/strong>. For example, if you send a payment request for USD&nbsp;41.39, the terminal authorizes USD&nbsp;40.39. You then follow up with a <a href=\"#make-a-follow-up-payment-for-the-remaining-amount\">payment for the remaining amount<\/a>, in this case USD&nbsp;1.00.<\/li>\n<li><a href=\"#unhappy-flow\">Unhappy flow<\/a>: Declined and blocked payments.<\/li>\n<\/ul>\n<h3>Happy flow<\/h3>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Scenario<\/th>\n<th style=\"text-align: left;\">Expected result<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Card acquisition with an FSA\/HSA-eligible Visa or Mastercard card<\/td>\n<td style=\"text-align: left;\"><code>healthcareIndicator<\/code> is <span translate=\"no\"><strong>true<\/strong><\/span> in <code>AdditionalResponse<\/code><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Card acquisition with a standard (non-healthcare) card<\/td>\n<td style=\"text-align: left;\"><code>healthcareIndicator<\/code> is absent from <code>AdditionalResponse<\/code><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Payment with <code>healthcare.totalHealthcareValue<\/code> and sub-amounts, within the transaction amount<\/td>\n<td style=\"text-align: left;\"><code>Result<\/code> is <span translate=\"no\"><strong>Success<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Payment with <code>healthcare.totalHealthcareValue<\/code> only, when no sub-amounts apply<\/td>\n<td style=\"text-align: left;\"><code>Result<\/code> is <span translate=\"no\"><strong>Success<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Payment where the FSA\/HSA balance covers only part of <code>healthcare.totalHealthcareValue<\/code><\/td>\n<td style=\"text-align: left;\"><code>Result<\/code> is <span translate=\"no\"><strong>Partial<\/strong><\/span>, and <code>AuthorizedAmount<\/code> is less than <code>RequestedAmount<\/code><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Follow-up payment for the remaining amount, without healthcare fields<\/td>\n<td style=\"text-align: left;\"><code>Result<\/code> is <span translate=\"no\"><strong>Success<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h3>Unhappy flow<\/h3>\n<p>To test how your POS app handles declined and blocked payments, use the following scenarios.<\/p>\n<table>\n<thead>\n<tr>\n<th style=\"text-align: left;\">Scenario<\/th>\n<th style=\"text-align: left;\">Expected result<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td style=\"text-align: left;\">Sum of sub-amounts exceeds <code>healthcare.totalHealthcareValue<\/code><\/td>\n<td style=\"text-align: left;\"><code>Result<\/code> is <span translate=\"no\"><strong>Failure<\/strong><\/span>, <code>ErrorCondition<\/code> is <span translate=\"no\"><strong>Refusal<\/strong><\/span>, and <code>refusalReason<\/code> in the decoded <code>AdditionalResponse<\/code> is <span translate=\"no\"><strong>InvalidFieldWithReason<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\"><code>healthcare.totalHealthcareValue<\/code> exceeds the transaction amount<\/td>\n<td style=\"text-align: left;\"><code>Result<\/code> is <span translate=\"no\"><strong>Failure<\/strong><\/span>, <code>ErrorCondition<\/code> is <span translate=\"no\"><strong>Refusal<\/strong><\/span>, and <code>refusalReason<\/code> in the decoded <code>AdditionalResponse<\/code> is <span translate=\"no\"><strong>InvalidFieldWithReason<\/strong><\/span><\/td>\n<\/tr>\n<tr>\n<td style=\"text-align: left;\">Healthcare payment while the terminal cannot reach Adyen. For example, turn off Wi-Fi and mobile data on the terminal and send the request over a local connection, or turn off your Wi-Fi router after you send the request and before the payment is authorized.<\/td>\n<td style=\"text-align: left;\"><code>Result<\/code> is <span translate=\"no\"><strong>Failure<\/strong><\/span>, <code>ErrorCondition<\/code> is <span translate=\"no\"><strong>UnreachableHost<\/strong><\/span>, and <code>refusalReason<\/code> in the decoded <code>AdditionalResponse<\/code> is <span translate=\"no\"><strong>Failed to go online<\/strong><\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<h2>See also<\/h2>\n<div class=\"see-also-links output-inline\" id=\"see-also\">\n<ul><li><a href=\"\/point-of-sale\/partial-authorizations\"\n                        target=\"_self\"\n                        >\n                    Partial authorizations\n                <\/a><\/li><li><a href=\"\/point-of-sale\/card-acquisition\"\n                        target=\"_self\"\n                        >\n                    Card acquisition\n                <\/a><\/li><li><a href=\"\/point-of-sale\/basic-tapi-integration\/refund-payment\"\n                        target=\"_self\"\n                        >\n                    Refund a payment\n                <\/a><\/li><li><a href=\"\/payment-methods\/cards\/enhanced-scheme-data\/fsa-hsa\"\n                        target=\"_self\"\n                        >\n                    FSA\/HSA payments online\n                <\/a><\/li><\/ul><\/div>\n","url":"https:\/\/docs.adyen.com\/point-of-sale\/alternative-payment-methods\/fsa-hsa-payments","articleFields":{"description":"Accept Flexible Spending Account (FSA) and Health Savings Account (HSA) payments in the US.","feedback_component":true,"filters_component":false,"decision_tree":"[]"},"algolia":{"url":"https:\/\/docs.adyen.com\/point-of-sale\/alternative-payment-methods\/fsa-hsa-payments","title":"FSA\/HSA healthcare payments with IIAS","content":"\nSIG-IS registrationThis page covers the IIAS program. If your business uses Direct Medical Services or the 90% Rule, you do not need this integration. See SIG-IS registration and certification.\n\nIn the US, you can use Adyen payment terminals to accept FSA\/HSA payments for eligible healthcare products if your business is SIG-IS-certified. FSA\/HSA payments are supported for US-issued Visa and Mastercard cards. Your POS app uses an Inventory Information Approval System (IIAS) to identify eligible healthcare products. This page explains how to identify FSA\/HSA cards and make FSA\/HSA payments with a Terminal API integration.\nRequirements\nBefore you begin, take into account the following requirements, limitations, and preparations.\n\n\n\nRequirement\nDescription\n\n\n\n\nIntegration type\nA Terminal API integration with payment terminals using terminal software version 1.136.3 or later.\n\n\nLimitations\nFSA\/HSA payments do not support offline payments, including Store and Forward and offline EMV. See Limitations.\n\n\nSetup steps\nBefore you begin: Register or certify your business with SIG-IS. The program that applies depends on your business type. See SIG-IS registration and certification.Contact your Adyen account manager to enable FSA\/HSA payments on your account.Ensure your integration supports partial authorizations, to be able to process FSA\/HSA payments.\n\n\n\nLimitations and product eligibility\nYour POS app must:\n\nIdentify eligible items by checking your inventory against the SIG-IS Eligible Product List.\nCalculate the eligible and ineligible totals.\nMake separate payments for eligible and ineligible items.\n\nAdyen does not determine product eligibility or calculate these amounts.\nFSA\/HSA payments do not support offline payments. This applies to both Store and Forward and offline EMV. When the terminal cannot reach Adyen's backend, it blocks the transaction instead of saving it for later. For how to handle this, see the Failure result under Make an FSA\/HSA payment.\nPayments that do not include healthcare fields keep the standard offline payment behavior.\nTo refund an FSA\/HSA payment, use the standard refund flows: a referenced refund or an unreferenced refund. Refunds have no FSA\/HSA-specific requirements.\nHow it works\nThe FSA\/HSA payment flow is as follows:\n\nThe shopper presents their card to the payment terminal.\n\nYou make a card acquisition request to identify whether the shopper used an FSA\/HSA card.\nFSA\/HSA is not a separate payment brand. Eligible cards use Visa or Mastercard. A card can be co-badged with a US Debit network, such as STAR, but Adyen processes FSA\/HSA payments only over the Visa or Mastercard network.\nIf any of the card's brands is healthcare-eligible, the response returns healthcareIndicator true. Your POS app does not need to select a brand for FSA\/HSA processing.\n\nThe card acquisition response determines how you continue:\n\nIf the response identifies an FSA\/HSA card, your POS app identifies the eligible items and calculates the eligible and ineligible totals.\nOtherwise, your store staff asks the shopper how to continue. The shopper can continue with a regular payment using the acquired card, or use another card. If the shopper wants to use another card, you cancel the card acquisition.\n\nFor an FSA\/HSA card, you make an FSA\/HSA payment for eligible healthcare items only.\nFrom the payment response you learn the amount approved by the issuer:\n\nIf the issuer approves the full eligible amount, the FSA\/HSA payment is complete.\nIf the shopper's FSA\/HSA account does not have enough funds, it is possible that the issuer still approves part of the eligible amount.\n\nIf the issuer approved only part of the eligible amount, make a follow-up payment to let the shopper pay the remaining amount with another card.\nIf the purchase includes ineligible items, make a separate payment for them using another payment method.\n\nIdentify FSA\/HSA cards\nTo identify an FSA\/HSA card:\n\n\nMake a card acquisition request with:\n\n\nThe standard \n  SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Service and MessageCategory set to CardAcquisition.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nService\n\n\nMessageCategory\n\nCardAcquisition\n\n\nMessageType\n\nRequest\n\n\nServiceID\n\nYour unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.\n\n\nSaleID\n\nYour unique ID for the POS system component to send this request from.\n\n\nPOIID\n\nThe unique ID of the terminal to send this request to. Format: [device model]-[serial number].\n\n\n\n\n\nThe  CardAcquisitionRequest object with:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nSaleData.SaleTransactionID\n\nAn object with: TransactionID: your reference to identify a payment. We recommend a unique value for each payment. TimeStamp: date and time of the request in UTC format.\n\n\nCardAcquisitionTransaction\n\nA required object that can be empty or contain: TotalAmount (optional): the transaction amount. When you do not know the amount yet, you can omit this parameter or specify an initial amount. If you specify an initial amount, provide the final amount later in the payment request.PaymentType (optional): if you intend to continue with a payment, either omit this parameter or specify Normal.\n\n\n\n\n\n\n\n\n\n\nWhen you receive the  CardAcquisitionResponse, save the TimeStamp and TransactionID from POIData.POITransactionID. You will need these details if you continue with a payment request using the acquired card. The Response.AdditionalResponse field contains either form-encoded key-value pairs or a Base64-encoded JSON object. If it is Base64-encoded, decode it to get the JSON object.\n\n\n\n\n\nTo find out whether the card is an FSA\/HSA card, check whether AdditionalResponse contains the healthcareIndicator key to decide on the next step:\n\nIf Result is Success and healthcareIndicator is true, the card is an FSA\/HSA card. Your POS app identifies the eligible items and calculates the eligible amount. Then make an FSA\/HSA payment.\nIf Result is Success and healthcareIndicator is not present, the response does not identify the card as an FSA\/HSA card. The response never returns healthcareIndicator false. A missing key means that the card is not an FSA\/HSA card, or that the terminal cannot reach the backend. You decide whether to continue with a regular payment:\n\nIf the shopper wants to use the acquired card, finish the card acquisition in the regular way with a payment request that includes PaymentData.CardAcquisitionReference but does not include healthcare fields.\nIf the shopper wants to use another card, cancel the card acquisition. Then make a new card acquisition request to identify the new card, and continue based on the response.\n\n\n\n\nMake an FSA\/HSA payment\nTo make an FSA\/HSA payment for eligible items:\n\n\nConfigure your POS app to validate healthcare amounts before you send a payment request. See Healthcare amount rules.\n\n\nMake a Terminal API payment request, specifying:\n\n\nThe standard \n  SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Service and MessageCategory set to Payment.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nService\n\n\nMessageCategory\n\nPayment\n\n\nMessageType\n\nRequest\n\n\nServiceID\n\nYour unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.\n\n\nSaleID\n\nYour unique ID for the POS system component to send this request from.\n\n\nPOIID\n\nThe unique ID of the terminal to send this request to. Format: [device model]-[serial number].\n\n\n\n\n\nThe  PaymentRequest object with:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nSaleData.SaleTransactionID\n\nAn object with: TransactionID: your reference to identify a payment. We recommend a unique value for each payment. TimeStamp: date and time of the request in UTC format.\n\n\nSaleData.SaleReferenceID\n\nA unique reference that lets you identify payments that belong together.\n\n\nSaleData.SaleToAcquirerData\n\nInclude the following parameters: One or more healthcare fields. See the details below.The AllowPartialAuthorisation tender option to allow a partial authorization.\n\n\nPaymentTransaction.AmountsReq\n\nAn object with: Currency: the transaction currency.RequestedAmount: the total for eligible items.\n\n\nPaymentData.CardAcquisitionReference\n\nAn object referring to the card acquisition: TimeStamp: the time stamp returned in the POIData.POITransactionID of the card acquisition response. TransactionID: the transaction ID returned in the POIData.POITransactionID of the card acquisition response.\n\n\n\n\n\nThe healthcare fields in SaleData.SaleToAcquirerData with amounts in minor units, using the currency specified in PaymentTransaction.AmountsReq.Currency:\nEach sub-amount is required when it applies to the eligible items in this payment. This also applies to follow-up payments.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nhealthcare.totalHealthcareValue\n\nThe total FSA\/HSA-eligible amount, in minor units. Must equal PaymentTransaction.AmountsReq.RequestedAmount converted to minor units. For example, 4500 for a RequestedAmount of 45.00 USD.\n\n\nhealthcare.prescriptionValue\n\n    \n        Conditional\n    \n\n\nThe prescription (Rx) sub-amount, in minor units. This amount is included in healthcare.totalHealthcareValue.\n\n\nhealthcare.visionPrescriptionValue\n\n    \n        Conditional\n    \n\n\nThe vision or optical sub-amount, in minor units. This amount is included in healthcare.totalHealthcareValue.\n\n\nhealthcare.dentalValue\n\n    \n        Conditional\n    \n\n\nThe dental sub-amount, in minor units. This amount is included in healthcare.totalHealthcareValue.\n\n\nhealthcare.otherMedicalValue\n\n    \n        Conditional\n    \n\n\nThe eligible medical amount not included in the prescription, vision, or dental sub-amounts, in minor units. This amount is included in healthcare.totalHealthcareValue.\n\n\n\n\n\n\nAdyen validates the healthcare amounts before authorizing the payment, and declines the payment if the amounts are invalid. The following rules apply:\n\nhealthcare.totalHealthcareValue must be greater than 0.\nhealthcare.totalHealthcareValue must not exceed the transaction amount.\nThe sum of the sub-amounts must not exceed healthcare.totalHealthcareValue.\nhealthcare.totalHealthcareValue is required when you include any sub-amount.\n\nYou can pass the SaleToAcquirerData fields in either of the following formats. Both examples specify USD&nbsp;45.00 in eligible healthcare amounts:\n\n\nOption 1: Base64-encoded JSON. Create the following JSON object, encode it to Base64, and use the resulting string as SaleData.SaleToAcquirerData.\n\n\n\n\n\nOption 2: Form-encoded key-value pairs. Use the following string as SaleData.SaleToAcquirerData.\n\n\n\n\n\nFor more information about the formats, see Add information to a payment.\nThe following example uses key-value pairs to send a USD&nbsp;45.00 payment for eligible items. The ineligible items, if any, need a separate payment with another payment method.\n\n\n\n\n\nCheck the  PaymentResponse:\n\nIf Result is Success, the issuer approved the full eligible amount. AuthorizedAmount matches RequestedAmount.\nSuccessful responses do not include healthcare-specific fields in AdditionalResponse.\nIf Result is Partial, the issuer approved only part of the eligible amount:\n\nAlert store staff that the shopper has not paid the full amount. The terminal also shows a warning, but staff can overlook it.\nUse PaymentResult.AmountsResp.AuthorizedAmount to calculate the remaining amount, then make a follow-up payment.\nIf the shopper does not want to make the purchase because they do not want to pay the remaining amount, cancel the authorization to release the hold on the approved amount in the shopper's FSA\/HSA account. To make sure you can cancel before the amount is captured, follow the partial authorization guidance and configure a capture delay.\n\n\nIf Result is Failure, check Response.ErrorCondition:\n\nInvalid healthcare amounts: ErrorCondition is Refusal, and refusalReason in the decoded AdditionalResponse is InvalidFieldWithReason. The response does not say which amount is invalid: message is UNKNOWN. Check the amounts against the healthcare amount rules, and correct them before retrying.\nAdyen unreachable: ErrorCondition is UnreachableHost, and refusalReason in the decoded AdditionalResponse is Failed to go online. The terminal cannot reach Adyen, and FSA\/HSA payments cannot be completed offline. Have your POS app alert staff that an online connection is required, so they can offer another payment method.\nIssuer unavailable: ErrorCondition is Refusal, and refusalReason in the decoded AdditionalResponse is Issuer unavailable. The FSA\/HSA card cannot be used for this payment. Have your POS app alert staff, so they can offer another payment method.\n\nFor other failures, see Handle responses.\n\n\nThe following tabs show response examples for a full approval, a partial approval, and a decline for invalid healthcare amounts.\n\n\n    \n        \n        \n    \n\n\n\n\nMake a follow-up payment for the remaining amount\nYou need a follow-up payment in the following cases:\n\nThe eligible amount is only partially paid: Collect the remaining eligible amount. Make a card acquisition request to identify the next card, then use an FSA\/HSA or regular payment as appropriate.\nThe eligible amount is fully paid, but ineligible items remain: Make a regular Terminal API payment request for the ineligible items.\nBoth eligible and ineligible amounts remain: Make separate payments for the remaining eligible amount and the ineligible items.\n\nTo collect the remaining eligible amount:\n\n\nCalculate the remaining amount by subtracting the PaymentResult.AmountsResp.AuthorizedAmount in the partial payment response from the PaymentTransaction.AmountsReq.RequestedAmount in your initial payment request. You can also calculate the remaining amount from the posOriginalAmountValue and posAuthAmountValue keys in AdditionalResponse. Both values are in minor units.\n\n\nMake a new card acquisition request to check whether the card for the remaining eligible amount is an FSA\/HSA card:\n\nIf the new card acquisition identifies the card as an FSA\/HSA card, make an FSA\/HSA payment for the remaining eligible amount. Include each sub-amount that applies to the remaining amount. The partial payment response returns only totals, not the amount authorized for each sub-amount, so your POS app determines the remaining sub-amounts. Their sum must not exceed the new healthcare.totalHealthcareValue.\nIf the new card acquisition does not identify the card as an FSA\/HSA card, go to the next step.\n\n\n\nMake a regular Terminal API payment request for the remaining amount, specifying:\n\n\nThe standard \n  SaleToPOIRequest.MessageHeader\n object, with MessageClass set to Service and MessageCategory set to Payment.\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nProtocolVersion\n\n3.0\n\n\nMessageClass\n\nService\n\n\nMessageCategory\n\nPayment\n\n\nMessageType\n\nRequest\n\n\nServiceID\n\nYour unique ID for this request, consisting of 1-10 alphanumeric characters. Must be unique within the last 48 hours for the terminal (POIID) being used.\n\n\nSaleID\n\nYour unique ID for the POS system component to send this request from.\n\n\nPOIID\n\nThe unique ID of the terminal to send this request to. Format: [device model]-[serial number].\n\n\n\n\n\nThe  PaymentRequest object with:\n\n\n\nParameter\nRequired\nDescription\n\n\n\n\nSaleData.SaleTransactionID\n\nAn object with: TransactionID: your reference to identify a payment. We recommend a unique value for each payment. TimeStamp: date and time of the request in UTC format.\n\n\nSaleData.SaleReferenceID\n\nA unique reference that lets you identify payments that belong together, as described in partial authorization guidance. For example, Order-FSA-001-2 links to Order-FSA-001-1.\n\n\nSaleData.SaleToAcquirerData\n\nThe AllowPartialAuthorisation tender option. Do not include healthcare fields for this regular payment.\n\n\nPaymentTransaction.AmountsReq\n\nAn object with: Currency: the transaction currency.RequestedAmount: the remaining amount.\n\n\nPaymentData.CardAcquisitionReference\n\n    \n        Conditional\n    \n\n\nRequired if you performed a new card acquisition. An object with: TimeStamp: the time stamp returned in the POIData.POITransactionID of the new card acquisition response. TransactionID: the transaction ID returned in the POIData.POITransactionID of the new card acquisition response.\n\n\n\n\n\nThe following example continues the example from Make an FSA\/HSA payment. The issuer approved USD&nbsp;25.00 of the USD&nbsp;45.00 eligible amount, so the remaining amount is USD&nbsp;20.00.\n\n\n\n\n\nCheck the  PaymentResponse. If Response.Result is Success, the remaining amount is paid. For other results, follow the partial authorization guidance or Handle responses.\nThe following example shows the response for a follow-up payment that the issuer approved in full.\n\n\n\n\n\nTesting\nTo verify your integration, test both successful and declined transactions. You can test your FSA\/HSA integration with the following test cards. Both cards are healthcare-eligible.\n\n\n\nCard number\nCard scheme\nIssuing country\/region\nExpiry date\nCard security code\n\n\n\n\n4001 2300 0000 0004\nVisa\nUS\n12\/2049\n737\n\n\n2292 2400 0000 0005\nMastercard\nUS\n12\/2049\n737\n\n\n\nThese card numbers are not available on a physical test card. To use them on a test terminal, enter the card details manually: in your card acquisition request, set CardAcquisitionTransaction.ForceEntryMode to Keyed, then enter the card number, expiry date, and security code on the terminal. Manual key entry must be enabled for your test account. See Manual Key Entry.\nThen test the following scenarios.\n\nHappy flow: Successful card acquisitions and payments, including a partial authorization. To trigger a partial authorization in test, use an amount ending in 139. For example, if you send a payment request for USD&nbsp;41.39, the terminal authorizes USD&nbsp;40.39. You then follow up with a payment for the remaining amount, in this case USD&nbsp;1.00.\nUnhappy flow: Declined and blocked payments.\n\nHappy flow\n\n\n\nScenario\nExpected result\n\n\n\n\nCard acquisition with an FSA\/HSA-eligible Visa or Mastercard card\nhealthcareIndicator is true in AdditionalResponse\n\n\nCard acquisition with a standard (non-healthcare) card\nhealthcareIndicator is absent from AdditionalResponse\n\n\nPayment with healthcare.totalHealthcareValue and sub-amounts, within the transaction amount\nResult is Success\n\n\nPayment with healthcare.totalHealthcareValue only, when no sub-amounts apply\nResult is Success\n\n\nPayment where the FSA\/HSA balance covers only part of healthcare.totalHealthcareValue\nResult is Partial, and AuthorizedAmount is less than RequestedAmount\n\n\nFollow-up payment for the remaining amount, without healthcare fields\nResult is Success\n\n\n\nUnhappy flow\nTo test how your POS app handles declined and blocked payments, use the following scenarios.\n\n\n\nScenario\nExpected result\n\n\n\n\nSum of sub-amounts exceeds healthcare.totalHealthcareValue\nResult is Failure, ErrorCondition is Refusal, and refusalReason in the decoded AdditionalResponse is InvalidFieldWithReason\n\n\nhealthcare.totalHealthcareValue exceeds the transaction amount\nResult is Failure, ErrorCondition is Refusal, and refusalReason in the decoded AdditionalResponse is InvalidFieldWithReason\n\n\nHealthcare payment while the terminal cannot reach Adyen. For example, turn off Wi-Fi and mobile data on the terminal and send the request over a local connection, or turn off your Wi-Fi router after you send the request and before the payment is authorized.\nResult is Failure, ErrorCondition is UnreachableHost, and refusalReason in the decoded AdditionalResponse is Failed to go online\n\n\n\nSee also\n\n\n                    Partial authorizations\n                \n                    Card acquisition\n                \n                    Refund a payment\n                \n                    FSA\/HSA payments online\n                \n","type":"page","locale":"en","boost":17,"hierarchy":{"lvl0":"Home","lvl1":"In-person payments","lvl2":"Alternative payment methods","lvl3":"FSA\/HSA healthcare payments with IIAS"},"hierarchy_url":{"lvl0":"https:\/\/docs.adyen.com\/","lvl1":"https:\/\/docs.adyen.com\/point-of-sale","lvl2":"https:\/\/docs.adyen.com\/point-of-sale\/alternative-payment-methods","lvl3":"\/point-of-sale\/alternative-payment-methods\/fsa-hsa-payments"},"levels":4,"category":"In-person payments","category_color":"green","tags":["FSA\/HSA","healthcare","payments"]}}
