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 Elavon Software Technical Support if custom amounts are required.
Supported Transactions
Transaction Types | Description |
---|---|
ccsale | Credit Card Sale |
ccauthonly | Credit Card Auth Only |
cccomplete | Credit 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>