Skip to content

Kartani to‘ldirish ​

Ecom Gate — hamkor balansidan mijozning bank kartasiga mablag‘ o‘tkazish uchun API. API REST asosida qurilgan, xabarlar HTTP orqali JSON formatida almashiladi.

To‘ldirish tartibi ​

  1. Karta ma’lumotlari — kartani tekshiring va egasining ismini oling.
  2. Tranzaksiya yaratish — noyob ext bilan operatsiya yarating va operationId oling.
  3. Tranzaksiyani tasdiqlash — operatsiyani operationId bo‘yicha tasdiqlang.
  4. Tranzaksiyani tekshirish — yakuniy holatni ext bo‘yicha bilib oling.

Balansingizdagi qoldiqni Balans metodi orqali bilish mumkin.

Autentifikatsiya ​

Har bir so‘rov Basic turidagi Authorization HTTP sarlavhasini o‘z ichiga olishi kerak. Sarlavhalar barcha metodlar uchun bir xil.

HeaderQiymat
AuthorizationBasic base64(login:password)
Content-Typeapplication/json

Javob formati ​

Barcha metodlar javobni yagona formatda qaytaradi. code 0 ga teng va data null bo‘lmasa, so‘rov muvaffaqiyatli bajarilgan.

json
{
  "data": {},
  "message": "",
  "code": 0,
  "timestamp": 1742816371550
}
#ParameterData typeDescription
1dataObjectJavob ma’lumotlari, xatolikda — null
2messageStringXabar (xatolikda — xatolik matni)
3codeIntegerJavob kodi, 0 — muvaffaqiyatli
4timestampLongSo‘rov qayta ishlangan vaqt (Unix, ms)

Summalar ​

Barcha summalar tiyinda uzatiladi: 10000 = 100 so‘m.

Ulanish va xavfsizlik ​

Ma’lumot almashinuvi faqat ikki tomonda sozlanadigan IPSec-tunnel orqali amalga oshiriladi. Sanoat API manzili va porti, shuningdek login va parol ulanish vaqtida beriladi.

Xavfsizlik talablari

Ikkala tomon serverlar, tarmoq himoyasini va ma’lumotlarning xavfsiz uzatilishini ta’minlashi shart. Hodisa yuz berganda tomonlar tahdidni bartaraf etish uchun tezkor hamkorlik qiladi.

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