Skip to content

Hisob yuborish API ​

Ushbu API orqali merchant Xazna’da buyurtma yaratadi va mijozga telefon raqami bo‘yicha to‘lov hisobini yuboradi. Shundan so‘ng merchant buyurtma va to‘lov holatini tekshirishi mumkin.

MetodEndpointVazifasi
Buyurtma yaratishPOST /api/v1/billing/create/orderBuyurtma yaratish va hisobni telefon raqamiga yuborish.
Buyurtmani tekshirishPOST /api/v1/billing/check/orderBuyurtma holatini tekshirish.
To‘lovni tekshirishGET /api/v1/billing/check/transactionTranzaksiya holatini uning identifikatori bo‘yicha tekshirish.

Ulanish parametrlari ​

Integratsiyadan oldin Xazna merchantga quyidagilarni taqdim etadi:

  1. Username va password — autentifikatsiya uchun ma'lumotlar;
  2. MerchantId — merchantning noyob identifikatori (merchantId);
  3. Base URL — API manzili, masalan https://xazna.uz.

Autentifikatsiya ​

Barcha so‘rovlar HTTP Basic autentifikatsiyasi bilan yuboriladi: Authorization sarlavhasida login va parol base64(username:password) ko‘rinishida uzatiladi.

http
Authorization: Basic base64(username:password)
Content-Type: application/json
Accept: application/json

Javob formati ​

Barcha metodlar javobni yagona formatda qaytaradi:

json
{
  "data": {
    "orderId": "string"
  },
  "errorMessage": "",
  "timestamp": 1753436810922
}
#ParametrTuriTavsif
1dataObjectSo‘rov natijasi. Xatolik bo‘lsa — null.
2errorMessageStringXatolik matni. So‘rov muvaffaqiyatli bo‘lsa — bo‘sh satr.
3timestampLongJavob vaqti millisekundlarda.

Agar data qiymati null bo‘lmasa va errorMessage bo‘sh satr bo‘lsa, so‘rov muvaffaqiyatli bajarilgan. Xatoliklar ro‘yxati Xatoliklar sahifasida keltirilgan.

Summalar tiyinda

Barcha summalar (amount) tiyinda uzatiladi: 1 so‘m = 100 tiyin. Masalan, 100000 — bu 1 000 so‘m.

АК «Халқ банки» — платежная система Xazna