FSA & HSA Command Line integration

Overview

This section will walk you through how you can process Flexible Spending Account (FSA) and Health Reimbursement Account (HRA) cards. The POS \ IIAS is responsible for tracking FSA and non-FSA eligible items and providing Gravity Payments with subtotals for each. Partial Approvals must be supported to process FSA \ HRA transactions, the AmountTotal field may vary based on partial approvals.

FSA/ HRA workflow

Multiple types of items may be purchased at one time, with some items being FSA eligible while others may not be FSA eligible.

  • If a customer uses a non-FSA card (regular credit or debit card) for payment the entire transaction amount (AmountTotal) will be charged to the non-FSA card.
  • If a customer uses a FSA card AND the transaction includes only FSA eligible items, the entire amount (AmountTotal) is charged to the FSA card.
  • If a customer uses a FSA card but the transaction includes only some FSA eligible items, only the HealthCareAmount will be charged as a partial approval. Check the AmountTotal field in the output file for the actual amount charged. The POS will need to prompt the customer\cashier for another form of payment for the remaining balance. If needed, the POS can start another credit or debit card transaction.

FSA/ HRA Transaction fields

ExampleName
-ga:21.00HealthCareAmount
-gb:1.00RxAmount
-gc:2.00 ClinicalAmount
-gd:3.00DentalAmount
-ge:4.00VisionAmount
-gf:5.00CopayAmount

Be advised

AmountTotal -be: is the grand total of sale including all FSA eligible amounts (HealthCareAmount), non-FSA eligible amounts, taxes etc.

HealthCareAmount is the sum of:

  • RxAmount
  • ClinicalAmount
  • DentalAmount
  • VisionAmount
  • CopayAmount
  • plus any uncategorized FSA eligible amount

In the table above, HealthCareAmount includes an uncategorized FSA amount of $6.00

The POS has the option of including all FSA amounts in HealthCareAmount if it does not break FSA amounts down into Rx, Clinical, Dental, Vision, Copay as allowed by SIGIS.

Setup guide

The POS application should add a button to run this command in its own system-specific configuration.

"C:\ChargeItPro\CIPCMD\CIPCMD.exe" -aa:"C:\ChargeItPro\CIPCMD\CIPSetup.xml" -ab:setup

Setup tips

  • This is generally only run once unless the merchant needs to change settings for devices or other preferences
  • The path and name of the file where the settings are stored is determined by the POS.
  • This allows the POS to support multiple merchant accounts at run time.

Test account

On the setup screen:

  1. Click on Quick Setup, enter fsatest01 in the Config Key field
  2. Click Download Settings
  3. Click Save

This will store the merchant’s settings in the file specified in the -aa parameter. The -aa parameter will be used later to reference the merchant’s settings.

These test credentials include a credit card terminal emulator for testing. The emulator’s settings can be accessed by running setup again and going to Detailed Setup -> Configure Devices -> PINPadEmulator. Options range from turning off the emulator completely to disabling signature capture.

 

Need a Test Account?

Please contact us to create a private test account by calling 1-800-989-2135 or email developersupport@gravitypayments.com.

Sample transactions

"C:\ChargeItPro\CIPCMD\CIPCMD.exe"^
 -aa:"C:\ChargeItPro\CIPCMD\CIPSetup.xml"^
 -ac:"C:\ChargeItPro\CIPCMD\cipout-AAA1.txt"^
 -ab:CreditSale^
 -ad:TXT^
 -be:20.00^
 -bj:"CashierName"^
 -br:"010003905"^
 -bg:111 Test St.^
 -bh:"20916"^
 -ga:20.00^
 -gb:2.00^
 -gc:3.00^
 -gd:4.00^
 -ge:5.00^
 -gf:6.00^
 -fa:true
"C:\ChargeItPro\CIPCMD\CIPCMD.exe"^
 -aa:"C:\ChargeItPro\CIPCMD\CIPSetup.xml"^
 -ac:"C:\ChargeItPro\CIPCMD\cipout-AAA1.txt"^
 -ab:CreditReturn^
 -ad:TXT^
 -be:20.00^
 -bj:"CashierName"^
 -br:"010003905"^
 -bg:111 Test St.^
 -bh:"20916"^
 -ga:20.00^
 -gb:2.00^
 -gc:3.00^
 -gd:4.00^
 -ge:5.00^
 -gf:6.00^
 -fa:true

