StarsPaymee
Botni ochish
Biznes

Telegram Stars API webhook integratsiyasi

Webhook orqali buyurtma va to‘lov holatini real vaqtda oling: imzo tekshiruvi, idempotency, retry va best practice. StarsPaymee API bilan avtomatik integratsiya — 18 savol-javob.

Qisqa javob

Webhook — StarsPaymee API buyurtma yoki to‘lov holati o‘zgarganda sizning serveringizga avtomatik yuboradigan HTTP so‘rov. Uning yordamida siz statusni doim so‘rab turmaysiz (polling), aksincha, «delivered» yoki «failed» hodisasi kelishi bilan mijozga darhol javob berasiz. Webhook — avtomatik integratsiyaning yuragi.

Webhook nima va nega kerak?

Polling’da siz har necha soniyada «buyurtma tayyormi?» deb so‘raysiz — bu resurs sarflaydi va sekin. Webhook’da esa API o‘zi hodisa yuz berishi bilan sizga xabar yuboradi. Bu tezroq, arzonroq va real vaqtga yaqin.

Webhook’da nima keladi?
  • Hodisa turi — order.delivered, order.failed, payment.success.
  • Buyurtma ID va status.
  • Vaqt belgisi (timestamp).
  • Imzo (signature) — haqiqiylikni tekshirish uchun.

Webhook’ni qanday ulash mumkin?

  1. 1. URL beringStarsPaymee panelida webhook manzilingizni (HTTPS) ko‘rsatasiz.
  2. 2. Imzoni tekshiringHar bir kelgan so‘rovda signature’ni maxfiy kalit bilan tekshirasiz.
  3. 3. IdempotencyBir hodisa ID’sini saqlab, takror kelsa qayta ishlamaysiz.
  4. 4. Tez javob200 OK qaytarasiz; og‘ir ishni navbatga (queue) qo‘yasiz.

Webhook integratsiyasi kerakmi? Business bilan bog‘laning.

@StarsPaymee_bot

Yaxshi amaliyotlar

Ishonchli webhook uchun
  • Faqat HTTPS ishlating.
  • Imzoni har doim tekshiring.
  • Idempotency kaliti bilan takrorni oldini oling.
  • Qayta urinish (retry) siyosatini hisobga oling.
  • Hodisalarni loglang va monitoring qiling.

Bog‘liq: Stars API, Click callback va botga to‘lov API ulash.

Manbalar

Tez-tez beriladigan savollar

Webhook nima?
API buyurtma/to‘lov holati o‘zgarganda serveringizga yuboradigan avtomatik HTTP so‘rov.
Webhook va polling farqi?
Polling’da siz so‘rab turasiz; webhook’da API o‘zi xabar yuboradi — tezroq va arzonroq.
Webhook’ni qanday ulayman?
Panelda HTTPS URL bering; imzoni tekshiring va 200 OK qaytaring.
Qanday hodisalar keladi?
order.delivered, order.failed, payment.success va boshqalar.
Imzo (signature) nima uchun?
So‘rov haqiqiyligini tekshirish uchun — soxta webhook rad etiladi.
Idempotency nima?
Bir hodisa ikki marta kelsa, qayta ishlamaslik mexanizmi (ID bo‘yicha).
Qanchada javob berish kerak?
Tez — 200 OK; og‘ir ishni navbatga qo‘ying.
Retry bo‘ladimi?
Ha. Yetkazilmasa API qayta urinishi mumkin; idempotency bilan xavfsiz.
HTTPS shartmi?
Ha. Xavfsizlik uchun faqat HTTPS.
Test qilsam bo‘ladimi?
Ha. Sandbox’da webhook oqimini sinash mumkin.
Loglar kerakmi?
Ha. Hodisalarni loglang va monitoring qiling.
Webhook kelmasa nima qilaman?
Zaxira sifatida GET /orders/{id} bilan status tekshiriladi.
Bir nechta hodisaga obuna bo‘lsam bo‘ladimi?
Ha. Kerakli hodisa turlariga obuna bo‘lasiz.
Click callback bilan bog‘liqmi?
O‘xshash tamoyil; Click callback to‘lovni, webhook yetkazishni bildiradi.
Xavfsizlik uchun yana nima?
IP cheklovi, maxfiy kalit va vaqt belgisini tekshirish.
JSON formatidami?
Ha. Webhook tanasi JSON ko‘rinishida.
Hujjat beriladimi?
Ha. Hodisa formati va imzo tekshiruvi bilan.
Qanday boshlayman?
StarsPaymee Business sahifasidan ariza qoldiring.

Webhook’ni ulang

StarsPaymee Business orqali webhook bilan real vaqtli integratsiya quring.

Botni ochish