Accept UPI Payments in Telegram Bots

pip install famgateway pyTelegramBotAPI

import telebot
from telebot.types import InlineKeyboardMarkup, InlineKeyboardButton
from famgateway import FamGateway, FamGatewayError

# 1. Initialize Bot & FamGateway Client
BOT_TOKEN = "YOUR_TELEGRAM_BOT_TOKEN"
FAMGATEWAY_API_KEY = "YOUR_FAMGATEWAY_API_KEY"

bot = telebot.TeleBot(BOT_TOKEN)
fg = FamGateway(api_key=FAMGATEWAY_API_KEY)


@bot.message_handler(commands=['start'])
def handle_start(message):
    bot.reply_to(
        message, 
        "Welcome! Send /buy to purchase premium VIP membership for INR 50."
    )


@bot.message_handler(commands=['buy'])
def handle_buy(message):
    user_id = message.from_user.id
    user_name = message.from_user.first_name or "User"

    bot.send_message(message.chat.id, "Generating your dynamic UPI QR code...")

    try:
        # 2. Call FamGateway SDK to create order
        # Note: 'amount' is the only mandatory field. 'customer_name' is optional
        # because FamGateway extracts the buyer's real bank name from email receipts automatically.
        order = fg.create_order(
            amount=50.00,
            customer_name=f"{user_name} ({user_id})"  # Optional custom tracking tag
        )

        caption_text = (
            f"<b>Order Created:</b> <code>{order.order_id}</code>\n"
            f"<b>Amount to Pay:</b> <code>INR {order.payable_amount}</code>\n\n"
            f"Scan the QR code above with any UPI app (PhonePe, GPay, Paytm) or tap the button below:"
        )

        # 3. Create inline buttons for UPI App and Status Check
        markup = InlineKeyboardMarkup()
        markup.row(
            InlineKeyboardButton("Pay via UPI App", url=order.upi_intent),
            InlineKeyboardButton("Web Page", url=order.checkout_url)
        )
        markup.row(
            InlineKeyboardButton("Check Status", callback_data=f"check_{order.order_id}")
        )

        # 4. SEND DIRECT QR IMAGE IN CHAT (Zero Browser Redirect!)
        bot.send_photo(
            chat_id=message.chat.id,
            photo=order.qr_url,
            caption=caption_text,
            parse_mode="HTML",
            reply_markup=markup
        )

    except FamGatewayError as e:
        bot.send_message(message.chat.id, f"Error generating payment: {str(e)}")


@bot.callback_query_handler(func=lambda call: call.data.startswith("check_"))
def handle_status_check(call):
    order_id = call.data.replace("check_", "")
    
    try:
        # Check payment status via FamGateway API
        status = fg.get_order_status(order_id)
        
        if status.is_paid:
            bot.answer_callback_query(call.id, "Payment Verified! Thank you.")
            bot.send_message(
                call.message.chat.id,
                f"Payment Successful!\n\n"
                f"Order: {order_id}\n"
                f"Amount: INR {status.amount}\n"
                f"UTR: {status.utr}\n\n"
                f"Your VIP access has been unlocked."
            )
        else:
            bot.answer_callback_query(
                call.id, 
                "Payment not detected yet. Please ensure you completed the transaction in your UPI app.",
                show_alert=True
            )
    except FamGatewayError as e:
        bot.answer_callback_query(call.id, f"Status check error: {str(e)}", show_alert=True)


if __name__ == '__main__':
    print("Telegram bot is running...")
    bot.infinity_polling()

const { Telegraf, Markup } = require('telegraf');
const axios = require('axios');

const bot = new Telegraf('YOUR_TELEGRAM_BOT_TOKEN');
const FAMGATEWAY_API_KEY = 'YOUR_FAMGATEWAY_API_KEY';

bot.command('buy', async (ctx) => {
  await ctx.reply('Generating your UPI QR code...');

  try {
    // 1. Create order via FamGateway REST API (amount is required; customer_name is optional)
    const response = await axios.post('https://famgateway.in/api/create-order.php', {
      amount: 50.00,
      customer_name: `${ctx.from.first_name} (${ctx.from.id})` // Optional tracking tag
    }, {
      headers: {
        'Content-Type': 'application/json',
        'X-Api-Key': FAMGATEWAY_API_KEY
      }
    });

    const { order_id, payable_amount, qr_url, upi_intent } = response.data.data;

    // 2. Send QR Photo directly in chat
    await ctx.replyWithPhoto(qr_url, {
      caption: `<b>Pay INR ${payable_amount} via UPI</b>\nOrder ID: <code>${order_id}</code>`,
      parse_mode: 'HTML',
      ...Markup.inlineKeyboard([
        [Markup.button.url('Open UPI App', upi_intent)],
        [Markup.button.callback('Check Status', `check_${order_id}`)]
      ])
    });

  } catch (err) {
    const errorMsg = err.response?.data?.message || 'Failed to create payment order.';
    ctx.reply(`Error: ${errorMsg}`);
  }
});

