Smart Router for Payouts

The Hyperswitch Smart Router allows you to define logic for distributing payout traffic across multiple processors. This ensures redundancy, optimizes for cost, and manages transaction volumes programmatically.

Note: Routing configurations for payout operations are isolated from payment operations. Modifying payout routing rules will not impact your payment routing logic and vice-versa.

For a conceptual deep dive into the routing engine, refer to the Smart Router Overview.

Configuration Options

You can manage your routing logic via the Hyperswitch Dashboard or the Routing APIs. The dashboard provides a visual interface for constructing and activating these rules.

Prerequisites

To utilize Smart Routing, you must have at least two payout processors integrated and active on your account. Follow the Getting Started with Payouts guide to add connectors.

Setting Up Payout Routing

Access Routing Settings

Navigate to Workflow -> Payout Routing in your Dashboard.

Head to Payout Routing

Select a Routing Strategy

Hyperswitch supports three distinct formats for payout orchestration:

• Volume-Based Routing: Distribute a percentage of total payout traffic across multiple connectors.

• Rule-Based Routing: Create conditional logic (if/then) to route payouts based on specific attributes like currency, region, or method.

• Default Fallback Routing: Establish a static priority list. If a primary processor is unavailable, the system attempts the payout with the next processor in the sequence.

Volume Based Routing

Rule Based Routing

Default fallback Routing

View configured rules

Manage and Activate Configurations

Once your rules are defined, you can manage them from the Payout Routing summary page.

• Activation: Only one routing configuration (Volume, Rule, or Fallback) can be active at any given time.

• Switching Rules: To change the active logic, select a saved configuration and click Activate Configuration.

Activate routing rule

Fallback Behavior: If no custom routing rule is activated, Hyperswitch will automatically process transactions based on the order defined in your Default Fallback Priority list.