Service Fees

Converge is able to associate either a service fee with any credit card. Converge can use service fees to charge the transaction amount and service fee amount separately. The payment form and confirmation receipt will list both amounts for the cardholder’s records.

Converge also provides the option to display an acceptance page for terms and conditions.

This option is available for the following integration methods:

  • Converge’s Hosted Payments Page
  • Checkout.js
  • XML API

Rules

Service fee transactions obey the following rules:

  • The service fee processes before the main transaction.
  • The service fee is non-refundable after the main transaction finishes processing.
  • If the service fee transaction declines or fails to process, the main transaction also declines.
  • If the main transaction declines or fails to process, the service fee immediately refunds to the payees account.

Setting Default Service Fees

The default service fees are set in Converge UI during terminal setup. Please contact Software Support if custom amounts are required.

Supported Transactions

Transaction TypesDescription
ccsaleCredit Card Sale
ccauthonlyCredit Card Auth Only
cccompleteCredit Card Complete

Examples

CCAuthonly Request

xmldata=
<txn>
    <ssl_merchant_id>my_merchant_id</ssl_merchant_id>
    <ssl_user_id>my_user_id</ssl_user_id>
    <ssl_pin>my_pin</ssl_pin>
    <ssl_transaction_type>CCAUTHONLY</ssl_transaction_type>
    <ssl_card_number>4000000000000002</ssl_card_number>
    <ssl_exp_date>1222</ssl_exp_date>
    <ssl_amount>20.00</ssl_amount>
    <ssl_cvv2cvc2_indicator>1</ssl_cvv2cvc2_indicator>
    <ssl_cvv2cvc2>123</ssl_cvv2cvc2>
</txn>

CCAuthonly Response

<txn>
    <APO/>
    <ssl_issuer_response>00</ssl_issuer_response>
    <ssl_last_name/>
    <ssl_service_fee_amount>2.00</ssl_service_fee_amount>
    <ssl_company/>
    <Customer/>
    <ssl_phone/>
    <ssl_card_number>40**********0002</ssl_card_number>
    <ssl_departure_date/>
    <ssl_oar_data>010010712108112009320000047554200000000000349472222320107121</ssl_oar_data>
    <Test13/>
    <ssl_result>0</ssl_result>
    <ssl_txn_id>110822MF4-F438246D-D10F-4BF6-930B-0A2D3EF22EBB</ssl_txn_id>
    <ssl_avs_response> </ssl_avs_response>
    <ssl_approval_code>349472</ssl_approval_code>
    <ssl_email/>
    <ssl_service_fee_approval_code>349464</ssl_service_fee_approval_code>
    <ssl_amount>20.00</ssl_amount>
    <ssl_avs_zip/>
    <ssl_txn_time>08/11/2022 04:09:32 PM</ssl_txn_time>
    <test_field2/>
    <ssl_exp_date>1222</ssl_exp_date>
    <ssl_service_fee_txn_id>110822MF4-B55AACDA-06CF-4791-890A-B9EFD5C0B138</ssl_service_fee_txn_id>
    <ssl_card_short_description>VISA</ssl_card_short_description>
    <ssl_completion_date/>
    <ssl_address2/>
    <ssl_service_fee_txn_time>08/11/2022 03:09:25 PM</ssl_service_fee_txn_time>
    <ssl_customer_code/>
    <ssl_country/>
    <ssl_card_type>CREDITCARD</ssl_card_type>
    <ssl_transaction_type>AUTHONLY</ssl_transaction_type>
    <ssl_salestax/>
    <ssl_avs_address/>
    <myCustomField/>
    <ssl_account_balance>0.00</ssl_account_balance>
    <ssl_ps2000_data>W7522237257299035045A</ssl_ps2000_data>
    <ssl_service_fee_percent>10</ssl_service_fee_percent>
    <ssl_state/>
    <ssl_city/>
    <ssl_result_message>APPROVAL</ssl_result_message>
    <ssl_first_name/>
    <ssl_invoice_number/>
    <CellNumber/>
    <ssl_cvv2_response>M</ssl_cvv2_response>
    <ssl_partner_app_id>01</ssl_partner_app_id>
</txn>

CCComplete Original auth only response

