> For the complete documentation index, see [llms.txt](https://docs.hyperswitch.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hyperswitch.io/integration-guide/workflows/intelligent-routing/routing-strategies/least-cost-routing.md).

# Least Cost Routing

Optimize debit payment cost by routing through the lowest-cost eligible network

Least Cost Routing helps merchants reduce debit payment cost by selecting the most cost-efficient eligible debit network for a transaction. In the dashboard, this feature is called **Debit Routing**. It is focused on debit network choice, while [Multi-Objective Routing](/integration-guide/workflows/intelligent-routing/routing-strategies/multi-objective-routing.md) focuses on processor-level cost and auth-rate tradeoffs.

## Prerequisites

Before enabling Debit Routing, confirm the following requirements:

* Connectors that support local debit network routing are configured.
* Debit card support is enabled.
* Your processors support the local debit networks you intend to use, and the required network eligibility and fee configuration is in place.
* The payment has the debit card and network data required to identify eligible local networks.

## Setup In Decision Engine Routing

### 1. Open Debit Routing

1. Select your merchant account and **Profile** in the dashboard.
2. Go to **Decision Engine Routing** > **Debit Routing**.
3. On the **Network / Debit Routing** page, review **Current state** in the **Debit Routing Runtime Access** card.

If the state is **Disabled**, the action button reads **Enable Debit Routing**. If it is **Enabled**, the button reads **Disable Debit Routing**.

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-c62b90c144b1484f70f3502d7edc082f9a372896%2Fdecision-engine-debit-routing-disabled.png?alt=media" alt="Decision Engine Routing > Debit Routing page showing the selected profile, Current state as Disabled, and the Enable Debit Routing button"><figcaption><p>Review the selected profile and current state before enabling Debit Routing.</p></figcaption></figure>

### 2. Enable Debit Routing

1. Confirm the processor, debit card, network eligibility, and fee configuration prerequisites above.
2. Click **Enable Debit Routing**.
3. Wait for the confirmation message. Check that **Current state** changes to **Enabled** and the button changes to **Disable Debit Routing**.

The button saves the change immediately. Enabling allows eligible payments to use debit network routing, including when it runs alongside auth-rate routing. The selected network still depends on the available payment data and network configuration.

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-3bdfb6e9ad6d9f1727d8566219c1a78b18165f33%2Fdecision-engine-debit-routing-enabled.png?alt=media" alt="Debit Routing page showing Current state as Enabled, the Debit routing enabled confirmation, and the Disable Debit Routing button"><figcaption><p>Confirm that Debit Routing is Enabled after saving the change.</p></figcaption></figure>

## Disable Debit Routing

1. Open **Decision Engine Routing** > **Debit Routing** for the same merchant account and profile.
2. Click **Disable Debit Routing**.
3. Wait for the confirmation message. Check that **Current state** changes to **Disabled** and the button changes back to **Enable Debit Routing**.

Disabling turns off access to debit network routing through this feature, including its use alongside auth-rate routing.

## Supported Configuration

| Item           | Supported values         |
| -------------- | ------------------------ |
| Geography      | US                       |
| Payment method | Cards                    |
| Networks       | Star, Pulse, NYCE, Accel |

## How It Works

For supported debit card payments, Hyperswitch checks the available card networks and eligible connector capabilities. It compares eligible global and local debit networks and selects the network with the lowest estimated cost.

Least Cost Routing can run as a standalone debit network routing strategy or alongside auth-rate routing in a hybrid setup, where Hyperswitch keeps processor performance in view while also selecting the debit network.

## Cost Computation

Hyperswitch estimates transaction cost using payment attributes such as amount, issuer, network, acquirer country, and merchant category.

<figure><img src="https://1943537505-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fkf7BGdsPkCw9nalhAIlE%2Fuploads%2Fgit-blob-512abb1904cd8e8486305b5a5e685a3322127983%2Fimage.png?alt=media" alt="Merchant Category Code selection in Payment Settings"><figcaption></figcaption></figure>

The cost computation considers:

* Merchant category code (MCC) supplied by the merchant.
* Transaction amount.
* Card issuer bank.
* Co-badged card network data, when available.
* Global network and local network eligibility.
* Default cost values available in Hyperswitch when merchant-specific cost data is not available.
* Merchant-provided PSP-network contracts where those inputs are available.

When supported by the processor, Hyperswitch passes the selected debit network in the payment request.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.hyperswitch.io/integration-guide/workflows/intelligent-routing/routing-strategies/least-cost-routing.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
