airpay

Generate a UPI QR code for payment collection. Always confirm details with the user before calling. Required: orderid (alphanumeric, max 30 chars), amount (string, exactly 2 decimals e.g. "100.00"), buyer_email, buyer_phone (digits only, 8-15 digits). Optional: tid (max 15 chars), customvar, customer_consent ("Y"/"N"). After generation: display the QR image, payment link, and QR preview/download URLs from the response. Poll airpay_order_confirmation with ap_transactionid to verify payment.

airpay_generate_qr

Retrieve banks and payment options available for the merchant. Optional: chmod filter (lowercase) — one of: pg, ppc, nb, cash, emi, upi, btqr, payltr, va, enach. Omit for all modes.

airpay_get_bank_list

Initiate a refund for one or more Airpay transactions. Irreversible — requires two-phase confirmation. Required: transactions[] each with ap_transactionid (integer from verify-order, NOT an order ID) and amount (string, exactly 2 decimals e.g. "100.00"). TWO-PHASE FLOW: - Phase 1 (confirmed=false): Tool echoes back transaction details and returns a confirmation_token. Wait for explicit user approval. - Phase 2 (confirmed=true): Re-call with the same transactions + confirmed=true + confirmation_token. Any mismatch aborts. Never infer amounts from context. Use airpay_order_confirmation first to get ap_transactionid.

airpay_initiate_refund

Fetch the current status of an Airpay payment transaction. Pass EXACTLY ONE identifier: orderid (alphanumeric, max 30 chars), ap_transactionid (numeric), or rrn (numeric, max 12 digits). Never combine identifiers. Optional: terminal_id (8 digits), txn_type.

airpay_order_confirmation

Get details of a specific POS terminal transaction. Required: mercid (numeric), terminalid (exactly 8 numeric digits), uniqueid (alphanumeric), referenceid (alphanumeric, max 30 chars, no hyphens).

airpay_pos_transaction_detail

Check settlement date and UTR number for a completed Airpay transaction. Use for reconciliation only — for general payment status use airpay_order_confirmation. Pass EXACTLY ONE identifier: orderid, ap_transactionid, or rrn (max 12 digits). Optional: terminal_id (8 digits), txn_type. LIVE merchant IDs only.

airpay_settlement_status

Check the status of an Airpay subscription or mandate. Provide at least one of: subscription_id (numeric) or orderId (numeric). Optional: pgno for paginating TRANSACTION_HISTORY. Status values: SUBSCRIBED, UNSUBSCRIBED, COMPLETED, PAUSED.

airpay_check_subscription_status

Validate a UPI Virtual Payment Address (VPA) before initiating a payment. Required: customer_vpa in format username@bankname (e.g. 9876543210@ybl). Returns vpa_name if valid.

airpay_validate_vpa