Cancel API

Agar xaridor to‘langan tovarni olmagan bo‘lsa yoki uni sotib olishdan voz kechgan bo‘lsa, merchent mablag‘ni XonPay Business dashboard orqali xaridorga qaytaradi.

API faqat merchent bekor qilish metodini implementatsiya qilgan taqdirda ishlaydi. Aks holda xato qaytariladi.

Content-Type: application/json

Protokol: JSON-RPC 2.0

Metod nomi: cancelTransaction

So‘rov parametrlari:

Parametr nomi	Ma’lumot turi	Tavsif
transactionId	varchar	Pul yechadigan tizimdagi ID
reason	varchar	Bekor qilish sababi
sign	varchar	Ma’lumotlar yaxlitligini tekshirish — parametrlar uzatilish vaqtida o‘zgartirilmaganligini kafolatlaydi. Formula: MD5(transactionId: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
cancelTime	long	Bekor qilingan vaqt
status	int	Tekshiruv holati

So‘rov namunasi:

{
  "jsonrpc": "2.0",
  "method": "cancelTransaction",
  "params": {
    "transactionId": "a822d5cb-b96b-450d-a65b-a2efb706ac9d",
    "reason": "debit failed",
    "sign": "hashGeneratedByFormula"
  },
  "id": 1
}

Muvaffaqiyatli javob namunasi:

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

Muvaffaqiyatsiz javob namunasi:

{
  "jsonrpc": "2.0",
  "error": {
    "code": -33007,
    "message": "Tranzaksiya topilmadi"
  },
  "id": 1
}