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.
Yeh usi product ka developer hissa hai jo users dekhte hain: API se banaaya aapka invoice wahi hai jise woh payment confirm karke balance se pay karte hain.
Isse kya kar sakte hain
- Invoices — payment request banaayein (fixed crypto amount, fiat price, ya payer ki chuni open amount), payer ko link bhejein aur webhook URL configured ho to payment ke baad signed webhook paayein.
- Refunds — paid invoice ki poori ya partial amount usi payer ko waapas karein — anonymous payer ko bhi.
- Transfers — app balance se Telegram user ko crypto bhejein, ek-ek karke ya batch mein 100 tak.
- Checks — app balance se claimable links fund karein, sabke liye ya named recipients ke liye, payout settings ke mutaabik.
- Subscriptions — recurring billing: user ek baar plan approve karta hai aur har period apne aap charge hota hai.
- Balances, currencies, exchange rates aur stats — apne accounts ke liye read-only endpoints.
Yeh sab aapas mein kaise judta hai
- Aapke app ka balance personal wallet se alag hota hai.
- Users ke paid invoices usi app balance mein credit hote hain.
- Transfers aur checks usi balance se kharch karte hain.
- URL aur event subscriptions configure karne par supported payment events signed webhook ke roop mein server par bheje ja sakte hain.
Payments app ke andar settle hote hain, on-chain nahi: network fee nahi, confirmations ka intezaar nahi, aur funds aate hi use kar sakte hain. Option available ho to payer external wallet se bhi invoice ke liye funds laa sakta hai. Deposit uske apne wallet mein aata hai; automatic payment ke liye kaafi balance, outgoing restriction na hona aur valid payment deadline bhi chahiye. Apni taraf order poora karne se pehle invoice ka paid status confirm karein.
Crypto Bot ke saath compatible
API jaan-boojhkar Crypto Bot jaisa hai: wahi method names, {ok, result} response format, decimal-string amounts aur webhook signature scheme. Existing integration adapt karne ke liye base URL aur token badlein, phir use kiye methods hamaare reference ke mutaabik test karein. Crypto Bot ki tarah hamaara bhi alag bot aur base URL waala testnet hai.
Canonical token header TgPayCrypto-API-Token hai; 2026-09-07 se pehle
wala TgCryptoPay-API-Token abhi bhi chalta hai, aur Crypto-Pay-API-Token
ko alias ki tarah accept kiya jaata hai taaki maujooda client libraries bina
badle chalti rahein.
⚠️ Aapka API token ek spending key hai
Main token app ke payout mode aur limits ke andar payouts authorize karta hai. Ise server-side rakhein, client apps aur repositories se baahar, aur leak ka shak hote hi rotate karein. Jin servers ko full access nahi chahiye, unke liye sirf zaroori scopes waala restricted token banaayein — API reference dekhein.
Aage kya
Kya yeh article helpful tha?
Feedback ke liye shukriya.