Accept UPI payments.
Verify them automatically.
FamPay Gateway turns a FamPay UPI ID into a secured payment API: create an order, show the buyer a QR, and the payment is verified from your Gmail alerts within seconds. No manual screenshots, no double-spends.
● Setup pending — finish /setup to go live
Unique-paise matching
Every order gets a unique amount (₹100.01–₹100.09). The verifier matches the Gmail alert to the exact order — two buyers paying the same base amount never collide.
15-minute expiry
Orders expire after 15 minutes. Old payment emails are ignored, so a stale receipt can never verify a new order.
UTR replay protection
Every UTR is recorded forever. A transaction ID that already verified an order can never be used again.
Webhooks
Verified payments POST to your webhook URL with an HMAC-SHA256 signature, so your bot or store can credit instantly.
API keys
Create, revoke and rate-limit API keys per integration. Keys are stored hashed and shown only once.
Encrypted secrets
Your Gmail app password and webhook secret are AES-256-GCM encrypted at rest and never leave the server.
API — quick start
Base URL https://fampay.shubhxlab.xyz/api/v1 · Auth: X-API-Key header · 60 requests/minute per key.
Create an order
curl -X POST https://fampay.shubhxlab.xyz/api/v1/orders \
-H "X-API-Key: fp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 100, "reference": "order-123"}'
{
"order_id": "FP-MABC1234ABCD",
"pay_amount": 100.05,
"upi_uri": "upi://pay?pa=you@fam&pn=Your+Name&am=100.05&cu=INR",
"qr_image": "data:image/png;base64,iVBORw0K...",
"expires_at": "2026-11-19T13:30:00.000Z",
"status": "pending"
}
Show the buyer the QR (or open the upi_uri). They pay the exact pay_amount — the odd paise identify their payment. The order verifies automatically, usually within a minute.
Check an order
curl https://fampay.shubhxlab.xyz/api/v1/orders/FP-MABC1234ABCD \ -H "X-API-Key: fp_YOUR_KEY"
{
"order_id": "FP-MABC1234ABCD",
"amount": 100,
"pay_amount": 100.05,
"status": "verified",
"utr": "123456789012",
"sender_name": "Buyer Name",
"verified_at": "2026-11-19T13:16:02.000Z",
"expires_at": "2026-11-19T13:30:00.000Z"
}
Verify by UTR (manual fallback)
curl -X POST https://fampay.shubhxlab.xyz/api/v1/verify \
-H "X-API-Key: fp_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"amount": 100.05, "utr": "123456789012"}'
List orders
curl "https://fampay.shubhxlab.xyz/api/v1/orders?limit=20" \ -H "X-API-Key: fp_YOUR_KEY"
How verification works
When a buyer pays your FamPay UPI ID, FamPay emails a payment alert to your Gmail. The gateway checks Gmail over IMAP every 20 seconds for an alert matching the order's unique amount within the last 15 minutes, extracts the UTR and sender, marks the order verified and fires your webhook. If all 9 paise offsets for an amount are busy, order creation returns 409 with retry_after — try again shortly.