Developers

API Documentation

Integrate UPI payments into your website or app in minutes.

Base URL
https://upi.teamhydrashop.com

All API requests should be sent over HTTPS.

Authentication

Pass your API key in the request body or header as configured in your dashboard. Keep your key secret.

Webhooks

Configure a callback URL in your dashboard to receive real-time status updates for every transaction.

1. Create Order

Endpoint: POST /api/create-order

Parameters:

  • api_key - Your API key
  • signature - HMAC-SHA256 of sorted parameters (excluding signature)
  • amount - Amount to collect
  • customer_mobile - Customer mobile number
  • order_id - Your unique order ID
  • remark1, remark2 - Optional references
{
  "api_key": "YOUR_API_KEY",
  "signature": "HMAC_SHA256_SIGNATURE",
  "amount": 100,
  "customer_mobile": "9876543210",
  "order_id": "ORD123456789",
  "remark1": "ORDER123"
}

Legacy user_token is still accepted but we recommend migrating to signed API keys.

2. Check Order Status

Endpoint: POST /api/check-order-status

Parameters:

  • api_key - Your API key
  • signature - HMAC-SHA256 of sorted parameters (excluding signature)
  • order_id - Order ID returned from create order
{
  "api_key": "YOUR_API_KEY",
  "signature": "HMAC_SHA256_SIGNATURE",
  "order_id": "ORD123456789"
}

Webhook Payload

When a payment succeeds, a POST request is sent to your callback URL with the following fields and an X-Webhook-Signature header:

status=SUCCESS
&order_id=ORD123456789
&customer_mobile=9876543210
&amount=100
&remark1=ORDER123
&remark2=

Verify the webhook using HMAC-SHA256(sorted_query_string, api_secret).