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.

Invoys komissiyasi

Toʻlovchi doim invoysning nominal summasini toʻlaydi. Komissiya sotuvchi tomonidan ushlanadi: ilova balansingizga komissiya chegirilgan summa tushadi.

Komissiya invoys summasining 3% ini tashkil qiladi va oxirgi 30 kunlik toʻlov aylanmangiz oʻsishi bilan avtomatik pasayadi:

Raqamning oʻzidan koʻra ikki qoida muhimroq:

• Komissiya toʻlov paytida aniqlanadi va qulflanadi. Stavkaning keyingi oʻzgarishi allaqachon toʻlangan invoysga hech qachon tegmaydi.
• Sizning stavkangiz aylanmangiz bilan birga oʻzgarishi mumkin. Oxirgi 30 kunlik oynadagi kattaroq toʻlov aylanmasi sizni avtomatik ravishda pastroq darajaga oʻtkazishi mumkin. Ariza berish kerak emas, sozlaydigan narsa yoʻq.

Aynan qancha ushlanganini bilish uchun toʻlangan invoysdagi fee_asset va fee_amount maydonlarini oʻqing — invoice_paid webhooki maʼlumotlaridan yoki getInvoices javobidan. Buxgalteriyangiz uchun asosiy raqam shu.

Qaytarish komissiyani qaytarmaydi: refundInvoice toʻlovchiga yuboradigan summa balansingizdan yechiladi, komissiya esa ushlangancha qoladi — qisman qaytarishda ham.

Obuna toʻlovlaridan ham sotuvchi tomonidagi komissiya olinadi; har bir toʻlov oʻz raqamini subscription_charged webhookining charge.fee maydonida bildiradi.

Oʻtkazma limitlari

transfer har bir oʻtkazma uchun minimum va maksimum bilan chegaralangan; ular har bir aktiv boʻyicha alohida raqam sifatida emas, joriy kurslar boʻyicha AQSh dollaridagi taxminiy ekvivalent sifatida qoʻllanadi. Bu oraliqdan tashqaridagi summa aniq xato bilan rad etiladi — integratsiyangizda amount_too_small va amount_too_big xatolarini qayta ishlang.

Oʻtkazma yana quyidagi hollarda oʻtmaydi:

• oʻsha aktiv ilova balansingizda yetmasa,
• qabul qiluvchi ilova foydalanuvchisi boʻlmasa — notanish yoki xato terilgan Telegram ID raqamiga toʻlov hech kim ochmaydigan hamyonga pul tushirish oʻrniga xato qaytaradi,
• qabul qiluvchining hisobi bloklangan boʻlsa.

Soʻrovlar limiti

Mablagʻni harakatlantiruvchi metodlar har bir ilova uchun chastota boʻyicha cheklangan (limit uning barcha tokenlari uchun umumiy): createInvoice va createCheck — daqiqasiga 60 ta, refundInvoice va transfer — 30 ta, transferBatch — 10 ta. Oʻqish metodlari cheklanmagan. Ehtiyotkor integratsiya buni hech qachon sezmaydi; qayta urinishlar sikli — sezadi: rate_limited kelganda soʻrovlarni ketma-ket yogʻdirmasdan, oraliqni kattalashtiring.

Idempotentlik

transfer uchun siz generatsiya qiladigan spend_id kaliti majburiy; createCheck va refundInvoice uni qabul qiladi. Xuddi shu qiymatni qayta ishlatish mablagʻni ikkinchi marta koʻchirish oʻrniga dastlabki natijani takrorlaydi — shuning uchun taymaut boʻyicha uzilgan soʻrovni oʻsha spend_id bilan qayta yuborish xavfsiz, yangi qiymatni esa faqat chinakam yangi toʻlov oladi.

Nima bepul

Merchant API ichida hech qayerda tarmoq komissiyasi yoʻq — invoyslar, oʻtkazmalar va cheklar ilova ichida, blokcheyndan tashqarida ijro etiladi. Invoyslardagi platforma komissiyasi — yagona yigʻim.

⚠️ Komissiyani hech qachon oʻzingiz hisoblab chiqarmang

Foizni kodga qatʼiy yozib qoʻymang va sof summani nominaldan tiklashga urinmang. Darajalar va stavkalar oʻzgaradi, eskirgan konstanta esa hisobingizni sezdirmay buzadi. Har safar invoysga yozilgan komissiyani oʻqing.