REST API v1.0

Developer API Integration Guide

Learn how to generate dynamic payment QR codes, redirect customers, verify transaction statuses via automated webhooks, and query order states directly using Qolor Pay's REST endpoints.

1. Authentication & Headers

All requests to Qolor Pay API endpoints require authentication via your unique merchant user token.

Header / Parameter	Type	Description
Content-Type	Header	Must be set to `application/x-www-form-urlencoded`
user_token	Form Field	Your 32-character merchant API token obtained from your dashboard.

2. Create Order API

Generate a dynamic UPI transaction session and retrieve a checkout URL for customer payment.

POST https://pay.qolor.in/api/create-order

Request Parameters

Parameter	Type	Status	Description
user_token	String	Required	Your Merchant API access token.
order_id	String	Required	Unique alphanumeric transaction identifier generated by your system.
amount	Numeric	Required	Transaction amount in INR (e.g. `1`, `399`).
customer_mobile	String	Required	10-digit mobile number of the paying customer.
redirect_url	URL	Required	Callback URL where the user will be redirected after completing payment.
remark1	String	Optional	Custom metadata (e.g. User ID, Plan Name).
remark2	String	Optional	Secondary tracking reference.

REQUEST PAYLOAD x-www-form-urlencoded

{
  "user_token": "YOUR_MERCHANT_USER_TOKEN",
  "order_id": "ORD982348234",
  "amount": "399",
  "customer_mobile": "9876543210",
  "redirect_url": "https://yoursite.com/payment/success",
  "remark1": "Standard_Plan",
  "remark2": "User_4982"
}

SUCCESS RESPONSE JSON (200 OK)

{
  "status": true,
  "message": "Order Created Successfully",
  "result": {
    "orderId": "ORD982348234",
    "payment_url": "https://pay.qolor.in/payment/pay.php?data=MTIzNDU2..."
  }
}

Order Expiry: Generated QR sessions remain valid for 30 minutes. Unpaid sessions will automatically transition to expired/failed state.

3. Check Order Status API

Query our server to check the real-time settlement status of any existing order.

POST https://pay.qolor.in/api/check-order-status

Request Parameters

Parameter	Type	Status	Description
user_token	String	Required	Your Merchant API access token.
order_id	String	Required	The order ID passed during order creation.

REQUEST PAYLOAD x-www-form-urlencoded

{
  "user_token": "YOUR_MERCHANT_USER_TOKEN",
  "order_id": "ORD982348234"
}

SUCCESS RESPONSE JSON (200 OK)

{
  "status": "COMPLETED",
  "message": "Transaction Successfully",
  "result": {
    "txnStatus": "COMPLETED",
    "resultInfo": "Transaction Success",
    "orderId": "ORD982348234",
    "status": "SUCCESS",
    "amount": "399",
    "date": "2026-08-19 22:45:10",
    "utr": "423456789012"
  }
}

4. Webhook Notification Callbacks

When a customer scans and completes the dynamic QR payment, Qolor Pay immediately sends an asynchronous server-to-server POST request to your configured Webhook URL.

WEBHOOK PAYLOAD RECEIVED ON YOUR SERVER POST Body

{
  "status": "SUCCESS",
  "order_id": "ORD982348234",
  "amount": "399.00",
  "utr": "423456789012"
}

Integration Tip: Always verify that the received order_id and amount match your internal records before fulfilling services or granting user credits. Respond with an HTTP 200 OK status to confirm receipt. Webhook Detailed Guide Click Here