--- title: Juspay API Integration on Truto slug: juspay category: Payment Gateway canonical: "https://truto.one/integrations/detail/juspay/" --- # Juspay API Integration on Truto **Category:** Payment Gateway **Status:** Generally available ## Unified APIs ### Unified Payment Gateway API - **Customers** — The customer represents a customer in Payment Gateway. ## How it works 1. **Link your customer's Juspay account.** Use Truto's frontend SDK; we handle every OAuth and API key flow so you don't need to create the OAuth app. 2. **Authentication is automatic.** Truto refreshes tokens, stores credentials securely, and injects them into every API request. 3. **Call Truto's API to reach Juspay.** The Proxy API is a 1-to-1 mapping of the Juspay API. 4. **Get a unified response format.** Every response uses a single shape, with cursor-based pagination and data in the `result` field. ## Use cases - **Enable payment collection for vertical SaaS platforms** — If you build software for gyms, schools, or clinics, your customers already use Juspay for payment orchestration. Let them connect their Juspay accounts so you can create orders, manage customers, and process payments on their behalf — without building a direct integration yourself. - **Sync customer payment profiles into billing platforms** — AR and invoicing SaaS companies need to pull customer records from their users' Juspay accounts to match payments to invoices. Truto lets you read and manage Juspay customer data through a unified interface, eliminating per-gateway plumbing. - **Power multi-gateway customer management for e-commerce builders** — Headless commerce and storefront platforms want to offer Juspay as a native option alongside other gateways. By connecting via Truto's Unified Payment Gateway API, you normalize customer data across processors so merchants can manage saved payment methods and buyer profiles from a single view. - **Centralize customer records for finance operations tools** — Finance and ops dashboards that aggregate data across payment processors need a consistent way to pull customer objects from Juspay. Truto abstracts the auth and API differences so your team ships the integration in days, not weeks. ## What you can build - **Unified customer directory across payment gateways** — Pull and display customer records from your users' Juspay accounts alongside other payment gateways using a single normalized schema. - **Automated customer onboarding sync** — Create and sync customer profiles in Juspay whenever a new buyer or subscriber is added in your platform, ensuring payment readiness from day one. - **Cross-processor customer lookup** — Let your users search for a customer by email or phone across Juspay and other connected payment gateways in one query. - **Customer data health dashboard** — Surface missing or inconsistent customer records across your users' connected Juspay accounts to help finance teams clean up payment data. - **Self-serve Juspay account connection flow** — Embed a Truto-powered connect experience so your end users can securely link their Juspay API credentials without your team handling key exchange. ## FAQs ### How does authentication work for Juspay integrations through Truto? Juspay uses Basic HTTP Authentication with a Base64-encoded API key provisioned from the Juspay dashboard. Your end users provide their API key and merchant ID when connecting their account through Truto. Truto securely stores and manages these credentials on your behalf. ### What Unified API does Truto support for Juspay? Juspay is supported under Truto's Unified Payment Gateway API, specifically the Customers resource. This lets you read and manage customer objects through a standardized schema shared across multiple payment gateway integrations. ### Are there specific tools or pre-built operations available for Juspay today? No pre-built tools are available for Juspay at launch. Custom tools for operations like order creation, refund initiation, or webhook management can be built on request. Contact the Truto team to discuss your specific requirements. ### Does Juspay require any special headers beyond authentication? Yes. Juspay API calls require the x-merchantid header (your end user's merchant identifier) and often an x-routing-id header (typically a customer_id or cart_id) for session tracking and consistent routing. Truto handles passing these headers automatically once the account is connected. ### What customer data can I access through the Unified Payment Gateway API? Through the Customers resource you can access core customer fields such as customer ID, mobile number, and email. Saved payment method details like network tokens and UPI VPAs are part of Juspay's customer and vaulting system, and support for those can be scoped through custom tool requests. ### Can my end users connect multiple Juspay merchant accounts? Yes. Truto supports multiple account connections per integration, so an end user operating several Juspay merchant IDs — for different brands, geographies, or business units — can connect each one independently.