// Handle Status Check Callback
bot.action(/check_(.+)/, async (ctx) => {
  const orderId = ctx.match[1];
  try {
    const res = await axios.get(`https://famgateway.in/api/verify-order.php?order_id=${orderId}&api_key=${FAMGATEWAY_API_KEY}`);
    if (res.data.status === 'success' && res.data.data.is_paid) {
      await ctx.answerCbQuery('Payment verified successfully!');
      await ctx.reply(`Payment Confirmed for Order: ${orderId}. Bank UTR: ${res.data.data.utr}`);
    } else {
      await ctx.answerCbQuery('Payment not received yet. Please try after completing UPI payment.', { show_alert: true });
    }
  } catch (e) {
    await ctx.answerCbQuery('Could not verify status. Try again shortly.', { show_alert: true });
  }
});

bot.launch();

<?php
// Telegram Webhook Handler in PHP
$botToken = "YOUR_TELEGRAM_BOT_TOKEN";
$apiKey   = "YOUR_FAMGATEWAY_API_KEY";

$content = file_get_contents("php://input");
$update = json_decode($content, true);

if (!$update) {
    exit('No input');
}

$chatId = $update['message']['chat']['id'] ?? ($update['callback_query']['message']['chat']['id'] ?? null);
$text   = $update['message']['text'] ?? '';
$callData = $update['callback_query']['data'] ?? '';

// Helper to make Telegram API requests
function tgRequest($method, $data, $botToken) {
    $url = "https://api.telegram.org/bot{$botToken}/{$method}";
    $ch = curl_init($url);
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $res = curl_exec($ch);
    curl_close($ch);
    return json_decode($res, true);
}

// 1. Handle /buy Command
if ($text === '/buy') {
    $userName = $update['message']['from']['first_name'] ?? 'User';

    // Call FamGateway create-order API (amount is required; customer_name is optional)
    $payload = json_encode([
        'amount' => 50.00,
        'customer_name' => "{$userName} ({$chatId})" // Optional custom tracking tag
    ]);

    $ch = curl_init('https://famgateway.in/api/create-order.php');
    curl_setopt($ch, CURLOPT_POST, true);
    curl_setopt($ch, CURLOPT_POSTFIELDS, $payload);
    curl_setopt($ch, CURLOPT_HTTPHEADER, [
        'Content-Type: application/json',
        'X-Api-Key: ' . $apiKey
    ]);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    $apiRes = curl_exec($ch);
    curl_close($ch);

    $orderData = json_decode($apiRes, true);

    if (isset($orderData['status']) && $orderData['status'] === 'success') {
        $order = $orderData['data'];
        
        $keyboard = json_encode([
            'inline_keyboard' => [
                [['text' => 'Pay via UPI App', 'url' => $order['upi_intent']]],
                [['text' => 'Check Status', 'callback_data' => 'chk_' . $order['order_id']]]
            ]
        ]);

        // Send QR Image directly into Telegram chat
        tgRequest('sendPhoto', [
            'chat_id' => $chatId,
            'photo' => $order['qr_url'],
            'caption' => "Pay INR {$order['payable_amount']} via UPI\nOrder: {$order['order_id']}",
            'reply_markup' => $keyboard
        ], $botToken);
    } else {
        tgRequest('sendMessage', [
            'chat_id' => $chatId,
            'text' => 'Error generating payment order. Please try again shortly.'
        ], $botToken);
    }
}

// 2. Handle Check Status Callback
if (strpos($callData, 'chk_') === 0) {
    $orderId = substr($callData, 4);
    $queryUrl = "https://famgateway.in/api/verify-order.php?order_id={$orderId}&api_key={$apiKey}";
    $chkRes = json_decode(file_get_contents($queryUrl), true);

    $callId = $update['callback_query']['id'];

    if (isset($chkRes['data']['is_paid']) && $chkRes['data']['is_paid'] === true) {
        tgRequest('answerCallbackQuery', ['callback_query_id' => $callId, 'text' => 'Payment Confirmed!'], $botToken);
        tgRequest('sendMessage', [
            'chat_id' => $chatId,
            'text' => "Payment Successful! Order {$orderId} verified. Thank you."
        ], $botToken);
    } else {
        tgRequest('answerCallbackQuery', [
            'callback_query_id' => $callId,
            'text' => 'Payment not detected yet. Please ensure payment is completed.',
            'show_alert' => true
        ], $botToken);
    }
}