DEVELOPER PORTAL
API documentation
Create orders from your website or bot and poll their status.
Authentication
Send your API key in the Authorization header. Never expose it in browser-side JavaScript or a mobile app.
Authorization: Bearer qpk_live_YOUR_SECRET_KEY
Content-Type: application/json
1. Create an order
POST /api/create_order.php
{
"amount": 149.00,
"currency": "INR",
"product_name": "Monthly subscription",
"customer_email": "buyer@example.com",
"webhook_url": "https://yourapp.example/payment-hook"
}
The response contains the order ID and hosted checkout URL. Each order uses the UPI ID configured for that API key's merchant account.
2. Check order status
GET /api/order_status.php?order_id=QPG...
{
"ok": true,
"order_id": "QPG...",
"status": "PENDING",
"amount": 149.00,
"currency": "INR",
"payment_reference": null
}
Webhook events
When an order is marked successful by a trusted verification path, Quantum sends JSON to the configured HTTPS webhook URL. The payload includes event, order ID, amount, currency, status and a signature in the X-Quantum-Signature header.
This installation does not mark orders successful from a checkout redirect. A real verification source must confirm payment first.