Healthcare

Healthcare options are available for Converge terminals in the healthcare sector.

Healthcare options are enabled as part of terminal set up. If you would like to enable healthcare options for your site, please contact Support.

Supported Transaction Types

Healthcare options are available for the following transaction types.

Credit Card
Credit Card Sale - ccsale
Credit Card Auth Only - ccauthonly

Healthcare Fields

Healthcare transactions involve the following fields. These fields are only available for terminals with healthcare enabled.

ssl_healthcare_amount
11 | numeric | optional
Healthcare Amount
Total amount in a healthcare transaction. ssl_healthcare_amount is equal to ssl_otc_amount + ssl_prescription_amount + ssl_clinic_other_amount + ssl_dental_amount. If this amount is not included in the transaction, then Converge will calculate based off of the other healthcare fields. If you do include this field in the transaction, then Converge will validate the field. If the validation fails, Converge will decline the transaction
ssl_otc_amount
11 | numeric | optional
Over the Counter Amount
Amount of over the counter medical expenditures. Defaults to 0.00 if not sent.
ssl_prescription_amount
11 | numeric | optional
Prescription Amount
Amount of prescription drug expenditures. Defaults to 0.00 if not sent.
ssl_clinic_other_amount
11 | numeric | optional
Clinic/Other Amount
Amount of expenditures for clinic or other medical office services. Defaults to 0.00 if not sent.
ssl_dental_amount
11 | numeric | optional
Dental Amount
Amount of dental expenditures. Defaults to 0.00 if not sent.
ssl_vision_amount
11 | numeric | optional
Vision Amount
Amount of vision expenditures. Defaults to 0.00 if not sent.
ssl_transit_amount
11 | numeric | optional
Transit Amount

Amount of transit expenditures. Defaults to 0.00 if not sent.

Requests that include Transit Amount must be sent separately from healthcare transactions that include other healthcare amount fields.

Example Request

Let's look at an example scenario for a credit card purchase using Healthcare options.

Request

<txn>
  <ssl_merchant_id>000006</ssl_merchant_id>
  <ssl_user_id>user</ssl_user_id>
  <ssl_pin>GTK8GT</ssl_pin>
  <ssl_transaction_type>CCSALE</ssl_transaction_type>
  <ssl_card_number>4000000000000002</ssl_card_number>
  <ssl_exp_date>1222</ssl_exp_date>
  <ssl_amount>100.00</ssl_amount>
  <ssl_cvv2cvc2_indicator>1</ssl_cvv2cvc2_indicator>
  <ssl_cvv2cvc2>123</ssl_cvv2cvc2>
  <ssl_healthcare_amount>32.00</ssl_healthcare_amount>
  <ssl_prescription_amount>10.00</ssl_prescription_amount>
  <ssl_vision_amount>0.00</ssl_vision_amount>
  <ssl_clinic_other_amount>6.00</ssl_clinic_other_amount>
  <ssl_dental_amount>7.00</ssl_dental_amount>
  <ssl_transit_amount>0.00</ssl_transit_amount>
  <ssl_otc_amount>9.00</ssl_otc_amount>
</txn>

Response

<txn>
  <ssl_issuer_response>00</ssl_issuer_response>
  <ssl_prescription_amount>10.00</ssl_prescription_amount>
  <ssl_card_number>40**********0002</ssl_card_number>
  <ssl_oar_data>010013252602242023060000047730000000000000033759005520132526</ssl_oar_data>
  <ssl_result>0</ssl_result>
  <ssl_txn_id>240220MB-3833177F-27E8-4B57-AC9E-ED436D93C5D1</ssl_txn_id>
  <ssl_avs_response> </ssl_avs_response>
  <ssl_otc_amount>9.00</ssl_otc_amount>
  <ssl_approval_code>033759</ssl_approval_code>
  <ssl_healthcare_amount>32.00</ssl_healthcare_amount>
  <ssl_dental_amount>7.00</ssl_dental_amount>
  <ssl_amount>100.00</ssl_amount>
  <ssl_txn_time>02/24/2020 03:23:06 PM</ssl_txn_time>
  <ssl_exp_date>1222</ssl_exp_date>
  <ssl_card_short_description>VISA</ssl_card_short_description>
  <ssl_card_type>CREDITCARD</ssl_card_type>
  <ssl_clinic_other_amount>6.00</ssl_clinic_other_amount>
  <ssl_transaction_type>SALE</ssl_transaction_type>
  <ssl_transit_amount>0.00</ssl_transit_amount>
  <ssl_account_balance>0.00</ssl_account_balance>
  <ssl_ps2000_data>A0200224152307275031VE</ssl_ps2000_data>
  <ssl_vision_amount>0.00</ssl_vision_amount>
  <ssl_result_message>APPROVAL</ssl_result_message>
  <ssl_cvv2_response>M</ssl_cvv2_response>
  <ssl_partner_app_id>VM</ssl_partner_app_id>
</txn>

Transit Only Transaction

Make requests that include ssl_transit_amount separately from other healthcare amount fields. Requests that include ssl_transit_amount with ssl_otc_amount, ssl_prescription_amount, ssl_clinic_other_amount, ssl_dental_amount, ssl_vision_amount. Transit amount does not add to the total amount calculated for ssl_healthcare_amount.

Request

<txn>
  <ssl_merchant_id>000006</ssl_merchant_id>
  <ssl_user_id>user</ssl_user_id>
  <ssl_pin>GTK8GT</ssl_pin>
  <ssl_transaction_type>CCSALE</ssl_transaction_type>
  <ssl_card_number>4000000000000002</ssl_card_number>
  <ssl_exp_date>1222</ssl_exp_date>
  <ssl_amount>10.00</ssl_amount>
  <ssl_cvv2cvc2_indicator>1</ssl_cvv2cvc2_indicator>
  <ssl_cvv2cvc2>123</ssl_cvv2cvc2>
  <ssl_healthcare_amount>0.00</ssl_healthcare_amount>
  <ssl_transit_amount>10.00</ssl_transit_amount>
</txn>

Response

<txn>
  <ssl_issuer_response>00</ssl_issuer_response>
  <ssl_card_number>40**********0002</ssl_card_number>
  <ssl_oar_data>010013252602242023060000047730000000000000033759005520132526</ssl_oar_data>
  <ssl_result>0</ssl_result>
  <ssl_txn_id>240220MB-3833177F-27E8-4B57-AC9E-ED436D93C5D1</ssl_txn_id>
  <ssl_avs_response> </ssl_avs_response>
  <ssl_approval_code>033759</ssl_approval_code>
  <ssl_healthcare_amount>0.00</ssl_healthcare_amount>
  <ssl_amount>100.00</ssl_amount>
  <ssl_txn_time>02/24/2020 03:23:06 PM</ssl_txn_time>
  <ssl_exp_date>1222</ssl_exp_date>
  <ssl_card_short_description>VISA</ssl_card_short_description>
  <ssl_card_type>CREDITCARD</ssl_card_type>
  <ssl_transaction_type>SALE</ssl_transaction_type>
  <ssl_transit_amount>10.00</ssl_transit_amount>
  <ssl_account_balance>0.00</ssl_account_balance>
  <ssl_ps2000_data>A0200224152307275031VE</ssl_ps2000_data>
  <ssl_result_message>APPROVAL</ssl_result_message>
  <ssl_cvv2_response>M</ssl_cvv2_response>
  <ssl_partner_app_id>VM</ssl_partner_app_id>
</txn>