Sample output files

  • Check the AmountTotal field for the actual amount processed in case the transaction was partially approved.
  • Check the TransactionType field to see if the transaction was processed as a FSA \ HRA transaction (FsaCreditSale) vs a regular transaction (CreditSale)

TXT format

- Note1: 
 - Note2: 
 - TransactionReference: 010003905
 - Cashier: CashierName
 - AmountTotal: 20
 - CustomerRef: 
 - PaymentID: 
 - AccountCardType: VS
 - AccountHash: 
 - AmountBalance: 0
 - AmountBill: 0
 - AmountFee: 0
 - ApprovalNumberResult: T000004
 - AVSResponseCode: 
 - AVSResponseText: 
 - BillingName: JOHN Q PUBLIC
 - CVVResponseCode: 
 - CVVResponseText: 
 - MaskedAccount: ************9016
 - ResultMessage: APPROVED
 - ResultStatus: True
 - Signature:
TUFJUDpNVTB5VERKTk0wdzBURFJMTkVvMFNUVkpOVWcwU0RSSE0wY3lSek5HTWtZeVJURkZNRVV3UkM5RUxrTXJSUC8vS2tFc1B5cytLandxT3lnNktEa21OeVUySkRRak15SXhJVEFnTHg4dEhpd2RLeDBxSENrY0tCc29IQ2dkS0I0b0h5Z2dLQ0VwSWlraktTUXFKU29tS3lnc0tTd3FMaXN1TEM4dE1DOHhNRE14TkRJMk1qY3pPVFE2TlR3MVBqWkJOa00zUlRkSU4wbzJUVFpQTlZJMVZEUlhNMWt6WERGZk1XRXdZeTVtTFdjbmFpbHNLVzBuYmlSdkkyOGlieUZ2SVc0Z2JpQnRIMndmYXlCcUlHZ2haeUpsSW1RaVlpTmhKRjhsWGlaY0psc29XaWxZSzFZdFZDNVRMMU14VWpKUU0wODBUalpPTjAwNVRUcE5PMDA4VFQxTlAwMUFUVUZNUVUxQ1RFTk1SRXhGUzBaTFIwdElTMGhLUjBwR1NrVktSRXBEU2tOTFFrdEJTMEZNUVUxQVRVQk9QMUEvVVQ5U1AxTkFWRUJWUVZWQlZrSldRMVpFVmtWVlJsVkdWRWRVU0ZOSlUwbFNTbEpLVVV0UlNsQktUMHBPUzA1TFRVeE1TMHhNVEV0TVNreEpURWhNU0UxSVRFZE1TRXhKVEVsTlNFMUhUVVpPUkUvLy8wazdTanRMTzBzNlREcE5PMDQ3VHp4UVBGQTlVRDVSUDFGQVVrSlNRMU5FVTBaVFNGUktWRXRVVEZST1ZFOVVVVlJTVkZOVFZGTlZVbFpUVjFKWVVsbFNXRkpYVWxaU1ZWTlZVMVJUVTFSVFZGSlZVVlZRVms5WFRsaE5XVTFiVEZ4TFhVcGVTbDlKWUVsaFNXSkpZMHBrU21WS1prdG5TMmRNYUV4b1RXaE9hRTlvVUdkU1oxTm5WR2RWWmxabVYyVlhaVmhrV0dSWlkxbGtXV1JZWlZkbFZtWlZaCmxSblZHZFRhRkpwVVdsUWFrOXBUMmhQYUU1c1RXMU5iMDF3VFhGTmMwMTFUblpQZDFGM1VuaFRlRlY0Vm5sWWVWbDVXbmxiZVZwNVdYcFllMWQ4Vm4xV2YxYUJWWUpWZzFXRlZvWldoMWFJVm9sWGlsZU1WNHhZalZpT1dJOVlrVmlQV0k1WWpWaUpXSVJZLy8rSFFJMUIvLytKUWYvL2hVTC8vNUZDbVVHZVFaOUFva0QvLzZKQW5VQ29QNm8vclQ2dVBiQThyanl1TzdBN3J6di8vNjQ1Ly8rc09MTTJzamExTmJZMHRUUzJNN1F6dGpLMU1yUXlzak95TXJJenNUT3ZNNjAwckRTdE5hNDFyemF1TjY0NXJ6cXZQSzQ5ckVDc1FxeEZyVWlyU3F0TnFsQ3JVNnhVcTFlbldLZGFvbHVkWFo1ZG4xNmZYWlZlLy8rV1habGRtVnlZWEpkY2xseVVYSlJibFZxVldabFhtMWFkVlp4Vm5WV2ZWS0ZVbzFPbVU2ZFRxRk9wVTZ4VHJWT3ZVN0JTc1ZPMFVyVlN0bEs2VWIxUXZGQzdVTUZPdzA3RVRjVk54a3pIVE1oTHlrckxTc3hKelVuTlNNNUh6MGZQUnRCRzBFWFBSTTFFeTBUS1JNbEV5RVhIUmNaR3hVZkVSOFJJdzBuQ1NzRkx2MHk5VGJGUXVGRzhVYjVSdjFHL1VzQlN3RkhCVWNOUXgwL0lUc3BOeTAzTlRNNU0wVXZUU3RWSzFVblhTZGxJMmtmYlI5dEcyMFhjUk4xRTNVUGVRdDVCM1VIZVFkOUIza0hmUWQ1QjNrTGZRdDVDMzBMZVE5NUUzVVhiUnQxSDNramVTZDVLM1V2YlROdE8zRTdjVU5wUjNGSGRVdDVUM2xUZ1UrSlM0MUxsVWVOUTQwL25UdWxONmt6b1MrdEs3RXJ0U2U1STdVanJTUC8vM0RMYk10b3oyalRZTk5NMi8vOD0=

 - TransactionType: FsaCreditSale
 - UniqueTransID: 54e52e3a9278ca11405040f5
 - AccountEntryMethod: Swiped
 - AccountExpiryDate: 0515
 - CardNickname:

