REST API Reference

Integrate PayNit seamlessly into your applications. Programmatically initiate payouts, fetch real-time balances, and monitor transaction statuses with our secure REST API.

Base URL https://portal.paynit.in/api/v1
AUTH

Authentication

Every API request must be authenticated using your unique API Key and API Secret. Pass them in the Authorization header using the Bearer schema, separated by a colon.

Keep your API Secret confidential. Do not expose it in client-side code.

Headers
Content-Type: application/json Authorization: Bearer YOUR_API_KEY:YOUR_API_SECRET
POST

/payout.php

Initiate a Payout

Instantly transfer funds via IMPS or UPI. Ensure you have sufficient wallet balance before executing this endpoint.

Body Parameters

type * string "IMPS" or "UPI"
amount * float Amount in INR
upi_id string Required if type is UPI
account_number string Required if type is IMPS
ifsc string Required if type is IMPS
{ "type": "IMPS", "amount": 500.00, "note": "Vendor settlement", "account_number": "9876543210", "ifsc": "HDFC0001234", "beneficiary_name": "Acme Corp" }
POST

/balance.php

Fetch Account Balance

Retrieve your current available wallet balance. No request body is required.

No parameters required

200 OK Response
{ "success": true, "balance": 15420.50 }
POST

/status.php

Check Transaction Status

Verify the real-time status and retrieve the bank UTR of a previously initiated payout.

Body Parameters

order_id * string The unique Order ID returned during initiation
{ "order_id": "PM260424ABCDEF1234" }