Get one purchase's status

Request: No body. Path purchase_key (Purchase-XXXXX)

Single purchase status check, owner-scoped - e.g. poll this after opening the Razorpay Checkout widget if the client-side verify callback never landed.

Self-healing on every call: if the stored status is still pending and this is an order-based (one-time) purchase, it's reconciled against Razorpay live before responding - same reconciliation POST /subscriptions/checkout does on retry. status in the response can therefore differ from what's in the DB: "active" means Razorpay confirmed payment and it was just activated; "processing" (with a reason message to show the user) means a payment attempt is live on Razorpay's side but not yet captured - keep polling, don't prompt to purchase again; plain "pending" means no payment attempt has been made yet.

Success: 200 - purchase detail

Errors: 401 - not authenticated | 404 - not found or not yours

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Responses

🟢200OK

application/json

Successful Response

Bodyapplication/json

Example

{
    "success": true,
    "message": "Success",
    "data": {
        "purchase_key": "Purchase-83921",
        "plan_name": "Sage",
        "slug": "sage-monthly",
        "status": "active",
        "purchase_type": "subscription",
        "amount": 299,
        "currency": "INR",
        "auto_renew": true,
        "started_on": "2026-07-01T00:00:00Z",
        "expires_on": "2026-08-01T00:00:00Z",
        "created_at": "2026-07-01T00:00:00Z"
    }
}

🟠401Unauthorized

🟠404Record Not Found

🟠406

🟠422Parameter Error

🟠429

Get one purchase's status

Request

Request Code Samples

Responses