Documentation
Getting Started Authentication Create Order API Check Order Status Error Codes

Getting Started

Welcome to the NexPayBridge API documentation. Our API allows merchants and developers to seamlessly process payments and check transaction statuses. All requests must be sent as secure HTTP POST requests.

Base URL: https://www.ipay.gtoools.site

Authentication

To make requests to our API, you need a unique API Key. You can find your API Key inside your customer dashboard after registering and purchasing an active subscription package.

Use this key as the user_token parameter in your POST payloads.

1. Create Order API

Generate a secure payment gateway redirection URL for your customers to complete their payments.

POST https://www.ipay.gtoools.site/api/create-order.php
Request Parameters (application/x-www-form-urlencoded)
Parameter Type Required Description
user_token string ✅ Yes Your unique API Key from the dashboard.
amount decimal ✅ Yes The payment amount in INR.
customer_name string ✅ Yes Full name of the customer.
customer_mobile string ✅ Yes Customer's 10-digit mobile number.
order_id string ❌ No Your custom, unique order ID. If empty, a unique ID is auto-generated.
redirect_url url ❌ No URL where your customers will be redirected after completing the payment.
Example cURL Request
curl -X POST https://www.ipay.gtoools.site/api/create-order.php \
  -d "user_token=YOUR_API_KEY" \
  -d "amount=100" \
  -d "customer_name=John Doe" \
  -d "customer_mobile=9876543210" \
  -d "order_id=MY-ORDER-001" \
  -d "redirect_url=https://yoursite.com/success"
Example Response (Success)
{
  "status": true,
  "message": "Order Created Successfully",
  "result": {
    "orderId": "MY-ORDER-001",
    "payment_url": "https://manage.globalnexpay.site/pay/abc123xyz"
  }
}

2. Check Order Status

Instantly verify the status of any transaction using your custom Order ID.

POST https://www.ipay.gtoools.site/api/check-order-status.php
Request Parameters
Parameter Type Required Description
user_token string ✅ Yes Your unique API Key.
order_id string ✅ Yes The custom Order ID you submitted when creating the transaction.
Example cURL Request
curl -X POST https://www.ipay.gtoools.site/api/check-order-status.php \
  -d "user_token=YOUR_API_KEY" \
  -d "order_id=MY-ORDER-001"
Example Response (Success/Paid)
{
  "status": true,
  "message": "Transaction Successfully",
  "result": {
    "txnStatus": "SUCCESS",
    "orderId": "MY-ORDER-001",
    "amount": "100",
    "date": "2026-06-14 10:35:00",
    "utr": "454525454245"
  }
}

Error Codes

The API uses standard HTTP response codes to indicate the success or failure of an API request.

HTTP Code Message Description
400 Missing required fields Some mandatory parameters (like amount or name) were left out.
401 Invalid API Key The user_token provided was incorrect or does not exist.
403 No active subscription found You do not have an active package or the package has expired.
404 Order not found The requested order ID was not found in your database.
500 Server error Internal processing issue either on the server or with the upstream provider.