Validate Order API

API buyurtmalar, login va boshqa ma’lumotlarning dolzarbligini tekshirish uchun chaqiriladi.

Method: POST

Content-Type: application/json

Protokol: JSON-RPC 2.0

Metod nomi: validateTransaction

So‘rov parametrlari:

Parametr nomi	Ma’lumot turi	Tavsif
amount	long	To‘lov summasi tiyinda
billingIdentifier	varchar	Buyurtma IDsi (do‘konlar uchun) / shaxsiy hisob / merchent tizimidagi login
serviceId	varchar	Xizmat IDsi
sign	varchar	Ma’lumotlar yaxlitligini tekshirish — parametrlar uzatilish vaqtida o‘zgartirilmaganligini kafolatlaydi. Formula: MD5(amount:billingIdentifier:serviceId:SECRET_KEY). SECRET_KEY — provayder bilan ulanishda berilgan noyob satr
requestData	map	Buyurtma bo‘yicha qo‘shimcha ma’lumotlar key-value formatida. Majburiy emas. Har bir kassa uchun alohida sozlanadi

Javob parametrlari:

Parametr nomi	Ma’lumot turi	Tavsif
valid	boolean	Agar flag true bo‘lsa, tranzaksiya amalga oshirilishi mumkin. Boshqa hollarda metod xatolarni qaytaradi.

So‘rov namunasi:

{
  "jsonrpc": "2.0",
  "method": "validateTransaction",
  "params": {
	  "amount": 500000,
	  "billingIdentifier": "order-1504",
	  "serviceId": "cb5838f8-d2c7-4bc7-9471-e2f38e5c75cf",
	  "sign": "hashGeneretedByFormula",
	  "requestData": {
	  "account": "1239",
	  "purpose": "some description"
	  }
  },
  "id": 1
}

Muvaffaqiyatli javob namunasi:

{
  "jsonrpc": "2.0",
  "result": {
    "valid": true
  },
  "id": 1
}

Muvaffaqiyatsiz javob namunasi:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -33002,
    "message": "Noto‘g‘ri summa"
  },
  "id": 1
}