Merchant API (Developers ke liye)
Merchant API: apps, invoices, transfers, aur webhooks.
Merchant API kya hai?
Merchant API app ka payment API hai — businesses aur bots ke liye. Aap ek app banate hain, API token lete hain, aur usse Telegram users ko bill karte hain, unhe payouts bhejte hain, aur apna balance dekhte hain — sab apne code se.
Developer ke taur par shuruaat
Mini App mein ek app banayein, uska API token ek baar copy karein, aur API call karna shuru karein. Poora setup More → Merchant API ke neeche hai.
AI agent connect karein
Apne AI coding agent ko bas ek URL dein — https://app.tgcryptopay.com/mcp — aur wo aapke liye poora payment integration bana deta hai: API docs padhta hai, aapka merchant app banata hai, webhooks set karta hai aur code likh deta hai. Aapko sirf ek baar, bot mein ek button se, naye app ko approve karna hota hai. Na terminal ki zaroorat, na koi API token haath se copy karna.
Invoices se payments accept karna
Invoice hi wo tareeka hai jisse aap kisi Telegram user ko charge karte hain. Aap API se ek invoice banate hain, payer ko uska link bhejte hain, aur uske confirm karte hi aapka app balance credit ho jaata hai.
Merchant API ki fees aur limits
Invoices par ek platform fee lagti hai jo aapko milne wale amount mein se jaati hai; transfers aur checks amount limits se bandhe hote hain. Neeche ke figures maujooda settings hain, contract terms nahi — agar yeh app mein dikhne wale figures se alag hon, to app hi sahi hai, aur sabse bharosemand source hamesha aapke apne paid invoices hain.
Merchant API reference
Wo conventions jo har method mein common hain, aur saath mein read-only catalog methods. Har method ke apne pages: invoices aur refunds, transfers aur checks, subscriptions, webhooks.
API reference: invoices aur refunds
Invoice ke methods: createInvoice, getInvoices, deleteInvoice, refundInvoice. Conventions (auth, envelope, amounts, spend_id) Merchant API reference page par hain; step-by-step walkthrough hai Invoices se payments accept karna.
API reference: transfers aur checks
Payout ke methods. transfer aapke app balance se seedhe kisi Telegram user ke wallet mein funds bhejta hai; check ek aisa link hai jise claim kiya ja sakta hai aur jise aap pehle se fund karte hain. Conventions (auth, envelope, amounts, spend_id) Merchant API reference page par hain.
API reference: subscriptions
Recurring billing — Crypto Bot ke upar ek extension. Aap ek plan banate hain (amount + period), users ko uska approval link bhejte hain, aur platform har period unke wallet balance se charge karta hai aur fee kaat kar aapke app balance mein credit kar deta hai. Conventions Merchant API reference page par hain.
API reference: webhooks
Webhooks har event ko hote hi aapke server par push kar dete hain. Apne app par More → Merchant API mein Webhook URL set karein; uske baad platform har us event ke liye ek signed JSON body POST karta hai jiske liye aapne subscribe kiya hai.