TAB format

010003905 CashierName 20 VS 0 0 0 T000006 JOHN Q PUBLIC ****9016 APPROVED True TUFJUDpNVTB5VERKTk0wdzBURFJMTkVvMFNUVkpOVWcwU0RSSE0wY3lSek5HTWtZeVJURkZNRVV3UkM5RUxrTXJSUC8vS2tFc1B5cytLandxT3lnNktEa21OeVUySkRRak15SXhJVEFnTHg4dEhpd2RLeDBxSENrY0tCc29IQ2dkS0I0b0h5Z2dLQ0VwSWlraktTUXFKU29tS3lnc0tTd3FMaXN1TEM4dE1DOHhNRE14TkRJMk1qY3pPVFE2TlR3MVBqWkJOa00zUlRkSU4wbzJUVFpQTlZJMVZEUlhNMWt6WERGZk1XRXdZeTVtTFdjbmFpbHNLVzBuYmlSdkkyOGlieUZ2SVc0Z2JpQnRIMndmYXlCcUlHZ2haeUpsSW1RaVlpTmhKRjhsWGlaY0psc29XaWxZSzFZdFZDNVRMMU14VWpKUU0wODBUalpPTjAwNVRUcE5PMDA4VFQxTlAwMUFUVUZNUVUxQ1RFTk1SRXhGUzBaTFIwdElTMGhLUjBwR1NrVktSRXBEU2tOTFFrdEJTMEZNUVUxQVRVQk9QMUEvVVQ5U1AxTkFWRUJWUVZWQlZrSldRMVpFVmtWVlJsVkdWRWRVU0ZOSlUwbFNTbEpLVVV0UlNsQktUMHBPUzA1TFRVeE1TMHhNVEV0TVNreEpURWhNU0UxSVRFZE1TRXhKVEVsTlNFMUhUVVpPUkUvLy8wazdTanRMTzBzNlREcE5PMDQ3VHp4UVBGQTlVRDVSUDFGQVVrSlNRMU5FVTBaVFNGUktWRXRVVEZST1ZFOVVVVlJTVkZOVFZGTlZVbFpUVjFKWVVsbFNXRkpYVWxaU1ZWTlZVMVJUVTFSVFZGSlZVVlZRVms5WFRsaE5XVTFiVEZ4TFhVcGVTbDlKWUVsaFNXSkpZMHBrU21WS1prdG5TMmRNYUV4b1RXaE9hRTlvVUdkU1oxTm5WR2RWWmxabVYyVlhaVmhrV0dSWlkxbGtXV1JZWlZkbFZtWlZaCmxSblZHZFRhRkpwVVdsUWFrOXBUMmhQYUU1c1RXMU5iMDF3VFhGTmMwMTFUblpQZDFGM1VuaFRlRlY0Vm5sWWVWbDVXbmxiZVZwNVdYcFllMWQ4Vm4xV2YxYUJWWUpWZzFXRlZvWldoMWFJVm9sWGlsZU1WNHhZalZpT1dJOVlrVmlQV0k1WWpWaUpXSVJZLy8rSFFJMUIvLytKUWYvL2hVTC8vNUZDbVVHZVFaOUFva0QvLzZKQW5VQ29QNm8vclQ2dVBiQThyanl1TzdBN3J6di8vNjQ1Ly8rc09MTTJzamExTmJZMHRUUzJNN1F6dGpLMU1yUXlzak95TXJJenNUT3ZNNjAwckRTdE5hNDFyemF1TjY0NXJ6cXZQSzQ5ckVDc1FxeEZyVWlyU3F0TnFsQ3JVNnhVcTFlbldLZGFvbHVkWFo1ZG4xNmZYWlZlLy8rV1habGRtVnlZWEpkY2xseVVYSlJibFZxVldabFhtMWFkVlp4Vm5WV2ZWS0ZVbzFPbVU2ZFRxRk9wVTZ4VHJWT3ZVN0JTc1ZPMFVyVlN0bEs2VWIxUXZGQzdVTUZPdzA3RVRjVk54a3pIVE1oTHlrckxTc3hKelVuTlNNNUh6MGZQUnRCRzBFWFBSTTFFeTBUS1JNbEV5RVhIUmNaR3hVZkVSOFJJdzBuQ1NzRkx2MHk5VGJGUXVGRzhVYjVSdjFHL1VzQlN3RkhCVWNOUXgwL0lUc3BOeTAzTlRNNU0wVXZUU3RWSzFVblhTZGxJMmtmYlI5dEcyMFhjUk4xRTNVUGVRdDVCM1VIZVFkOUIza0hmUWQ1QjNrTGZRdDVDMzBMZVE5NUUzVVhiUnQxSDNramVTZDVLM1V2YlROdE8zRTdjVU5wUjNGSGRVdDVUM2xUZ1UrSlM0MUxsVWVOUTQwL25UdWxONmt6b1MrdEs3RXJ0U2U1STdVanJTUC8vM0RMYk10b3oyalRZTk5NMi8vOD0= FsaCreditSale 54e52f2e9278ca11405040f7 Swiped 0515

