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 side hai jo users ko dikhta hai: API se banaya gaya invoice wahi invoice hai jise wo ek tap mein apne balance se pay karte hain.

Isse kya kar sakte hain

• Invoices — ek payment request banayein (fixed crypto amount, fiat mein price, ya open amount jo payer khud daale), payer ko uska link bhejein, aur pay hote hi signed callback mil jaata hai.
• Refunds — kisi paid invoice ka amount, poora ya uska koi hissa, jisne pay kiya usi ko wapas karein — anonymous payers bhi shaamil.
• Transfers — apne app balance se kisi Telegram user ko crypto send karein, ek-ek karke ya ek batch mein 100 tak.
• Checks — apne app balance se aise redeemable links banayein jinhe koi bhi claim kar sake.
• Subscriptions — recurring billing: users ek baar plan approve karte hain aur har period par apne aap charge ho jaate hain.
• Balances, currencies, exchange rates aur stats — apni bookkeeping ke liye read-only endpoints.

Yeh sab aapas mein kaise judta hai

1. Aapka app ek balance rakhta hai, aapke personal wallet se alag.
2. Users jo invoices pay karte hain wo usi app balance mein credit hote hain.
3. Transfers aur checks usi mein se kharch karte hain.
4. Har zaroori event aapke server par signed webhook ki tarah push kiya ja sakta hai.

Payments app ke andar settle hote hain, on-chain nahi: na network fee, na confirmations ka intezaar, aur funds aate hi use karne layak hote hain. Payer phir bhi kisi external wallet se invoice fund kar sakta hai — uska deposit uske apne wallet mein aata hai aur invoice apne aap usi se settle ho jaata hai; aapki taraf se yeh bilkul kisi bhi doosre paid invoice jaisa hi dikhta hai.

Crypto Bot ke saath compatible

API jaan-boojh kar Crypto Bot jaisa hi rakha gaya hai: wahi method names, wahi {ok, result} envelope, wahi decimal-string amounts, wahi webhook signature scheme. Kisi maujooda Crypto Bot integration ko sirf base URL aur token badal kar hamari taraf point kiya ja sakta hai — request aur response ke shapes nahi badalte.

Canonical token header TgPayCrypto-API-Token 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

Jiske paas bhi yeh hai wo aapke app ka balance bahar transfer kar sakta hai. Ise server-side rakhein, client apps aur repositories se bahar, aur leak hone ka shak hote hi rotate karein. Jin servers ko poora access nahi chahiye, unke liye ek restricted token banayein jo sirf unhi scopes tak limited ho jo wo asal mein use karte hain — dekhein API reference.

Aage kya

• Developer ke taur par shuruaat
• Invoices se payments accept karna
• Merchant API reference