TL;DR
Narvar is a post-purchase experience platform serving global retail brands providing tracking, returns, and customer care at scale. As a platform managing thousands of individual retailers, Narvar needed payment infrastructure that matched its architecture: the ability to programmatically onboard merchants, control how payment data is shared or isolated across brands, and perform post-purchase operations like refunds and captures on transactions that were never originally processed through their system.
Juspay Hyperswitch provided Narvar with a Platform Organization architecture to manage merchants at scale via API, and a Relay API suite to operate on externally authorized transactions – enabling Narvar to act as a unified post-purchase payment layer across all the brands it serves.
| What Narvar Needed | What Hyperswitch Delivered |
| Programmatic onboarding of thousands of retail merchants | Platform Organization with API-driven merchant creation and key generation |
| Control over data sharing and isolation across merchants | Connected and Standard merchant types with configurable cross-merchant data policies |
| Post-purchase operations on externally authorized transactions | Relay API suite — refund, capture, void, incremental auth on external transactions |
| White-labeled self-service interface for merchants | Embedded Components for branded, no-code merchant configuration (Planned) |
Impact
- Implemented programmatic onboarding of new merchants
- Provided full control over cross-merchant data isolation
- Unified post-purchase operations (like refunds) on externally authorized transactions
Products Used
- Hyperswitch
Narvar is a pioneering post-purchase platform that empowers global brands to deliver exceptional tracking, returns, and customer care experiences. Because Narvar acts as a centralized operational hub, it doesn't serve a single merchant – it serves thousands of distinct retail brands, each with its own payment configurations, credentials, and strict data requirements. Manually onboarding each new brand through a dashboard, managing separate API keys, and maintaining visibility across all of them was not viable at scale. Furthermore, some global brands needed shared payment profiles across their regional storefronts, while others required absolute data isolation.
Adding to this architectural complexity was the very nature of post-purchase operations. Many of the brands Narvar serves process their own payments through their native checkout systems, and Narvar only steps in for what happens after – returns, refunds, and delivery-triggered captures. When facilitating returns or exchanges, Narvar lacked a clean way to execute refunds or capture funds on transactions that were originally authorized outside of their immediate system. To build a hierarchical multi-merchant architecture and seamlessly operate on external transactions, Narvar turned to Juspay Hyperswitch.
Platform Organization Architecture for Seamless Multi-Merchant Management
To manage thousands of brands efficiently, Narvar deployed the "Platform Organization" mode on Hyperswitch. Narvar was equipped with a master Platform API Key, granting them the ability to create and manage sub-merchants programmatically. Now, new retail brands are onboarded in seconds: Narvar's system simply calls the Hyperswitch API to instantly create a merchant account and generate its specific API keys automatically, bypassing manual dashboards entirely. Narvar maintains centralized visibility and control over payments, refunds, and configurations across all merchants from a single platform layer, without each brand needing direct access to Hyperswitch.
Features used: Platform Organization Architecture
Cross-Merchant Data Sharing and Isolation
To solve the complex data-sharing requirements across thousands of brands, Hyperswitch empowered Narvar to classify merchants into two distinct models:
- Connected Merchants: For retail brands operating multiple storefronts (e.g., US, EU, UK), this classification allows them to share customer profiles and saved payment methods across their connected group, delivering a frictionless, unified checkout experience globally.
- Standard Merchants: For regulated or contractually restricted brands, this classification ensures full isolation. Customer data, vaulted cards, and transaction histories are strictly siloed and invisible to all other merchants on the platform.
Narvar can assign the appropriate merchant type at onboarding and switch between models as a brand's requirements evolve, without re-architecting the integration.
Features used: Connected Merchant Data Sharing
Relay API Suite to Operate on External Payment Authorizations
Hyperswitch’s Relay API suite solved Narvar's biggest post-purchase bottleneck by enabling operations on resources created entirely outside of Hyperswitch. By passing an external transaction reference, Narvar can now trigger complex workflows (refunds, captures, voids, and incremental authorizations) regardless of where the original payment was processed:
- Refunds on External Transactions: If a retailer captures a payment natively, Narvar can use the Relay API to issue a return refund to the customer directly through the retailer's PSP.
- Captures on External Auth: If a retailer authorizes a payment at native checkout, Narvar can trigger the capture of funds after confirming a successful delivery.
- Multiple Partial Captures: A single authorization can be captured in stages as individual items ship separately – perfect for split-delivery retail scenarios.
- Voids and Incremental Auths: Narvar can void an authorization if an order is canceled pre-shipment, or increase the authorized amount if a customer adds items post-checkout.
Features used: Relay APIs
Result: A Programmable, Multi-Tenant Payments OS
By upgrading their platform infrastructure with Juspay Hyperswitch, Narvar successfully transformed complex, multi-merchant payment operations into a scalable, programmatic engine:
- Frictionless Merchant Scaling: API-driven onboarding drastically reduced the time and engineering overhead required to create and configure new retailers on the Narvar platform.
- Enterprise-Grade Compliance: The ability to instantly toggle brands between "Connected" and "Standard" data models ensured strict regulatory compliance without requiring architectural rewrites.
- Seamless Post-Purchase Execution: Relay APIs eliminated the technical friction of managing external payments, allowing Narvar to execute reliable, instantaneous refunds and captures on orders processed entirely outside their ecosystem.
Next Steps: Embeddable Components
Narvar continues to deepen its platform capabilities with Juspay Hyperswitch. They plan to deploy Hyperswitch’s Embeddable Components – integrating a white-labeled Connector Component directly into Narvar's merchant-facing interface. This will give retail brands a self-service UI to configure their own PSP credentials right inside Narvar’s dashboard. Rendered under Narvar's branding with zero Hyperswitch attribution, this planned enhancement will automatically handle underlying PSP API changes, eliminating maintenance overhead for Narvar's engineering team and further unifying the post-purchase ecosystem.
By partnering with Juspay Hyperswitch, Narvar has successfully modernized its complex, multi-tenant payment infrastructure. Narvar is now perfectly poised to deliver a fully autonomous, plug-and-play post-purchase ecosystem for the world's leading retail brands, and turn post-purchase complexity into a massive competitive advantage.