<txn>
    <ssl_transaction_type>EMVSWIPEauthonly</ssl_transaction_type>
    <ssl_response_code>AA</ssl_response_code>
    <ssl_txn_id>190922MB-8140D6C1-F6E4-4F2D-9FAC-BA879D4BD979</ssl_txn_id>
    <ssl_txn_time>09/19/2022 09:33:51 AM</ssl_txn_time>
    <ssl_card_type>CREDITCARD</ssl_card_type>
    <ssl_issuer_response>00</ssl_issuer_response>
    <ssl_service_fee_amount>0.56</ssl_service_fee_amount>
    <ssl_account_balance>0.00</ssl_account_balance>
    <ssl_ps2000_data>MMCC821451 0919C1</ssl_ps2000_data>
    <ssl_oar_data>010001043109191333510919000892500000000000343884MCC821451</ssl_oar_data>
    <ssl_card_scheme>MASTERCARD</ssl_card_scheme>
    <ssl_result_message>APPROVAL</ssl_result_message>
    <ssl_result>0</ssl_result>
    <ssl_approval_code>343884</ssl_approval_code>
    <ssl_card_number>54**********4111</ssl_card_number>
    <ssl_exp_date>1222</ssl_exp_date>
    <ssl_amount>11.00</ssl_amount>
    <ssl_card_short_description>MC</ssl_card_short_description>
    <ssl_invoice_number/>
    <ssl_partial_shipment_flag>N</ssl_partial_shipment_flag>
    <ssl_company/>
    <ssl_first_name>TEST CARD 05 </ssl_first_name>
    <ssl_last_name>UAT CAN</ssl_last_name>
    <ssl_avs_address/>
    <ssl_address2/>
    <ssl_city/>
    <ssl_state/>
    <ssl_avs_zip>80112</ssl_avs_zip>
    <ssl_country/>
    <ssl_ship_to_phone/>
    <ssl_service_fee_txn_id>190922MB-4A50DC86-D8BD-4294-B80D-FE3666797F0C</ssl_service_fee_txn_id>
    <ssl_service_fee_approval_code>343883</ssl_service_fee_approval_code>
    <ssl_service_fee_txn_time>09/19/2022 07:33:48 AM</ssl_service_fee_txn_time>
    <ssl_service_fee_percent>5</ssl_service_fee_percent>
    <ssl_partner_app_id>01</ssl_partner_app_id>
</txn>

CCOMPLETE (partial amount) Request

xmldata=
<txn>
    <ssl_merchant_id>my_merchant_id</ssl_merchant_id>
    <ssl_user_id>my_user_id</ssl_user_id>
    <ssl_pin>my_pin</ssl_pin>
    <ssl_transaction_type>cccomplete</ssl_transaction_type>
    <ssl_txn_id>190922MB-8140D6C1-F6E4-4F2D-9FAC-BA879D4BD979</ssl_txn_id>
    <ssl_amount>10.00</ssl_amount>
</txn>

CCOMPLETE (partial amount) Response

<txn>
    <ssl_service_fee_amount>0.50</ssl_service_fee_amount>
    <ssl_transaction_type>COMPLETE</ssl_transaction_type>
    <ssl_card_number>54**********4111</ssl_card_number>
    <ssl_oar_data>010001043109191333510919000892500000000000343884MCC821451</ssl_oar_data>
    <ssl_result>0</ssl_result>
    <ssl_txn_id>190922MB-8140D6C1-F6E4-4F2D-9FAC-BA879D4BD979</ssl_txn_id>
    <ssl_avs_response/>
    <ssl_approval_code>343884</ssl_approval_code>
    <ssl_salestax/>
    <ssl_service_fee_approval_code>343883</ssl_service_fee_approval_code>
    <ssl_amount>10.00</ssl_amount>
    <ssl_txn_time>09/19/2022 09:33:51 AM</ssl_txn_time>
    <ssl_account_balance>0.00</ssl_account_balance>
    <ssl_ps2000_data>MMCC821451 0919C1</ssl_ps2000_data>
    <ssl_service_fee_percent>5</ssl_service_fee_percent>
    <ssl_exp_date>1222</ssl_exp_date>
    <ssl_service_fee_txn_id>190922MB-4A50DC86-D8BD-4294-B80D-FE3666797F0C</ssl_service_fee_txn_id>
    <ssl_result_message>APPROVAL</ssl_result_message>
    <ssl_card_short_description>MC</ssl_card_short_description>
    <ssl_service_fee_txn_time>09/19/2022 08:33:42 AM</ssl_service_fee_txn_time>
    <ssl_customer_code/>
    <ssl_card_type>CREDITCARD</ssl_card_type>
    <ssl_invoice_number/>
    <ssl_cvv2_response/>
    <ssl_partner_app_id>01</ssl_partner_app_id>
</txn>