CSV format

,,010003905,CashierName,20,,,VS,,0,0,0,T000005,,,JOHN Q PUBLIC,,,****9016,APPROVED,True,TUFJUDpNVTB5VERKTk0wdzBURFJMTkVvMFNUVkpOVWcwU0RSSE0wY3lSek5HTWtZeVJURkZNRVV3UkM5RUxrTXJSUC8vS2tFc1B5cytLandxT3lnNktEa21OeVUySkRRak15SXhJVEFnTHg4dEhpd2RLeDBxSENrY0tCc29IQ2dkS0I0b0h5Z2dLQ0VwSWlraktTUXFKU29tS3lnc0tTd3FMaXN1TEM4dE1DOHhNRE14TkRJMk1qY3pPVFE2TlR3MVBqWkJOa00zUlRkSU4wbzJUVFpQTlZJMVZEUlhNMWt6WERGZk1XRXdZeTVtTFdjbmFpbHNLVzBuYmlSdkkyOGlieUZ2SVc0Z2JpQnRIMndmYXlCcUlHZ2haeUpsSW1RaVlpTmhKRjhsWGlaY0psc29XaWxZSzFZdFZDNVRMMU14VWpKUU0wODBUalpPTjAwNVRUcE5PMDA4VFQxTlAwMUFUVUZNUVUxQ1RFTk1SRXhGUzBaTFIwdElTMGhLUjBwR1NrVktSRXBEU2tOTFFrdEJTMEZNUVUxQVRVQk9QMUEvVVQ5U1AxTkFWRUJWUVZWQlZrSldRMVpFVmtWVlJsVkdWRWRVU0ZOSlUwbFNTbEpLVVV0UlNsQktUMHBPUzA1TFRVeE1TMHhNVEV0TVNreEpURWhNU0UxSVRFZE1TRXhKVEVsTlNFMUhUVVpPUkUvLy8wazdTanRMTzBzNlREcE5PMDQ3VHp4UVBGQTlVRDVSUDFGQVVrSlNRMU5FVTBaVFNGUktWRXRVVEZST1ZFOVVVVlJTVkZOVFZGTlZVbFpUVjFKWVVsbFNXRkpYVWxaU1ZWTlZVMVJUVTFSVFZGSlZVVlZRVms5WFRsaE5XVTFiVEZ4TFhVcGVTbDlKWUVsaFNXSkpZMHBrU21WS1prdG5TMmRNYUV4b1RXaE9hRTlvVUdkU1oxTm5WR2RWWmxabVYyVlhaVmhrV0dSWlkxbGtXV1JZWlZkbFZtWlZaCmxSblZHZFRhRkpwVVdsUWFrOXBUMmhQYUU1c1RXMU5iMDF3VFhGTmMwMTFUblpQZDFGM1VuaFRlRlY0Vm5sWWVWbDVXbmxiZVZwNVdYcFllMWQ4Vm4xV2YxYUJWWUpWZzFXRlZvWldoMWFJVm9sWGlsZU1WNHhZalZpT1dJOVlrVmlQV0k1WWpWaUpXSVJZLy8rSFFJMUIvLytKUWYvL2hVTC8vNUZDbVVHZVFaOUFva0QvLzZKQW5VQ29QNm8vclQ2dVBiQThyanl1TzdBN3J6di8vNjQ1Ly8rc09MTTJzamExTmJZMHRUUzJNN1F6dGpLMU1yUXlzak95TXJJenNUT3ZNNjAwckRTdE5hNDFyemF1TjY0NXJ6cXZQSzQ5ckVDc1FxeEZyVWlyU3F0TnFsQ3JVNnhVcTFlbldLZGFvbHVkWFo1ZG4xNmZYWlZlLy8rV1habGRtVnlZWEpkY2xseVVYSlJibFZxVldabFhtMWFkVlp4Vm5WV2ZWS0ZVbzFPbVU2ZFRxRk9wVTZ4VHJWT3ZVN0JTc1ZPMFVyVlN0bEs2VWIxUXZGQzdVTUZPdzA3RVRjVk54a3pIVE1oTHlrckxTc3hKelVuTlNNNUh6MGZQUnRCRzBFWFBSTTFFeTBUS1JNbEV5RVhIUmNaR3hVZkVSOFJJdzBuQ1NzRkx2MHk5VGJGUXVGRzhVYjVSdjFHL1VzQlN3RkhCVWNOUXgwL0lUc3BOeTAzTlRNNU0wVXZUU3RWSzFVblhTZGxJMmtmYlI5dEcyMFhjUk4xRTNVUGVRdDVCM1VIZVFkOUIza0hmUWQ1QjNrTGZRdDVDMzBMZVE5NUUzVVhiUnQxSDNramVTZDVLM1V2YlROdE8zRTdjVU5wUjNGSGRVdDVUM2xUZ1UrSlM0MUxsVWVOUTQwL25UdWxONmt6b1MrdEs3RXJ0U2U1STdVanJTUC8vM0RMYk10b3oyalRZTk5NMi8vOD0=,FsaCreditSale,54e52edb9278ca11405040f6,Swiped,0515,,

