Skip to content
English
Customer portal
eComCharge Blog
  • There are no suggestions because the search field is empty.

Surcharge billing. Version 2

Surcharge stands for the commissions for processing and acquiring that are paid by the customer in addition to the initial transaction amount. For example, if the initial transaction amount is 10 USD and the surcharge rate fee is 0.30 USD, the customer will be charged 10.30 USD. The surcharge amount will be displayed to the customer on the widget/payment page.

The surcharge billing can be set up for the shops which accept payments with the widget. The surcharge billing will be applied to transactions of payment and authorization types made with the widget.

Surcharge billing is not supported for host-to-host transactions.

The service is activated for PSPs on request. Once the service is activated, 2 new fields will appear in the shop settings:

  • Enable surcharge billing   – for activating surcharge billing version 1;

  • Enable surcharge billing (v2)  – for activating surcharge billing version 2.

 

! Important

For now, both versions are supported. We plan to soon discontinue the version 1 of the service, so it is recommended to use only the 2nd version of surcharge billing.

 
 Steps for applying surcharge billing:

  1. Add a gateway to a shop.

  2. Go to {shop name} > Gateways > {gateway name} > Rates > fill in the fields according to the description in the table below. You can use either the v.1 or v.2 of the Rates.

  3. Go to Accountant > Shops > {shop name} > Edit > select the checkbox Enable surcharge billing (v2).

Please note the following features of this service:

  • Pay attention that the rates specified for the transactions other than payments and authorization, as well as the rates for the failed transactions won’t be added to the transaction amount and will be reflected in the reports as the regular rates.

  • The system doesn’t provide an option to include PSP commission in the transaction amount and to charge Bank commission as a surcharge amount as well as the other way around.

  • When calculating the surcharge, the maximum rate from all the active gateways of the shop will be applied. Contact your manager or the Tech Support team for details.

  • The information on the applied surcharge rates will be in the adjustments.surcharge_info object in the webhook notification, in the response to the status query, in the reports in Surcharge amount column as well as on the transaction details page. Information on the applied surcharge rates is also available when exporting transaction information with API. See more information in the PSP API documentation (method Export the list of processed transactions). For receiving information on the surcharge rates, add adjustments to the response_parameters.