DEVELOPER GUIDE

Documentation

Two API calls to create a checkout and read its status.

Before you start

Configure your UPI ID and Gmail in Integrations. Copy your key from API key. Your API base URL is https://famtrack.zcorex.shop.

1. Create a payment link

POST /api/qr
Authorization: Bearer YOUR_INTEGRATION_KEY
Content-Type: application/json

{"amount":"1.00","reference":"order_001"}

Creation returns an order ID and checkout URL. It does not prove payment. The response includes requested_amount, the actual payable amount, and amount_adjustment. If another active checkout uses the amount, the payable total increases in ₹0.01 steps, up to ₹0.99. Show the actual payable total to the customer.

2. Check payment status

POST /api/verify_order
Authorization: Bearer YOUR_INTEGRATION_KEY
Content-Type: application/json

{"order_id":"ord_..."}

Statuses are pending, success, expired and cancelled. Verify amount and reference before fulfillment. authenticated_email_unique_match means an authenticated incoming email matched exactly one checkout by amount and payment window.

What email verification means

The FamApp email has no checkout reference or recipient UPI ID. This app checks its sender authentication, amount, transaction ID and UTR, then matches it when exactly one checkout fits the amount and receipt time. It cannot rule out an unrelated transfer of the same amount to your account during that window. This is email evidence, not a bank settlement API.