Result fields

You can find the result fields in our Index.

Storing user signature

Review our documentation on storing user signatures.

Receipts

AccountCardType
AmountTotal
AmountBalance
ApprovalNumberResult
BillingName
MaskedAccount
TransactionType
Signature (if supporting signature capture)
Space for customer to sign
Agreement Blurb:
I AGREE TO PAY THE ABOVE
TOTAL AMOUNT ACCORDING
TO CARD ISSUER AGREEMENT

Receipt guidelines

Review our documentation on Receipt Requirements.

Test cards

Any combination of address, zip code, or CVV number may be used with the test cards below:

4264280001234559 EXP 12/24
5424180001234514 EXP 12/24

Test amounts

You must set AmountTotal to initialize the transaction and you must check AmountTotal after the transaction is completed to validate the actual amount processed.

AmountTotalFSA Eligible AmountActual Amount Processed
295.49295.4995.49
295.47295.4795.47
76.6976.690
153.38153.380
50.0250.0250.02
491.04491.04491.04
30.0130.0120.01

Partial Approvals based on available FSA funds

In some instances, there will be less FSA funds available than the total amount requested for processing. A partial approval amount will be returned to reflect the total FSA amount available on the particular FSA account.The -fa: parameter must be set to True to allow for partial approvals.

What does the ^ do in the examples on this page?

Note that the ^ (caret) symbol is an escape character within cmd.exe. Using it here allows us to span a single command with parameters across multiple lines, making our documentation easier to read.

For example, xcopy file1.txt file2.txt

…can be written as:

xcopy^
 file1.txt^
 file2.txt