PayZapy UPI Gateway API
Direct-to-Bank UPI Payment Infrastructure

Programmable UPI Checkout & Real-Time UTR Verification.

PayZapy transforms your FamPay, Paytm Business, and BharatPe merchant accounts into a developer-grade payment gateway. Generate dynamic UPI QR codes via REST API, verify settlements strictly against bank and provider ledgers, and trigger cryptographic webhooks with 0% transaction commission.

Gateway Cut
0.00%
Direct UPI settlement to your VPA
Supported Engines
3 Providers
FamPay (Free), Paytm & BharatPe
Credential Vault
AES-256
GCM Encryption + HMAC Webhooks
3D Neumorphic Gateway Terminal
ORDER #ord_m9z8x4a1 • AUTO-VERIFIED
PAID
PayZapy 3D Neumorphic UPI Payment Terminal and Verification Engine
1. Create Order
POST /api/v1/create
2. Auto-Verify
IMAP / MID / Prism
3. Webhook Sent
HMAC-SHA256 Signed
1. What PayZapy Does

Direct-to-Bank UPI Infrastructure Without Intermediary Holds

Conventional payment gateways deduct 2%–3% fees and hold funds for T+2 days. PayZapy generates QR codes for your own merchant UPI ID so funds settle into your bank account immediately while PayZapy handles real-time payment verification and order webhooks.

DYNAMIC QR & INTENT

Instant UPI QR & Hosted Checkout

Call POST /api/v1/create to generate a scannable QR code data URL, standard upi://pay intent deep-link, and a hosted /pay/{order_id} page with automatic 8-second status polling.

upi://pay?pa=merchant@fam&am=250.00&tr=ord_...
REPLAY PROTECTION

Strict Ledger & Paise Collision Matching

For concurrent FamPay orders of the same base amount, PayZapy automatically assigns a unique payable_amount paise offset and locks every verified UTR in seen_utrs so no transaction can ever be claimed twice.

Atomic Lock: seen_utrs PRIMARY KEY (utr)
RELIABLE DELIVERY

HMAC-SHA256 Webhooks & Retry Queue

Every settled payment dispatches an HTTP POST callback signed with your whsec_... secret in X-FamPay-Signature and X-PayZapy-Signature, backed by automatic exponential backoff retries.

hash_hmac('sha256', $rawBody, $webhookSecret)
2. Supported Payment Providers

Three Purpose-Built UPI Verification Engines

Set a default provider in your Merchant Console or route individual orders dynamically via /api/v1/{fampay|paytm|bharatpe}/create.

FamPay + Gmail IMAP

Free Forever Tier
FAMPAY

Connects to your Gmail inbox via SSL IMAP using a 16-character Google App Password to parse incoming FamPay credit alert emails and extract the bank UTR automatically.

Required Console Setup
  • FamPay UPI ID: e.g. yourname@fam
  • Gmail Address: Receiving FamPay alerts
  • 16-Char App Password: AES-256-GCM encrypted
Verification: Payable Amount + Window + UTR

Paytm Business

Direct Order Status API
PAYTM

Embeds the unique order reference into the UPI tr parameter and queries https://securegw.paytm.in/order/status using your MID for instant TXN_SUCCESS verification.

Required Console Setup
  • Paytm Business UPI ID: paytmqr...@paytm
  • Paytm Merchant ID (MID): Official MID
  • Zero Manual UTR: 100% automatic polling
Verification: MID + ORDERID + TXN_SUCCESS

BharatPe Merchant

Prism Ledger API
BHARATPE

Polls BharatPe's merchant transaction feed using your encrypted API token and Merchant ID to match incoming SUCCESS UPI collections within the active order window.

Required Console Setup
  • BharatPe UPI ID: BHARATPE...@fbpe
  • Merchant ID: Numeric BharatPe MID
  • BharatPe API Token: AES-256-GCM encrypted
Verification: Bank Reference + Window + Exact Amt
3. How Payment Requests & Verification Work

Deterministic 4-Stage Payment Verification Lifecycle

PayZapy never trusts client-side success signals or unverified UTR claims. Every order transitions through a strict server-side verification pipeline.

Stage 1: Order Creation & Paise Allocation

T + 0.0s

Your server calls POST /api/v1/create with X-API-Key. PayZapy validates your API access, computes a collision-free payable_amount if needed, and generates the QR and /pay/{order_id} link.

Stage 2: Customer Scans QR or Taps Pay via App

CHECKOUT

The customer completes the UPI transfer using any UPI app (Google Pay, PhonePe, Paytm, FamPay, BHIM). The hosted checkout page polls /api/orders?action=get&id=... every 8 seconds.

Stage 3: Provider Ledger Match & UTR Deduplication

STRICT MATCH

PayZapy verifies the transaction directly against Gmail IMAP (FamPay), Paytm Order Status API, or BharatPe Prism API, confirming exact amount, post-creation timestamp, and inserting the UTR into seen_utrs.

Stage 4: Instant Settlement & Signed Webhook

PAID

The order status transitions atomically to paid, the customer sees a printable verified receipt, and your webhook URL receives an HMAC-SHA256 signed event payload.

Hosted 3D Neumorphic Checkout Experience /pay/{order_id}
PayZapy 3D Mobile UPI QR Checkout Interface
Cryptographic AES-256-GCM & HMAC-SHA256 Security Zero Plaintext Secrets
PayZapy 3D Cryptographic Security Vault
4. How To Integrate The API

