How FamGateway Works: 0% Fee Automated UPI Settlement Engine (2026 Guide)

FamGateway was engineered to solve a critical barrier in the Indian FinTech ecosystem: enabling developers, students, and indie creators to accept automated UPI payments without requiring enterprise banking aggregators, GST registrations, or expensive commercial setups.

The Non-Custodial Architecture

Traditional payment gateways act as custodians: they collect customer money into nodal accounts, hold it for 2 to 3 days (T+2 settlement), deduct 2% to 3% processing fees, and enforce strict corporate verification.

FamGateway takes a completely decentralized, non-custodial software approach:

Step-by-Step Payment Lifecycle

1. Order Session Creation

When a customer initiates a payment on your website or application, your backend calls POST /api/create-order with your X-Api-Key header and order amount in JSON format. FamGateway provisions an atomic order session with a unique Order ID and an exact 5-minute TTL (300 seconds) validity window.

2. Payment via Dynamic QR or Hosted Checkout

The customer scans the generated dynamic UPI QR code or pays via our mobile-optimized Hosted Checkout. The payment settles immediately inside the merchant's personal FamPay account.

3. Real-Time Stateless Receipt Inspection

FamPay dispatches an instant payment confirmation receipt to the merchant's linked Gmail address from [email protected]. FamGateway's backend daemon performs real-time IMAP inspection:

• The daemon inspects only the transactional receipt headers (udate) and message body in temporary RAM.
• It extracts the 12-digit Bank UTR, internal FamPay Transaction ID, Sender Name, and Timestamp.

4. Bank UTR Idempotency & Database Locking

Using ACID row-level locking (SELECT ... FOR UPDATE), the engine verifies that the extracted Bank UTR has never been used to claim any prior order. Once validated, the UTR is permanently bound to the current Order ID, preventing replay attacks and race conditions.

5. HMAC-SHA256 Signed Webhook Dispatch

Within seconds of confirmation, FamGateway dispatches an authenticated JSON webhook to the merchant's server endpoint:

{
  "event": "payment.success",
  "order_id": "fg_A1B2C3D4",
  "amount": "499.00",
  "utr": "420987654321",
  "sender_name": "Rahul Sharma",
  "timestamp": 1756473072
}

The merchant server validates the signature in header HTTP_X_FAMGATEWAY_SIGNATURE and automatically delivers the digital goods or activates the user's subscription.

Key Advantages for Developers

• 0% Platform Fees: No setup fees, no monthly maintenance, and no per-transaction cuts.
• Exact Clean Amounts: No awkward decimal increments (₹499.04) required for collision prevention.
• Plug-and-Play Integration: Ready SDKs for PHP, Python, and Node.js with built-in webhook handlers.

Related Technical Guides & Resources

Explore the Full API Documentation & Quickstart →

Back to Homepage →