Hold API

Agar birinchi API da billing muvaffaqiyatli javob qaytarsa, tizim HOLD metodini chaqiradi va tovar, xizmat yoki buyurtmani (internet-do‘konlar uchun) bron qiladi. Billing tizimida tranzaksiya yaratiladi.

Tranzaksiya holati “To‘lov kutilmoqda” deb belgilanadi.

Method: POST

Content-Type: application/json

Protokol: JSON-RPC 2.0

Metod nomi: createTransaction

So‘rov parametrlari:

Parametr nomi	Ma’lumot turi	Tavsif
transactionId	varchar	XonPay Business tizimidagi tranzaksiyaning noyob IDsi
amount	long	To‘lov summasi tiyinda
billingIdentifier	varchar	Buyurtma IDsi (do‘konlar uchun) / shaxsiy hisob / merchent tizimidagi login
serviceId	varchar	Xizmat IDsi
time	long	XonPay Business tizimida tranzaksiya yaratilgan vaqt
sign	varchar	Ma’lumotlar yaxlitligini tekshirish — parametrlar uzatilish vaqtida o‘zgartirilmaganligini kafolatlaydi. Formula: MD5(transactionId:amount:billingIdentifier:serviceId:SECRET_KEY). SECRET_KEY — provayder bilan ulanishda berilgan noyob satr

Javob parametrlari:

Parametr nomi	Ma’lumot turi	Tavsif
externalId	varchar	Merchent tizimida yaratilgan tranzaksiya IDsi
createdTime	long	Merchent tizimida tranzaksiya yaratilgan vaqt

So‘rov namunasi:

{
  "jsonrpc": "2.0",
  "method": "createTransaction",
  "params": {
	  "transactionId": "a822d5cb-b96b-450d-a65b-a2efb706ac9d",
	  "amount": 500000,
	  "billingIdentifier": "order-1504",
	  "serviceId": "cb5838f8-d2c7-4bc7-9471-e2f38e5c75cf",
	  "time": 1754678838106,
	  "sign": "hashGeneretedByFormula"
  },
  "id": 1
}

Muvaffaqiyatli javob namunasi:

{
  "jsonrpc": "2.0",
  "result": {
    "externalId": "88697d15-45e8-44e8-ac01-de3e6b48e80e",
    "createdTime": 1754678838106
  },
  "id": 1
}

Muvaffaqiyatsiz javob namunasi:

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