API Documentation | UPI Gateway.dev - Developer Integration Guide

Developer Portal

Complete integration blueprints for merchants and software engineers.

Create Order API

Gateway POST URL

Order Timeout Warning: Orders automatically transition to FAILURE state if left pending for more than 30 minutes.

Form-Encoded Payload Parameters (application/x-www-form-urlencoded)

{
  "customer_mobile": "8145344963",
  "user_token": "YOUR_MERCHANT_TOKEN",
  "amount": "1",
  "order_id": "8787772321800",
  "redirect_url": "https://yourwebsite.com/callback.php",
  "remark1" : "testremark",
  "remark2" : "testremark2"
}

Success Response Schema

{
    "status": true,
    "message": "Order Created Successfully",
    "result": {
        "orderId": "1234561705047510",
        "payment_url": "https://www.upigateway.dev/payment/pay.php?data=MTIzNDU2"
    }
}

Failed Response Schema

{
    "status": "false",
    "message": "Order_id Already Exist"
}

Check Order Status API

Status Verification POST URL

Form-Encoded Verification Payload (application/x-www-form-urlencoded)

{
    "user_token": "2048f66bef68633fa3262d7a398ab577",
    "order_id": "8052313697"
}

Success Status Response

{
    "status": "COMPLETED",
    "message": "Transaction Successfully",
    "result": {
        "txnStatus": "COMPLETED",
        "resultInfo": "Transaction Success",
        "orderId": "784525sdD",
        "status": "SUCCESS",
        "amount": "1",
        "date": "2024-01-12 13:22:08",
        "utr": "454525454245"
    }
}

Failed Verification Response

{
    "status": "ERROR",
    "message": "Transaction Not Found / Invalid Token"
}