Skip to content

Merchant API

O‘zaro aloqa sahifasida tavsiflangan sxema ishlashi uchun merchant o‘z tomonida uchta metodni amalga oshiradi. Ularning barchasi bitta endpointda JSON-RPC 2.0 protokoli orqali qabul qilinadi.

MetodVazifasi
get.infoTo‘lov hisobi haqida ma'lumot olish.
payHisobni to‘lash.
checkTranzaksiya holatini tekshirish.

Autentifikatsiya

http
Auth: Basic (Username & password for authentication)
Content-Type: application/json
Accept: application/json

Login va parol ulanish paytida Xazna bilan kelishiladi. Barcha so‘rovlar bitta manzilga POST metodi bilan keladi, masalan https://example.uz/api/.

So‘rov formati

json
{
  "jsonrpc": "2.0",
  "method": "get.info",
  "id": "1234",
  "params": {}
}
#ParametrTuriTavsif
1jsonrpcStringStatik, doim "2.0".
2methodStringMetod nomi.
3idStringSo‘rovning statik identifikatori.
4paramsObjectAniq metodning parametrlari.

Javob formati

Muvaffaqiyatli javob result obyektini, xatolik javobi esa result: null va error obyektini o‘z ichiga oladi. Batafsil — Xatoliklar sahifasida.

Tavsiya

Endpoint HTTPS orqali yaroqli sertifikat bilan javob berishi va javob vaqti oqilona bo‘lishi kerak. pay ga uzoq javob Xazna tomonidan takroriy chaqiruv xavfini oshiradi.

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