Production-Ready REST API v1 Endpoints

Pass your fam_live_... or fam_test_... key in the X-API-Key header. Copy the snippets below to integrate PayZapy in minutes.

Full API Reference
POST /api/v1/create (PHP cURL)
<?php
$payload = [
    'amount'           => 250.00,
    'payment_provider' => 'fampay', // 'fampay' | 'paytm' | 'bharatpe'
    'client_order_id'  => 'INV-2026-991',
    'customer_name'    => 'Rohan Gupta',
    'customer_email'   => 'rohan@example.com',
    'description'      => 'Pro Plan Renewal',
    'redirect_url'     => 'https://yourstore.com/thank-you',
    'expiry_minutes'   => 15
];

$ch = curl_init('https://freex.mixygrow.in/api/v1/create');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER     => [
        'Content-Type: application/json',
        'X-API-Key: fam_live_your_api_key_here'
    ],
    CURLOPT_POSTFIELDS     => json_encode($payload)
]);

$response = json_decode(curl_exec($ch), true);
// Redirect customer to $response['payment_url']
200 OK — JSON Response HTTP 200
{
  "ok": true,
  "order_id": "ord_m9z8x4a1",
  "amount": 250.00,
  "payable_amount": 250.00,
  "payment_provider": "fampay",
  "status": "pending",
  "upi_link": "upi://pay?pa=merchant@fam&pn=Store&am=250.00&cu=INR&tr=ord_m9z8x4a1",
  "payment_url": "https://freex.mixygrow.in/pay/ord_m9z8x4a1",
  "qr_data": "data:image/png;base64,iVBORw0KGgoAAAANS...",
  "expires_at": "2026-10-19T07:30:00.000Z"
}
Merchant Telemetry & Control Center
Sculpted 3D Neumorphic Command Interface
LIVE CONSOLE
PayZapy 3D Merchant Dashboard and Telemetry Console
Live & Test Keys
1-Click Rotate
Provider Vault
Live Diagnostics
Auto-Polling
Every 15s
5. What The Merchant Dashboard Offers

Complete Operational Control Over Orders, Providers, Keys & Webhooks

Designed for both developers and non-technical store owners, the PayZapy Merchant Console gives you real-time visibility into every UPI transaction.

Instant QR Generator Modal

Create live UPI payment links and QR codes right from your browser without writing a single line of code.

Provider Connection Tester

Verify your Gmail IMAP app password, Paytm Business MID, or BharatPe API feed with one-click live diagnostics.

Live & Sandbox API Keys

Manage your fam_live_ production key and fam_test_ sandbox key (with 5 free test requests).

Webhook Delivery & Retry Logs

Send test webhook events, inspect HTTP status codes and response bodies, and manually retry failed callbacks.

Pricing & Gateway Plans

FamPay is Free Forever. Upgrade Anytime for Paytm & BharatPe.

PayZapy never takes a percentage of your sales. Start accepting FamPay UPI payments for free, or unlock Paytm Business and BharatPe with a flat monthly plan.

FREE FOREVER

FamPay Direct Tier

Complete FamPay + Gmail IMAP automatic payment verification with 5 sandbox test requests.

₹0 forever
  • Unlimited Live FamPay UPI Payment Orders
  • 5 Free Sandbox Test Key Requests (fam_test_)
  • Automatic Gmail IMAP Credit Alert Matching
  • Unique Paise Collision & UTR Replay Guard
  • HMAC-SHA256 Signed Webhooks & Retry Queue
Create Account & Start
30 DAYS ACCESS RECOMMENDED

Starter

Full access to Paytm Business & BharatPe APIs for 1 month.

₹39 / 30 days
  • Unlimited Paytm Business & BharatPe Orders
  • FamPay + Gmail IMAP Auto-Verify Included
  • Zero Per-Transaction Commission (0% Cut)
  • HMAC-SHA256 Signed Webhook Callbacks
  • Hosted 3D UPI QR Checkout Pages
Create Account & Start
60 DAYS ACCESS

Smart Choice

Full access to Paytm Business & BharatPe APIs for 2 months.

₹69 / 60 days
  • Unlimited Paytm Business & BharatPe Orders
  • FamPay + Gmail IMAP Auto-Verify Included
  • Zero Per-Transaction Commission (0% Cut)
  • HMAC-SHA256 Signed Webhook Callbacks
  • Hosted 3D UPI QR Checkout Pages
Create Account & Start
90 DAYS ACCESS

Business

Full access to Paytm Business & BharatPe APIs for 3 months.

₹89 / 90 days
  • Unlimited Paytm Business & BharatPe Orders
  • FamPay + Gmail IMAP Auto-Verify Included
  • Zero Per-Transaction Commission (0% Cut)
  • HMAC-SHA256 Signed Webhook Callbacks
  • Hosted 3D UPI QR Checkout Pages
Create Account & Start
6. DOCUMENTATION & SUPPORT

Developer Documentation & Provider Setup Guides

Read complete endpoint specs (/api/v1/create, /api/v1/check, /api/v1/verify) and step-by-step setup guides for Gmail App Passwords, Paytm Business MIDs, and BharatPe tokens.

7. GET STARTED IN 3 STEPS

Go Live With Direct UPI Collections Today

STEP 1 Create your merchant account in 30 seconds.
STEP 2 Connect FamPay (free), Paytm Business, or BharatPe in the Console.
STEP 3 Copy your fam_live_ API key and start generating UPI QRs.