Merchant API

Telegram bot mein crypto payments: invoices, webhooks aur payouts

Merchant API bots aur services ke liye TG Crypto Pay ka payment API hai. Bot mein app banaayein, token lein, apne code se invoices issue karein aur payment hote hi signed webhook receive karein. Ya MCP server ka URL apne AI agent ko dein aur integration usse karvaayein. Payments wallet ke andar settle hoti hain: network fee nahi, confirmations ka intezaar nahi.

Token lein API documentation AI agent ke zariye
API base — app.tgpaycrypto.com/pay/api · testnet — testnet.tgpaycrypto.com
Merchant API screen: app, token aur webhook events
Webhook delivered
Testnet
Kaise kaam karta hai

Token se pehli payment tak, chaar steps mein

Payment API ka jaana-pehchaana process: invoice banaayein, link dikhaayein aur event ka intezaar karein.

Step 1

App banaayein

Bot mein More → Merchant API kholein, naam aur webhook URL daalein. Token sirf ek baar dikhta hai — use apne server par save karein.

Step 2

Invoice banaayein

createInvoice ko ek POST request: crypto ya fiat amount, description aur deadline. Response mein payment link milta hai.

Step 3

User ko link dikhaayein

Apne bot mein button ya link dein: user ek tap mein wallet balance se pay karta hai.

Step 4

Webhook handle karein

Aapke server ko HMAC-SHA256 se signed invoice_paid milta hai. Signature verify karein, update_id se duplicate events hataayein, phir product deliver karein.

AI agent

Integration aapka AI agent kar sakta hai

Merchant API ka MCP server hai. Agent ko ek URL dein: woh docs padhega, app banaayega, webhook set karega aur code likhega. Terminal ya token manually copy karne ki zaroorat nahi.

  1. Step 1

    Agent ko prompt send karein

    Kisi bhi agent chat mein: Claude Code, claude.ai, Claude Desktop, ChatGPT ya doosra MCP client. Wahi prompt app mein More → Merchant API ke AI agent connection option mein bhi hai.

  2. Step 2

    Telegram mein app approve karein

    Agent t.me link dega. Bot dikhaayega ki kya request hua hai; aap ek button se approve karte hain. Link sirf ek baar kaam karta hai. Aapke approval se pehle kuch create nahi hota.

  3. Step 3

    Agent setup khud poora karega

    Use restricted token milega aur woh invoices, subscription plans aur webhook ka integration poora karega. Webhook signing key app mein aapke paas rehti hai.

Agent ka token payments accept aur webhook configure kar sakta hai, lekin transfer, checks issue ya refund nahi kar sakta. Funds baahar send karne ka control aapke paas hai, app ke full token ke saath.

Agent connection ki details documentation mein
Kisi bhi agent ke liye prompt
Connect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
Claude Code
claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
claude.ai, Claude Desktop, ChatGPT

Connector settings mein custom connector add karein aur app.tgpaycrypto.com/mcp paste karein

Testnet
https://testnet.tgpaycrypto.com/mcp
Terms

Fees aur limits

Yeh values page generate hone ke waqt app ke public limits catalog se li gayi hain. Latest values app mein dekhein.

Invoice feeMerchant pay karta hai: fee kaatkar amount app balance mein credit hota hai. Fee rate payment ke waqt lock hota hai; pehle se paid invoices ke liye nahi badalta.
3%
Volume discountPichhle 30 din ke volume ke saath fee apne aap kam hoti hai: $10,000 se 2.9%, $25,000 se 2.8%, $50,000 se 2.7%, $75,000 se 2.6% aur $100,000 se 2.5%.
2.5% tak
Network feeInvoices, transfers aur checks wallet ke andar settle hote hain, blockchain par nahi. Confirmations ka intezaar nahi: funds turant use kar sakte hain.
0
Users ko payoutstransfer method app balance se Telegram user ko ID ke zariye crypto send karta hai. transferBatch ek call mein 100 recipients tak pay karta hai. Wahi spend_id dobara use karne par double charge nahi hota.
$25,000 tak
Request limitscreateInvoice aur createCheck: 60 per minute; transfer aur refundInvoice: 30; transferBatch: 10. Read methods par limit nahi hai.
60 per minute
Webhook delivery10 seconds ke andar 2xx response par delivery complete maani jaati hai. Warna lagbhag teen din tak badhte intervals par retries hoti hain. Har retry mein update_id wahi rehta hai.
17 attempts tak
Features

Merchant API se kya kar sakte hain

App ka apna balance hai, aapke wallet se alag. Invoice payments ismein aati hain; payouts aur checks isi se jaate hain.

Invoices aur refunds

Fixed crypto amount, fiat price ya payer ke chune hue amount ka invoice. Full ya partial refunds, anonymous payers ko bhi.

Subscriptions

User plan ek baar approve karta hai. Uske baad har period ki payment apne aap charge hoti hai aur har charge ka event aata hai.

Transfers aur checks

App balance se Telegram users ko payouts aur checks — aise links jinhe koi bhi claim kar sakta hai.

Webhooks

invoice_paid hamesha send hota hai. Invoice expiry, check claims, refunds aur subscription events har app ke liye alag se enable karein.

Testnet

Wahi API aur wahi Mini App @tgpaycrypto_testnet_bot mein. Home screen ke button se har ghante ek baar test coins milte hain.

AI agent aur MCP

Agent ko app.tgpaycrypto.com/mcp dein. Woh app banaayega, webhook set karega aur integration likhega. Aap bot mein ek button se app approve karte hain.

Crypto Bot API compatible

Wahi method names, {ok, result} response format aur webhook signature scheme. Base URL aur token badlein; code wahi rahega.

Token aapke control mein

Permissions ke hisaab se restricted tokens, turant rotation, sirf listed users ko payouts ya payouts band karne ka mode, aur token leak hone ki situation ke liye daily payout limit.

FAQ

API ke baare mein sawaal

Tokens, webhook signatures, testing aur doosre API se migration ki zaroori baatein.

Current policy ke hisaab se app banaane ke liye identity verification complete hona zaroori ho sakta hai. Verification error aaye to app mein verification poora karein aur phir try karein.

TgPayCrypto-API-Signature header mein request body ka HMAC-SHA256 hota hai; key aapke main token ka SHA-256 hai. Body ke original bytes par signature compare karein. Verification pass hone se pehle product deliver na karein aur invoice paid mark na karein.

Haan. Merchant API mein Crypto Bot API ke methods, {ok, result} format, decimal-string amounts aur signature scheme wahi hain. Base URL aur token badlein; Crypto-Pay-API-Token header bhi alias ke taur par accepted hai.

Testnet par wahi API aur Mini App hai: bot @tgpaycrypto_testnet_bot, base testnet.tgpaycrypto.com/pay/api. Home screen ka “Get test coins” button har ghante ek baar 1,000 USDT, 1,000 GRAM aur 0.01 BTC deta hai. Mainnet aur testnet tokens ek doosre ki jagah kaam nahi karte.

Agent ko restricted token milta hai: invoices aur subscription plans banaana, balance aur stats padhna, webhook URL set karna. Transfers, checks aur refunds ke liye full token chahiye, jo aapke paas rehta hai.

Saare methods documentation meinSawaal — @tgpayhelpbot
Documentation

Merchant API ki public documentation

Methods ka reference, OpenAPI description aur step-by-step guides docs.tgpaycrypto.com par.

Ek shaam mein payments set up karein

@tgpaycryptobot mein app banaayein, ya AI agent ko MCP server ka link dein aur ek button se app approve karein.

Bot kholein