Auth-Rate Routing
Improve successful payments by routing traffic to processors with stronger recent authorization performance
Auth-Rate Routing uses recent payment outcomes to choose the processor most likely to authorize the next payment. It is useful when you have multiple processors for the same payment method and want routing to adapt as processor performance changes.
How It Works
Hyperswitch tracks processor performance across payment attributes such as payment method, payment method type, transaction amount, currency, country, card network, and authentication type. The routing engine then ranks eligible processors by recent success rate.
The model treats each processor as a changing option in a non-stationary multi-armed bandit with delayed feedback. That means it accounts for both fluctuating success rates and the delay between sending a payment and receiving its final outcome.
The strategy balances two behaviors:
Exploitation: Send most traffic to the processor with the best recent performance.
Exploration: Send a smaller share of traffic to other eligible processors so the model keeps fresh performance data.
Hyperswitch uses a sliding window of recent attempts so routing can react to processor behavior without waiting for a manual configuration change. Downtime or repeated technical failures can deprioritize a processor before the final decision is made.

Merchant Controls
Traffic split
Roll out auth-rate routing gradually before using it for all payments.
Bucket size
Controls how much recent traffic is used to calculate processor performance.
Hedging percentage
Controls the exploration share sent to alternate eligible processors.
Elimination threshold
Controls when a poorly performing processor is temporarily deprioritized.
Key Configurations
Bucket size: Number of payments included in a block, limited by count or time period.
Aggregate pipeline size:
Max: Number of buckets used to calculate scores in FIFO order. This determines reaction time.
Min: Number of buckets after which scores are used. This acts as the offset for error tolerance.
Exploration percentage: Share of traffic sent to alternate eligible processors to keep scoring data fresh.
Dashboard Setup
Configure at least two processors that support the same payment method.
Go to
Workflow>Routing.Choose
Auth-Rate Routing.Configure rollout percentage and scoring settings.
Save and activate the configuration.
Monitor processor share, auth rate, and decision logs.
API Setup
Enable Auth-Rate Routing for your business profile:
Roll it out to the required split of payment traffic:
Update the routing model settings:
Activate the updated configuration:
Test Routing Behavior
Use the routing playground to simulate payment scenarios and review routing choices:
https://hyperswitch-ten.vercel.app/
Create a merchant on Juspay Hyperswitch Control Center.
Configure at least two payment processors for the merchant profile.
Enter the sandbox API key, merchant ID, and profile ID when the simulator prompts for them.
Go to the
Routingtab and toggle Success Based Routing.Select the routing configuration settings.
Go to the
Generaltab and enter the number of payments to trigger in batches.Click
Start Simulationto see the results.Use
Test Payment Datato modify processor auth rates and observe how routing choices change.
For automatic tuning of bucket size and exploration settings, see Autopilot.
Last updated
Was this helpful?

