Merchant API (Dasturchilar uchun)
Merchant API: ilovalar, invoyslar, oʻtkazmalar va webhooklar.
Merchant API nima?
Merchant API — bu ilovaning biznes va botlar uchun toʻlov API. Siz ilova yaratasiz, API token olasiz va uning yordamida Telegram foydalanuvchilariga invoys chiqarasiz, ularga mablagʻ yuborasiz va balansni tekshirasiz — hammasi oʻz kodingizdan turib.
Dasturchi sifatida ishni boshlash
Mini App ichida ilova yarating, uning API tokenini bir marta nusxalang va API metodlarini chaqirishni boshlang. Butun sozlash Yana → Merchant API boʻlimida turadi.
AI agentni ulash
Koding-agentingizga bitta URL bering — https://app.tgcryptopay.com/mcp — va u toʻlov integratsiyasini oʻzi yigʻib beradi: API hujjatlarini oʻqiydi, sotuvchi ilovangizni yaratadi, webhooklarni sozlaydi va kodni yozadi. Sizdan faqat yangi ilovani bir marta tasdiqlash soʻraladi — botdagi bitta tugma bilan. Terminal ham, tokenni qoʻlda nusxalash ham kerak emas.
Invoyslar orqali toʻlovlarni qabul qilish
Invoys — bu Telegram foydalanuvchisiga toʻlov qoʻyish usuli. Uni API orqali yaratasiz, toʻlovchiga havolasini yuborasiz va u toʻlovni tasdiqlagan zahoti summa ilova balansingizga tushadi.
Merchant API komissiyalari va limitlari
Invoyslardan platforma komissiyasi olinadi va u siz oladigan summadan ushlanadi; oʻtkazmalar va cheklar esa summa limitlari bilan chegaralangan. Quyidagi raqamlar — joriy sozlamalar, shartnoma shartlari emas: ular siz koʻrayotgan narsaga mos kelmasa, ilova haq, ishonchli manba esa — har doim oʻzingizning toʻlangan invoyslaringiz.
Merchant API maʼlumotnomasi
Barcha metodlar uchun umumiy qoidalar va katalogni oʻqish metodlari. Metodlar boʻyicha alohida sahifalar: invoyslar va qaytarishlar, oʻtkazmalar va cheklar, obunalar, webhooklar.
API maʼlumotnomasi: invoyslar va qaytarishlar
Invoys metodlari: createInvoice, getInvoices, deleteInvoice, refundInvoice. Umumiy qoidalar (autentifikatsiya, konvert, summalar, spend_id) — Merchant API maʼlumotnomasi sahifasida; bosqichma-bosqich yoʻriqnoma — Invoyslar orqali toʻlovlarni qabul qilish.
API maʼlumotnomasi: oʻtkazmalar va cheklar
Toʻlov chiqarish metodlari. Oʻtkazma ilova balansingizdan toʻgʻridan-toʻgʻri Telegram foydalanuvchisining hamyoniga mablagʻ yuboradi; chek — bu siz oldindan moliyalashtiradigan, faollashtiriladigan havola. Umumiy qoidalar (autentifikatsiya, konvert, summalar, spend_id) — Merchant API maʼlumotnomasi sahifasida.
API maʼlumotnomasi: obunalar
Muntazam toʻlovlar — Crypto Bot ustidagi kengaytma. Siz tarif yaratasiz (summa + davr), foydalanuvchilarga uni tasdiqlash havolasini yuborasiz, platforma esa har davrda ularning hamyon balansidan pulni yechib, komissiya chegirilgan holda ilova balansingizga oʻtkazadi. Umumiy qoidalar — Merchant API maʼlumotnomasi sahifasida.
API maʼlumotnomasi: webhooklar
Webhooklar hodisalarni sodir boʻlgan zahoti serveringizga yetkazadi. Ilovangizga Yana → Merchant API boʻlimida Webhook URL manzilini belgilang — shundan keyin platforma siz obuna boʻlgan har bir hodisa uchun imzolangan JSON-tanani POST qiladi.