01
@HamyonAPIBot ni boshlang
Telegram'da @HamyonAPIBot botini oching va /start buyrug'ini yuboring. Bot sizga shop_id va shop_key beradi.
Hamyon API orqali HUMO va UZCARD kartalariga tushgan to'lovlarni 5–30 soniya ichida real vaqtda aniqlang va botingizni to'liq avtomatlashtiring.
Atigi 4 qadamda o'z Telegram botingizga to'liq avtomatlashtirilgan to'lov tizimini ulang
Telegram'da @HamyonAPIBot botini oching va /start buyrug'ini yuboring. Bot sizga shop_id va shop_key beradi.
@HumoCardBot (HUMO uchun) yoki @CardXabarBot (UZCARD uchun) orqali o'z karta xabarnotlarini ulashtiring.
API orqali to'lov so'rovini yuboring: shop_id, shop_key va amount. Javobda payment_id va karta raqami qaytadi — mijozga shuni ko'rsatasiz.
Keyingi ish bizda. Kartani biz kuzatamiz: pul tushishi bilan complete_url ga paid yuboriladi, 5 daqiqa ichida topilmasa — cancel. Sizning tomoningizda cron ham, holatni so'rab turish ham kerak emas.
Bizning platformamiz bilan to'lov tizimini qo'shish hech qachon bunday oson bo'lmagan
To'lovlar 5–30 soniya ichida avtomatik aniqlanadi. Hech qanday kechikish yo'q.
Sizning login va karta ma'lumotlaringiz faqat sizga ko'rinadi. Mablag' o'zgarmaydi.
HUMO va UZCARD — O'zbekistondagi barcha asosiy karta tizimlari qo'llab-quvvatlanadi.
Telegram botingiz orqali barcha to'lovlarni boshqaring. Alohida panel kerak emas.
REST API bilan ishlash juda oson. Har qanday dasturlash tilida integratsiya qiling.
Tizim kechayu kunduz ishlaydi. Hech qanday texnik tanaffus yo'q.
To'lov tasdiqlanganda darhol webhook orqali xabar oling va botingizni avtomatlang.
Har bir to'lovning holatini GET so'rovi orqali istalgan vaqtda tekshiring.
Qo'llab-quvvatlanadigan karta tizimlari
Quyidagi simulyatorda Hamyon API qanday ishlashini real vaqtda ko'ring
Oddiy REST API — istalgan dasturlash tili bilan bir necha daqiqada ulaning
/payment/createprepare_urlcomplete_url/payment/status/payment/cancelBase URL
https://hamyon-api.uzParametrlar · /payment/create
shop_idstring*requiredshop_keystring*requiredamountnumber · so'm*requiredorder_idstring · o'z buyurtma raqamingizCallback imzosi
signmd5(shop_id + payment_id + amount + shop_key)To'lov muddati
5 daqiqakeyin avtomatik cancelcomplete_url ga status=paid yuboriladi.
5 daqiqa ichida topilmasa — o'sha manzilga status=cancel
keladi. Ya'ni har bir to'lov albatta bitta yakuniy callback bilan
tugaydi; siz hech narsa so'rab turishingiz shart emas.
Eng ko'p beriladigan savollarga javoblarni shu yerdan toping
Hamyon API — Telegram botlaringizga HUMO va UZCARD kartalari orqali to'lov qabul qilishni ulash xizmati. Siz oddiy REST so'rov yuborasiz, tizim esa kartangizga tushgan to'lovni avtomatik aniqlab, botingizga xabar beradi. Alohida to'lov terminali yoki shartnoma kerak emas.
Siz @HumoCardBot yoki @CardXabarBot karta xabarnoma botlarini tizimga ulaysiz. POST /payment/create orqali to'lov yaratganingizda tizim shu summani kutish holatiga qo'yadi va kartani o'zi kuzata boshlaydi (har bir necha soniyada). Xabarnoma kelganda summa solishtiriladi, to'lov paid bo'ladi va complete_url ga xabar yuboriladi. Sizning tomoningizda hech qanday cron yoki kuzatuvchi kerak emas.
Hozircha O'zbekistondagi ikkita asosiy tizim: UZCARD (@CardXabarBot orqali) va HUMO (@HumoCardBot orqali). Bir vaqtning o'zida bir nechta kartani ulash mumkin.
Botdan olgan shop_id va shop_key bilan POST /payment/create so'rovini yuboring — javobda payment_id va karta qaytadi. Keyin hech narsa so'rab turish shart emas: to'lov boshlanganda prepare_url ga, yakunlanganda complete_url ga biz o'zimiz POST yuboramiz. Sizdan talab qilinadigan yagona narsa — shu ikki manzilni do'kon sozlamalarida ko'rsatish va callback ga 200 qaytarish. Yuqoridagi "API Docs" bo'limida Python va PHP uchun tayyor namunalar bor.
To'lov holati o'zgarganda biz o'zimiz xabar beramiz: boshlanganda prepare_url ga, yakunlanganda complete_url ga POST yuboriladi (status = paid yoki cancel). Har bir to'lov albatta bitta yakuniy callback bilan tugaydi — "javobsiz" qolgan to'lov bo'lmaydi. Xohlasangiz GET /payment/status?payment_id=... orqali ham tekshirishingiz mumkin, lekin bu majburiy emas. Barcha tranzaksiyalar @HamyonAPIBot ichidagi panelda ham ko'rinadi.
To'lov summa bo'yicha aniqlanadi, shuning uchun bitta do'konda bir vaqtda bir xil summadagi ikkita ochiq to'lov bo'lishi mumkin emas — aks holda pul qaysi buyurtmaga tegishli ekani bilinmasdi. Ikkinchi so'rovga error qaytadi. Yechim oddiy: summani 1–2 so'mga o'zgartiring (50000 → 50001). Mijoz farqni sezmaydi, tizim esa ikkala to'lovni aniq ajratadi.
Yo'q. Kartani kuzatish bizning serverimizda bo'ladi. Siz faqat ikkita narsani qilasiz: POST /payment/create bilan to'lov yaratasiz va complete_url ga kelgan callback ni qabul qilasiz. Callback yetib bormasa (serveringiz javob bermasa), biz uni bir necha marta qayta yuboramiz — 3, 10, 30 va 60 soniyadan keyin. Shu sababli bitta to'lov bo'yicha complete ikki marta kelishi mumkin: tovarni faqat bir marta yetkazing (payment_id bo'yicha tekshiring).
Odatda 5–30 soniya. Vaqt karta tizimining xabarnoma yuborish tezligiga bog'liq. To'lov uchun berilgan muddat — 5 daqiqa: shu vaqt ichida pul tushmasa, holat cancel ga o'tadi va complete_url ga status=cancel, reason=timeout bilan xabar yuboriladi. Mijoz voz kechsa, muddatni kutmasdan POST /payment/cancel bilan o'zingiz ham yopishingiz mumkin.
Ha. Tizim faqat xabarnomalarni o'qiydi — mablag'ni ko'chirish yoki karta bilan amal bajarish imkoniyati yo'q. shop_key faqat server tomonida ishlatilishi kerak, uni mijoz kodiga qo'ymang. Karta ma'lumotlaringiz uchinchi shaxsga ko'rinmaydi.
@HamyonAPIBot ichidagi "Yordam" bo'limiga yozing yoki @HamyonAPI kanalidagi yangiliklar va qo'llanmalarni kuzatib boring. Support jamoasi 24/7 ishlaydi.
Bizning support jamoamiz sizga yordam berishga doimo tayyor!
Hamyon API bilan Telegram botingizga to'liq avtomatlashtirilgan to'lov tizimini ulang. Faqat bir necha daqiqa vaqt talab etadi.