Getting Started

HyperCheckout SDK offers a seamless, fast, and intuitive checkout experience for end users, leading to higher conversions. Merchants need to integrate with the SDK through a combination of APIs and SDK calls. HyperCheckout SDK manages the entire checkout flow, ensuring a consistent look and feel within the merchant app. HyperCheckout uses a hybrid integration model:

• Backend (Handled by Merchants)

• Frontend (Handled by Juspay)

Step-by-Step Integration

Step 1: Backend Integration

Use Juspay’s secure server-side APIs to:

• Generate Session Tokens to initiate payment flows

• Handle Webhooks for real-time payment status updates

• Check Order Status using the Order Status API

• Process Refunds using the Refund Order API

Step 2: Frontend Integration 

Integrate the HyperCheckout SDK into your app to:

• Launch the payment screen using the session token

• Handle payment responses via callbacks

Step 3: Testing & Go-Live

1. Share UAT Build: Once integration is done, submit your UAT build to Juspay for QA validation.

2. Removal of Restricted Mode: After QA approval, Juspay will switch your account to Live Mode.

3. Go Live : Your integration is now live and ready for real users to complete their checkout.

Refund Handling

Process refunds using:

• Juspay Dashboard: Issue refunds manually using Juspay’s Dashboard interface

• Refund Order API: Automate refunds using the Refund Order API

Webhook Events: Get real-time notifications on refund status and completion through webhook events.

Additional Feature

Mandate Support

Support recurring/subscription-based payments with:

• Mandate Registration: Used this API to set up standing instructions by selecting a preferred payment method

• Mandate Execution: After registering a mandate, use the Mandate Execution API to trigger recurring transactions without user input.

• Webhook Events: Receive notifications for mandate creation, execution, failure, expiry and other status updates via webhooks

Additional Developer Resources

Explore additional documentation and resources, including:

Core Resources

The Core Resources section provides essential technical references required to build and manage your payment integration effectively. This includes:

• Gateway Reference ID: Helps map Juspay transaction IDs to gateway-specific references.

• Sample Payloads: Ready-to-use request/response examples for quick integration.

• Transaction Status: API and status lifecycle documentation to track payments.

• Webhooks: Details on all webhook types—Order, Transaction, Mandate, Refunds

• Error Codes: A comprehensive list of standard and gateway-specific error codes for debugging.

• Clickstream Events: Capture and analyze user interaction events for behavioral insights.

Payment Page Customization

Juspay’s HyperCheckout SDK offers flexible customization options for tailoring the payment experience to match your app’s UX and business needs:

• Payment Method Locking: Pre-select or restrict available payment methods (e.g., only UPI or cards).

• Custom Wallet Integration: Add support for third-party or brand-specific wallets.