Telegram botida kriptotoʻlovlar: invoyslar, webhooklar va foydalanuvchilarga toʻlovlar
Merchant API — botlar va servislar uchun TG Crypto Pay toʻlov APIʼsi. Botda ilova yarating, token oling, kod orqali invoyslar chiqaring va toʻlov boʻlishi bilan imzolangan webhookni qabul qiling. Yoki MCP server URL manzilini SI yordamchisiga bering — integratsiyani u bajaradi. Toʻlovlar hamyon ichida, tarmoq komissiyasisiz va tasdiqlarni kutmasdan amalga oshiriladi.
API asosiy manzili — app.tgpaycrypto.com/pay/api · sinov tarmogʻi — testnet.tgpaycrypto.com
Tokendan birinchi toʻlovgacha toʻrt qadam
Odatdagi toʻlov API jarayoni: invoys yarating, havolani koʻrsating va hodisani kuting.
Ilova yarating
Botda «Yana» → «Merchant API» boʻlimini ochib, nom va webhook URL manzilini kiriting. Token faqat bir marta koʻrsatiladi — uni serveringizda saqlang.
Invoys yarating
createInvoice uchun bitta POST soʻrovi: kripto yoki fiatdagi summa, tavsif va muddat. Javobda toʻlov havolasi keladi.
Havolani foydalanuvchiga koʻrsating
Botingizdagi tugma yoki havola orqali foydalanuvchi bir bosishda hamyon balansidan toʻlaydi.
Vebhukni qayta ishlang
Serveringizga HMAC-SHA256 bilan imzolangan invoice_paid keladi. Imzoni tekshiring, update_id boʻyicha takrorlarni ajrating va mahsulotni yetkazing.
Integratsiyani SI yordamchingiz bajarishi mumkin
Merchant APIʼda MCP server bor. Yordamchiga bitta URL bering: u hujjatlarni oʻqiydi, ilova yaratadi, webhookni sozlaydi va kod yozadi. Terminal ham, tokenni qoʻlda nusxalash ham kerak emas.
- Qadam 1
Yordamchiga soʻrov yuboring
Yordamchi bilan istalgan chat: Claude Code, claude.ai, Claude Desktop, ChatGPT yoki boshqa MCP mijozi. Shu soʻrov ilovada ham bor: «Yana» → «Merchant API» → SI yordamchisini ulash.
- Qadam 2
Ilovani Telegramʼda tasdiqlang
Yordamchi t.me havolasini beradi. Bot nima soʻralayotganini koʻrsatadi, siz bitta tugmani bosasiz. Havola bir martalik; tasdiqlamaguningizcha hech narsa yaratilmaydi.
- Qadam 3
Yordamchi sozlashni oʻzi tugatadi
U cheklangan tokenni olib, invoyslar, obuna tariflari va webhook integratsiyasini tugatadi. Webhook imzolash kaliti ilovada sizda qoladi.
Yordamchi tokeni toʻlovlarni qabul qilishi va webhookni sozlashi mumkin, lekin oʻtkazma, chek yoki qaytarish bajara olmaydi. Mablagʻni chiqarish sizning nazoratingizda — ilovadagi toʻliq token orqali.
Yordamchini ulash haqida batafsil — hujjatlardaConnect the tgpay MCP server (https://app.tgpaycrypto.com/mcp) and integrate payments via the TgPay Merchant API.
claude mcp add --transport http tgpay https://app.tgpaycrypto.com/mcp
Ulagich sozlamalarida yangi maxsus ulagich qoʻshing va app.tgpaycrypto.com/mcp manzilini kiriting
https://testnet.tgpaycrypto.com/mcp
Komissiyalar va limitlar
Qiymatlar ushbu sahifa yaratilgan paytda ilovaning ochiq limitlar katalogidan olingan. Eng yangi qiymatlar ilovada.
Merchant API imkoniyatlari
Ilovaning hamyoningizdan alohida balansi bor: invoys toʻlovlari uni toʻldiradi, foydalanuvchilarga toʻlovlar va cheklar undan sarflanadi.
Invoyslar va qaytarishlar
Kriptoda belgilangan summa, fiatdagi narx yoki toʻlovchi oʻzi tanlaydigan summa. Toʻliq yoki qisman qaytarish, jumladan anonim toʻlovchilarga ham.
Obunalar
Foydalanuvchi tarifni bir marta tasdiqlaydi. Keyin har davr uchun toʻlov avtomatik yechiladi va har safar hodisa yuboriladi.
Oʻtkazmalar va cheklar
Ilova balansidan Telegram foydalanuvchilariga toʻlovlar hamda istalgan kishi faollashtirishi mumkin boʻlgan chek havolalari.
Webhooklar
invoice_paid har doim yuboriladi. Invoys muddati tugashi, chek faollashishi, qaytarishlar va obuna hodisalari har ilova uchun alohida yoqiladi.
Sinov tarmogʻi
@tgpaycrypto_testnet_botʼda xuddi shu API va Mini App bor. Bosh ekrandagi tugma bilan soatiga bir marta sinov tangalarini olish mumkin.
SI yordamchisi va MCP
Yordamchiga app.tgpaycrypto.com/mcp manzilini bering: u ilova yaratadi, webhookni sozlaydi va integratsiyani yozadi. Siz ilovani botda bitta tugma bilan tasdiqlaysiz.
Crypto Bot API bilan mos
Usul nomlari, {ok, result} javob shakli va webhook imzo sxemasi bir xil. Asosiy URL va tokenni almashtiring — kod oʻzgarmaydi.
Token sizning nazoratingizda
Vakolatlari cheklangan tokenlar, tezkor almashtirish, faqat roʻyxatdagi foydalanuvchilarga toʻlash yoki toʻlovlarni oʻchirish rejimi va token sizib chiqishiga qarshi kunlik toʻlov limiti.
API haqida savollar
Tokenlar, webhook imzolari, sinov va boshqa APIʼdan oʻtish haqida.
Amaldagi siyosatga qarab, ilova yaratish uchun shaxsni tasdiqlash tugallangan boʻlishi talab qilinishi mumkin. Verifikatsiya xatosi chiqsa, ilovada tekshiruvdan oʻting va qayta urinib koʻring.
TgPayCrypto-API-Signature sarlavhasida soʻrov tanasining HMAC-SHA256 imzosi bor; kalit — asosiy tokeningizning SHA-256 xeshi. Imzoni tananing asl baytlari boʻyicha solishtiring. Tekshiruvdan oʻtmaguncha mahsulotni bermang va invoysni toʻlangan deb belgilamang.
Ha. Merchant API Crypto Bot API usullari, {ok, result} javob shakli, oʻnlik satr koʻrinishidagi summalar va imzo sxemasini takrorlaydi. Asosiy URL va tokenni almashtiring; Crypto-Pay-API-Token sarlavhasi ham muqobil sifatida qabul qilinadi.
Sinov tarmogʻida xuddi shu API va Mini App ishlaydi: bot — @tgpaycrypto_testnet_bot, asosiy manzil — testnet.tgpaycrypto.com/pay/api. Bosh ekrandagi sinov tangalari tugmasi soatiga bir marta 1 000 USDT, 1 000 GRAM va 0,01 BTC beradi. Asosiy va sinov tarmogʻi tokenlari bir-birining oʻrniga ishlamaydi.
Yordamchi cheklangan token oladi: invoyslar va obuna tariflari yaratadi, balans va statistikani oʻqiydi, webhook URL manzilini sozlaydi. Oʻtkazmalar, cheklar va qaytarishlar uchun toʻliq token kerak — u sizda qoladi.
Merchant API ochiq hujjatlari
Usullar maʼlumotnomasi, OpenAPI tavsifi va bosqichma-bosqich qoʻllanmalar docs.tgpaycrypto.com saytida.
Bir oqshomda toʻlovlarni ulang
@tgpaycryptobotʼda ilova yarating yoki SI yordamchingizga MCP server havolasini bering va ilovani bitta tugma bilan tasdiqlang.
Botni ochish