Juspay

Juspay is an Indian payments orchestration and checkout platform that routes transactions across payment gateways, aggregators, UPI, cards, wallets, and netbanking for merchants, banks, and card networks. Its server-to-server Express Checkout / PG REST APIs create and track orders, process transactions, issue refunds, and manage customers, and pair with the HyperSDK / Hyper Checkout drop-in checkout. APIs authenticate with an API key over HTTP Basic plus a merchant ID header, against a sandbox and a production host.

5 APIs 0 Features
PaymentsPayment OrchestrationCheckoutIndiaUPICardsPayment GatewayFintechHyperSDKFinancial Infrastructure

APIs

Juspay Orders API

Create an order (POST /orders), retrieve its current status by order id (GET /orders/{order_id}), and read the encrypted status variant (POST /v4/order-status). The order is the...

Juspay Transactions API

Server-to-server transaction endpoint (POST /txns) that processes a payment against an existing order with a chosen payment method - cards, UPI, netbanking, or wallets. Document...

Juspay Session API

Create a payment session (POST /session) that accepts order parameters and returns an SDK payload and payment links to initialize a Hyper Checkout / HyperSDK drop-in payment exp...

Juspay Refunds API

Create a refund for a CHARGED order (POST /orders/{order_id}/refunds) with a unique request id and amount. Supports STANDARD, INSTANT, and INSTANT_WITH_FALLBACK refund types dep...

Juspay Customers API

Create a customer (POST /customers) and retrieve one by id (GET /customers/{customer_id}). Get/create customer can also mint a 15-minute client auth token used for client-side S...

Collections

Juspay Express Checkout API

OPEN

Pricing Plans

Juspay Plans Pricing

3 plans

PLANS

Rate Limits

Juspay Rate Limits

3 limits

RATE LIMITS

FinOps

Juspay Finops

FINOPS

Resources

🔗
AgenticAccess
AgenticAccess
🔗
DomainSecurity
DomainSecurity
🔑
Authentication
Authentication
👥
GitHubOrganization
GitHubOrganization
🔗
LinkedIn
LinkedIn
🔗
Website
Website
🔗
Documentation
Documentation
🔗
Plans
Plans
🔗
RateLimits
RateLimits
🔗
FinOps
FinOps
📰
Blog
Blog

Sources

Raw ↑ 
opencollection: 1.0.0
info:
  name: Juspay Express Checkout API
  version: '1.0'
request:
  auth:
    type: basic
    username: '{{apiKey}}'
    password: ''
items:
- info:
    name: Orders
    type: folder
  items:
  - info:
      name: Create an order.
      type: http
    http:
      method: POST
      url: https://api.juspay.in/orders
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      - name: Content-Type
        value: application/x-www-form-urlencoded
      body:
        type: text
        data: order_id=order_001&amount=100.00&currency=INR&customer_id=cust_00000001
    docs: Creates an order, the unit a payment is attached to.
  - info:
      name: Get order status.
      type: http
    http:
      method: GET
      url: https://api.juspay.in/orders/:order_id
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      params:
      - name: order_id
        value: order_001
        type: path
        description: The order identifier.
    docs: Retrieves an order's status. CHARGED indicates a successful payment.
  - info:
      name: Get order status (encrypted V4).
      type: http
    http:
      method: POST
      url: https://api.juspay.in/v4/order-status
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: '{}'
    docs: Encrypted (JWE/JWT) order-status variant.
- info:
    name: Transactions
    type: folder
  items:
  - info:
      name: Create a transaction.
      type: http
    http:
      method: POST
      url: https://api.juspay.in/txns
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      - name: Content-Type
        value: application/x-www-form-urlencoded
      body:
        type: text
        data: order_id=order_001&payment_method_type=UPI&format=json
    docs: Server-to-server transaction processing against an order.
- info:
    name: Session
    type: folder
  items:
  - info:
      name: Create a payment session.
      type: http
    http:
      method: POST
      url: https://api.juspay.in/session
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      - name: Content-Type
        value: application/json
      body:
        type: json
        data: "{\n  \"order_id\": \"order_001\",\n  \"amount\": \"100.00\",\n  \"customer_id\": \"cust_00000001\",\n  \"action\"\
          : \"paymentPage\"\n}"
    docs: Creates a Hyper Checkout / HyperSDK session and returns an SDK payload and payment links.
- info:
    name: Refunds
    type: folder
  items:
  - info:
      name: Refund an order.
      type: http
    http:
      method: POST
      url: https://api.juspay.in/orders/:order_id/refunds
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      - name: Content-Type
        value: application/x-www-form-urlencoded
      params:
      - name: order_id
        value: order_001
        type: path
        description: The order identifier.
      body:
        type: text
        data: unique_request_id=refund_001&amount=100.00
    docs: Creates a refund for a CHARGED order.
- info:
    name: Customers
    type: folder
  items:
  - info:
      name: Create a customer.
      type: http
    http:
      method: POST
      url: https://api.juspay.in/customers
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      - name: Content-Type
        value: application/x-www-form-urlencoded
      body:
        type: text
        data: customer_id=cust_00000001&mobile_number=9000000000&email_address=customer@example.com
    docs: Creates a customer. customer_id should be at least 8 characters and unique.
  - info:
      name: Get a customer.
      type: http
    http:
      method: GET
      url: https://api.juspay.in/customers/:customer_id
      headers:
      - name: x-merchantid
        value: '{{merchantId}}'
      params:
      - name: customer_id
        value: cust_00000001
        type: path
        description: The customer identifier.
    docs: Retrieves a customer by id; can also return a client auth token.
bundled: true