Yandex Pay API
version: 1.0.0
Sarlavhalar
So‘rovlaringizda quyidagi HTTP sarlavhalarni yuboring:
- X-Request-Id: <so‘rovning noyob identifikatori>
- X-Request-Timeout: <so‘rov taym-auti millisekundlarda>
- X-Request-Attempt: <urinish raqami (0 – birinchi urinish, 1, 2 va h.k. – qayta yuborishlar)>
X-Request-Id so‘rovlarni diagnostika qilish hamda yozuvchi so‘rovlarning idempotentligini ta’minlash uchun kerak.
Shu sababli bir xil X-Request-Id qiymati barcha qayta yuboriladigan so‘rovlarda saqlanishi kerak, agar javobda HTTP 5xx yoki 429 bilan
xatolik kodlari qaytsa.
X-Request-Timeout so‘rovni qayta yuborish deadline propagation
vaqtini tizimda qayta ishlash jarayonida boshqarish uchun kerak.
Taym-aut qiymatini 1 soniyadan kichik qilib qo‘ymang. Maksimal taym-aut qiymati – 10 soniya.
X-Request-Attempt umumiy diagnostika uchun foydalidir.
Sotuvchi so‘rovini autentifikatsiya qilish
API'dan foydalanish uchun autentifikatsiya API-kalitini olish zarur.
Token har bir so‘rov uchun HTTP sarlavhasidagi Authorization sarlavha orqali uzatilishi kerak.
Kalitlarni boshqarish Yandex Split konsolida amalga oshiriladi.
Sandbox muhitida API-kalit qiymati Merchant ID qiymatiga teng bo‘ladi.
--header 'Authorization: Api-Key <kalit qiymati>'
Agar so‘rovda token bo‘lmasa yoki noto‘g‘ri token yuborilsa,
server 401 Unauthorized HTTP holatini qaytaradi.
Sections
Specification
Open API
{
"components": {
"schemas": {
"Agent": {
"properties": {
"agentType": {
"description": "Hisob-kitob predmeti bo‘yicha agent belgisi. [Qiymatlar](https://pay.yandex.uz/ru/docs/custom/fns#agent-type)ga qarang",
"enum": [
1,
2,
3,
4,
5,
6,
7
],
"type": "integer"
},
"operation": {
"maxLength": 2048,
"type": "string"
},
"paymentsOperator": {
"allOf": [
{
"properties": {
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
]
},
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
},
"transferOperator": {
"allOf": [
{
"properties": {
"address": {
"maxLength": 2048,
"type": "string"
},
"inn": {
"maxLength": 2048,
"type": "string"
},
"name": {
"maxLength": 2048,
"type": "string"
},
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
]
}
},
"required": [
"agentType"
],
"type": "object"
},
"BaseMerchantApiOrder": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori.",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatchadagi mahsulotlar roʻyxati",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"finalPrice": {
"description": "Pozitsiya va savat bo‘yicha barcha chegirmalar hisobga olingan holdagi mahsulotning birlik narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"default": null,
"description": "Toʻlovga yoʻnaltiriladigan savatchaning yakuniy qiymati"
}
},
"required": [
"items"
],
"type": "object"
}
],
"description": "Savat"
},
"coolingPeriodExpiresAt": {
"description": "Sovutish muddati tugash sanasi va vaqti (ISO 8601)",
"format": "date-time",
"type": "string"
},
"created": {
"description": "Buyurtma yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"isPrepayment": {
"default": false,
"description": "Buyurtma “kechiktirilgan to‘lov” oqimi bo‘yicha amalga oshiriladimi.\n\nAgar parametr `true` qiymatiga o‘rnatilgan bo‘lsa, buyurtma kechiktirilgan to‘lovli buyurtma sifatida rasmiylashtiriladi.",
"type": "boolean"
},
"merchantId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"metadata": {
"description": "Tugmani ishga tushirish vaqtida uzatilgan ixtiyoriy ma’lumotlar",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Qaytarishlar, yetkazish, chegirmalar va promokodlarni hisobga olgan holda to‘lov uchun buyurtmaning to‘liq qiymati",
"example": "123.45",
"format": "double",
"type": "string"
},
"orderId": {
"description": "[/orders](../order/merchant_v1_orders-post.md) xizmatiga uzatilgan sotuvchi tomonidagi buyurtma ID raqami.",
"maxLength": 2048,
"type": "string"
},
"paymentMethod": {
"properties": {
"cardLast4": {
"maxLength": 2048,
"type": "string"
},
"cardNetwork": {
"description": "To‘lov tizimi",
"enum": [
"AMEX",
"DISCOVER",
"JCB",
"MASTERCARD",
"MAESTRO",
"VISAELECTRON",
"VISA",
"MIR",
"UNIONPAY",
"UZCARD",
"HUMOCARD",
"UNKNOWN",
"UNDEFINED",
null
],
"type": "string"
},
"methodType": {
"enum": [
"SPLIT"
],
"type": "string"
}
},
"required": [
"methodType"
],
"type": "object"
},
"paymentStatus": {
"description": "Batafsil ma’lumotni [Operatsiya holatlari](../../../../payments/statuses) bo‘limidan o‘qing.",
"enum": [
"PENDING",
"AUTHORIZED",
"CAPTURED",
"VOIDED",
"REFUNDED",
"CONFIRMED",
"PARTIALLY_REFUNDED",
"FAILED",
null
],
"type": "string",
"x-enumDescriptions": {
"AUTHORIZED": "Платеж за заказ авторизован. Средства заблокированы на счету плательщика",
"CAPTURED": "Заказ успешно оплачен. Средства списаны со счета плательщика",
"CONFIRMED": "Заказ успешно оформлен",
"FAILED": "Заказ не был успешно оплачен",
"PARTIALLY_REFUNDED": "Совершен частичный возврат средств за заказ",
"PENDING": "Ожидается оплата",
"REFUNDED": "Совершен возврат средств за заказ",
"VOIDED": "Оплата отменена. Списание средств не производилось"
}
},
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
},
"reason": {
"description": "Buyurtma bekor qilinish sababi. `VOIDED` va `FAILED` holatlari uchun qo‘llaniladi.",
"maxLength": 2048,
"type": "string"
},
"updated": {
"description": "Buyurtma yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"cart",
"currencyCode"
],
"type": "object"
},
"BillingReport": {
"properties": {
"branchId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Savdo nuqtasi identifikatori",
"maxLength": 2048,
"type": "string"
},
"managerId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Menejer identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"CancelOrderRequest": {
"properties": {
"externalOperationId": {
"description": "Operatsiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"reason": {
"description": "Bekor qilish sababi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"reason"
],
"type": "object"
},
"CaptureRequest": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Yakuniy savat"
},
"externalOperationId": {
"description": "Operatsiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Yechib olinadigan summa. Agar ko‘rsatilmagan bo‘lsa, kiritilgan savatning yakuniy qiymati yechib olinadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"shipping": {
"allOf": [
{
"properties": {
"amount": {
"description": "Verguldan keyin ikki xonadan ortiq belgi bo‘lmasligi kerak.\nMasalan: 1,12, 5,1, 10, 11,00",
"example": "123.45",
"format": "double",
"type": "string"
},
"methodType": {
"enum": [
"DIRECT",
"PICKUP",
"COURIER",
"YANDEX_DELIVERY"
],
"type": "string"
}
},
"required": [
"amount",
"methodType"
],
"type": "object"
}
],
"description": "Yakuniy yetkazish usuli"
}
},
"type": "object"
},
"Cart": {
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori.",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatchadagi mahsulotlar roʻyxati",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"finalPrice": {
"description": "Pozitsiya va savat bo‘yicha barcha chegirmalar hisobga olingan holdagi mahsulotning birlik narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"default": null,
"description": "Toʻlovga yoʻnaltiriladigan savatchaning yakuniy qiymati"
}
},
"required": [
"items"
],
"type": "object"
},
"CartItem": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"finalPrice": {
"description": "Pozitsiya va savat bo‘yicha barcha chegirmalar hisobga olingan holdagi mahsulotning birlik narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"CartItemFeatures": {
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
},
"CartItemFeatures1": {
"properties": {
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
},
"CartItemWithoutFinalPriceCamelCase": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"CartTotal": {
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
},
"CartWithRequiredTotalWithoutFinalPrice": {
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
},
"required": [
"items",
"total"
],
"type": "object"
},
"CheckSubscriptionUserCardActivated": {
"properties": {
"check_card_active": {
"description": "Karta biriktirilganligni tekshirish imkonini beradi",
"type": "boolean"
}
},
"type": "object"
},
"Coupon": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"CourierOption": {
"properties": {
"allowedPaymentMethods": {
"description": "Yetkazish berish usuli uchun individual to‘lov usullari. Ushbu parametr `availablePaymentMethods`da ko‘rsatilgan to‘lov usullarini cheklash zarur bo‘lsa qo‘llaniladi. Agar parametr ko‘rsatilmagan bo‘lsa, `availablePaymentMethods`da sanab o‘tilgan barcha to‘lov usullaridan foydalaniladi.",
"items": {
"enum": [
"CARD",
"SPLIT",
"CASH_ON_DELIVERY",
"CARD_ON_DELIVERY",
"UNIQR_REUSABLE",
"UNIQR_ONETIME"
],
"type": "string"
},
"type": "array"
},
"amount": {
"description": "Yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"category": {
"enum": [
"EXPRESS",
"TODAY",
"STANDARD"
],
"type": "string"
},
"courierOptionId": {
"description": "Sotuvchi tizimidagi tanlangan yetkazish varianti ID raqami",
"maxLength": 2048,
"type": "string"
},
"customerChoice": {
"allOf": [
{
"properties": {
"date": {
"format": "date",
"type": "string"
},
"time": {
"allOf": [
{
"properties": {
"end": {
"description": "Interval tugash vaqti",
"type": "string"
},
"start": {
"description": "Interval boshlanish vaqti",
"type": "string"
}
},
"required": [
"end",
"start"
],
"type": "object"
}
]
}
},
"required": [
"date"
],
"type": "object"
}
],
"description": "Foydalanuvchi tomonidan tanlangan sana va interval. Faqat `type: FLEXIBLE` uchun"
},
"fromDate": {
"description": "`type: PLAIN` uchun eng yaqin yetkazish sanasi. `type: FLEXIBLE` uchun yetkazish sanasini tanlash intervalining boshlanishi",
"format": "date",
"type": "string"
},
"fromTime": {
"description": "Yetkazish intervali boshlanishi. Faqat `type: PLAIN` uchun",
"type": "string"
},
"provider": {
"description": "Yetkazish xizmati turi.",
"enum": [
"BOXBERRY",
"CDEK",
"RUSSIAN_POST",
"EMS",
"COURIER",
"DHL",
"EXPRESS_DELIVERY",
"FIVEPOST",
"OZON_ROCKET",
"DPD",
"SBER_LOGISTICS",
"PEK",
"PICKPOINT",
"KCE",
"PONY_EXPRESS",
"YANDEX_DELIVERY",
null
],
"type": "string"
},
"timeIntervals": {
"allOf": [
{
"properties": {
"grid": {
"allOf": [
{
"properties": {
"duration": {
"description": "Har bir interval davomiyligi",
"type": "string"
},
"end": {
"description": "Eng oxirgi interval boshlanishining maksimal vaqti",
"type": "string"
},
"start": {
"description": "Birinchi interval boshlanish vaqti",
"type": "string"
},
"step": {
"description": "Ikki qo‘shni interval boshlanishlari orasidagi vaqt farqi",
"type": "string"
}
},
"required": [
"duration",
"end",
"start",
"step"
],
"type": "object"
}
],
"description": "Intervallarni to‘r ko‘rinishida kodlaydi. Agar 20 tadan ortiq yetkazish intervalini belgilash kerak bo‘lsa, ushbu formatdan foydalaning.\nMasalan: `{\"start\": \"09:00\", \"end\": \"21:00\", \"duration\": \"00:20\", \"step\": \"01:00\"}` quyidagi intervallar to‘plami sifatida talqin qilinadi: `[{\"start\": \"09:00\", \"end\": \"09:20\"}, {\"start\": \"10:00\", \"end\": \"10:20\"}, ..., {\"start\": \"20:00\", \"end\": \"20:20\"}]`"
},
"type": {
"description": "Agar `GRID` turi ko‘rsatilgan bo‘lsa, `grid` maydonini kiritish zarur. Agar `VALUES` turi ko‘rsatilgan bo‘lsa, `values` maydonini kiritish zarur",
"enum": [
"GRID",
"VALUES"
],
"type": "string"
},
"values": {
"description": "Yetkazish intervallari ro‘yxatini to‘g‘ridan-to‘g‘ri belgilaydi. Yetkazish berish intervallari soni kam bo‘lgan holatlar uchun mos keladi. Tavsiya etilgan maksimal intervallar soni – 20",
"items": {
"properties": {
"end": {
"description": "Interval tugash vaqti",
"type": "string"
},
"start": {
"description": "Interval boshlanish vaqti",
"type": "string"
}
},
"required": [
"end",
"start"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type"
],
"type": "object"
}
],
"description": "Tanlash uchun mavjud bo‘lgan yetkazish vaqt intervallarini kodlaydi. Faqat `type: FLEXIBLE` uchun"
},
"title": {
"description": "Yetkazish usuli nomi. Variantlar ro‘yxatida foydalanuvchiga ko‘rsatiladi",
"maxLength": 2048,
"type": "string"
},
"toDate": {
"description": "`type: PLAIN` uchun eng kech yetkazish sanasi. `type: FLEXIBLE` uchun yetkazish sanasini tanlash intervalining tugashi",
"format": "date",
"type": "string"
},
"toTime": {
"description": "Yetkazish vaqt intervalining tugashi. Faqat `type: PLAIN` uchun",
"type": "string"
},
"type": {
"default": "PLAIN",
"description": "Opsiya turi.\n`FLEXIBLE` turidagi yetkazish variantlari uchun foydalanuvchiga kerakli sana va intervalni tanlash imkoniyati beriladi:\n- Yetkazish sanasi xaridor tomonidan `[fromDate, toDate]` oralig‘ida tanlanadi\n- foydalanuvchiga kun davomida interval tanlash imkonini berish uchun `timeIntervals` maydonini to‘ldiring\n`PLAIN` turidagi variantlarda bunday tanlov mavjud emas.",
"enum": [
"PLAIN",
"FLEXIBLE"
],
"type": "string"
}
},
"required": [
"amount",
"category",
"courierOptionId",
"title"
],
"type": "object"
},
"CreateOrderRequest": {
"properties": {
"availablePaymentMethods": {
"default": null,
"description": "To‘lov formasida xaridorga mavjud bo‘ladigan to‘lov usullari Yandex Split orqali.\n\nMumkin bo‘lgan variantlar:\n- `[\"SPLIT\"]` – faqat Split orqali;",
"items": {
"enum": [
"CARD",
"SPLIT"
],
"type": "string"
},
"minItems": 1,
"type": "array"
},
"billingPhone": {
"description": "Mijoz telefon raqami.\n\nAvtorizatsiyani soddalashtirish uchun ishlatiladi hamda Split orqali tasdiqlanish ehtimolini oshirishi mumkin.\n\nTelefon raqami uchun quyidagi formatlardan foydalanish tavsiya etiladi: `+998123456789` yoki `998123456789`. Raqamlar qatorida boshqa belgilar bo‘lishi mumkin, ammo raqamlardan tashqari barcha belgilar e’tiborga olinmaydi.\n\nMasalan, quyidagi yuborilgan qiymatlar: `998123456789`, `+998123456789`, `+998 (12) 345-67-89` – `998123456789 `ko‘rinishida qayta ishlanadi.",
"maxLength": 2048,
"type": "string"
},
"cart": {
"allOf": [
{
"description": "{% note info %}\n\nYetkazish narxini `items` ichida alohida mahsulot sifatida kiriting.\n\n{% endnote %}",
"properties": {
"externalId": {
"description": "Savat identifikatori – sotuvchi tomonida.",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatdagi mahsulotlar ro‘yxati.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Savat"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"extensions": {
"allOf": [
{
"properties": {
"billingReport": {
"allOf": [
{
"properties": {
"branchId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Savdo nuqtasi identifikatori",
"maxLength": 2048,
"type": "string"
},
"managerId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Menejer identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
}
],
"description": "Buyurtmani rasmiylashtirish joyi va mas’ul shaxs haqida ma’lumot."
},
"paymentData": {
"allOf": [
{
"properties": {
"saleToken": {
"description": "Har bir to‘lov operatsiyasi uchun kassa tomonidan yaratiladigan noyob ID",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
}
],
"description": "To‘lovning qo‘shimcha parametrlari."
},
"qrData": {
"allOf": [
{
"properties": {
"token": {
"description": "QR token",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
}
],
"description": "QR yordamida to‘lov havolasini yuborish uchun qo‘shimcha parametrlar."
},
"smsOffer": {
"allOf": [
{
"properties": {
"phone": {
"description": "SMS orqali xabarnoma yuborish uchun mijoz telefon raqami (masalan: `+998123456789`).\nFaqat oflayn do‘konlar uchun.",
"maxLength": 2048,
"pattern": "^\\+\\d+$",
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
}
],
"description": "SMS orqali to‘lov havolasini yuborish uchun qo‘shimcha parametrlar.\n\nFaqat oflayn doʻkonlar uchun majburiy maydon."
}
},
"type": "object"
}
],
"default": null,
"description": "Oflayn buyurtmani rasmiylashtirish uchun qo‘shimcha parametrlar"
},
"isPrepayment": {
"description": "Buyurtma “kechiktirilgan to‘lov” oqimi bo‘yicha amalga oshiriladimi.\n\nAgar parametr `true` qiymatiga o‘rnatilgan bo‘lsa, buyurtma kechiktirilgan to‘lovli buyurtma sifatida rasmiylashtiriladi.",
"type": "boolean"
},
"metadata": {
"description": "Buyurtma bo‘yicha ichki foydalanish uchun ixtiyoriy ma’lumotlar.",
"maxLength": 2048,
"type": "string"
},
"orderId": {
"description": "Sotuvchi tizimidagi buyurtma identifikatori (unikal bo‘lishi shart). To‘lov so‘rovi bo‘yicha keyingi barcha jarayonlar aynan shu identifikator orqali amalga oshiriladi. Ushbu identifikator solishtirish jarayonlarida ham ishlatiladi",
"maxLength": 2048,
"type": "string"
},
"orderSource": {
"default": null,
"description": "Buyurtma yaratilishi boshlangan platforma yoki interfeys\n\nKeyingi tahlillar uchun zarur\n\n---\n\n**WEBSITE**: Tugma veb-saytda joylashtirilgan. To‘lov havolasi foydalanuvchi saytda amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**APP**: Tugma mobil ilovada joylashtirilgan. To‘lov havolasi foydalanuvchi ilova ichida amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**CRM**: To‘lov havolasi CRM tizimida yoki boshqa administrator panelida menejer tomonidan yaratilgan\n\n**CASH_REGISTER**: To‘lov havolasi oflayn kassada ko‘rsatish uchun shakllantirilgan\n\n**CMS_PLUGIN**: To‘lov havolasi CMS uchun plagin ichida shakllantirilgan\n\n**TV**: To‘lov havolasi TV-platformada ko‘rsatish uchun shakllantirilgan.",
"enum": [
"WEBSITE",
"APP",
"CRM",
"CASH_REGISTER",
"CMS_PLUGIN"
],
"type": "string"
},
"preferredPaymentMethod": {
"description": "Afzal to‘lov usuli.\n\nUzatilgan to‘lov usuli, agar u `availablePaymentMethods` maydonida mavjud usullarga zid bo‘lmasa, to‘lov formasida avtomatik tanlanadi.",
"enum": [
"FULLPAYMENT",
"SPLIT"
],
"type": "string"
},
"publicConstructor": {
"description": "Split orqali to‘lash uchun oldindan tanlangan reja konstruktori.\n\n_Faqat kelishuv asosida mavjud_",
"type": "string"
},
"purpose": {
"description": "To‘lov maqsadi",
"maxLength": 1000,
"type": "string"
},
"redirectUrls": {
"allOf": [
{
"properties": {
"onAbort": {
"description": "To‘lov jarayoni bekor qilinganda foydalanuvchini qayta yo‘naltirish uchun havola. To‘lovni bekor qilish foydalanuvchi tomonidan to‘lov formasida amalga oshiriladi.",
"maxLength": 2048,
"type": "string"
},
"onError": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov vaqtida noma’lum xatolik yuz bersa yoki to‘lov havolasining amal qilish muddati tugasa, foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
},
"onSuccess": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov muvaffaqiyatli yakunlanganda foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"onError",
"onSuccess"
],
"type": "object"
}
],
"description": "To‘lov shaklidan foydalanuvchini qayta yo‘naltirish havolalari. Onlayn do‘konlar uchun majburiy."
},
"risk": {
"allOf": [
{
"properties": {
"billingPhone": {
"description": "**DEPRECATED** Mijoz telefon raqami. <br/>*Yuqori darajadagi shu nomdagi maydondan foydalanish tavsiya etiladi.*",
"maxLength": 2048,
"type": "string"
},
"customerAggregates": {
"allOf": [
{
"properties": {
"amountFirstSuccessfulOrder": {
"description": "Birinchi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"amountLatestSuccessfulOrder": {
"description": "Oxirgi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"cookie": {
"description": "Cookie fayllar",
"maxLength": 2048,
"type": "string"
},
"daysSinceLastPasswordReset": {
"description": "Parol oxirgi marta tiklanganidan beri o‘tgan kunlar soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsOneDay": {
"description": "So‘nggi 1 kun ichida muvaffaqiyatsiz kirish urinishlari soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsSevenDays": {
"description": "So‘nggi 7 kun ichida muvaffaqiyatsiz kirishga urinishlar soni",
"format": "int32",
"type": "integer"
},
"firstSuccessfulOrderDate": {
"description": "Tarixdagi birinchi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"historicalCookieLogin": {
"description": "Saqlangan cookie orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"historicalDeviceLogin": {
"description": "Saqlangan qurilma orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"lastPasswordResetDate": {
"description": "Parol oxirgi marta tiklangan sana",
"format": "date",
"type": "string"
},
"latestSuccessfulOrderLastYearDate": {
"description": "So‘nggi bir yil ichidagi oxirgi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"previousSuccessfulOrdersAtSameAddress": {
"description": "Foydalanuvchi joriy manzil bo‘yicha ilgari muvaffaqiyatli buyurtma qilganmi",
"type": "boolean"
},
"redemptionRateLastHalfYear": {
"description": "So‘nggi yarim yil ichidagi xaridni yakunlash foizi",
"example": "123.45",
"format": "double",
"type": "string"
},
"registrationDate": {
"description": "Sotuvchi saytida ro‘yxatdan o‘tgan sana",
"format": "date",
"type": "string"
}
},
"type": "object"
}
],
"description": "Mijoz haqida umumlashtirilgan ma’lumotlar"
},
"deviceId": {
"description": "Mijoz qurilmasi identifikatori (device_id/gaid/idfa/ifv)",
"maxLength": 2048,
"type": "string"
},
"isExpressShipping": {
"description": "Ekspress yetkazish belgisi",
"type": "boolean"
},
"merchantMcc": {
"description": "Merchant MCC kodi",
"maxLength": 2048,
"type": "string"
},
"merchantName": {
"description": "Merchant nomi",
"maxLength": 2048,
"type": "string"
},
"merchantOfflinePosLegalAddress": {
"description": "Oflayn savdo nuqtasining yuridik manzili",
"maxLength": 2048,
"type": "string"
},
"merchantTaxRefNumber": {
"description": "Merchantning soliq raqami",
"maxLength": 2048,
"type": "string"
},
"periodCheckAggregates": {
"allOf": [
{
"properties": {
"successfulOrdersCountNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountOneMonth": {
"description": "So‘nggi 1 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"totalAmountSuccessfulOrdersNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersOneMonth": {
"description": "So‘nggi bir oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"type": "object"
}
],
"description": "Turli davrlar bo‘yicha chek agregatlari."
},
"qrType": {
"description": "QR kod turi",
"enum": [
"static",
"dynamic",
null
],
"type": "string"
},
"qrcId": {
"description": "QR kod raqami",
"maxLength": 2048,
"type": "string"
},
"shippingAddress": {
"description": "Yetkazish manzili Agar buyurtmani olish usuli (`PICKUP`) “olib ketish” deb tanlangan bo‘lsa, mahsulotni berish punkti manzilini ko‘rsatish kerak.",
"maxLength": 2048,
"type": "string"
},
"shippingPhone": {
"description": "Qabul qiluvchining telefon raqami (masalan: +998123456789).",
"maxLength": 2048,
"type": "string"
},
"shippingType": {
"description": "Buyurtmani olish usuli",
"enum": [
"COURIER",
"PICKUP",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Splitni tasdiqlash ehtimolini oshirishi mumkin boʻlgan qoʻshimcha maʼlumotlar. To‘liq hajmda faqat onlayn-do‘konlar uchun mavjud."
},
"ttl": {
"default": 1800,
"description": "Parametr foydalanuvchi buyurtma to‘lov sahifasiga havoladan foydalanishi mumkin bo‘lgan vaqtni belgilaydi.\n\nBelgilangan vaqt tugagach, foydalanuvchi “To‘lov vaqti tugadi” degan xabarni ko‘radi.\n\nAgar foydalanuvchi havoladan vaqt tugashidan oldin foydalangan bo‘lsa, to‘lovni yakunlash uchun qo‘shimcha 15 daqiqa beriladi. Agar qo‘shimcha vaqt tugagandan keyin ham to‘lov amalga oshirilmasa, buyurtma yakuniy ravishda to‘lanmagan deb hisoblanadi.\n\nBu holat buyurtma holatining `Order.paymentStatus` qiymati `FAILED`ga o‘zgarishi orqali aks etadi. Shuningdek, buyurtma statusi o‘zgargani haqida [bildirishnoma](../../merchant-api/webhook) yuboriladi. Agar sotuvchi mahsulotni oldindan band qilib qo‘ygan bo‘lsa, buyurtma statusi o‘zgargandan so‘ng bandlovni bekor qilish mumkin.\n\nAmal qilish muddati (sek.): `180 <= ttl <= 604800`\n\nAmal qilish muddati (shaxsiy kabinetda to‘lov havolasi yaratilganda, sek.): `86400`",
"format": "int32",
"type": "integer"
}
},
"required": [
"cart",
"currencyCode",
"orderId"
],
"type": "object"
},
"CreateOrderResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"paymentUrl"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"required": [
"data"
],
"type": "object"
},
"CreateOrderResponseData": {
"properties": {
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"paymentUrl"
],
"type": "object"
},
"CreateSubscriptionRequest": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"externalId": {
"description": "Sotuvchi tomonidan uzatilgan savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Xaridor to‘laydigan mahsulotlar savatchasi.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Mahsulotning bir dona narxi – pozitsiyaga qo‘llangan chegirmalar hisobga olingan holda.",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "Plus ballari soni\n\nFaqat o‘qish uchun maydon. Yuborilgan qiymatlar e’tiborga olinmaydi.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot id raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob id raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan jami narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Mahsulot birligi uchun chegirmasiz to‘liq narx",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Savat"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"futureWriteOffAmount": {
"description": "Kelajakda yechib olinadigan summa",
"example": "123.45",
"format": "double",
"type": "string"
},
"intervalCount": {
"description": "`intervalUnit` parametrida ko‘rsatilgan vaqt birligiga nisbatan obuna davrlari soni.\n\nMasalan, 6 oylik obuna uchun: `intervalUnit: 'MONTH'`, `intervalCount: 6` deb ko‘rsating.\n\nAgar `isBinding=True` parametri ko‘rsatilmagan bo‘lsa, majburiy maydon.",
"example": "6",
"format": "int32",
"type": "integer"
},
"intervalUnit": {
"description": "Obuna davriyligi belgilanadigan vaqt birligi.\n\nAgar `isBinding=True` parametri ko‘rsatilmagan bo‘lsa, majburiy maydon.",
"enum": [
"SECOND",
"DAY",
"WEEK",
"MONTH",
"YEAR",
null
],
"type": "string"
},
"isBinding": {
"default": false,
"description": "Mahsulotlar savatchasi yaratilmagan holda foydalanuvchi kartasini bog‘lash imkonini beradi.\n\nAgar birinchi yechib olish vaqtida faqat kartani bog‘lash kerak bo‘lsa, so‘rovda `isBinding: true` parametrini yuboring.\n\nUshbu ssenariyda savat va obuna davriyligini yuborish talab etilmaydi.",
"type": "boolean"
},
"metadata": {
"description": "Buyurtma bo‘yicha ichki foydalanish uchun ixtiyoriy ma’lumotlar.",
"maxLength": 2048,
"type": "string"
},
"orderId": {
"description": "Sotuvchi tizimidagi buyurtma identifikatori (unikal bo‘lishi shart). To‘lov so‘rovi bo‘yicha keyingi barcha jarayonlar aynan shu identifikator orqali amalga oshiriladi. Ushbu identifikator solishtirish jarayonlarida ham ishlatiladi",
"maxLength": 2048,
"type": "string"
},
"orderSource": {
"default": null,
"description": "Buyurtma yaratish boshlang‘ich tarzda qaysi platformada ishga tushirilganini bildiradi.\n\nKeyingi tahlillar uchun zarur\n\n---\n\n**WEBSITE**: Tugma veb-saytda joylashtirilgan. To‘lov havolasi foydalanuvchi saytda amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**APP**: Tugma mobil ilovada joylashtirilgan. To‘lov havolasi foydalanuvchi ilova ichida amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**CRM**: To‘lov havolasi CRM tizimida yoki boshqa administrator panelida menejer tomonidan yaratilgan\n\n**CASH_REGISTER**: To‘lov havolasi oflayn kassada ko‘rsatish uchun shakllantirilgan\n\n**CMS_PLUGIN**: To‘lov havolasi CMS uchun plagin ichida shakllantirilgan\n\n**TV**: To‘lov havolasi TV-platformada ko‘rsatish uchun shakllantirilgan.",
"enum": [
"WEBSITE",
"APP",
"CRM",
"CASH_REGISTER",
"CMS_PLUGIN",
"TV"
],
"type": "string"
},
"purpose": {
"description": "To‘lov maqsadi",
"maxLength": 1000,
"type": "string"
},
"redirectUrls": {
"allOf": [
{
"properties": {
"onAbort": {
"description": "To‘lov jarayoni bekor qilinganda foydalanuvchini qayta yo‘naltirish uchun havola. To‘lovni bekor qilish foydalanuvchi tomonidan to‘lov formasida amalga oshiriladi.",
"maxLength": 2048,
"type": "string"
},
"onError": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov vaqtida noma’lum xatolik yuz bersa yoki to‘lov havolasining amal qilish muddati tugasa, foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
},
"onSuccess": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov muvaffaqiyatli yakunlanganda foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"onError",
"onSuccess"
],
"type": "object"
}
],
"description": "To‘lov shaklidan foydalanuvchini qayta yo‘naltirish havolalari. Onlayn do‘konlar uchun majburiy."
},
"title": {
"description": "Obuna nomi",
"maxLength": 30,
"type": "string"
},
"trialCount": {
"description": "`trialUnit` parametrida ko‘rsatilgan sinov obuna davrlari soni.\n\nMasalan, 7 kunlik sinov obunasi uchun quyidagicha ko‘rsatiladi: `trialUnit: \"DAY\"`, `trialCount: 7`.",
"format": "int32",
"type": "integer"
},
"trialEndAt": {
"description": "Sinov davrining tugash sanasi. `trial_unit` va `trial_count` maydonlari bilan o‘zaro birgalikda ishlatilmaydi.",
"format": "date-time",
"type": "string"
},
"trialUnit": {
"description": "Sinov obunasi davomiyligi o‘lchanadigan vaqt birligi.",
"enum": [
"SECOND",
"DAY",
"WEEK",
"MONTH",
"YEAR",
null
],
"type": "string"
},
"ttl": {
"default": 1800,
"description": "Buyurtmaning amal qilish muddati (sekundlarda).\n\n`180 <= ttl <= 604800`",
"format": "int32",
"type": "integer"
}
},
"required": [
"currencyCode",
"orderId"
],
"type": "object"
},
"CreateSubscriptionResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
},
"subscriptionId": {
"description": "Obuna identifikatori",
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"paymentUrl",
"subscriptionId"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"required": [
"data"
],
"type": "object"
},
"CreateSubscriptionResponseData": {
"properties": {
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
},
"subscriptionId": {
"description": "Obuna identifikatori",
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"paymentUrl",
"subscriptionId"
],
"type": "object"
},
"CustomerAggregates": {
"properties": {
"amountFirstSuccessfulOrder": {
"description": "Birinchi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"amountLatestSuccessfulOrder": {
"description": "Oxirgi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"cookie": {
"description": "Cookie fayllar",
"maxLength": 2048,
"type": "string"
},
"daysSinceLastPasswordReset": {
"description": "Parol oxirgi marta tiklanganidan beri o‘tgan kunlar soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsOneDay": {
"description": "So‘nggi 1 kun ichida muvaffaqiyatsiz kirish urinishlari soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsSevenDays": {
"description": "So‘nggi 7 kun ichida muvaffaqiyatsiz kirishga urinishlar soni",
"format": "int32",
"type": "integer"
},
"firstSuccessfulOrderDate": {
"description": "Tarixdagi birinchi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"historicalCookieLogin": {
"description": "Saqlangan cookie orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"historicalDeviceLogin": {
"description": "Saqlangan qurilma orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"lastPasswordResetDate": {
"description": "Parol oxirgi marta tiklangan sana",
"format": "date",
"type": "string"
},
"latestSuccessfulOrderLastYearDate": {
"description": "So‘nggi bir yil ichidagi oxirgi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"previousSuccessfulOrdersAtSameAddress": {
"description": "Foydalanuvchi joriy manzil bo‘yicha ilgari muvaffaqiyatli buyurtma qilganmi",
"type": "boolean"
},
"redemptionRateLastHalfYear": {
"description": "So‘nggi yarim yil ichidagi xaridni yakunlash foizi",
"example": "123.45",
"format": "double",
"type": "string"
},
"registrationDate": {
"description": "Sotuvchi saytida ro‘yxatdan o‘tgan sana",
"format": "date",
"type": "string"
}
},
"type": "object"
},
"CustomerSubscriptionResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"cancelledAt": {
"description": "Obunani bekor qilish vaqti",
"format": "date-time",
"type": "string"
},
"customerSubscriptionId": {
"description": "Obuna ID raqami",
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"isCardActive": {
"description": "Biriktirilgan karta holati",
"type": "boolean"
},
"nextWriteOff": {
"description": "Keyingi yechib olish sanasi",
"format": "date-time",
"type": "string"
},
"status": {
"description": "Obuna holati",
"enum": [
"NEW",
"ACTIVE",
"CANCELLED",
"EXPIRED"
],
"type": "string"
},
"subscriptionPlanId": {
"description": "Obuna rejasi ID raqami",
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"status",
"subscriptionPlanId"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
},
"CustomerSubscriptionResponseData": {
"properties": {
"cancelledAt": {
"description": "Obunani bekor qilish vaqti",
"format": "date-time",
"type": "string"
},
"customerSubscriptionId": {
"description": "Obuna ID raqami",
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"isCardActive": {
"description": "Biriktirilgan karta holati",
"type": "boolean"
},
"nextWriteOff": {
"description": "Keyingi yechib olish sanasi",
"format": "date-time",
"type": "string"
},
"status": {
"description": "Obuna holati",
"enum": [
"NEW",
"ACTIVE",
"CANCELLED",
"EXPIRED"
],
"type": "string"
},
"subscriptionPlanId": {
"description": "Obuna rejasi ID raqami",
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"status",
"subscriptionPlanId"
],
"type": "object"
},
"Delivery": {
"properties": {
"actualPrice": {
"description": "Sotuvchi uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Yetkazish yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"price": {
"description": "Xaridor uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"status": {
"default": "NEW",
"description": "Yetkazish holati",
"enum": [
"NEW",
"ESTIMATING",
"EXPIRED",
"READY_FOR_APPROVAL",
"COLLECTING",
"PREPARING",
"DELIVERING",
"DELIVERED",
"RETURNING",
"RETURNED",
"FAILED",
"CANCELLED"
],
"type": "string"
},
"updated": {
"description": "Yetkazish yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"price"
],
"type": "object"
},
"Discount": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"FlexibleCustomerChoice": {
"properties": {
"date": {
"format": "date",
"type": "string"
},
"time": {
"allOf": [
{
"properties": {
"end": {
"description": "Interval tugash vaqti",
"type": "string"
},
"start": {
"description": "Interval boshlanish vaqti",
"type": "string"
}
},
"required": [
"end",
"start"
],
"type": "object"
}
]
}
},
"required": [
"date"
],
"type": "object"
},
"FlexibleTimeIntervals": {
"properties": {
"grid": {
"allOf": [
{
"properties": {
"duration": {
"description": "Har bir interval davomiyligi",
"type": "string"
},
"end": {
"description": "Eng oxirgi interval boshlanishining maksimal vaqti",
"type": "string"
},
"start": {
"description": "Birinchi interval boshlanish vaqti",
"type": "string"
},
"step": {
"description": "Ikki qo‘shni interval boshlanishlari orasidagi vaqt farqi",
"type": "string"
}
},
"required": [
"duration",
"end",
"start",
"step"
],
"type": "object"
}
],
"description": "Intervallarni to‘r ko‘rinishida kodlaydi. Agar 20 tadan ortiq yetkazish intervalini belgilash kerak bo‘lsa, ushbu formatdan foydalaning.\nMasalan: `{\"start\": \"09:00\", \"end\": \"21:00\", \"duration\": \"00:20\", \"step\": \"01:00\"}` quyidagi intervallar to‘plami sifatida talqin qilinadi: `[{\"start\": \"09:00\", \"end\": \"09:20\"}, {\"start\": \"10:00\", \"end\": \"10:20\"}, ..., {\"start\": \"20:00\", \"end\": \"20:20\"}]`"
},
"type": {
"description": "Agar `GRID` turi ko‘rsatilgan bo‘lsa, `grid` maydonini kiritish zarur. Agar `VALUES` turi ko‘rsatilgan bo‘lsa, `values` maydonini kiritish zarur",
"enum": [
"GRID",
"VALUES"
],
"type": "string"
},
"values": {
"description": "Yetkazish intervallari ro‘yxatini to‘g‘ridan-to‘g‘ri belgilaydi. Yetkazish berish intervallari soni kam bo‘lgan holatlar uchun mos keladi. Tavsiya etilgan maksimal intervallar soni – 20",
"items": {
"properties": {
"end": {
"description": "Interval tugash vaqti",
"type": "string"
},
"start": {
"description": "Interval boshlanish vaqti",
"type": "string"
}
},
"required": [
"end",
"start"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type"
],
"type": "object"
},
"FlexibleTimeIntervalsGridDescriptor": {
"properties": {
"duration": {
"description": "Har bir interval davomiyligi",
"type": "string"
},
"end": {
"description": "Eng oxirgi interval boshlanishining maksimal vaqti",
"type": "string"
},
"start": {
"description": "Birinchi interval boshlanish vaqti",
"type": "string"
},
"step": {
"description": "Ikki qo‘shni interval boshlanishlari orasidagi vaqt farqi",
"type": "string"
}
},
"required": [
"duration",
"end",
"start",
"step"
],
"type": "object"
},
"ItemQuantity": {
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
},
"ItemReceipt": {
"properties": {
"agent": {
"allOf": [
{
"properties": {
"agentType": {
"description": "Hisob-kitob predmeti bo‘yicha agent belgisi. [Qiymatlar](https://pay.yandex.uz/ru/docs/custom/fns#agent-type)ga qarang",
"enum": [
1,
2,
3,
4,
5,
6,
7
],
"type": "integer"
},
"operation": {
"maxLength": 2048,
"type": "string"
},
"paymentsOperator": {
"allOf": [
{
"properties": {
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
]
},
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
},
"transferOperator": {
"allOf": [
{
"properties": {
"address": {
"maxLength": 2048,
"type": "string"
},
"inn": {
"maxLength": 2048,
"type": "string"
},
"name": {
"maxLength": 2048,
"type": "string"
},
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
]
}
},
"required": [
"agentType"
],
"type": "object"
}
]
},
"excise": {
"description": "Verguldan keyin ikki xonadan ortiq belgi bo‘lmasligi kerak.\nMasalan: 1,12, 5,1, 10, 11,00",
"example": "123.45",
"format": "double",
"type": "string"
},
"markQuantity": {
"allOf": [
{
"properties": {
"denominator": {
"format": "int32",
"type": "integer"
},
"numerator": {
"format": "int32",
"type": "integer"
}
},
"required": [
"denominator",
"numerator"
],
"type": "object"
}
]
},
"measure": {
"description": "Qiymatlar tavsifi: [Havola](https://pay.yandex.uz/ru/docs/custom/backend/fns#measure-code)",
"enum": [
0,
10,
11,
12,
20,
21,
22,
30,
31,
32,
40,
41,
42,
50,
51,
70,
71,
72,
73,
80,
81,
82,
83,
255,
null
],
"type": "integer"
},
"paymentMethodType": {
"description": "Qiymatlar tavsifi: [Havola](https://pay.yandex.uz/ru/docs/custom/backend/fns#payment-method-type)",
"enum": [
1,
2,
3,
4,
5,
6,
7,
null
],
"type": "integer"
},
"paymentSubjectType": {
"description": "Qiymatlar tavsifi: [Havola](https://pay.yandex.uz/ru/docs/custom/backend/fns#payment-subject-type)",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10,
11,
12,
13,
14,
15,
16,
17,
18,
19,
20,
21,
22,
23,
24,
25,
26,
null
],
"type": "integer"
},
"productCode": {
"description": "Mahsulot kodi (base64 formatida kodlangan, 1 dan 32 baytgacha bo‘lgan massiv)",
"format": "base64",
"type": "string"
},
"supplier": {
"allOf": [
{
"properties": {
"inn": {
"maxLength": 2048,
"type": "string"
},
"name": {
"maxLength": 2048,
"type": "string"
},
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
}
]
},
"tax": {
"description": "Qiymatlar tavsifi: [Havola](https://pay.yandex.uz/ru/docs/custom/backend/fns#tax)",
"enum": [
1,
2,
3,
4,
5,
6,
7,
8,
9,
10
],
"type": "integer"
},
"title": {
"maxLength": 2048,
"type": "string"
}
},
"required": [
"tax"
],
"type": "object"
},
"Location": {
"properties": {
"latitude": {
"format": "float",
"type": "number"
},
"longitude": {
"format": "float",
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"MarkQuantity": {
"properties": {
"denominator": {
"format": "int32",
"type": "integer"
},
"numerator": {
"format": "int32",
"type": "integer"
}
},
"required": [
"denominator",
"numerator"
],
"type": "object"
},
"Measurements": {
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
},
"MerchantGetHostAppLinkHandlerResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"url": {
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
},
"MerchantGetHostAppLinkHandlerResponseData": {
"properties": {
"url": {
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"MerchantOperationResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
},
"MerchantOrderResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"delivery": {
"properties": {
"actualPrice": {
"description": "Sotuvchi uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Yetkazish yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"price": {
"description": "Xaridor uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"status": {
"default": "NEW",
"description": "Yetkazish holati",
"enum": [
"NEW",
"ESTIMATING",
"EXPIRED",
"READY_FOR_APPROVAL",
"COLLECTING",
"PREPARING",
"DELIVERING",
"DELIVERED",
"RETURNING",
"RETURNED",
"FAILED",
"CANCELLED"
],
"type": "string"
},
"updated": {
"description": "Yetkazish yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"price"
],
"type": "object"
},
"operations": {
"items": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"approvalCode": {
"description": "Protsessing markazidan olingan tranzaksiya tasdiqlash kodi.",
"readOnly": true,
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
},
"type": "array"
},
"order": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori.",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatchadagi mahsulotlar roʻyxati",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"finalPrice": {
"description": "Pozitsiya va savat bo‘yicha barcha chegirmalar hisobga olingan holdagi mahsulotning birlik narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"default": null,
"description": "Toʻlovga yoʻnaltiriladigan savatchaning yakuniy qiymati"
}
},
"required": [
"items"
],
"type": "object"
}
],
"description": "Savat"
},
"coolingPeriodExpiresAt": {
"description": "Sovutish muddati tugash sanasi va vaqti (ISO 8601)",
"format": "date-time",
"type": "string"
},
"created": {
"description": "Buyurtma yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"isPrepayment": {
"default": false,
"description": "Buyurtma “kechiktirilgan to‘lov” oqimi bo‘yicha amalga oshiriladimi.\n\nAgar parametr `true` qiymatiga o‘rnatilgan bo‘lsa, buyurtma kechiktirilgan to‘lovli buyurtma sifatida rasmiylashtiriladi.",
"type": "boolean"
},
"merchantId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"metadata": {
"description": "Tugmani ishga tushirish vaqtida uzatilgan ixtiyoriy ma’lumotlar",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Qaytarishlar, yetkazish, chegirmalar va promokodlarni hisobga olgan holda to‘lov uchun buyurtmaning to‘liq qiymati",
"example": "123.45",
"format": "double",
"type": "string"
},
"orderId": {
"description": "[/orders](../order/merchant_v1_orders-post.md) xizmatiga uzatilgan sotuvchi tomonidagi buyurtma ID raqami.",
"maxLength": 2048,
"type": "string"
},
"paymentMethod": {
"properties": {
"cardLast4": {
"maxLength": 2048,
"type": "string"
},
"cardNetwork": {
"description": "To‘lov tizimi",
"enum": [
"AMEX",
"DISCOVER",
"JCB",
"MASTERCARD",
"MAESTRO",
"VISAELECTRON",
"VISA",
"MIR",
"UNIONPAY",
"UZCARD",
"HUMOCARD",
"UNKNOWN",
"UNDEFINED",
null
],
"type": "string"
},
"methodType": {
"enum": [
"SPLIT"
],
"type": "string"
}
},
"required": [
"methodType"
],
"type": "object"
},
"paymentStatus": {
"description": "Batafsil ma’lumotni [Operatsiya holatlari](../../../../payments/statuses) bo‘limidan o‘qing.",
"enum": [
"PENDING",
"AUTHORIZED",
"CAPTURED",
"VOIDED",
"REFUNDED",
"CONFIRMED",
"PARTIALLY_REFUNDED",
"FAILED",
null
],
"type": "string",
"x-enumDescriptions": {
"AUTHORIZED": "Платеж за заказ авторизован. Средства заблокированы на счету плательщика",
"CAPTURED": "Заказ успешно оплачен. Средства списаны со счета плательщика",
"CONFIRMED": "Заказ успешно оформлен",
"FAILED": "Заказ не был успешно оплачен",
"PARTIALLY_REFUNDED": "Совершен частичный возврат средств за заказ",
"PENDING": "Ожидается оплата",
"REFUNDED": "Совершен возврат средств за заказ",
"VOIDED": "Оплата отменена. Списание средств не производилось"
}
},
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
},
"reason": {
"description": "Buyurtma bekor qilinish sababi. `VOIDED` va `FAILED` holatlari uchun qo‘llaniladi.",
"maxLength": 2048,
"type": "string"
},
"updated": {
"description": "Buyurtma yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"cart",
"currencyCode"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
},
"MerchantRedirectUrls": {
"properties": {
"onAbort": {
"description": "To‘lov jarayoni bekor qilinganda foydalanuvchini qayta yo‘naltirish uchun havola. To‘lovni bekor qilish foydalanuvchi tomonidan to‘lov formasida amalga oshiriladi.",
"maxLength": 2048,
"type": "string"
},
"onError": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov vaqtida noma’lum xatolik yuz bersa yoki to‘lov havolasining amal qilish muddati tugasa, foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
},
"onSuccess": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov muvaffaqiyatli yakunlanganda foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"onError",
"onSuccess"
],
"type": "object"
},
"MerchantRiskInfo": {
"properties": {
"billingPhone": {
"description": "**DEPRECATED** Mijoz telefon raqami. <br/>*Yuqori darajadagi shu nomdagi maydondan foydalanish tavsiya etiladi.*",
"maxLength": 2048,
"type": "string"
},
"customerAggregates": {
"allOf": [
{
"properties": {
"amountFirstSuccessfulOrder": {
"description": "Birinchi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"amountLatestSuccessfulOrder": {
"description": "Oxirgi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"cookie": {
"description": "Cookie fayllar",
"maxLength": 2048,
"type": "string"
},
"daysSinceLastPasswordReset": {
"description": "Parol oxirgi marta tiklanganidan beri o‘tgan kunlar soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsOneDay": {
"description": "So‘nggi 1 kun ichida muvaffaqiyatsiz kirish urinishlari soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsSevenDays": {
"description": "So‘nggi 7 kun ichida muvaffaqiyatsiz kirishga urinishlar soni",
"format": "int32",
"type": "integer"
},
"firstSuccessfulOrderDate": {
"description": "Tarixdagi birinchi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"historicalCookieLogin": {
"description": "Saqlangan cookie orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"historicalDeviceLogin": {
"description": "Saqlangan qurilma orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"lastPasswordResetDate": {
"description": "Parol oxirgi marta tiklangan sana",
"format": "date",
"type": "string"
},
"latestSuccessfulOrderLastYearDate": {
"description": "So‘nggi bir yil ichidagi oxirgi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"previousSuccessfulOrdersAtSameAddress": {
"description": "Foydalanuvchi joriy manzil bo‘yicha ilgari muvaffaqiyatli buyurtma qilganmi",
"type": "boolean"
},
"redemptionRateLastHalfYear": {
"description": "So‘nggi yarim yil ichidagi xaridni yakunlash foizi",
"example": "123.45",
"format": "double",
"type": "string"
},
"registrationDate": {
"description": "Sotuvchi saytida ro‘yxatdan o‘tgan sana",
"format": "date",
"type": "string"
}
},
"type": "object"
}
],
"description": "Mijoz haqida umumlashtirilgan ma’lumotlar"
},
"deviceId": {
"description": "Mijoz qurilmasi identifikatori (device_id/gaid/idfa/ifv)",
"maxLength": 2048,
"type": "string"
},
"isExpressShipping": {
"description": "Ekspress yetkazish belgisi",
"type": "boolean"
},
"merchantMcc": {
"description": "Merchant MCC kodi",
"maxLength": 2048,
"type": "string"
},
"merchantName": {
"description": "Merchant nomi",
"maxLength": 2048,
"type": "string"
},
"merchantOfflinePosLegalAddress": {
"description": "Oflayn savdo nuqtasining yuridik manzili",
"maxLength": 2048,
"type": "string"
},
"merchantTaxRefNumber": {
"description": "Merchantning soliq raqami",
"maxLength": 2048,
"type": "string"
},
"periodCheckAggregates": {
"allOf": [
{
"properties": {
"successfulOrdersCountNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountOneMonth": {
"description": "So‘nggi 1 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"totalAmountSuccessfulOrdersNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersOneMonth": {
"description": "So‘nggi bir oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"type": "object"
}
],
"description": "Turli davrlar bo‘yicha chek agregatlari."
},
"qrType": {
"description": "QR kod turi",
"enum": [
"static",
"dynamic",
null
],
"type": "string"
},
"qrcId": {
"description": "QR kod raqami",
"maxLength": 2048,
"type": "string"
},
"shippingAddress": {
"description": "Yetkazish manzili Agar buyurtmani olish usuli (`PICKUP`) “olib ketish” deb tanlangan bo‘lsa, mahsulotni berish punkti manzilini ko‘rsatish kerak.",
"maxLength": 2048,
"type": "string"
},
"shippingPhone": {
"description": "Qabul qiluvchining telefon raqami (masalan: +998123456789).",
"maxLength": 2048,
"type": "string"
},
"shippingType": {
"description": "Buyurtmani olish usuli",
"enum": [
"COURIER",
"PICKUP",
null
],
"type": "string"
}
},
"type": "object"
},
"Operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
},
"OperationResponseData": {
"properties": {
"operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
}
},
"type": "object"
},
"OrderExtensions": {
"properties": {
"billingReport": {
"allOf": [
{
"properties": {
"branchId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Savdo nuqtasi identifikatori",
"maxLength": 2048,
"type": "string"
},
"managerId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Menejer identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
}
],
"description": "Buyurtmani rasmiylashtirish joyi va mas’ul shaxs haqida ma’lumot."
},
"paymentData": {
"allOf": [
{
"properties": {
"saleToken": {
"description": "Har bir to‘lov operatsiyasi uchun kassa tomonidan yaratiladigan noyob ID",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
}
],
"description": "To‘lovning qo‘shimcha parametrlari."
},
"qrData": {
"allOf": [
{
"properties": {
"token": {
"description": "QR token",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
}
],
"description": "QR yordamida to‘lov havolasini yuborish uchun qo‘shimcha parametrlar."
},
"smsOffer": {
"allOf": [
{
"properties": {
"phone": {
"description": "SMS orqali xabarnoma yuborish uchun mijoz telefon raqami (masalan: `+998123456789`).\nFaqat oflayn do‘konlar uchun.",
"maxLength": 2048,
"pattern": "^\\+\\d+$",
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
}
],
"description": "SMS orqali to‘lov havolasini yuborish uchun qo‘shimcha parametrlar.\n\nFaqat oflayn doʻkonlar uchun majburiy maydon."
}
},
"type": "object"
},
"OrderResponseData": {
"properties": {
"delivery": {
"properties": {
"actualPrice": {
"description": "Sotuvchi uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Yetkazish yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"price": {
"description": "Xaridor uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"status": {
"default": "NEW",
"description": "Yetkazish holati",
"enum": [
"NEW",
"ESTIMATING",
"EXPIRED",
"READY_FOR_APPROVAL",
"COLLECTING",
"PREPARING",
"DELIVERING",
"DELIVERED",
"RETURNING",
"RETURNED",
"FAILED",
"CANCELLED"
],
"type": "string"
},
"updated": {
"description": "Yetkazish yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"price"
],
"type": "object"
},
"operations": {
"items": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"approvalCode": {
"description": "Protsessing markazidan olingan tranzaksiya tasdiqlash kodi.",
"readOnly": true,
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
},
"type": "array"
},
"order": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori.",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatchadagi mahsulotlar roʻyxati",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"finalPrice": {
"description": "Pozitsiya va savat bo‘yicha barcha chegirmalar hisobga olingan holdagi mahsulotning birlik narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"default": null,
"description": "Toʻlovga yoʻnaltiriladigan savatchaning yakuniy qiymati"
}
},
"required": [
"items"
],
"type": "object"
}
],
"description": "Savat"
},
"coolingPeriodExpiresAt": {
"description": "Sovutish muddati tugash sanasi va vaqti (ISO 8601)",
"format": "date-time",
"type": "string"
},
"created": {
"description": "Buyurtma yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"isPrepayment": {
"default": false,
"description": "Buyurtma “kechiktirilgan to‘lov” oqimi bo‘yicha amalga oshiriladimi.\n\nAgar parametr `true` qiymatiga o‘rnatilgan bo‘lsa, buyurtma kechiktirilgan to‘lovli buyurtma sifatida rasmiylashtiriladi.",
"type": "boolean"
},
"merchantId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"metadata": {
"description": "Tugmani ishga tushirish vaqtida uzatilgan ixtiyoriy ma’lumotlar",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Qaytarishlar, yetkazish, chegirmalar va promokodlarni hisobga olgan holda to‘lov uchun buyurtmaning to‘liq qiymati",
"example": "123.45",
"format": "double",
"type": "string"
},
"orderId": {
"description": "[/orders](../order/merchant_v1_orders-post.md) xizmatiga uzatilgan sotuvchi tomonidagi buyurtma ID raqami.",
"maxLength": 2048,
"type": "string"
},
"paymentMethod": {
"properties": {
"cardLast4": {
"maxLength": 2048,
"type": "string"
},
"cardNetwork": {
"description": "To‘lov tizimi",
"enum": [
"AMEX",
"DISCOVER",
"JCB",
"MASTERCARD",
"MAESTRO",
"VISAELECTRON",
"VISA",
"MIR",
"UNIONPAY",
"UZCARD",
"HUMOCARD",
"UNKNOWN",
"UNDEFINED",
null
],
"type": "string"
},
"methodType": {
"enum": [
"SPLIT"
],
"type": "string"
}
},
"required": [
"methodType"
],
"type": "object"
},
"paymentStatus": {
"description": "Batafsil ma’lumotni [Operatsiya holatlari](../../../../payments/statuses) bo‘limidan o‘qing.",
"enum": [
"PENDING",
"AUTHORIZED",
"CAPTURED",
"VOIDED",
"REFUNDED",
"CONFIRMED",
"PARTIALLY_REFUNDED",
"FAILED",
null
],
"type": "string",
"x-enumDescriptions": {
"AUTHORIZED": "Платеж за заказ авторизован. Средства заблокированы на счету плательщика",
"CAPTURED": "Заказ успешно оплачен. Средства списаны со счета плательщика",
"CONFIRMED": "Заказ успешно оформлен",
"FAILED": "Заказ не был успешно оплачен",
"PARTIALLY_REFUNDED": "Совершен частичный возврат средств за заказ",
"PENDING": "Ожидается оплата",
"REFUNDED": "Совершен возврат средств за заказ",
"VOIDED": "Оплата отменена. Списание средств не производилось"
}
},
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
},
"reason": {
"description": "Buyurtma bekor qilinish sababi. `VOIDED` va `FAILED` holatlari uchun qo‘llaniladi.",
"maxLength": 2048,
"type": "string"
},
"updated": {
"description": "Buyurtma yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"cart",
"currencyCode"
],
"type": "object"
}
},
"type": "object"
},
"OrderResponseOperation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"approvalCode": {
"description": "Protsessing markazidan olingan tranzaksiya tasdiqlash kodi.",
"readOnly": true,
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
},
"PaymentData": {
"properties": {
"saleToken": {
"description": "Har bir to‘lov operatsiyasi uchun kassa tomonidan yaratiladigan noyob ID",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"PaymentMethod": {
"properties": {
"cardLast4": {
"maxLength": 2048,
"type": "string"
},
"cardNetwork": {
"description": "To‘lov tizimi",
"enum": [
"AMEX",
"DISCOVER",
"JCB",
"MASTERCARD",
"MAESTRO",
"VISAELECTRON",
"VISA",
"MIR",
"UNIONPAY",
"UZCARD",
"HUMOCARD",
"UNKNOWN",
"UNDEFINED",
null
],
"type": "string"
},
"methodType": {
"enum": [
"SPLIT"
],
"type": "string"
}
},
"required": [
"methodType"
],
"type": "object"
},
"PaymentsOperator": {
"properties": {
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"PeriodCheckAggregates": {
"properties": {
"successfulOrdersCountNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountOneMonth": {
"description": "So‘nggi 1 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"totalAmountSuccessfulOrdersNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersOneMonth": {
"description": "So‘nggi bir oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"type": "object"
},
"PickupOption": {
"properties": {
"address": {
"description": "Manzil qator ko‘rinishida",
"maxLength": 2048,
"type": "string"
},
"allowedPaymentMethods": {
"description": "Tanlangan olib ketish usuli uchun individual to‘lov usullari. Tanlangan olib ketish usulida buyurtma uchun mavjud to‘lov usullari. Ushbu parametr `availablePaymentMethods`da ko‘rsatilgan to‘lov usullarini cheklash zarur bo‘lsa qo‘llaniladi. Agar parametr ko‘rsatilmagan bo‘lsa, `availablePaymentMethods`da sanab o‘tilgan barcha to‘lov usullaridan foydalaniladi.",
"items": {
"enum": [
"CARD",
"SPLIT",
"CASH_ON_DELIVERY",
"CARD_ON_DELIVERY",
"UNIQR_REUSABLE",
"UNIQR_ONETIME"
],
"type": "string"
},
"type": "array"
},
"amount": {
"description": "Manzilga yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Qo‘shimcha tavsif",
"maxLength": 2048,
"type": "string"
},
"fromDate": {
"description": "YYYY-MM-DD. Eng yaqin yetkazish sanasi",
"format": "date",
"type": "string"
},
"location": {
"properties": {
"latitude": {
"format": "float",
"type": "number"
},
"longitude": {
"format": "float",
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"phones": {
"description": "Aloqa uchun telefonlar",
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
},
"pickupPointId": {
"description": "Sotuvchi tizimidagi olib ketish nuqtasining unikal ID raqami",
"maxLength": 2048,
"type": "string"
},
"provider": {
"description": "Olib ketish punkti turi",
"enum": [
"YANDEX_MARKET",
"BOXBERRY",
"CDEK",
"IN_STORE",
"RUSSIAN_POST",
"PICKPOINT",
"DPD"
],
"type": "string"
},
"schedule": {
"description": "Punktning ish jadvali",
"items": {
"properties": {
"fromTime": {
"description": "HH:mm, \"08:00\"",
"type": "string"
},
"label": {
"description": "Masalan: \"du-jum\"",
"maxLength": 2048,
"type": "string"
},
"toTime": {
"description": "HH:mm, \"20:00\"",
"type": "string"
}
},
"required": [
"fromTime",
"label",
"toTime"
],
"type": "object"
},
"type": "array"
},
"storagePeriod": {
"description": "Ixtiyoriy. Mahsulotni olib ketish punktida saqlash muddati (kun hisobida)",
"format": "int32",
"type": "integer"
},
"title": {
"description": "Olib ketish punkti nomi",
"maxLength": 2048,
"type": "string"
},
"toDate": {
"description": "YYYY-MM-DD. Eng kech yetkazish sanasi",
"format": "date",
"type": "string"
}
},
"required": [
"address",
"location",
"pickupPointId",
"title"
],
"type": "object"
},
"PickupSchedule": {
"properties": {
"fromTime": {
"description": "HH:mm, \"08:00\"",
"type": "string"
},
"label": {
"description": "Masalan: \"du-jum\"",
"maxLength": 2048,
"type": "string"
},
"toTime": {
"description": "HH:mm, \"20:00\"",
"type": "string"
}
},
"required": [
"fromTime",
"label",
"toTime"
],
"type": "object"
},
"QRData": {
"properties": {
"token": {
"description": "QR token",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
},
"RecurSubscriptionRequest": {
"properties": {
"amount": {
"description": "Yechib olinadigan summa",
"example": "123.45",
"format": "double",
"type": "string"
},
"cart": {
"allOf": [
{
"properties": {
"externalId": {
"description": "Sotuvchi tomonidan uzatilgan savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Xaridor to‘laydigan mahsulotlar savatchasi.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Mahsulotning bir dona narxi – pozitsiyaga qo‘llangan chegirmalar hisobga olingan holda.",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "Plus ballari soni\n\nFaqat o‘qish uchun maydon. Yuborilgan qiymatlar e’tiborga olinmaydi.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot id raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob id raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan jami narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Mahsulot birligi uchun chegirmasiz to‘liq narx",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Savat"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"metadata": {
"description": "Buyurtma bo‘yicha ichki foydalanish uchun ixtiyoriy ma’lumotlar.",
"maxLength": 2048,
"type": "string"
},
"orderId": {
"description": "Sotuvchi tomonidagi buyurtma identifikatori (unikal bo‘lishi kerak)",
"maxLength": 2048,
"type": "string"
},
"parentOrderId": {
"description": "Boshlangʻich buyurtma identifikatori",
"maxLength": 2048,
"type": "string"
},
"purpose": {
"description": "To‘lov maqsadi",
"maxLength": 1000,
"type": "string"
}
},
"required": [
"amount",
"cart",
"currencyCode",
"orderId",
"parentOrderId"
],
"type": "object"
},
"RecurSubscriptionResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"operationId"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
},
"RecurSubscriptionResponseData": {
"properties": {
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"operationId"
],
"type": "object"
},
"RefundRequest": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Yakuniy savat"
},
"externalOperationId": {
"description": "Sotuvchi tizimidagi operatsiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Buyurtmaning yakuniy summasi. `cart.total.amount` + `shipping.amount` ga teng",
"example": "123.45",
"format": "double",
"type": "string"
},
"refundAmount": {
"description": "Qaytariladigan summa.",
"example": "123.45",
"format": "double",
"type": "string"
},
"shipping": {
"properties": {
"amount": {
"description": "Verguldan keyin ikki xonadan ortiq belgi bo‘lmasligi kerak.\nMasalan: 1,12, 5,1, 10, 11,00",
"example": "123.45",
"format": "double",
"type": "string"
},
"methodType": {
"enum": [
"DIRECT",
"PICKUP",
"COURIER",
"YANDEX_DELIVERY"
],
"type": "string"
}
},
"required": [
"amount",
"methodType"
],
"type": "object"
}
},
"required": [
"orderAmount",
"refundAmount"
],
"type": "object"
},
"RefundV2Request": {
"properties": {
"branchId": {
"description": "Savdo nuqtasi identifikatori",
"maxLength": 2048,
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tizimidagi qaytarish operatsiyasi identifikatori. U noyob bo‘lishi kerak.\n\nUshbu parametrni kiriting – qaytarish operatsiyasi holatini [/operations/{external_operation_id}](../operation/merchant_v1_operations-get) metodi orqali kuzatish imkoniyatiga ega bo‘lasiz.\n\nAgar operatsiya hali yakunlanmagan bo‘lsa (ya’ni qayta ishlanayotgan yoki to‘xtatilgan holatda bo‘lsa), unda xuddi shu argumentlar va aynan shu `externalOperationId` qiymati bilan qaytarish metodini qayta chaqirish idempotent hisoblanadi – javobda o‘sha operatsiyaning o‘zi qaytariladi. Aks holda xatolik qaytariladi.\n\nAgar qaytarish jarayoni muvaffaqiyatli ishga tushirilgan bo‘lsa, shu `externalOperationId` bilan metodni qayta chaqirish quyidagi xatoni qaytaradi: `reasonCode: \"DUPLICATE_EXTERNAL_OPERATION_ID\"`.",
"maxLength": 2048,
"type": "string"
},
"managerId": {
"description": "Menejer identifikatori",
"maxLength": 2048,
"type": "string"
},
"motive": {
"description": "Qaytarish sababi",
"maxLength": 2048,
"type": "string"
},
"refundAmount": {
"description": "Qaytariladigan summa.",
"example": "123.45",
"format": "double",
"type": "string"
},
"refundCart": {
"allOf": [
{
"properties": {
"items": {
"items": {
"properties": {
"price": {
"description": "Operatsiya bajarilgandan keyingi mahsulot/xizmatning bir dona narxi.\nAgar operatsiya natijasida bitta mahsulot narxi kamaytirilsa, ushbu parametrni ko‘rsatish zarur.\nBu parametr mahsulot uchun pulning faqat bir qismini qaytarish yoki buyurtmani tasdiqlash jarayonida foydali bo‘lishi mumkin.\nAgar so‘rovda ushbu maydon ko‘rsatilmasa, mahsulot narxi o‘zgarmagan deb hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"productId": {
"description": "Buyurtma yaratilgan paytdagi savatdagi pozitsiya identifikatori.\nAgar dastlabki savatda mavjud bo‘lmagan identifikator yuborilsa – xatolik yuz beradi.",
"maxLength": 2048,
"type": "string"
},
"quantityCount": {
"description": "Qaytarish operatsiyasi uchun mahsulot birliklari soni.\n\nQiymat ishlatilayotgan savat turiga bog‘liq:\n\n- agar `targetCart` ishlatilsa, `quantityCount` – qaytarishdan keyin qoladigan mahsulot soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 2 dona qoladi);\n- agar `refundCart` ishlatilsa, `quantityCount` – qaytariladigan mahsulotlar soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 3 dona qaytariladi).\n\nAgar maydon ko‘rsatilmasa, mahsulot miqdori o‘zgarmaydi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
],
"description": "Qaytarilishi kerak bo‘lgan savat pozitsiyalarini tavsiflaydi.\nBu parametrni `targetCart` maydoni bilan bir vaqtda ko‘rsatish mumkin emas.\nShuningdek, ushbu parametr bilan birga `externalOperationId` operatsiya identifikatorini yuborish tavsiya etiladi, chunki u idempotentlik tokeni hisoblanadi."
},
"targetCart": {
"allOf": [
{
"properties": {
"items": {
"items": {
"properties": {
"price": {
"description": "Operatsiya bajarilgandan keyingi mahsulot/xizmatning bir dona narxi.\nAgar operatsiya natijasida bitta mahsulot narxi kamaytirilsa, ushbu parametrni ko‘rsatish zarur.\nBu parametr mahsulot uchun pulning faqat bir qismini qaytarish yoki buyurtmani tasdiqlash jarayonida foydali bo‘lishi mumkin.\nAgar so‘rovda ushbu maydon ko‘rsatilmasa, mahsulot narxi o‘zgarmagan deb hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"productId": {
"description": "Buyurtma yaratilgan paytdagi savatdagi pozitsiya identifikatori.\nAgar dastlabki savatda mavjud bo‘lmagan identifikator yuborilsa – xatolik yuz beradi.",
"maxLength": 2048,
"type": "string"
},
"quantityCount": {
"description": "Qaytarish operatsiyasi uchun mahsulot birliklari soni.\n\nQiymat ishlatilayotgan savat turiga bog‘liq:\n\n- agar `targetCart` ishlatilsa, `quantityCount` – qaytarishdan keyin qoladigan mahsulot soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 2 dona qoladi);\n- agar `refundCart` ishlatilsa, `quantityCount` – qaytariladigan mahsulotlar soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 3 dona qaytariladi).\n\nAgar maydon ko‘rsatilmasa, mahsulot miqdori o‘zgarmaydi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
],
"description": "Qaytarish amalga oshirilgandan keyingi savatning yakuniy holatini tavsiflaydi.\nAgar bu maydon ko‘rsatilmasa, savat to‘liq qaytarilgan deb hisoblanadi. Uni `refundCart` maydoni bilan bir vaqtda ko‘rsatish mumkin emas."
},
"targetShipping": {
"allOf": [
{
"properties": {
"amount": {
"description": "Operatsiya bajarilgandan keyingi yetkazish narxi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"type": "object"
}
],
"description": "Faqat Yandex Pay Checkout uchun qo‘llaniladi. Boshqa holatlarda ushbu maydonni bo‘sh qoldirish kerak.\n\nQaytarish amalga oshirilgandan keyingi yetkazishning yakuniy holatini tavsiflaydi.\nAgar bu maydon ko‘rsatilmagan bo‘lsa yoki qiymati `null`ga teng bo‘lsa, yetkazish narxi to‘liq qaytarilgan deb hisoblanadi."
}
},
"required": [
"refundAmount"
],
"type": "object"
},
"RenderedCart": {
"description": "{% note info %}\n\nYetkazish narxini `items` ichida alohida mahsulot sifatida kiriting.\n\n{% endnote %}",
"properties": {
"externalId": {
"description": "Savat identifikatori – sotuvchi tomonida.",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatdagi mahsulotlar ro‘yxati.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
},
"RenderedCart1": {
"properties": {
"externalId": {
"description": "Sotuvchi tomonidan uzatilgan savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Xaridor to‘laydigan mahsulotlar savatchasi.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Mahsulotning bir dona narxi – pozitsiyaga qo‘llangan chegirmalar hisobga olingan holda.",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "Plus ballari soni\n\nFaqat o‘qish uchun maydon. Yuborilgan qiymatlar e’tiborga olinmaydi.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot id raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob id raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan jami narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Mahsulot birligi uchun chegirmasiz to‘liq narx",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
},
"RenderedCartItem": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"RenderedCartItem1": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Mahsulotning bir dona narxi – pozitsiyaga qo‘llangan chegirmalar hisobga olingan holda.",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "Plus ballari soni\n\nFaqat o‘qish uchun maydon. Yuborilgan qiymatlar e’tiborga olinmaydi.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot id raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob id raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan jami narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Mahsulot birligi uchun chegirmasiz to‘liq narx",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"SMSOffer": {
"properties": {
"phone": {
"description": "SMS orqali xabarnoma yuborish uchun mijoz telefon raqami (masalan: `+998123456789`).\nFaqat oflayn do‘konlar uchun.",
"maxLength": 2048,
"pattern": "^\\+\\d+$",
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
},
"ShippingMethod": {
"properties": {
"courierOption": {
"allOf": [
{
"properties": {
"allowedPaymentMethods": {
"description": "Yetkazish berish usuli uchun individual to‘lov usullari. Ushbu parametr `availablePaymentMethods`da ko‘rsatilgan to‘lov usullarini cheklash zarur bo‘lsa qo‘llaniladi. Agar parametr ko‘rsatilmagan bo‘lsa, `availablePaymentMethods`da sanab o‘tilgan barcha to‘lov usullaridan foydalaniladi.",
"items": {
"enum": [
"CARD",
"SPLIT",
"CASH_ON_DELIVERY",
"CARD_ON_DELIVERY",
"UNIQR_REUSABLE",
"UNIQR_ONETIME"
],
"type": "string"
},
"type": "array"
},
"amount": {
"description": "Yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"category": {
"enum": [
"EXPRESS",
"TODAY",
"STANDARD"
],
"type": "string"
},
"courierOptionId": {
"description": "Sotuvchi tizimidagi tanlangan yetkazish varianti ID raqami",
"maxLength": 2048,
"type": "string"
},
"customerChoice": {
"allOf": [
{
"properties": {
"date": {
"format": "date",
"type": "string"
},
"time": {
"allOf": [
{
"properties": {
"end": {
"description": "Interval tugash vaqti",
"type": "string"
},
"start": {
"description": "Interval boshlanish vaqti",
"type": "string"
}
},
"required": [
"end",
"start"
],
"type": "object"
}
]
}
},
"required": [
"date"
],
"type": "object"
}
],
"description": "Foydalanuvchi tomonidan tanlangan sana va interval. Faqat `type: FLEXIBLE` uchun"
},
"fromDate": {
"description": "`type: PLAIN` uchun eng yaqin yetkazish sanasi. `type: FLEXIBLE` uchun yetkazish sanasini tanlash intervalining boshlanishi",
"format": "date",
"type": "string"
},
"fromTime": {
"description": "Yetkazish intervali boshlanishi. Faqat `type: PLAIN` uchun",
"type": "string"
},
"provider": {
"description": "Yetkazish xizmati turi.",
"enum": [
"BOXBERRY",
"CDEK",
"RUSSIAN_POST",
"EMS",
"COURIER",
"DHL",
"EXPRESS_DELIVERY",
"FIVEPOST",
"OZON_ROCKET",
"DPD",
"SBER_LOGISTICS",
"PEK",
"PICKPOINT",
"KCE",
"PONY_EXPRESS",
"YANDEX_DELIVERY",
null
],
"type": "string"
},
"timeIntervals": {
"allOf": [
{
"properties": {
"grid": {
"allOf": [
{
"properties": {
"duration": {
"description": "Har bir interval davomiyligi",
"type": "string"
},
"end": {
"description": "Eng oxirgi interval boshlanishining maksimal vaqti",
"type": "string"
},
"start": {
"description": "Birinchi interval boshlanish vaqti",
"type": "string"
},
"step": {
"description": "Ikki qo‘shni interval boshlanishlari orasidagi vaqt farqi",
"type": "string"
}
},
"required": [
"duration",
"end",
"start",
"step"
],
"type": "object"
}
],
"description": "Intervallarni to‘r ko‘rinishida kodlaydi. Agar 20 tadan ortiq yetkazish intervalini belgilash kerak bo‘lsa, ushbu formatdan foydalaning.\nMasalan: `{\"start\": \"09:00\", \"end\": \"21:00\", \"duration\": \"00:20\", \"step\": \"01:00\"}` quyidagi intervallar to‘plami sifatida talqin qilinadi: `[{\"start\": \"09:00\", \"end\": \"09:20\"}, {\"start\": \"10:00\", \"end\": \"10:20\"}, ..., {\"start\": \"20:00\", \"end\": \"20:20\"}]`"
},
"type": {
"description": "Agar `GRID` turi ko‘rsatilgan bo‘lsa, `grid` maydonini kiritish zarur. Agar `VALUES` turi ko‘rsatilgan bo‘lsa, `values` maydonini kiritish zarur",
"enum": [
"GRID",
"VALUES"
],
"type": "string"
},
"values": {
"description": "Yetkazish intervallari ro‘yxatini to‘g‘ridan-to‘g‘ri belgilaydi. Yetkazish berish intervallari soni kam bo‘lgan holatlar uchun mos keladi. Tavsiya etilgan maksimal intervallar soni – 20",
"items": {
"properties": {
"end": {
"description": "Interval tugash vaqti",
"type": "string"
},
"start": {
"description": "Interval boshlanish vaqti",
"type": "string"
}
},
"required": [
"end",
"start"
],
"type": "object"
},
"type": "array"
}
},
"required": [
"type"
],
"type": "object"
}
],
"description": "Tanlash uchun mavjud bo‘lgan yetkazish vaqt intervallarini kodlaydi. Faqat `type: FLEXIBLE` uchun"
},
"title": {
"description": "Yetkazish usuli nomi. Variantlar ro‘yxatida foydalanuvchiga ko‘rsatiladi",
"maxLength": 2048,
"type": "string"
},
"toDate": {
"description": "`type: PLAIN` uchun eng kech yetkazish sanasi. `type: FLEXIBLE` uchun yetkazish sanasini tanlash intervalining tugashi",
"format": "date",
"type": "string"
},
"toTime": {
"description": "Yetkazish vaqt intervalining tugashi. Faqat `type: PLAIN` uchun",
"type": "string"
},
"type": {
"default": "PLAIN",
"description": "Opsiya turi.\n`FLEXIBLE` turidagi yetkazish variantlari uchun foydalanuvchiga kerakli sana va intervalni tanlash imkoniyati beriladi:\n- Yetkazish sanasi xaridor tomonidan `[fromDate, toDate]` oralig‘ida tanlanadi\n- foydalanuvchiga kun davomida interval tanlash imkonini berish uchun `timeIntervals` maydonini to‘ldiring\n`PLAIN` turidagi variantlarda bunday tanlov mavjud emas.",
"enum": [
"PLAIN",
"FLEXIBLE"
],
"type": "string"
}
},
"required": [
"amount",
"category",
"courierOptionId",
"title"
],
"type": "object"
}
],
"description": "agar methodType == COURIER"
},
"methodType": {
"enum": [
"DIRECT",
"PICKUP",
"COURIER",
"YANDEX_DELIVERY"
],
"type": "string"
},
"pickupOption": {
"allOf": [
{
"properties": {
"address": {
"description": "Manzil qator ko‘rinishida",
"maxLength": 2048,
"type": "string"
},
"allowedPaymentMethods": {
"description": "Tanlangan olib ketish usuli uchun individual to‘lov usullari. Tanlangan olib ketish usulida buyurtma uchun mavjud to‘lov usullari. Ushbu parametr `availablePaymentMethods`da ko‘rsatilgan to‘lov usullarini cheklash zarur bo‘lsa qo‘llaniladi. Agar parametr ko‘rsatilmagan bo‘lsa, `availablePaymentMethods`da sanab o‘tilgan barcha to‘lov usullaridan foydalaniladi.",
"items": {
"enum": [
"CARD",
"SPLIT",
"CASH_ON_DELIVERY",
"CARD_ON_DELIVERY",
"UNIQR_REUSABLE",
"UNIQR_ONETIME"
],
"type": "string"
},
"type": "array"
},
"amount": {
"description": "Manzilga yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Qo‘shimcha tavsif",
"maxLength": 2048,
"type": "string"
},
"fromDate": {
"description": "YYYY-MM-DD. Eng yaqin yetkazish sanasi",
"format": "date",
"type": "string"
},
"location": {
"properties": {
"latitude": {
"format": "float",
"type": "number"
},
"longitude": {
"format": "float",
"type": "number"
}
},
"required": [
"latitude",
"longitude"
],
"type": "object"
},
"phones": {
"description": "Aloqa uchun telefonlar",
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
},
"pickupPointId": {
"description": "Sotuvchi tizimidagi olib ketish nuqtasining unikal ID raqami",
"maxLength": 2048,
"type": "string"
},
"provider": {
"description": "Olib ketish punkti turi",
"enum": [
"YANDEX_MARKET",
"BOXBERRY",
"CDEK",
"IN_STORE",
"RUSSIAN_POST",
"PICKPOINT",
"DPD"
],
"type": "string"
},
"schedule": {
"description": "Punktning ish jadvali",
"items": {
"properties": {
"fromTime": {
"description": "HH:mm, \"08:00\"",
"type": "string"
},
"label": {
"description": "Masalan: \"du-jum\"",
"maxLength": 2048,
"type": "string"
},
"toTime": {
"description": "HH:mm, \"20:00\"",
"type": "string"
}
},
"required": [
"fromTime",
"label",
"toTime"
],
"type": "object"
},
"type": "array"
},
"storagePeriod": {
"description": "Ixtiyoriy. Mahsulotni olib ketish punktida saqlash muddati (kun hisobida)",
"format": "int32",
"type": "integer"
},
"title": {
"description": "Olib ketish punkti nomi",
"maxLength": 2048,
"type": "string"
},
"toDate": {
"description": "YYYY-MM-DD. Eng kech yetkazish sanasi",
"format": "date",
"type": "string"
}
},
"required": [
"address",
"location",
"pickupPointId",
"title"
],
"type": "object"
}
],
"description": "agar methodType == PICKUP"
},
"yandexDeliveryOption": {
"allOf": [
{
"properties": {
"allowedPaymentMethods": {
"description": "Yetkazish berish usuli uchun individual to‘lov usullari. Ushbu parametr `availablePaymentMethods`da ko‘rsatilgan to‘lov usullarini cheklash zarur bo‘lsa qo‘llaniladi. Agar parametr ko‘rsatilmagan bo‘lsa, `availablePaymentMethods`da sanab o‘tilgan barcha to‘lov usullaridan foydalaniladi.",
"items": {
"enum": [
"CARD",
"SPLIT",
"CASH_ON_DELIVERY",
"CARD_ON_DELIVERY",
"UNIQR_REUSABLE",
"UNIQR_ONETIME"
],
"type": "string"
},
"type": "array"
},
"amount": {
"description": "Yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"category": {
"enum": [
"EXPRESS",
"TODAY",
"STANDARD"
],
"type": "string"
},
"fromDatetime": {
"format": "date-time",
"type": "string"
},
"title": {
"description": "Yetkazish usuli nomi. Variantlar ro‘yxatida foydalanuvchiga ko‘rsatiladi",
"maxLength": 2048,
"type": "string"
},
"toDatetime": {
"format": "date-time",
"type": "string"
},
"yandexDeliveryOptionId": {
"description": "Yandex Delivery taklifi ID raqami",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"category",
"title",
"yandexDeliveryOptionId"
],
"type": "object"
}
],
"description": "agar methodType == YANDEX_DELIVERY"
}
},
"required": [
"methodType"
],
"type": "object"
},
"ShippingPrice": {
"properties": {
"amount": {
"description": "Verguldan keyin ikki xonadan ortiq belgi bo‘lmasligi kerak.\nMasalan: 1,12, 5,1, 10, 11,00",
"example": "123.45",
"format": "double",
"type": "string"
},
"methodType": {
"enum": [
"DIRECT",
"PICKUP",
"COURIER",
"YANDEX_DELIVERY"
],
"type": "string"
}
},
"required": [
"amount",
"methodType"
],
"type": "object"
},
"StorageInitialPaymentOptions": {
"properties": {
"amount": {
"description": "Verguldan keyin ikki xonadan ortiq belgi bo‘lmasligi kerak.\nMasalan: 1,12, 5,1, 10, 11,00",
"example": "123.45",
"format": "double",
"type": "string"
},
"cardId": {
"maxLength": 2048,
"type": "string"
},
"merchantId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"paymentMethod": {
"enum": [
"CARD",
"SPLIT",
"SBP",
"SPLIT_SBP",
"CASH_ON_DELIVERY",
"CARD_ON_DELIVERY",
"UNIQR_REUSABLE",
"UNIQR_ONETIME",
null
],
"type": "string"
},
"publicConstructor": {
"maxLength": 2048,
"type": "string"
},
"sessionId": {
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
},
"SubmitRequest": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Yakuniy savat"
},
"externalOperationId": {
"description": "Sotuvchi tizimidagi operatsiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Buyurtmaning yakuniy summasi. `cart.total.amount` qiymatiga teng.\n\nAgar `cart` yuborilsa, bu maydon majburiy hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"externalOperationId"
],
"type": "object"
},
"SuccessResponse": {
"properties": {
"code": {
"default": 200
},
"data": {
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
},
"Supplier": {
"properties": {
"inn": {
"maxLength": 2048,
"type": "string"
},
"name": {
"maxLength": 2048,
"type": "string"
},
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"TargetCart": {
"properties": {
"items": {
"items": {
"properties": {
"price": {
"description": "Operatsiya bajarilgandan keyingi mahsulot/xizmatning bir dona narxi.\nAgar operatsiya natijasida bitta mahsulot narxi kamaytirilsa, ushbu parametrni ko‘rsatish zarur.\nBu parametr mahsulot uchun pulning faqat bir qismini qaytarish yoki buyurtmani tasdiqlash jarayonida foydali bo‘lishi mumkin.\nAgar so‘rovda ushbu maydon ko‘rsatilmasa, mahsulot narxi o‘zgarmagan deb hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"productId": {
"description": "Buyurtma yaratilgan paytdagi savatdagi pozitsiya identifikatori.\nAgar dastlabki savatda mavjud bo‘lmagan identifikator yuborilsa – xatolik yuz beradi.",
"maxLength": 2048,
"type": "string"
},
"quantityCount": {
"description": "Qaytarish operatsiyasi uchun mahsulot birliklari soni.\n\nQiymat ishlatilayotgan savat turiga bog‘liq:\n\n- agar `targetCart` ishlatilsa, `quantityCount` – qaytarishdan keyin qoladigan mahsulot soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 2 dona qoladi);\n- agar `refundCart` ishlatilsa, `quantityCount` – qaytariladigan mahsulotlar soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 3 dona qaytariladi).\n\nAgar maydon ko‘rsatilmasa, mahsulot miqdori o‘zgarmaydi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
},
"TargetCartItem": {
"properties": {
"price": {
"description": "Operatsiya bajarilgandan keyingi mahsulot/xizmatning bir dona narxi.\nAgar operatsiya natijasida bitta mahsulot narxi kamaytirilsa, ushbu parametrni ko‘rsatish zarur.\nBu parametr mahsulot uchun pulning faqat bir qismini qaytarish yoki buyurtmani tasdiqlash jarayonida foydali bo‘lishi mumkin.\nAgar so‘rovda ushbu maydon ko‘rsatilmasa, mahsulot narxi o‘zgarmagan deb hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"productId": {
"description": "Buyurtma yaratilgan paytdagi savatdagi pozitsiya identifikatori.\nAgar dastlabki savatda mavjud bo‘lmagan identifikator yuborilsa – xatolik yuz beradi.",
"maxLength": 2048,
"type": "string"
},
"quantityCount": {
"description": "Qaytarish operatsiyasi uchun mahsulot birliklari soni.\n\nQiymat ishlatilayotgan savat turiga bog‘liq:\n\n- agar `targetCart` ishlatilsa, `quantityCount` – qaytarishdan keyin qoladigan mahsulot soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 2 dona qoladi);\n- agar `refundCart` ishlatilsa, `quantityCount` – qaytariladigan mahsulotlar soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 3 dona qaytariladi).\n\nAgar maydon ko‘rsatilmasa, mahsulot miqdori o‘zgarmaydi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId"
],
"type": "object"
},
"TargetShipping": {
"properties": {
"amount": {
"description": "Operatsiya bajarilgandan keyingi yetkazish narxi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"type": "object"
},
"TimeInterval": {
"properties": {
"end": {
"description": "Interval tugash vaqti",
"type": "string"
},
"start": {
"description": "Interval boshlanish vaqti",
"type": "string"
}
},
"required": [
"end",
"start"
],
"type": "object"
},
"TransferOperator": {
"properties": {
"address": {
"maxLength": 2048,
"type": "string"
},
"inn": {
"maxLength": 2048,
"type": "string"
},
"name": {
"maxLength": 2048,
"type": "string"
},
"phones": {
"items": {
"maxLength": 2048,
"type": "string"
},
"type": "array"
}
},
"type": "object"
},
"UniqrMetadata": {
"properties": {
"paramsId": {
"maxLength": 2048,
"type": "string"
},
"uniQrId": {
"maxLength": 2048,
"type": "string"
}
},
"required": [
"uniQrId"
],
"type": "object"
},
"YandexDeliveryOption": {
"properties": {
"allowedPaymentMethods": {
"description": "Yetkazish berish usuli uchun individual to‘lov usullari. Ushbu parametr `availablePaymentMethods`da ko‘rsatilgan to‘lov usullarini cheklash zarur bo‘lsa qo‘llaniladi. Agar parametr ko‘rsatilmagan bo‘lsa, `availablePaymentMethods`da sanab o‘tilgan barcha to‘lov usullaridan foydalaniladi.",
"items": {
"enum": [
"CARD",
"SPLIT",
"CASH_ON_DELIVERY",
"CARD_ON_DELIVERY",
"UNIQR_REUSABLE",
"UNIQR_ONETIME"
],
"type": "string"
},
"type": "array"
},
"amount": {
"description": "Yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"category": {
"enum": [
"EXPRESS",
"TODAY",
"STANDARD"
],
"type": "string"
},
"fromDatetime": {
"format": "date-time",
"type": "string"
},
"title": {
"description": "Yetkazish usuli nomi. Variantlar ro‘yxatida foydalanuvchiga ko‘rsatiladi",
"maxLength": 2048,
"type": "string"
},
"toDatetime": {
"format": "date-time",
"type": "string"
},
"yandexDeliveryOptionId": {
"description": "Yandex Delivery taklifi ID raqami",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"category",
"title",
"yandexDeliveryOptionId"
],
"type": "object"
}
},
"securitySchemes": {
"ApiKey": {
"in": "header",
"name": "Authorization",
"type": "apiKey"
}
}
},
"info": {
"description": "\n## Sarlavhalar {#headers}\n\nSo‘rovlaringizda quyidagi HTTP sarlavhalarni yuboring:\n\n- X-Request-Id: <so‘rovning noyob identifikatori>\n- X-Request-Timeout: <so‘rov taym-auti millisekundlarda>\n- X-Request-Attempt: <urinish raqami (0 – birinchi urinish, 1, 2 va h.k. – qayta yuborishlar)>\n\n`X-Request-Id` so‘rovlarni diagnostika qilish hamda yozuvchi so‘rovlarning idempotentligini ta’minlash uchun kerak.\nShu sababli bir xil `X-Request-Id` qiymati barcha qayta yuboriladigan so‘rovlarda saqlanishi kerak, agar javobda HTTP 5xx yoki 429 bilan\nxatolik kodlari qaytsa.\n\n`X-Request-Timeout` so‘rovni qayta yuborish [deadline propagation](https://sre.google/sre-book/addressing-cascading-failures/#deadline-propagation-1)\nvaqtini tizimda qayta ishlash jarayonida boshqarish uchun kerak.\nTaym-aut qiymatini 1 soniyadan kichik qilib qo‘ymang. Maksimal taym-aut qiymati – 10 soniya.\n\n`X-Request-Attempt` umumiy diagnostika uchun foydalidir.\n\n## Sotuvchi so‘rovini autentifikatsiya qilish {#auth}\n\nAPI'dan foydalanish uchun autentifikatsiya API-kalitini olish zarur.\nToken har bir so‘rov uchun HTTP sarlavhasidagi `Authorization` sarlavha orqali uzatilishi kerak.\nKalitlarni boshqarish [Yandex Split konsolida](https://console.pay.yandex.uz/settings) amalga oshiriladi.\nSandbox muhitida API-kalit qiymati [Merchant ID](../../../console/settings-pay-split.md#merchant-id) qiymatiga teng bo‘ladi.\n\n```text\n--header 'Authorization: Api-Key <kalit qiymati>'\n```\n\nAgar so‘rovda token bo‘lmasa yoki noto‘g‘ri token yuborilsa,\n server 401 `Unauthorized HTTP` holatini qaytaradi.",
"title": "Yandex Pay API",
"version": "1.0.0"
},
"openapi": "3.0.3",
"paths": {
"/api/merchant/v1/orders": {
"post": {
"description": "Buyurtma yaratish so‘rovi. Buyurtma uchun to‘lov havolasini qaytaradi.",
"operationId": "merchant_v1_orders-post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"availablePaymentMethods": {
"default": null,
"description": "To‘lov formasida xaridorga mavjud bo‘ladigan to‘lov usullari Yandex Split orqali.\n\nMumkin bo‘lgan variantlar:\n- `[\"SPLIT\"]` – faqat Split orqali;",
"items": {
"enum": [
"CARD",
"SPLIT"
],
"type": "string"
},
"minItems": 1,
"type": "array"
},
"billingPhone": {
"description": "Mijoz telefon raqami.\n\nAvtorizatsiyani soddalashtirish uchun ishlatiladi hamda Split orqali tasdiqlanish ehtimolini oshirishi mumkin.\n\nTelefon raqami uchun quyidagi formatlardan foydalanish tavsiya etiladi: `+998123456789` yoki `998123456789`. Raqamlar qatorida boshqa belgilar bo‘lishi mumkin, ammo raqamlardan tashqari barcha belgilar e’tiborga olinmaydi.\n\nMasalan, quyidagi yuborilgan qiymatlar: `998123456789`, `+998123456789`, `+998 (12) 345-67-89` – `998123456789 `ko‘rinishida qayta ishlanadi.",
"maxLength": 2048,
"type": "string"
},
"cart": {
"allOf": [
{
"description": "{% note info %}\n\nYetkazish narxini `items` ichida alohida mahsulot sifatida kiriting.\n\n{% endnote %}",
"properties": {
"externalId": {
"description": "Savat identifikatori – sotuvchi tomonida.",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatdagi mahsulotlar ro‘yxati.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Savat"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"extensions": {
"allOf": [
{
"properties": {
"billingReport": {
"allOf": [
{
"properties": {
"branchId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Savdo nuqtasi identifikatori",
"maxLength": 2048,
"type": "string"
},
"managerId": {
"default": null,
"description": "Faqat oflayn doʻkonlar uchun majburiy maydon. Menejer identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
}
],
"description": "Buyurtmani rasmiylashtirish joyi va mas’ul shaxs haqida ma’lumot."
},
"paymentData": {
"allOf": [
{
"properties": {
"saleToken": {
"description": "Har bir to‘lov operatsiyasi uchun kassa tomonidan yaratiladigan noyob ID",
"maxLength": 2048,
"type": "string"
}
},
"type": "object"
}
],
"description": "To‘lovning qo‘shimcha parametrlari."
},
"qrData": {
"allOf": [
{
"properties": {
"token": {
"description": "QR token",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"token"
],
"type": "object"
}
],
"description": "QR yordamida to‘lov havolasini yuborish uchun qo‘shimcha parametrlar."
},
"smsOffer": {
"allOf": [
{
"properties": {
"phone": {
"description": "SMS orqali xabarnoma yuborish uchun mijoz telefon raqami (masalan: `+998123456789`).\nFaqat oflayn do‘konlar uchun.",
"maxLength": 2048,
"pattern": "^\\+\\d+$",
"type": "string"
}
},
"required": [
"phone"
],
"type": "object"
}
],
"description": "SMS orqali to‘lov havolasini yuborish uchun qo‘shimcha parametrlar.\n\nFaqat oflayn doʻkonlar uchun majburiy maydon."
}
},
"type": "object"
}
],
"default": null,
"description": "Oflayn buyurtmani rasmiylashtirish uchun qo‘shimcha parametrlar"
},
"isPrepayment": {
"description": "Buyurtma “kechiktirilgan to‘lov” oqimi bo‘yicha amalga oshiriladimi.\n\nAgar parametr `true` qiymatiga o‘rnatilgan bo‘lsa, buyurtma kechiktirilgan to‘lovli buyurtma sifatida rasmiylashtiriladi.",
"type": "boolean"
},
"metadata": {
"description": "Buyurtma bo‘yicha ichki foydalanish uchun ixtiyoriy ma’lumotlar.",
"maxLength": 2048,
"type": "string"
},
"orderId": {
"description": "Sotuvchi tizimidagi buyurtma identifikatori (unikal bo‘lishi shart). To‘lov so‘rovi bo‘yicha keyingi barcha jarayonlar aynan shu identifikator orqali amalga oshiriladi. Ushbu identifikator solishtirish jarayonlarida ham ishlatiladi",
"maxLength": 2048,
"type": "string"
},
"orderSource": {
"default": null,
"description": "Buyurtma yaratilishi boshlangan platforma yoki interfeys\n\nKeyingi tahlillar uchun zarur\n\n---\n\n**WEBSITE**: Tugma veb-saytda joylashtirilgan. To‘lov havolasi foydalanuvchi saytda amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**APP**: Tugma mobil ilovada joylashtirilgan. To‘lov havolasi foydalanuvchi ilova ichida amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**CRM**: To‘lov havolasi CRM tizimida yoki boshqa administrator panelida menejer tomonidan yaratilgan\n\n**CASH_REGISTER**: To‘lov havolasi oflayn kassada ko‘rsatish uchun shakllantirilgan\n\n**CMS_PLUGIN**: To‘lov havolasi CMS uchun plagin ichida shakllantirilgan\n\n**TV**: To‘lov havolasi TV-platformada ko‘rsatish uchun shakllantirilgan.",
"enum": [
"WEBSITE",
"APP",
"CRM",
"CASH_REGISTER",
"CMS_PLUGIN"
],
"type": "string"
},
"preferredPaymentMethod": {
"description": "Afzal to‘lov usuli.\n\nUzatilgan to‘lov usuli, agar u `availablePaymentMethods` maydonida mavjud usullarga zid bo‘lmasa, to‘lov formasida avtomatik tanlanadi.",
"enum": [
"FULLPAYMENT",
"SPLIT"
],
"type": "string"
},
"publicConstructor": {
"description": "Split orqali to‘lash uchun oldindan tanlangan reja konstruktori.\n\n_Faqat kelishuv asosida mavjud_",
"type": "string"
},
"purpose": {
"description": "To‘lov maqsadi",
"maxLength": 1000,
"type": "string"
},
"redirectUrls": {
"allOf": [
{
"properties": {
"onAbort": {
"description": "To‘lov jarayoni bekor qilinganda foydalanuvchini qayta yo‘naltirish uchun havola. To‘lovni bekor qilish foydalanuvchi tomonidan to‘lov formasida amalga oshiriladi.",
"maxLength": 2048,
"type": "string"
},
"onError": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov vaqtida noma’lum xatolik yuz bersa yoki to‘lov havolasining amal qilish muddati tugasa, foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
},
"onSuccess": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov muvaffaqiyatli yakunlanganda foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"onError",
"onSuccess"
],
"type": "object"
}
],
"description": "To‘lov shaklidan foydalanuvchini qayta yo‘naltirish havolalari. Onlayn do‘konlar uchun majburiy."
},
"risk": {
"allOf": [
{
"properties": {
"billingPhone": {
"description": "**DEPRECATED** Mijoz telefon raqami. <br/>*Yuqori darajadagi shu nomdagi maydondan foydalanish tavsiya etiladi.*",
"maxLength": 2048,
"type": "string"
},
"customerAggregates": {
"allOf": [
{
"properties": {
"amountFirstSuccessfulOrder": {
"description": "Birinchi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"amountLatestSuccessfulOrder": {
"description": "Oxirgi muvaffaqiyatli buyurtma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"cookie": {
"description": "Cookie fayllar",
"maxLength": 2048,
"type": "string"
},
"daysSinceLastPasswordReset": {
"description": "Parol oxirgi marta tiklanganidan beri o‘tgan kunlar soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsOneDay": {
"description": "So‘nggi 1 kun ichida muvaffaqiyatsiz kirish urinishlari soni",
"format": "int32",
"type": "integer"
},
"failedLoginAttemptsSevenDays": {
"description": "So‘nggi 7 kun ichida muvaffaqiyatsiz kirishga urinishlar soni",
"format": "int32",
"type": "integer"
},
"firstSuccessfulOrderDate": {
"description": "Tarixdagi birinchi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"historicalCookieLogin": {
"description": "Saqlangan cookie orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"historicalDeviceLogin": {
"description": "Saqlangan qurilma orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)",
"type": "boolean"
},
"lastPasswordResetDate": {
"description": "Parol oxirgi marta tiklangan sana",
"format": "date",
"type": "string"
},
"latestSuccessfulOrderLastYearDate": {
"description": "So‘nggi bir yil ichidagi oxirgi muvaffaqiyatli buyurtma sanasi",
"format": "date",
"type": "string"
},
"previousSuccessfulOrdersAtSameAddress": {
"description": "Foydalanuvchi joriy manzil bo‘yicha ilgari muvaffaqiyatli buyurtma qilganmi",
"type": "boolean"
},
"redemptionRateLastHalfYear": {
"description": "So‘nggi yarim yil ichidagi xaridni yakunlash foizi",
"example": "123.45",
"format": "double",
"type": "string"
},
"registrationDate": {
"description": "Sotuvchi saytida ro‘yxatdan o‘tgan sana",
"format": "date",
"type": "string"
}
},
"type": "object"
}
],
"description": "Mijoz haqida umumlashtirilgan ma’lumotlar"
},
"deviceId": {
"description": "Mijoz qurilmasi identifikatori (device_id/gaid/idfa/ifv)",
"maxLength": 2048,
"type": "string"
},
"isExpressShipping": {
"description": "Ekspress yetkazish belgisi",
"type": "boolean"
},
"merchantMcc": {
"description": "Merchant MCC kodi",
"maxLength": 2048,
"type": "string"
},
"merchantName": {
"description": "Merchant nomi",
"maxLength": 2048,
"type": "string"
},
"merchantOfflinePosLegalAddress": {
"description": "Oflayn savdo nuqtasining yuridik manzili",
"maxLength": 2048,
"type": "string"
},
"merchantTaxRefNumber": {
"description": "Merchantning soliq raqami",
"maxLength": 2048,
"type": "string"
},
"periodCheckAggregates": {
"allOf": [
{
"properties": {
"successfulOrdersCountNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountOneMonth": {
"description": "So‘nggi 1 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"successfulOrdersCountTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar soni",
"format": "int32",
"type": "integer"
},
"totalAmountSuccessfulOrdersNineMonths": {
"description": "So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersOneMonth": {
"description": "So‘nggi bir oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersSixMonths": {
"description": "So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersThreeMonths": {
"description": "So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"totalAmountSuccessfulOrdersTwelveMonths": {
"description": "So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar summasi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"type": "object"
}
],
"description": "Turli davrlar bo‘yicha chek agregatlari."
},
"qrType": {
"description": "QR kod turi",
"enum": [
"static",
"dynamic",
null
],
"type": "string"
},
"qrcId": {
"description": "QR kod raqami",
"maxLength": 2048,
"type": "string"
},
"shippingAddress": {
"description": "Yetkazish manzili Agar buyurtmani olish usuli (`PICKUP`) “olib ketish” deb tanlangan bo‘lsa, mahsulotni berish punkti manzilini ko‘rsatish kerak.",
"maxLength": 2048,
"type": "string"
},
"shippingPhone": {
"description": "Qabul qiluvchining telefon raqami (masalan: +998123456789).",
"maxLength": 2048,
"type": "string"
},
"shippingType": {
"description": "Buyurtmani olish usuli",
"enum": [
"COURIER",
"PICKUP",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Splitni tasdiqlash ehtimolini oshirishi mumkin boʻlgan qoʻshimcha maʼlumotlar. To‘liq hajmda faqat onlayn-do‘konlar uchun mavjud."
},
"ttl": {
"default": 1800,
"description": "Parametr foydalanuvchi buyurtma to‘lov sahifasiga havoladan foydalanishi mumkin bo‘lgan vaqtni belgilaydi.\n\nBelgilangan vaqt tugagach, foydalanuvchi “To‘lov vaqti tugadi” degan xabarni ko‘radi.\n\nAgar foydalanuvchi havoladan vaqt tugashidan oldin foydalangan bo‘lsa, to‘lovni yakunlash uchun qo‘shimcha 15 daqiqa beriladi. Agar qo‘shimcha vaqt tugagandan keyin ham to‘lov amalga oshirilmasa, buyurtma yakuniy ravishda to‘lanmagan deb hisoblanadi.\n\nBu holat buyurtma holatining `Order.paymentStatus` qiymati `FAILED`ga o‘zgarishi orqali aks etadi. Shuningdek, buyurtma statusi o‘zgargani haqida [bildirishnoma](../../merchant-api/webhook) yuboriladi. Agar sotuvchi mahsulotni oldindan band qilib qo‘ygan bo‘lsa, buyurtma statusi o‘zgargandan so‘ng bandlovni bekor qilish mumkin.\n\nAmal qilish muddati (sek.): `180 <= ttl <= 604800`\n\nAmal qilish muddati (shaxsiy kabinetda to‘lov havolasi yaratilganda, sek.): `86400`",
"format": "int32",
"type": "integer"
}
},
"required": [
"cart",
"currencyCode",
"orderId"
],
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"paymentUrl"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"required": [
"data"
],
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/orders",
"tags": [
"order"
]
}
},
"/api/merchant/v1/orders/{order_id}": {
"get": {
"description": "Buyurtma tafsilotlarini olish so‘rovi.\n\nSo‘rov buyurtma tafsilotlarini hamda qaytarish bo‘yicha tranzaksiyalar ro‘yxatini qaytaradi.",
"operationId": "merchant_v1_order-get",
"parameters": [
{
"description": "Buyurtma yaratilganda `/orders` so‘rovida yuborilgan sotuvchi tizimidagi buyurtma ID raqami.",
"in": "path",
"name": "order_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"delivery": {
"properties": {
"actualPrice": {
"description": "Sotuvchi uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Yetkazish yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"price": {
"description": "Xaridor uchun yetkazish narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"status": {
"default": "NEW",
"description": "Yetkazish holati",
"enum": [
"NEW",
"ESTIMATING",
"EXPIRED",
"READY_FOR_APPROVAL",
"COLLECTING",
"PREPARING",
"DELIVERING",
"DELIVERED",
"RETURNING",
"RETURNED",
"FAILED",
"CANCELLED"
],
"type": "string"
},
"updated": {
"description": "Yetkazish yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"price"
],
"type": "object"
},
"operations": {
"items": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"approvalCode": {
"description": "Protsessing markazidan olingan tranzaksiya tasdiqlash kodi.",
"readOnly": true,
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
},
"type": "array"
},
"order": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori.",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Savatchadagi mahsulotlar roʻyxati",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"finalPrice": {
"description": "Pozitsiya va savat bo‘yicha barcha chegirmalar hisobga olingan holdagi mahsulotning birlik narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"default": null,
"description": "Toʻlovga yoʻnaltiriladigan savatchaning yakuniy qiymati"
}
},
"required": [
"items"
],
"type": "object"
}
],
"description": "Savat"
},
"coolingPeriodExpiresAt": {
"description": "Sovutish muddati tugash sanasi va vaqti (ISO 8601)",
"format": "date-time",
"type": "string"
},
"created": {
"description": "Buyurtma yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"isPrepayment": {
"default": false,
"description": "Buyurtma “kechiktirilgan to‘lov” oqimi bo‘yicha amalga oshiriladimi.\n\nAgar parametr `true` qiymatiga o‘rnatilgan bo‘lsa, buyurtma kechiktirilgan to‘lovli buyurtma sifatida rasmiylashtiriladi.",
"type": "boolean"
},
"merchantId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"metadata": {
"description": "Tugmani ishga tushirish vaqtida uzatilgan ixtiyoriy ma’lumotlar",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Qaytarishlar, yetkazish, chegirmalar va promokodlarni hisobga olgan holda to‘lov uchun buyurtmaning to‘liq qiymati",
"example": "123.45",
"format": "double",
"type": "string"
},
"orderId": {
"description": "[/orders](../order/merchant_v1_orders-post.md) xizmatiga uzatilgan sotuvchi tomonidagi buyurtma ID raqami.",
"maxLength": 2048,
"type": "string"
},
"paymentMethod": {
"properties": {
"cardLast4": {
"maxLength": 2048,
"type": "string"
},
"cardNetwork": {
"description": "To‘lov tizimi",
"enum": [
"AMEX",
"DISCOVER",
"JCB",
"MASTERCARD",
"MAESTRO",
"VISAELECTRON",
"VISA",
"MIR",
"UNIONPAY",
"UZCARD",
"HUMOCARD",
"UNKNOWN",
"UNDEFINED",
null
],
"type": "string"
},
"methodType": {
"enum": [
"SPLIT"
],
"type": "string"
}
},
"required": [
"methodType"
],
"type": "object"
},
"paymentStatus": {
"description": "Batafsil ma’lumotni [Operatsiya holatlari](../../../../payments/statuses) bo‘limidan o‘qing.",
"enum": [
"PENDING",
"AUTHORIZED",
"CAPTURED",
"VOIDED",
"REFUNDED",
"CONFIRMED",
"PARTIALLY_REFUNDED",
"FAILED",
null
],
"type": "string",
"x-enumDescriptions": {
"AUTHORIZED": "Платеж за заказ авторизован. Средства заблокированы на счету плательщика",
"CAPTURED": "Заказ успешно оплачен. Средства списаны со счета плательщика",
"CONFIRMED": "Заказ успешно оформлен",
"FAILED": "Заказ не был успешно оплачен",
"PARTIALLY_REFUNDED": "Совершен частичный возврат средств за заказ",
"PENDING": "Ожидается оплата",
"REFUNDED": "Совершен возврат средств за заказ",
"VOIDED": "Оплата отменена. Списание средств не производилось"
}
},
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
},
"reason": {
"description": "Buyurtma bekor qilinish sababi. `VOIDED` va `FAILED` holatlari uchun qo‘llaniladi.",
"maxLength": 2048,
"type": "string"
},
"updated": {
"description": "Buyurtma yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"cart",
"currencyCode"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/orders/{order_id}",
"tags": [
"order"
]
}
},
"/api/merchant/v1/orders/{order_id}/cancel": {
"post": {
"description": "To‘lovni bekor qilish so‘rovi.\n\nFaqat `AUTHORIZED` holatidagi to‘lovlar uchun mavjud.\nMuvaffaqiyatli bajarilganda to‘lov holati `VOIDED`ga o‘zgaradi.",
"operationId": "merchant_v1_cancel-post",
"parameters": [
{
"description": "Buyurtma yaratilganda `/orders` so‘rovida yuborilgan sotuvchi tizimidagi buyurtma ID raqami.",
"in": "path",
"name": "order_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"externalOperationId": {
"description": "Operatsiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"reason": {
"description": "Bekor qilish sababi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"reason"
],
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/orders/{order_id}/cancel",
"tags": [
"order"
]
}
},
"/api/merchant/v2/orders/{order_id}/refund": {
"post": {
"description": "Buyurtma uchun mablag‘ni qaytarish so‘rovi.\n\nMetod asinxron hisoblanadi.\n\n## Qaytarish jarayoni sxemasi {#refund-diagram}\n\n\n\n## Cheklovlar {#refund-constraints}\n\nSiz to‘lovni [to‘liq yoki qisman qaytarishingiz](#refund-types) mumkin.\n\nQaytarishlar quyidagi `paymentStatus` holatlaridan birida bo‘lgan [to‘lovlar](../order/merchant_v1_order-get#basemerchantapiorder) uchun mavjud:\n\n- `CAPTURED` – buyurtma muvaffaqiyatli to‘langan, mablag‘ to‘lovchining hisobidan yechilgan;\n- `PARTIALLY_REFUNDED` – buyurtma bo‘yicha mablag‘ning bir qismi qaytarilgan.\n\nQaytarish muvaffaqiyatli bajarilgandan so‘ng, to‘lovning `paymentStatus` holati quyidagicha o‘zgaradi:\n\n- `REFUNDED` – agar to‘liq qaytarish amalga oshirilgan bo‘lsa;\n- `PARTIALLY_REFUNDED` – agar qaytarishdan keyin buyurtmada hali ham mahsulotlar qolgan bo‘lsa.\n\nJoriy kun uchun qaytarilgan mablag‘lar summasi keyingi ish kunida hamkorga buyurtma bo‘yicha to‘lanadigan summadan ushlab qolinadi.\n\n**Misol**: do‘koningizda 1000 soʻm buyurtma amalga oshirildi va 200 soʻm qaytarildi. Keyingi ish kunida siz 800 soʻm miqdorida to‘lovni olasiz (1000 − 200).\n\n{% note warning \"Bitta buyurtma bo‘yicha bir vaqtning o‘zida bir nechta qaytarishni amalga oshirib bo‘lmaydi.\" %}\n\nTakroriy so‘rovni yuborishdan oldin joriy qaytarish operatsiyasi yakunlanganini tekshiring: `status` qiymati `SUCCESS` yoki `FAIL` bo‘lishi kerak.\n\nAks holda siz `ANOTHER_OPERATION_IN_PROGRESS` xatosi bilan `409 Conflict` javobini olasiz.\n\n{% endnote %}\n\nQaytarish holatidagi o‘zgarishlarni [/webhook](../../merchant-api/webhook.md) orqali, shuningdek quyidagi so‘rovlar yordamida kuzatish mumkin:\n\n- [/operations/\\{external_operation_id\\}/](../operation/merchant_v1_operations-get.md)\n- [/order/\\{order_id\\}/](../order/merchant_v1_order-get.md)\n\n### Qaytarish statusini tekshirish misoli {#refund-status-examples}\n\n[/operations/{external_operation_id}/](../operation/merchant_v1_operations-get.md) metodi orqali `externalOperationId` bo‘yicha joriy qaytarish operatsiyasining holatini tekshirish mumkin.\n\nAgar operatsiya hali yakunlanmagan bo‘lsa, masalan: `\"status\": \"PENDING\"`. Bu holatda qaytarish uchun takroriy so‘rov yuborish mumkin emas.\n\n{% cut \"Javob namunasi\" %}\n\n```json\n{\n \"code\": 200,\n \"status\": \"success\",\n \"data\": {\n \"operation\": {\n \"operationId\": \"52b3c4a8-528b-45eb-a57f-8f808f65d28f\",\n \"operationType\": \"REFUND\",\n \"orderId\": \"OrderS-2038\",\n \"amount\": \"250.00\",\n \"pointsAmount\": null,\n \"status\": \"PENDING\", // возврат в процессе\n \"reason\": null,\n \"params\": { \"motive\": null, \"branch_id\": null, \"manager_id\": null },\n \"externalOperationId\": \"OrderS-2038\",\n \"created\": \"2025-03-14T14:58:45.850206+03:00\",\n \"updated\": \"2025-03-14T14:58:45.850206+03:00\"\n }\n }\n}\n```\n\n{% endcut %}\n\n[/operations/{external_operation_id}/](../operation/merchant_v1_operations-get.md) metodi yordamida buyurtmaning barcha tafsilotlarini tekshirish mumkin.\n\nQuyidagi misolda qaytarish operatsiyasi muvaffaqiyatli yakunlangan – `\"status\": \"SUCCESS\"`, to‘lov esa `\"paymentStatus\": \"PARTIALLY_REFUNDED\"` holatida. Qaytarish uchun takroriy so‘rov yuborish mumkin.\n\n{% cut \"Javob namunasi\" %}\n\n```json\n{\n \"code\": 200,\n \"status\": \"success\",\n \"data\": {\n \"operations\": [\n {\n \"operationId\": \"52b3c4a8-528b-45eb-a57f-8f808f65d28f\",\n \"operationType\": \"REFUND\",\n \"orderId\": \"OrderS-2038\",\n \"amount\": \"250.00\",\n \"status\": \"SUCCESS\", // возврат успешно завершен\n \"reason\": null,\n \"params\": { \"motive\": null, \"branch_id\": null, \"manager_id\": null },\n \"externalOperationId\": \"OrderS-2038\",\n \"created\": \"2025-03-14T14:58:45.850206+03:00\",\n \"updated\": \"2025-03-14T14:58:46.084886+03:00\",\n \"approvalCode\": null\n },\n {\n \"operationId\": \"9c763cfb-dcf6-4056-be8f-ca9e2e61d772\",\n \"operationType\": \"AUTHORIZE\",\n \"orderId\": \"OrderS-2038\",\n \"amount\": \"500.00\",\n \"status\": \"SUCCESS\",\n \"reason\": null,\n \"params\": {},\n \"externalOperationId\": null,\n \"created\": \"2025-03-14T14:58:07.161667+03:00\",\n \"updated\": \"2025-03-14T14:58:07.414886+03:00\",\n \"approvalCode\": null\n }\n ],\n \"order\": {\n \"currencyCode\": \"RUB\",\n \"cart\": {\n \"items\": [\n {\n \"productId\": \"p2\",\n \"quantity\": { \"count\": \"1\", \"available\": null, \"label\": null },\n \"type\": \"UNSPECIFIED\",\n \"title\": \"Яндекс.Станция Мини\",\n \"description\": null,\n \"total\": \"250\",\n \"subtotal\": null,\n \"discountedUnitPrice\": \"250\",\n \"unitPrice\": null,\n \"measurements\": null,\n \"finalPrice\": \"250\",\n \"pointsAmount\": null,\n \"features\": null\n }\n ],\n \"total\": { \"amount\": \"250\", \"pointsAmount\": null, \"label\": null },\n \"cartId\": \"1eed9a9827e68ba8981d9961c1237624fabc19cda05044b574e06302e83c7549\",\n \"externalId\": null,\n \"coupons\": null,\n \"discounts\": null,\n \"measurements\": null\n },\n \"merchantId\": \"76cc0f5c-91c4-40f2-9794-64a64c3c6011\",\n \"orderAmount\": \"250.00\",\n \"orderId\": \"OrderS-2038\",\n \"paymentMethod\": { \"methodType\": \"CARD\", \"cardLast4\": \"0412\", \"cardNetwork\": \"MASTERCARD\" },\n \"shippingMethod\": null,\n \"metadata\": null,\n \"created\": \"2025-03-14T14:58:03.699930+03:00\",\n \"updated\": \"2025-03-14T14:58:46.084886+03:00\",\n \"paymentStatus\": \"PARTIALLY_REFUNDED\", // платеж частично возвращен\n \"reason\": null,\n \"paymentUrl\": \"https://sandbox.pay.yandex.uz/l/I1RnP9\",\n \"isPrepayment\": false,\n \"splitCode\": null\n },\n \"delivery\": null\n }\n}\n```\n\n{% endcut %}\n\n## Qaytarish turlari {#refund-types}\n\nTo‘lovni to‘liq yoki qisman qaytarish mumkin.\n\n**To‘liq** qaytarishni amalga oshirish uchun buyurtma summasiga teng bo‘lgan faqat `refundAmount` parametrini yuboring.\n\n**Qisman** qaytarishni amalga oshirish uchun qaytariladigan summaga teng `refundAmount` qiymatini yuboring va qaytarilayotgan mahsulotlar hamda xizmatlardan iborat savatni qo‘shing. Savatni quyidagi usullardan biri orqali shakllantirish mumkin:\n\n- 1-usul: Qaytarishdan keyingi savat holatini ko‘rsatish.\n\n Buning uchun `targetCart` maydonidan foydalaning – bu qaytarish amalga oshirilgandan keyin xaridorda qolishi kerak bo‘lgan yakuniy savatdir. Agar bu maydon ko‘rsatilmagan bo‘lsa, savat to‘liq qaytarilmoqda deb hisoblanadi.\n\n `targetShipping` maydoni faqat Yandex Pay Checkout uchun qo‘llaniladi.\n Boshqa holatlarda ushbu maydonni bo‘sh qoldirish kerak. Agar bu maydon ko‘rsatilmagan bo‘lsa, yetkazish narxi ham to‘liq qaytariladi deb hisoblanadi.\n\n- 2-usul: Qaytariladigan mahsulotlarni ko‘rsatish\n\n `refundCart` maydonidan foydalaning – unda qaytarilayotgan pozitsiyalar haqida ma’lumot beriladi: qaytarilayotgan mahsulotlar soni yoki\n aniq mahsulot narxini kamaytirish kerak bo‘lgan summa. Agar ushbu maydon ko‘rsatilmagan bo‘lsa, qaytarish butun savat bo‘yicha amalga oshiriladi.\n\n{% note info %}\n\n`refundCart`dan foydalanganda operatsiya identifikatori – `externalOperationId`ni ko‘rsating. U idempotentlik tokeni vazifasini bajaradi va takroriy qaytarishlar xavfini oldini olishga yordam beradi.\n\n{% endnote %}\n\n## Qaytarish misollari {#refund-examples}\n\nKeling, `orderId = Order-123` bo‘lgan buyurtma va quyidagi savat misolida ko‘rib chiqamiz.\n\n```json\n{\n \"items\": [\n {\n \"productId\": \"id-1\",\n \"price\": \"50\",\n \"title\": \"Sharikli ruchka\",\n \"quantity\": {\n \"count\": \"10\"\n }\n },\n {\n \"productId\": \"id-2\",\n \"price\": \"200\",\n \"title\": \"Bloknot\",\n \"quantity\": {\n \"count\": \"2\"\n }\n }\n ]\n}\n```\n\n### To‘liq qaytarish {#refund-examples-full}\n\n{% list tabs %}\n\n- httpie\n\n ```(bash)\n http POST https://sandbox.pay.yandex.uz/api/merchant/v2/orders/Order-123/refund \\\n \"Authorization: Api-Key ${API_KEY}\" 'refundAmount:=\"900.00\"'\n ```\n\n{% endlist %}\n\n### Qisman qaytarish {#refund-examples-partial}\n\n#### Mahsulot birliklarini qaytarish {#single-item}\n\nFaraz qilaylik, ikkita sharikli ruchkani qaytarish kerak. Bu quyidagi so‘rov orqali amalga oshiriladi:\n\n{% list tabs %}\n\n- httpie\n\n ```(bash)\n http POST https://sandbox.pay.yandex.uz/api/merchant/v2/orders/Order-123/refund \\\n \"Authorization: Api-Key ${API_KEY}\" \\\n 'targetCart[items][0]:={\"productId\": \"id-1\", \"quantityCount\": \"8\"}' \\\n 'targetCart[items][1]:={\"productId\": \"id-2\", \"quantityCount\": \"2\"}' \\\n 'refundAmount:=\"100.00\"'\n ```\n\n{% endlist %}\n\nUshbu misolda:\n\n- Sharikli ruchkalar soni 2 taga kamaydi – ya’ni 10 donadan 8 donaga tushdi.\n- So‘rovda `price` maydoni ko‘rsatilmagan, ammo uni ko‘rsatish ruxsat etiladi.\n- Bloknot pozitsiyasida `quantityCount` o‘zgarmagan, shuning uchun uni ko‘rsatmaslik ham mumkin edi.\n\n#### Pulning bir qismini qaytarish {#price-update}\n\nFaraz qilaylik, har bir bloknot uchun 30 soʻm miqdorida mablag‘ni qaytarish kerak. Bu pozitsiya narxini kamaytirish orqali amalga oshiriladi.\n\n{% list tabs %}\n\n- httpie\n\n ```(bash)\n http POST https://sandbox.pay.yandex.uz/api/merchant/v2/orders/Order-123/refund \\\n \"Authorization: Api-Key ${API_KEY}\" \\\n 'targetCart[items]:=[{\"productId\": \"id-1\"}, {\"productId\": \"id-2\", \"price\": \"170\"}]' \\\n 'refundAmount:=\"60.00\"'\n ```\n\n{% endlist %}\n\nUshbu misolda:\n\n- Bloknot narxi 30 soʻmga kamaydi – ya’ni 200 dan 170 soʻmgacha tushdi;\n- Shu tariqa jami 60 soʻm miqdorida qaytarish amalga oshiriladi, chunki bloknotlar 2 ta edi.\n- `quantityCount` maydonlari ko‘rsatilmagan, biroq zarur bo‘lsa ularning oldingi qiymatlarini ko‘rsatish mumkin.\n\n#### Qaytarilayotgan mahsulot miqdorini ko‘rsatgan holda qaytarish {#single-item-refund-cart}\n\nFaraz qilaylik, ikkita sharikli ruchkani qaytarish kerak. Bu quyidagi so‘rov orqali amalga oshiriladi:\n\n{% list tabs %}\n\n- httpie\n\n ```(bash)\n http POST https://sandbox.pay.yandex.uz/api/merchant/v2/orders/Order-123/refund \\\n \"Authorization: Api-Key ${API_KEY}\" \\\n 'refundCart[items][0]:={\"productId\": \"id-1\", \"quantityCount\": \"2\"}' \\\n 'refundAmount:=\"100.00\"'\n ```\n\n{% endlist %}\n\nUshbu misolda:\n\n- Sharikli ruchkalar soni 2 taga kamaydi – ya’ni 10 donadan 8 donaga tushdi.\n- So‘rovda `price` maydoni ko‘rsatilmagan, ammo uni ko‘rsatish to‘liq ruxsat etilgan edi.\n\n#### Mahsulot narxining qaysi qismini qaytarish kerakligi ko‘rsatilgan holdagi qaytarish {#price-update-refund-cart}\n\nFaraz qilaylik, har bir bloknot uchun 30 soʻm miqdorida mablag‘ni qaytarish kerak. Bu pozitsiya narxini kamaytirish orqali amalga oshiriladi.\n\n{% list tabs %}\n\n- httpie\n\n ```(bash)\n http POST https://sandbox.pay.yandex.uz/api/merchant/v2/orders/Order-123/refund \\\n \"Authorization: Api-Key ${API_KEY}\" \\\n 'refundCart[items]:=[{\"productId\": \"id-1\"}, {\"productId\": \"id-2\", \"price\": \"30\"}]' \\\n 'refundAmount:=\"60.00\"'\n ```\n\n{% endlist %}\n\nUshbu misolda:\n\n- Bloknot narxi 30 ga kamaydi – 200 soʻmdan 170 soʻmgacha.\n- Shu tariqa jami 60 soʻm miqdorida qaytarish amalga oshiriladi, chunki bloknotlar 2 ta edi.\n- `quantityCount` maydonlari ko‘rsatilmagan, biroq zarur bo‘lsa ularning oldingi qiymatlarini ko‘rsatish mumkin.",
"operationId": "merchant_v2_refund-post",
"parameters": [
{
"description": "Buyurtma yaratilganda `/orders` so‘rovida yuborilgan sotuvchi tizimidagi buyurtma ID raqami.",
"in": "path",
"name": "order_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"branchId": {
"description": "Savdo nuqtasi identifikatori",
"maxLength": 2048,
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tizimidagi qaytarish operatsiyasi identifikatori. U noyob bo‘lishi kerak.\n\nUshbu parametrni kiriting – qaytarish operatsiyasi holatini [/operations/{external_operation_id}](../operation/merchant_v1_operations-get) metodi orqali kuzatish imkoniyatiga ega bo‘lasiz.\n\nAgar operatsiya hali yakunlanmagan bo‘lsa (ya’ni qayta ishlanayotgan yoki to‘xtatilgan holatda bo‘lsa), unda xuddi shu argumentlar va aynan shu `externalOperationId` qiymati bilan qaytarish metodini qayta chaqirish idempotent hisoblanadi – javobda o‘sha operatsiyaning o‘zi qaytariladi. Aks holda xatolik qaytariladi.\n\nAgar qaytarish jarayoni muvaffaqiyatli ishga tushirilgan bo‘lsa, shu `externalOperationId` bilan metodni qayta chaqirish quyidagi xatoni qaytaradi: `reasonCode: \"DUPLICATE_EXTERNAL_OPERATION_ID\"`.",
"maxLength": 2048,
"type": "string"
},
"managerId": {
"description": "Menejer identifikatori",
"maxLength": 2048,
"type": "string"
},
"motive": {
"description": "Qaytarish sababi",
"maxLength": 2048,
"type": "string"
},
"refundAmount": {
"description": "Qaytariladigan summa.",
"example": "123.45",
"format": "double",
"type": "string"
},
"refundCart": {
"allOf": [
{
"properties": {
"items": {
"items": {
"properties": {
"price": {
"description": "Operatsiya bajarilgandan keyingi mahsulot/xizmatning bir dona narxi.\nAgar operatsiya natijasida bitta mahsulot narxi kamaytirilsa, ushbu parametrni ko‘rsatish zarur.\nBu parametr mahsulot uchun pulning faqat bir qismini qaytarish yoki buyurtmani tasdiqlash jarayonida foydali bo‘lishi mumkin.\nAgar so‘rovda ushbu maydon ko‘rsatilmasa, mahsulot narxi o‘zgarmagan deb hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"productId": {
"description": "Buyurtma yaratilgan paytdagi savatdagi pozitsiya identifikatori.\nAgar dastlabki savatda mavjud bo‘lmagan identifikator yuborilsa – xatolik yuz beradi.",
"maxLength": 2048,
"type": "string"
},
"quantityCount": {
"description": "Qaytarish operatsiyasi uchun mahsulot birliklari soni.\n\nQiymat ishlatilayotgan savat turiga bog‘liq:\n\n- agar `targetCart` ishlatilsa, `quantityCount` – qaytarishdan keyin qoladigan mahsulot soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 2 dona qoladi);\n- agar `refundCart` ishlatilsa, `quantityCount` – qaytariladigan mahsulotlar soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 3 dona qaytariladi).\n\nAgar maydon ko‘rsatilmasa, mahsulot miqdori o‘zgarmaydi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
],
"description": "Qaytarilishi kerak bo‘lgan savat pozitsiyalarini tavsiflaydi.\nBu parametrni `targetCart` maydoni bilan bir vaqtda ko‘rsatish mumkin emas.\nShuningdek, ushbu parametr bilan birga `externalOperationId` operatsiya identifikatorini yuborish tavsiya etiladi, chunki u idempotentlik tokeni hisoblanadi."
},
"targetCart": {
"allOf": [
{
"properties": {
"items": {
"items": {
"properties": {
"price": {
"description": "Operatsiya bajarilgandan keyingi mahsulot/xizmatning bir dona narxi.\nAgar operatsiya natijasida bitta mahsulot narxi kamaytirilsa, ushbu parametrni ko‘rsatish zarur.\nBu parametr mahsulot uchun pulning faqat bir qismini qaytarish yoki buyurtmani tasdiqlash jarayonida foydali bo‘lishi mumkin.\nAgar so‘rovda ushbu maydon ko‘rsatilmasa, mahsulot narxi o‘zgarmagan deb hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"productId": {
"description": "Buyurtma yaratilgan paytdagi savatdagi pozitsiya identifikatori.\nAgar dastlabki savatda mavjud bo‘lmagan identifikator yuborilsa – xatolik yuz beradi.",
"maxLength": 2048,
"type": "string"
},
"quantityCount": {
"description": "Qaytarish operatsiyasi uchun mahsulot birliklari soni.\n\nQiymat ishlatilayotgan savat turiga bog‘liq:\n\n- agar `targetCart` ishlatilsa, `quantityCount` – qaytarishdan keyin qoladigan mahsulot soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 2 dona qoladi);\n- agar `refundCart` ishlatilsa, `quantityCount` – qaytariladigan mahsulotlar soni (masalan: 5 dona bor edi, 3 ko‘rsatildi → 3 dona qaytariladi).\n\nAgar maydon ko‘rsatilmasa, mahsulot miqdori o‘zgarmaydi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId"
],
"type": "object"
},
"type": "array"
}
},
"type": "object"
}
],
"description": "Qaytarish amalga oshirilgandan keyingi savatning yakuniy holatini tavsiflaydi.\nAgar bu maydon ko‘rsatilmasa, savat to‘liq qaytarilgan deb hisoblanadi. Uni `refundCart` maydoni bilan bir vaqtda ko‘rsatish mumkin emas."
},
"targetShipping": {
"allOf": [
{
"properties": {
"amount": {
"description": "Operatsiya bajarilgandan keyingi yetkazish narxi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"type": "object"
}
],
"description": "Faqat Yandex Pay Checkout uchun qo‘llaniladi. Boshqa holatlarda ushbu maydonni bo‘sh qoldirish kerak.\n\nQaytarish amalga oshirilgandan keyingi yetkazishning yakuniy holatini tavsiflaydi.\nAgar bu maydon ko‘rsatilmagan bo‘lsa yoki qiymati `null`ga teng bo‘lsa, yetkazish narxi to‘liq qaytarilgan deb hisoblanadi."
}
},
"required": [
"refundAmount"
],
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v2/orders/{order_id}/refund",
"tags": [
"order"
]
}
},
"/api/merchant/v1/orders/{order_id}/capture": {
"post": {
"description": "Buyurtma bo‘yicha mablag‘ni yechish so‘rovi.\n\nBloklangan mablag‘larni yechish. Faqat `AUTHORIZED` holatidagi to‘lovlar uchun mavjud.\nSo‘rov muvaffaqiyatli bajarilganda to‘lov statusi `CAPTURED`ga o‘zgaradi.\n\nAgar tasdiqlash summasi asl summadan kamroq yuborilsa, qolgan qismi avtomatik ravishda qaytariladi.\nBunday holatda taqdim etilayotgan mahsulot va xizmatlarning yakuniy savatini yuborish kerak.\nYakuniy savat joriy savat asosida shakllantiriladi,\nbunda qaytarilgan ayrim pozitsiyalar chiqarib tashlanadi.",
"operationId": "merchant_v1_capture-post",
"parameters": [
{
"description": "Sotuvchi tomonidagi buyurtma identifikatori, u /orders so‘roviga javobda yuborilgan.",
"in": "path",
"name": "order_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Yakuniy savat"
},
"externalOperationId": {
"description": "Operatsiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Yechib olinadigan summa. Agar ko‘rsatilmagan bo‘lsa, kiritilgan savatning yakuniy qiymati yechib olinadi.",
"example": "123.45",
"format": "double",
"type": "string"
},
"shipping": {
"allOf": [
{
"properties": {
"amount": {
"description": "Verguldan keyin ikki xonadan ortiq belgi bo‘lmasligi kerak.\nMasalan: 1,12, 5,1, 10, 11,00",
"example": "123.45",
"format": "double",
"type": "string"
},
"methodType": {
"enum": [
"DIRECT",
"PICKUP",
"COURIER",
"YANDEX_DELIVERY"
],
"type": "string"
}
},
"required": [
"amount",
"methodType"
],
"type": "object"
}
],
"description": "Yakuniy yetkazish usuli"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/orders/{order_id}/capture",
"tags": [
"order"
]
}
},
"/api/merchant/v1/orders/{order_id}/rollback": {
"post": {
"description": "To‘lovni bekor qilish so‘rovi.\n\nHar qanday statusdagi to‘lovlar uchun mavjud.\nBuyurtma bo‘yicha keyingi to‘lovni taqiqlaydi, shuningdek agar to‘lov allaqachon amalga oshirilgan bo‘lsa,\n mijozga mablag‘lar to‘liq qaytariladi.\nMuvaffaqiyatli bajarilganda to‘lov statusi `FAILED`ga o‘zgaradi.",
"operationId": "merchant_v1_rollback-post",
"parameters": [
{
"description": "Buyurtma yaratilganda `/orders` so‘rovida yuborilgan sotuvchi tizimidagi buyurtma ID raqami.",
"in": "path",
"name": "order_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/orders/{order_id}/rollback",
"tags": [
"order"
]
}
},
"/api/merchant/v1/orders/{order_id}/submit": {
"post": {
"description": "Qabul qilish vaqtida to‘lanadigan Split to‘lovi uchun to‘lovni tasdiqlash so‘rovi.\n\n`CONFIRMED` statusidagi to‘lovlar uchun mavjud. So‘rov muvaffaqiyatli bajarilganda holat `CAPTURED`ga o‘zgaradi.\n\nAgar buyurtmani tasdiqlash bosqichida savat tarkibi rasmiylashtirish bosqichidagi savatdan farq qilsa,\n `cart` va `orderAmount` maydonlari uchun yangi qiymatlarni yuboring.",
"operationId": "merchant_v1_submit-post",
"parameters": [
{
"description": "Sotuvchi tomonidagi buyurtma identifikatori, u /orders so‘roviga javobda yuborilgan.",
"in": "path",
"name": "order_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"cartId": {
"description": "Yandex tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"coupons": {
"description": "Savatga qo‘llangan kuponlar",
"items": {
"properties": {
"description": {
"description": "Kupon tavsifi",
"example": "Скидка 3%",
"maxLength": 2048,
"type": "string"
},
"status": {
"enum": [
"VALID",
"INVALID",
"EXPIRED",
null
],
"type": "string"
},
"value": {
"description": "Kupon kodi",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"value"
],
"type": "object"
},
"type": "array"
},
"discounts": {
"description": "Savatga qo‘llangan chegirmalar",
"items": {
"properties": {
"amount": {
"description": "Chegirma summasi",
"example": "123.45",
"format": "double",
"type": "string"
},
"description": {
"description": "Matnli tavsif",
"maxLength": 2048,
"type": "string"
},
"discountId": {
"description": "Sotuvchi tizimidagi chegirma identifikatori",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"amount",
"description",
"discountId"
],
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Sotuvchi tomonidagi savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"pointsDisabled": {
"default": false,
"description": "O‘zbekistonda mavjud emas.",
"type": "boolean"
},
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
],
"description": "Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"type": {
"default": "UNSPECIFIED",
"description": "Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim",
"enum": [
"PHYSICAL",
"DIGITAL",
"UNSPECIFIED"
],
"type": "string"
},
"unitPrice": {
"description": "Chegirmasiz bir dona mahsulotning to‘liq narxi",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity"
],
"type": "object"
},
"type": "array"
},
"measurements": {
"allOf": [
{
"properties": {
"height": {
"description": "Balandligi, metrda",
"format": "float",
"type": "number"
},
"length": {
"description": "Uzunligi, metrda",
"format": "float",
"type": "number"
},
"weight": {
"description": "Og‘irligi, kilogrammda",
"format": "float",
"type": "number"
},
"width": {
"description": "Kengligi, metrda",
"format": "float",
"type": "number"
}
},
"required": [
"height",
"length",
"weight",
"width"
],
"type": "object"
}
]
},
"total": {
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Yakuniy savat"
},
"externalOperationId": {
"description": "Sotuvchi tizimidagi operatsiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"orderAmount": {
"description": "Buyurtmaning yakuniy summasi. `cart.total.amount` qiymatiga teng.\n\nAgar `cart` yuborilsa, bu maydon majburiy hisoblanadi.",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"externalOperationId"
],
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/orders/{order_id}/submit",
"tags": [
"order"
]
}
},
"/api/merchant/v1/operations/{external_operation_id}": {
"get": {
"description": "Avtorizatsiya, mablag‘ni yechish, qaytarish yoki to‘lovni bekor qilish operatsiyalari tafsilotlarini olish uchun so‘rov.",
"operationId": "merchant_v1_operations-get",
"parameters": [
{
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"in": "path",
"name": "external_operation_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operation": {
"properties": {
"amount": {
"description": "Operatsiya summasi fiat valyutada",
"example": "123.45",
"format": "double",
"type": "string"
},
"created": {
"description": "Operatsiya yaratilgan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
},
"externalOperationId": {
"description": "Sotuvchi tomonidagi tranzaksiya identifikatori",
"maxLength": 2048,
"type": "string"
},
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"operationType": {
"enum": [
"AUTHORIZE",
"BIND_CARD",
"REFUND",
"CAPTURE",
"VOID",
"RECURRING",
"PREPAYMENT",
"SUBMIT"
],
"type": "string"
},
"orderId": {
"maxLength": 2048,
"type": "string"
},
"params": {
"type": "object"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"type": "string"
},
"reason": {
"description": "Xatolik sababi",
"maxLength": 2048,
"type": "string"
},
"status": {
"default": "PENDING",
"enum": [
"PENDING",
"SUCCESS",
"FAIL"
],
"type": "string"
},
"updated": {
"description": "Operatsiya yangilangan sana va vaqt (ISO 8601)",
"format": "date-time",
"type": "string"
}
},
"required": [
"amount",
"operationId",
"operationType",
"orderId"
],
"type": "object"
}
},
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/operations/{external_operation_id}",
"tags": [
"operation"
]
}
},
"/api/merchant/v1/subscriptions": {
"post": {
"description": "Obuna yaratish uchun so‘rov.\n\nObuna yaratish va uni rasmiylashtirish havolasini olish uchun ishlatiladi.",
"operationId": "merchant_v1_subscriptions-post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"cart": {
"allOf": [
{
"properties": {
"externalId": {
"description": "Sotuvchi tomonidan uzatilgan savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Xaridor to‘laydigan mahsulotlar savatchasi.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Mahsulotning bir dona narxi – pozitsiyaga qo‘llangan chegirmalar hisobga olingan holda.",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "Plus ballari soni\n\nFaqat o‘qish uchun maydon. Yuborilgan qiymatlar e’tiborga olinmaydi.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot id raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob id raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan jami narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Mahsulot birligi uchun chegirmasiz to‘liq narx",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Savat"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"futureWriteOffAmount": {
"description": "Kelajakda yechib olinadigan summa",
"example": "123.45",
"format": "double",
"type": "string"
},
"intervalCount": {
"description": "`intervalUnit` parametrida ko‘rsatilgan vaqt birligiga nisbatan obuna davrlari soni.\n\nMasalan, 6 oylik obuna uchun: `intervalUnit: 'MONTH'`, `intervalCount: 6` deb ko‘rsating.\n\nAgar `isBinding=True` parametri ko‘rsatilmagan bo‘lsa, majburiy maydon.",
"example": "6",
"format": "int32",
"type": "integer"
},
"intervalUnit": {
"description": "Obuna davriyligi belgilanadigan vaqt birligi.\n\nAgar `isBinding=True` parametri ko‘rsatilmagan bo‘lsa, majburiy maydon.",
"enum": [
"SECOND",
"DAY",
"WEEK",
"MONTH",
"YEAR",
null
],
"type": "string"
},
"isBinding": {
"default": false,
"description": "Mahsulotlar savatchasi yaratilmagan holda foydalanuvchi kartasini bog‘lash imkonini beradi.\n\nAgar birinchi yechib olish vaqtida faqat kartani bog‘lash kerak bo‘lsa, so‘rovda `isBinding: true` parametrini yuboring.\n\nUshbu ssenariyda savat va obuna davriyligini yuborish talab etilmaydi.",
"type": "boolean"
},
"metadata": {
"description": "Buyurtma bo‘yicha ichki foydalanish uchun ixtiyoriy ma’lumotlar.",
"maxLength": 2048,
"type": "string"
},
"orderId": {
"description": "Sotuvchi tizimidagi buyurtma identifikatori (unikal bo‘lishi shart). To‘lov so‘rovi bo‘yicha keyingi barcha jarayonlar aynan shu identifikator orqali amalga oshiriladi. Ushbu identifikator solishtirish jarayonlarida ham ishlatiladi",
"maxLength": 2048,
"type": "string"
},
"orderSource": {
"default": null,
"description": "Buyurtma yaratish boshlang‘ich tarzda qaysi platformada ishga tushirilganini bildiradi.\n\nKeyingi tahlillar uchun zarur\n\n---\n\n**WEBSITE**: Tugma veb-saytda joylashtirilgan. To‘lov havolasi foydalanuvchi saytda amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**APP**: Tugma mobil ilovada joylashtirilgan. To‘lov havolasi foydalanuvchi ilova ichida amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan\n\n**CRM**: To‘lov havolasi CRM tizimida yoki boshqa administrator panelida menejer tomonidan yaratilgan\n\n**CASH_REGISTER**: To‘lov havolasi oflayn kassada ko‘rsatish uchun shakllantirilgan\n\n**CMS_PLUGIN**: To‘lov havolasi CMS uchun plagin ichida shakllantirilgan\n\n**TV**: To‘lov havolasi TV-platformada ko‘rsatish uchun shakllantirilgan.",
"enum": [
"WEBSITE",
"APP",
"CRM",
"CASH_REGISTER",
"CMS_PLUGIN",
"TV"
],
"type": "string"
},
"purpose": {
"description": "To‘lov maqsadi",
"maxLength": 1000,
"type": "string"
},
"redirectUrls": {
"allOf": [
{
"properties": {
"onAbort": {
"description": "To‘lov jarayoni bekor qilinganda foydalanuvchini qayta yo‘naltirish uchun havola. To‘lovni bekor qilish foydalanuvchi tomonidan to‘lov formasida amalga oshiriladi.",
"maxLength": 2048,
"type": "string"
},
"onError": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov vaqtida noma’lum xatolik yuz bersa yoki to‘lov havolasining amal qilish muddati tugasa, foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
},
"onSuccess": {
"description": "Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov muvaffaqiyatli yakunlanganda foydalanuvchini qayta yo‘naltirish uchun havola.",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"onError",
"onSuccess"
],
"type": "object"
}
],
"description": "To‘lov shaklidan foydalanuvchini qayta yo‘naltirish havolalari. Onlayn do‘konlar uchun majburiy."
},
"title": {
"description": "Obuna nomi",
"maxLength": 30,
"type": "string"
},
"trialCount": {
"description": "`trialUnit` parametrida ko‘rsatilgan sinov obuna davrlari soni.\n\nMasalan, 7 kunlik sinov obunasi uchun quyidagicha ko‘rsatiladi: `trialUnit: \"DAY\"`, `trialCount: 7`.",
"format": "int32",
"type": "integer"
},
"trialEndAt": {
"description": "Sinov davrining tugash sanasi. `trial_unit` va `trial_count` maydonlari bilan o‘zaro birgalikda ishlatilmaydi.",
"format": "date-time",
"type": "string"
},
"trialUnit": {
"description": "Sinov obunasi davomiyligi o‘lchanadigan vaqt birligi.",
"enum": [
"SECOND",
"DAY",
"WEEK",
"MONTH",
"YEAR",
null
],
"type": "string"
},
"ttl": {
"default": 1800,
"description": "Buyurtmaning amal qilish muddati (sekundlarda).\n\n`180 <= ttl <= 604800`",
"format": "int32",
"type": "integer"
}
},
"required": [
"currencyCode",
"orderId"
],
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"paymentUrl": {
"description": "Buyurtma uchun to‘lov havolasi",
"maxLength": 2048,
"type": "string"
},
"subscriptionId": {
"description": "Obuna identifikatori",
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"paymentUrl",
"subscriptionId"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"required": [
"data"
],
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/subscriptions",
"tags": [
"subscriptions",
"nobuild",
"noindex"
]
}
},
"/api/merchant/v1/subscriptions/recur": {
"post": {
"description": "Obuna bo‘yicha navbatdagi mablag‘ yechib olish so‘rovi.\n\nSo‘rov obunaga bog‘langan hisob yoki kartadan mablag‘larni oldindan tasdiqsiz yechib olish uchun ishlatiladi.\nMablag‘ni yechish uchun buyurtma raqami, savat, yechib olinadigan summa hamda\nobuna yaratilganda ishlatilgan boshlang‘ich buyurtma raqamini yuborish kerak.",
"operationId": "merchant_v1_subscriptions_recur-post",
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"amount": {
"description": "Yechib olinadigan summa",
"example": "123.45",
"format": "double",
"type": "string"
},
"cart": {
"allOf": [
{
"properties": {
"externalId": {
"description": "Sotuvchi tomonidan uzatilgan savat identifikatori",
"maxLength": 2048,
"type": "string"
},
"items": {
"description": "Xaridor to‘laydigan mahsulotlar savatchasi.",
"items": {
"properties": {
"description": {
"description": "Mahsulot tavsifi",
"maxLength": 2048,
"type": "string"
},
"discountedUnitPrice": {
"description": "Mahsulotning bir dona narxi – pozitsiyaga qo‘llangan chegirmalar hisobga olingan holda.",
"example": "123.45",
"format": "double",
"type": "string"
},
"features": {
"allOf": [
{
"properties": {
"tariffModifier": {
"description": "Komissiyani hisoblash uchun tarif modifikatori. Savatdagi pozitsiyani qayta ishlash uchun komissiya hisoblanayotganda qaysi tarif qo‘llanishini belgilaydi.",
"enum": [
"VERY_LOW",
"LOW",
"MEDIUM",
"HIGH",
"VERY_HIGH",
null
],
"type": "string"
}
},
"type": "object"
}
],
"description": "Mahsulot promo parametrlari"
},
"pointsAmount": {
"description": "Plus ballari soni\n\nFaqat o‘qish uchun maydon. Yuborilgan qiymatlar e’tiborga olinmaydi.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
},
"productId": {
"description": "Sotuvchi tizimidagi mahsulot id raqami. So‘rov parametrlarida har bir mahsulot identifikatori `productId` unikal bo‘lishi kerak.",
"maxLength": 2048,
"type": "string"
},
"quantity": {
"allOf": [
{
"properties": {
"available": {
"description": "Mahsulot uchun maksimal mavjud miqdor",
"example": "123.45",
"format": "double",
"type": "string"
},
"count": {
"description": "Buyurtmadagi mahsulot miqdori",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"count"
],
"type": "object"
}
],
"description": "Buyurtmadagi mahsulot miqdori"
},
"skuId": {
"description": "Assortiment birligini tavsiflovchi noyob id raqam. Individual tarifni qo‘llash uchun zarur.",
"maxLength": 2048,
"type": "string"
},
"subtotal": {
"description": "Chegirmalarsiz pozitsiya bo‘yicha umumiy narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"title": {
"description": "Mahsulot nomi",
"maxLength": 2048,
"type": "string"
},
"total": {
"description": "Pozitsiya bo‘yicha chegirmalar hisobga olingan jami narx",
"example": "123.45",
"format": "double",
"type": "string"
},
"unitPrice": {
"description": "Mahsulot birligi uchun chegirmasiz to‘liq narx",
"example": "123.45",
"format": "double",
"type": "string"
}
},
"required": [
"productId",
"quantity",
"title",
"total"
],
"type": "object"
},
"type": "array"
},
"total": {
"allOf": [
{
"properties": {
"amount": {
"description": "Barcha chegirmalar hisobga olingan savat qiymati.",
"example": "123.45",
"format": "double",
"type": "string"
},
"pointsAmount": {
"description": "O‘zbekistonda mavjud emas.",
"example": "123.45",
"format": "double",
"readOnly": true,
"type": "string"
}
},
"required": [
"amount"
],
"type": "object"
}
],
"description": "Buyurtma qiymati bo‘yicha yakuniy ma’lumot."
}
},
"required": [
"items",
"total"
],
"type": "object"
}
],
"description": "Savat"
},
"currencyCode": {
"description": "Buyurtma valyutasining uch harfli kodi (ISO 4217).",
"enum": [
"RUB",
"UZS"
],
"maxLength": 2048,
"type": "string"
},
"metadata": {
"description": "Buyurtma bo‘yicha ichki foydalanish uchun ixtiyoriy ma’lumotlar.",
"maxLength": 2048,
"type": "string"
},
"orderId": {
"description": "Sotuvchi tomonidagi buyurtma identifikatori (unikal bo‘lishi kerak)",
"maxLength": 2048,
"type": "string"
},
"parentOrderId": {
"description": "Boshlangʻich buyurtma identifikatori",
"maxLength": 2048,
"type": "string"
},
"purpose": {
"description": "To‘lov maqsadi",
"maxLength": 1000,
"type": "string"
}
},
"required": [
"amount",
"cart",
"currencyCode",
"orderId",
"parentOrderId"
],
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"operationId": {
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"operationId"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/subscriptions/recur",
"tags": [
"subscriptions",
"nobuild",
"noindex"
]
}
},
"/api/merchant/v1/subscriptions/{customer_subscription_id}": {
"get": {
"description": "Obuna bo‘yicha ma’lumot olish uchun so‘rov.\n\nObuna identifikatori, obuna holati va bog‘langan to‘lov usuli holatini qaytaradi.",
"operationId": "merchant_v1_customer_subscription-get",
"parameters": [
{
"description": "Obuna ID raqami",
"in": "path",
"name": "customer_subscription_id",
"required": true,
"schema": {
"maxLength": 2048,
"type": "string"
}
}
],
"requestBody": {
"content": {
"application/json": {
"schema": {
"properties": {
"check_card_active": {
"description": "Karta biriktirilganligni tekshirish imkonini beradi",
"type": "boolean"
}
},
"type": "object"
}
}
}
},
"responses": {
"200": {
"content": {
"application/json": {
"schema": {
"properties": {
"code": {
"default": 200
},
"data": {
"properties": {
"cancelledAt": {
"description": "Obunani bekor qilish vaqti",
"format": "date-time",
"type": "string"
},
"customerSubscriptionId": {
"description": "Obuna ID raqami",
"format": "uuid",
"maxLength": 2048,
"type": "string"
},
"isCardActive": {
"description": "Biriktirilgan karta holati",
"type": "boolean"
},
"nextWriteOff": {
"description": "Keyingi yechib olish sanasi",
"format": "date-time",
"type": "string"
},
"status": {
"description": "Obuna holati",
"enum": [
"NEW",
"ACTIVE",
"CANCELLED",
"EXPIRED"
],
"type": "string"
},
"subscriptionPlanId": {
"description": "Obuna rejasi ID raqami",
"format": "uuid",
"maxLength": 2048,
"type": "string"
}
},
"required": [
"status",
"subscriptionPlanId"
],
"type": "object"
},
"status": {
"default": "success",
"enum": [
"success"
],
"type": "string"
}
},
"type": "object"
}
}
},
"description": ""
}
},
"security": [
{
"ApiKey": []
}
],
"summary": "/v1/subscriptions/{customer_subscription_id}",
"tags": [
"subscriptions",
"nobuild",
"noindex"
]
}
}
},
"security": [
{}
],
"servers": [
{
"description": "Production",
"url": "https://pay.yandex.uz"
},
{
"description": "Sandbox",
"url": "https://sandbox.pay.yandex.uz"
}
]
}
Maqola foyda berdimi?
Avvalgisi
Keyingisi