Merchant API

Telegram bot mein crypto payments: invoices, webhooks aur payouts

Merchant API bots aur services ke liye TgPay Crypto ka payment API hai. App banaayein, token lein, code se invoices issue karein aur signed payment webhooks receive karein. Compatible MCP agent integration mein madad kar sakta hai. Wallet balance se payments service ke andar settle hoti hain. On-chain payments ke liye chune hue network ki confirmations zaroori hain.

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. Use compatible agent client mein connect karein: agent docs padh sakta hai, app creation request kar sakta hai, webhooks configure kar sakta hai aur integration likhne mein madad kar sakta hai. Aap Telegram mein app approve karke result review aur test karte hain.

  1. Step 1

    Agent ko prompt send karein

    Aisa agent client use karein jismein aapke account ya workspace ke liye remote MCP support available ho. 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

    Integration poora karke test karein

    Agent ko restricted token milega aur woh invoices, subscription plans aur webhooks configure karne mein madad karega. Webhook signing key paane ke liye app mein main token rotate karein aur apne server par securely save karein.

Agent ka token payments accept aur webhooks configure kar sakta hai. Isse transfers, checks ya refunds nahi kiye jaa sakte; unke liye relevant permissions waala token chahiye.

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

Client settings mein app.tgpaycrypto.com/mcp ko remote MCP server ke taur par add karein. Availability aur menu ke naam client aur aapke account par depend karte hain.

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 feeWallet balance se payments, internal transfers aur checks service ke andar settle hote hain. On-chain invoice payments ke liye chune hue network ki confirmations zaroori 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

Remote MCP support waale agent client mein app.tgpaycrypto.com/mcp connect karein. Telegram mein aapki approval ke baad agent app banaane aur integration likhne mein madad kar sakta hai. Use karne se pehle result review aur test karein.

Crypto Bot API compatible

Jaane-pehchaane method names, {ok, result} response format aur HMAC webhook signatures. API URL aur token badlein, phir apni integration mein use hone waale methods test karein.

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.

Merchant API mein jaane-pehchaane method names, {ok, result} format, decimal-string amounts aur HMAC signatures hain. API URL aur token badlein; Crypto-Pay-API-Token header bhi alias ke taur par accepted hai. Switch karne se pehle documentation dekhein aur apne use kiye jaane waale methods aur assets test karein.

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 invoices, subscription plans, balances, stats aur webhook settings ke liye restricted token milta hai. Is token se transfers, checks ya refunds nahi kiye jaa sakte. In actions ke liye relevant permissions waala token chahiye.

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