Xatolar

Barcha javoblar bitta o'ramda keladi. Xato:

{
  "success": false,
  "error": {
    "code": -1007,
    "type": "validation",
    "message": "So'rov validatsiyadan o'tmadi",
    "details": [{ "field": "recipients.0.share", "message": "share must not be less than 1" }]
  },
  "meta": { "requestId": "8d0c…", "timestamp": "2026-09-25T10:00:00.000Z", "processingTimeMs": 3 }
}

message Accept-Language dagi tilda keladi (uz, ru, en), uni foydalanuvchiga ko'rsatsa bo'ladi.
code barqaror raqamli kod, mantiqni xabar matni bo'yicha emas, shu kod bo'yicha tarmoqlang.
meta.requestId ni qo'llab-quvvatlashga yozganda ko'rsating. O'z x-request-id ingizni so'rovda yuborish mumkin.

Diapazonlar

Har bir modul o'z yuzligini egallaydi. Diapazon butunlay bitta mavzuga tegishli, shuning uchun kodlarni birma-bir sanamasdan, diapazon bo'yicha guruhlab ishlov berish mumkin.

Diapazon	Mavzu
`-1001` … `-1009`	Umumiy validatsiya: summa, ulushlar, UUID, PINFL, STIR, ism, email, sahifalash
`-2001` … `-2009`	Komissiya va ulushlar: stavka minimumdan past, takroriy qabul qiluvchi, ulushlar yig'indisi 10000 emas
`-3001` … `-3007`	To'lov: holat, bekor qilish, `externalId` to'qnashuvi, parallel o'zgarish
`-4001` … `-4004`	Biznes: holat, faol emas, topilmadi, STIR band
`-5001` … `-5006`	Kassa: holat, faol emas, begona qabul qiluvchi, standart qabul qiluvchi yo'q
`-6001` … `-6007`	Qabul qiluvchi: topilmadi, pul ololmaydi, provayderda hisob yo'q
`-7001` … `-7002`	Mijoz: noto'g'ri `externalUserId`, topilmadi
`-8001` … `-8008`	Karta: faol emas, muddati o'tgan, kassaga ochiq emas, niqob noto'g'ri
`-9001` … `-9009`	To'lov provayderi: rad etish, noto'g'ri kod, mavjud emas, Split rad etildi
`-10001` … `-10003`	Kalit va token: noto'g'ri ma'lumot, yaroqsiz token, kalit bekor qilingan
`-11001` … `-11005`	So'rov: idempotentlik, avtorizatsiya, so'rovlar limiti
`-12001` … `-12004`	Fiskal profil: IKPU, qadoq kodi, QQS stavkasi
`-14001` … `-14005`	Webhooklar: noto'g'ri manzil, sozlanmagan, yetkazish topilmadi

Yana ikki diapazon Partner API da uchramaydi: -13001 … -13016 bu admin panel hisoblari, -15001 … -15005 bu saytdan kelgan ulanish arizalari.

Eng ko'p uchraydigan kodlar

Kod	HTTP	Qachon
`-1007`	`422`	Validatsiya xatosi, maydonlar bo'yicha tafsilot `details` da
`-10001`	`401`	Noto'g'ri `clientId` yoki `clientSecret`
`-10002`	`401`	Token yaroqsiz yoki muddati o'tgan, yangisini oling
`-10003`	`401`	API kalit admin panelda bekor qilingan
`-11001`	`400`	Majburiy bo'lgan joyda `Idempotency-Key` yuborilmagan
`-11002`	`422`	Bir xil `Idempotency-Key`, lekin so'rov tanasi boshqa
`-11003`	`409`	Shu kalitli so'rov hali bajarilyapti, keyinroq takrorlang
`-11005`	`429`	So'rovlar limiti, `Retry-After` soniyadan keyin takrorlang
`-2006`	`422`	Ulushlar yig'indisi 10000 bazis punktga teng emas
`-3004`	`409`	`externalId` allaqachon ishlatilgan, ikkinchi to'lov yaratilmadi
`-3006`	`422`	Operatsion kun yopilgan, endi bekor qilib bo'lmaydi
`-3007`	`409`	To'lov parallel o'zgardi, uni qayta o'qing va takrorlang
`-6004`	`422`	Qabul qiluvchi tasdiqlanmagan va pul ololmaydi
`-8004`	`422`	Karta faol emas, ulash kod bilan tasdiqlanmagan
`-8006`	`403`	Karta boshqa kassaga tegishli
`-9002`	`422`	Bank kartani rad etdi
`-9004`	`422`	Bank to'lovni rad etdi, sababi `failureReason` da
`-12004`	`422`	Kassada fiskal profil yo'q, chek chiqarib bo'lmaydi

5xx javoblarni bir xil Idempotency-Key bilan takrorlash xavfsiz.

Limitlar

Nima	Limit
`POST /v1/auth/token`	`clientId` ga daqiqasiga 30 va IP ga daqiqasiga 60
`POST /v1/cards/{id}/confirm`	15 daqiqada bitta kartaga 10 urinish, umumiy limitdan tashqari
Qolgan metodlar	API kalitga daqiqasiga 600

Limitdan oshsa, -11005 kodi va Retry-After sarlavhasi bilan 429 keladi: shuncha soniya kutish kerak. Tokenni keshlang, u bir soat yashaydi, uni har so'rov oldidan olish shart emas.

DiapazonlarHavolani nusxalash

Eng ko'p uchraydigan kodlarHavolani nusxalash

LimitlarHavolani nusxalash

Ushbu sahifada

Diapazonlar

Eng ko'p uchraydigan kodlar

Limitlar