# Surcharge Setup guide

{% hint style="info" %}
This section covers the steps to setup surcharge manager using the Hyperswitch Control Center
{% endhint %}

## 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

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-9c02c786e7311f15169999b3761dd4952134c70e%2FScreenshot%202024-03-04%20at%206.49.56%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-9fc12c9b8c18c584689137ab425d7063717943a2%2FScreenshot%202024-03-04%20at%205.42.22%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-5e39eaf920cd9dd396da4a623dc875b03ca24125%2FScreenshot%202024-03-04%20at%206.38.04%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

**Step 6:** Click save to configure and activate the rule

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-9bdb3b637d8fa28b4f833810395540ac18e11802%2FScreenshot%202024-04-15%20at%201.38.07%E2%80%AFPM.png?alt=media" alt=""><figcaption></figcaption></figure>

**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.

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-2bfb059bc18d9c660c195d811b8305e9257235ea%2FScreenshot%202024-07-02%20at%201.04.09%E2%80%AFPM.png?alt=media" alt=""><figcaption><p>Test payment</p></figcaption></figure>

**Note:**&#x53;urcharge manager supports only one active configuration at a time. Multiple rules can be combined into a single configuration as shown in the example

### FAQs

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

2. How do I update the current configuration?\
   Click on Create New and configure a new rule that would replace the existing configuration
3. 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.