Surcharge Setup guide

Surcharge Manager Setup

This section covers the steps to setup surcharge manager using the Hyperswitch Control Center

Steps to setup a rule on Surcharge Manager?

Step 1: Go to Workflow -> Surcharge tab on the Hyperswitch Control Center

Step 2: Click on create new button

Step 3: Enter the rule name, description and configure your desired rule by selecting the operators and values for the various fields

Step 5: Add more rules using the plus icon on the top right of the current rule panel

Step 6: Click save to configure and activate the rule

Step 7: Your rule is now successfully configured and Surcharge would be applied to all payments conforming to this rule.

To create a test payment, Go to Home and click on Try a test payment.

Note:Surcharge manager supports only one active configuration at a time. Multiple rules can be combined into a single configuration as shown in the example


  1. What are some of the payment parameters that I can use to configure Surcharge rules?

  • Available Parameters:

    • amount - set rules for a specific value or a range of values for the transaction amount

    • currency - select the currency of transaction

    • payment_method - configure rules for different payment methods like card, wallet, direct bank debit etc.

    • card_type - choose between credit and debit cards

    • card_network - choose between card networks like visa, mastercard etc.

    • billing_country - to select the billing_country

  1. How do I update the current configuration? Click on Create New and configure a new rule that would replace the existing configuration

  2. What happens if I pass surcharge_details field in /payments request? surcharge_details if sent in payments create request, surcharge decision manager will be overridden and surcharge sent in the request will be applied.

Last updated