MSPay
REST API Reference v2.4

Complete REST API Documentation & Interactive Code Sandbox

Integrate orders, payments, automated refunds, 24/7 payouts, and BBPS utility bill switching with clean JSON endpoints and strict schema validation.

✓ 99.99% Uptime✓ Sub-second Latency✓ Multi-Bank Active✓ RBI Tokenized
Interactive Sandbox Code

Create Order Request Sample

Live v2.4
curl -X POST https://api.mspay.in/v2/orders \
  -H "Authorization: Bearer sec_live_98ab7621c90" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 250000,
    "currency": "INR",
    "receipt": "order_rcpt_10982",
    "customer": {
      "name": "Dev Sharma",
      "email": "dev@company.com",
      "phone": "+919876543210"
    },
    "payment_capture": 1
  }'
API Endpoints

Core API Methods

Standard HTTP response codes: 200 (Success), 400 (Bad Request), 401 (Unauthorized), 422 (Validation), 500 (Gateway Error).

POST
/v2/orders

Initialize a new payment order with amount, currency, and customer details before loading checkout.

Core
GET
/v2/payments/{id}

Retrieve real-time transaction status, bank reference number (RRN), card token, and fee deductions.

Inquiry
POST
/v2/refunds

Trigger full or partial instant refund to the original payment source or customer UPI ID.

Instant
POST
/v2/payouts/transfers

Disburse funds 24/7/365 to any Indian bank account or VPA via IMPS, NEFT, RTGS, or UPI.

Payouts
POST
/v2/bbps/bill/fetch

Query outstanding consumer bills across 20,000+ national utility billers under the BBPS framework.

BBPS Utility
POST
/v2/bbps/bill/pay

Execute instant settlement for utility bills and receive official NPCI payment confirmation tokens.

BBPS Settle
Frequently Asked Questions

Got Questions? We Have Answers.

Find detailed answers about technical integration, settlement cycles, RBI tokenization, and our BBPS network.

Standard production API keys support up to 120 requests per second (RPS) per endpoint. Enterprise accounts can request custom rate limit escalations for anticipated high-volume flash sales.
Instant Sandbox & Same-Day Onboarding

Ready to Upgrade Your Payment Infrastructure?

Join hundreds of forward-thinking enterprises, digital marketplaces, and distributor networks powered by MSPay multi-bank technology.

PCI DSS Level 1 CertifiedRBI Tokenization FrameworkNPCI BBPS Operating Partner