/v1/orders

cart

Savat

{
  "externalId": "example",
  "items": [
    {
      "description": "example",
      "discountedUnitPrice": "123.45",
      "features": null,
      "productId": "example",
      "quantity": null,
      "skuId": "example",
      "subtotal": "123.45",
      "title": "example",
      "total": "123.45",
      "unitPrice": "123.45"
    }
  ],
  "total": {
    "amount": "123.45"
  }
}

currencyCode

Type: string

Buyurtma valyutasining uch harfli kodi (ISO 4217).

Enum: RUB, UZS

Max length: 2048

orderId

Type: string

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

Max length: 2048

Example: example

availablePaymentMethods

Type: string[]

To‘lov formasida xaridorga mavjud bo‘ladigan to‘lov usullari Yandex Split orqali.

Mumkin bo‘lgan variantlar:

• ["SPLIT"] – faqat Split orqali;

Default: null

Min items: 1

[
  "CARD"
]

billingPhone

Type: string

Mijoz telefon raqami.

Avtorizatsiyani soddalashtirish uchun ishlatiladi hamda Split orqali tasdiqlanish ehtimolini oshirishi mumkin.

Telefon 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.

Masalan, quyidagi yuborilgan qiymatlar: 998123456789, +998123456789, +998 (12) 345-67-89 – 998123456789 ko‘rinishida qayta ishlanadi.

Max length: 2048

Example: example

extensions

Oflayn buyurtmani rasmiylashtirish uchun qo‘shimcha parametrlar

Default: null

isPrepayment

Type: boolean

Buyurtma “kechiktirilgan to‘lov” oqimi bo‘yicha amalga oshiriladimi.

Agar parametr true qiymatiga o‘rnatilgan bo‘lsa, buyurtma kechiktirilgan to‘lovli buyurtma sifatida rasmiylashtiriladi.

metadata

Type: string

Buyurtma bo‘yicha ichki foydalanish uchun ixtiyoriy ma’lumotlar.

Max length: 2048

Example: example

orderSource

Type: string

Buyurtma yaratilishi boshlangan platforma yoki interfeys

Keyingi tahlillar uchun zarur

WEBSITE: Tugma veb-saytda joylashtirilgan. To‘lov havolasi foydalanuvchi saytda amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan

APP: Tugma mobil ilovada joylashtirilgan. To‘lov havolasi foydalanuvchi ilova ichida amal bajarganidan (tugmani bosganidan) keyin shakllantirilgan

CRM: To‘lov havolasi CRM tizimida yoki boshqa administrator panelida menejer tomonidan yaratilgan

CASH_REGISTER: To‘lov havolasi oflayn kassada ko‘rsatish uchun shakllantirilgan

CMS_PLUGIN: To‘lov havolasi CMS uchun plagin ichida shakllantirilgan

TV: To‘lov havolasi TV-platformada ko‘rsatish uchun shakllantirilgan.

Default: null

Enum: WEBSITE, APP, CRM, CASH_REGISTER, CMS_PLUGIN

preferredPaymentMethod

Type: string

Afzal to‘lov usuli.

Uzatilgan to‘lov usuli, agar u availablePaymentMethods maydonida mavjud usullarga zid bo‘lmasa, to‘lov formasida avtomatik tanlanadi.

Enum: FULLPAYMENT, SPLIT

publicConstructor

Type: string

Split orqali to‘lash uchun oldindan tanlangan reja konstruktori.

Faqat kelishuv asosida mavjud

Example: example

purpose

Type: string

To‘lov maqsadi

Max length: 1000

Example: example

redirectUrls

To‘lov shaklidan foydalanuvchini qayta yo‘naltirish havolalari. Onlayn do‘konlar uchun majburiy.

{
  "onAbort": "example",
  "onError": "example",
  "onSuccess": "example"
}

risk

Splitni tasdiqlash ehtimolini oshirishi mumkin boʻlgan qoʻshimcha maʼlumotlar. To‘liq hajmda faqat onlayn-do‘konlar uchun mavjud.

{
  "billingPhone": "example",
  "customerAggregates": {
    "amountFirstSuccessfulOrder": "123.45",
    "amountLatestSuccessfulOrder": "123.45",
    "cookie": "example",
    "daysSinceLastPasswordReset": 0,
    "failedLoginAttemptsOneDay": 0,
    "failedLoginAttemptsSevenDays": 0,
    "firstSuccessfulOrderDate": "2025-01-01",
    "historicalCookieLogin": true,
    "historicalDeviceLogin": true,
    "lastPasswordResetDate": "2025-01-01",
    "latestSuccessfulOrderLastYearDate": "2025-01-01",
    "previousSuccessfulOrdersAtSameAddress": true,
    "redemptionRateLastHalfYear": "123.45",
    "registrationDate": "2025-01-01"
  },
  "deviceId": "example",
  "isExpressShipping": true,
  "merchantMcc": "example",
  "merchantName": "example",
  "merchantOfflinePosLegalAddress": "example",
  "merchantTaxRefNumber": "example",
  "periodCheckAggregates": {
    "successfulOrdersCountNineMonths": 0,
    "successfulOrdersCountOneMonth": 0,
    "successfulOrdersCountSixMonths": 0,
    "successfulOrdersCountThreeMonths": 0,
    "successfulOrdersCountTwelveMonths": 0,
    "totalAmountSuccessfulOrdersNineMonths": "123.45",
    "totalAmountSuccessfulOrdersOneMonth": "123.45",
    "totalAmountSuccessfulOrdersSixMonths": "123.45",
    "totalAmountSuccessfulOrdersThreeMonths": "123.45",
    "totalAmountSuccessfulOrdersTwelveMonths": "123.45"
  },
  "qrType": "static",
  "qrcId": "example",
  "shippingAddress": "example",
  "shippingPhone": "example",
  "shippingType": "COURIER"
}

ttl

Type: integer

Parametr foydalanuvchi buyurtma to‘lov sahifasiga havoladan foydalanishi mumkin bo‘lgan vaqtni belgilaydi.

Belgilangan vaqt tugagach, foydalanuvchi “To‘lov vaqti tugadi” degan xabarni ko‘radi.

Agar 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.

Bu holat buyurtma holatining Order.paymentStatus qiymati FAILEDga o‘zgarishi orqali aks etadi. Shuningdek, buyurtma statusi o‘zgargani haqida bildirishnoma yuboriladi. Agar sotuvchi mahsulotni oldindan band qilib qo‘ygan bo‘lsa, buyurtma statusi o‘zgargandan so‘ng bandlovni bekor qilish mumkin.

Amal qilish muddati (sek.): 180 <= ttl <= 604800

Amal qilish muddati (shaxsiy kabinetda to‘lov havolasi yaratilganda, sek.): 86400

Default: 1800

pointsDisabled

Type: boolean

O‘zbekistonda mavjud emas.

Default: false

tariffModifier

Type: string

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

Example: VERY_LOW

count

Type: string<double>

Buyurtmadagi mahsulot miqdori

Example: 123.45

available

Type: string<double>

Mahsulot uchun maksimal mavjud miqdor

Example: 123.45

productId

Type: string

Sotuvchi tizimidagi mahsulot ID raqami. So‘rov parametrlarida har bir mahsulot identifikatori productId unikal bo‘lishi kerak.

Max length: 2048

Example: example

quantity

Buyurtmadagi mahsulot miqdori

{
  "available": "123.45",
  "count": "123.45"
}

title

Type: string

Mahsulot nomi

Max length: 2048

Example: example

total

Type: string<double>

Pozitsiya bo‘yicha chegirmalar hisobga olingan umumiy narx

Example: 123.45

description

Type: string

Mahsulot tavsifi

Max length: 2048

Example: example

discountedUnitPrice

Type: string<double>

Bir pozitsiya uchun chegirmalarni hisobga olgan holda mahsulot birligining narxi

Example: 123.45

features

Mahsulot promo parametrlari

{
  "pointsDisabled": false,
  "tariffModifier": "VERY_LOW"
}

skuId

Type: string

Assortiment birligini tavsiflovchi noyob ID raqam. Individual tarifni qo‘llash uchun zarur.

Max length: 2048

Example: example

subtotal

Type: string<double>

Chegirmalarsiz pozitsiya bo‘yicha umumiy narx

Example: 123.45

unitPrice

Type: string<double>

Chegirmasiz bir dona mahsulotning to‘liq narxi

Example: 123.45

amount

Type: string<double>

Barcha chegirmalar hisobga olingan savat qiymati.

Example: 123.45

items

Type: RenderedCartItem[]

Savatdagi mahsulotlar ro‘yxati.

[
  {
    "description": "example",
    "discountedUnitPrice": "123.45",
    "features": {
      "pointsDisabled": false,
      "tariffModifier": "VERY_LOW"
    },
    "productId": "example",
    "quantity": {
      "available": "123.45",
      "count": "123.45"
    },
    "skuId": "example",
    "subtotal": "123.45",
    "title": "example",
    "total": "123.45",
    "unitPrice": "123.45"
  }
]

total

Buyurtma qiymati bo‘yicha yakuniy ma’lumot.

{
  "amount": "123.45"
}

externalId

Type: string

Savat identifikatori – sotuvchi tomonida.

Max length: 2048

Example: example

branchId

Type: string

Faqat oflayn doʻkonlar uchun majburiy maydon. Savdo nuqtasi identifikatori

Default: null

Max length: 2048

managerId

Type: string

Faqat oflayn doʻkonlar uchun majburiy maydon. Menejer identifikatori

Default: null

Max length: 2048

saleToken

Type: string

Har bir to‘lov operatsiyasi uchun kassa tomonidan yaratiladigan noyob ID

Max length: 2048

Example: example

token

Type: string

QR token

Max length: 2048

Example: example

phone

Type: string

SMS orqali xabarnoma yuborish uchun mijoz telefon raqami (masalan: +998123456789). Faqat oflayn do‘konlar uchun.

Max length: 2048

Pattern: ^\+\d+$

Example: example

billingReport

Buyurtmani rasmiylashtirish joyi va mas’ul shaxs haqida ma’lumot.

{
  "branchId": "null",
  "managerId": "null"
}

paymentData

To‘lovning qo‘shimcha parametrlari.

{
  "saleToken": "example"
}

qrData

QR yordamida to‘lov havolasini yuborish uchun qo‘shimcha parametrlar.

{
  "token": "example"
}

smsOffer

SMS orqali to‘lov havolasini yuborish uchun qo‘shimcha parametrlar.

Faqat oflayn doʻkonlar uchun majburiy maydon.

{
  "phone": "example"
}

onError

Type: string

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.

Max length: 2048

Example: example

onSuccess

Type: string

Faqat onlayn do‘konlar uchun majburiy maydon. To‘lov muvaffaqiyatli yakunlanganda foydalanuvchini qayta yo‘naltirish uchun havola.

Max length: 2048

Example: example

onAbort

Type: string

To‘lov jarayoni bekor qilinganda foydalanuvchini qayta yo‘naltirish uchun havola. To‘lovni bekor qilish foydalanuvchi tomonidan to‘lov formasida amalga oshiriladi.

Max length: 2048

Example: example

amountFirstSuccessfulOrder

Type: string<double>

Birinchi muvaffaqiyatli buyurtma summasi

Example: 123.45

amountLatestSuccessfulOrder

Type: string<double>

Oxirgi muvaffaqiyatli buyurtma summasi

Example: 123.45

cookie

Type: string

Cookie fayllar

Max length: 2048

Example: example

daysSinceLastPasswordReset

Type: integer

Parol oxirgi marta tiklanganidan beri o‘tgan kunlar soni

failedLoginAttemptsOneDay

Type: integer

So‘nggi 1 kun ichida muvaffaqiyatsiz kirish urinishlari soni

failedLoginAttemptsSevenDays

Type: integer

So‘nggi 7 kun ichida muvaffaqiyatsiz kirishga urinishlar soni

firstSuccessfulOrderDate

Type: string<date>

Tarixdagi birinchi muvaffaqiyatli buyurtma sanasi

Example: 2025-01-01

historicalCookieLogin

Type: boolean

Saqlangan cookie orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)

historicalDeviceLogin

Type: boolean

Saqlangan qurilma orqali kirish (foydalanuvchi avval buyurtma uchun to‘lov qilgan)

lastPasswordResetDate

Type: string<date>

Parol oxirgi marta tiklangan sana

Example: 2025-01-01

latestSuccessfulOrderLastYearDate

Type: string<date>

So‘nggi bir yil ichidagi oxirgi muvaffaqiyatli buyurtma sanasi

Example: 2025-01-01

previousSuccessfulOrdersAtSameAddress

Type: boolean

Foydalanuvchi joriy manzil bo‘yicha ilgari muvaffaqiyatli buyurtma qilganmi

redemptionRateLastHalfYear

Type: string<double>

So‘nggi yarim yil ichidagi xaridni yakunlash foizi

Example: 123.45

registrationDate

Type: string<date>

Sotuvchi saytida ro‘yxatdan o‘tgan sana

Example: 2025-01-01

successfulOrdersCountNineMonths

Type: integer

So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar soni

successfulOrdersCountOneMonth

Type: integer

So‘nggi 1 oy ichidagi muvaffaqiyatli buyurtmalar soni

successfulOrdersCountSixMonths

Type: integer

So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar soni

successfulOrdersCountThreeMonths

Type: integer

So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar soni

successfulOrdersCountTwelveMonths

Type: integer

So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar soni

totalAmountSuccessfulOrdersNineMonths

Type: string<double>

So‘nggi 9 oy ichidagi muvaffaqiyatli buyurtmalar summasi

Example: 123.45

totalAmountSuccessfulOrdersOneMonth

Type: string<double>

So‘nggi bir oy ichidagi muvaffaqiyatli buyurtmalar summasi

Example: 123.45

totalAmountSuccessfulOrdersSixMonths

Type: string<double>

So‘nggi 6 oy ichidagi muvaffaqiyatli buyurtmalar summasi

Example: 123.45

totalAmountSuccessfulOrdersThreeMonths

Type: string<double>

So‘nggi 3 oy ichidagi muvaffaqiyatli buyurtmalar summasi

Example: 123.45

totalAmountSuccessfulOrdersTwelveMonths

Type: string<double>

So‘nggi 12 oy ichidagi muvaffaqiyatli buyurtmalar summasi

Example: 123.45

billingPhone

Type: string

DEPRECATED Mijoz telefon raqami.
Yuqori darajadagi shu nomdagi maydondan foydalanish tavsiya etiladi.

Max length: 2048

Example: example

customerAggregates

Mijoz haqida umumlashtirilgan ma’lumotlar

{
  "amountFirstSuccessfulOrder": "123.45",
  "amountLatestSuccessfulOrder": "123.45",
  "cookie": "example",
  "daysSinceLastPasswordReset": 0,
  "failedLoginAttemptsOneDay": 0,
  "failedLoginAttemptsSevenDays": 0,
  "firstSuccessfulOrderDate": "2025-01-01",
  "historicalCookieLogin": true,
  "historicalDeviceLogin": true,
  "lastPasswordResetDate": "2025-01-01",
  "latestSuccessfulOrderLastYearDate": "2025-01-01",
  "previousSuccessfulOrdersAtSameAddress": true,
  "redemptionRateLastHalfYear": "123.45",
  "registrationDate": "2025-01-01"
}

deviceId

Type: string

Mijoz qurilmasi identifikatori (device_id/gaid/idfa/ifv)

Max length: 2048

Example: example

isExpressShipping

Type: boolean

Ekspress yetkazish belgisi

merchantMcc

Type: string

Merchant MCC kodi

Max length: 2048

Example: example

merchantName

Type: string

Merchant nomi

Max length: 2048

Example: example

merchantOfflinePosLegalAddress

Type: string

Oflayn savdo nuqtasining yuridik manzili

Max length: 2048

Example: example

merchantTaxRefNumber

Type: string

Merchantning soliq raqami

Max length: 2048

Example: example

periodCheckAggregates

Turli davrlar bo‘yicha chek agregatlari.

{
  "successfulOrdersCountNineMonths": 0,
  "successfulOrdersCountOneMonth": 0,
  "successfulOrdersCountSixMonths": 0,
  "successfulOrdersCountThreeMonths": 0,
  "successfulOrdersCountTwelveMonths": 0,
  "totalAmountSuccessfulOrdersNineMonths": "123.45",
  "totalAmountSuccessfulOrdersOneMonth": "123.45",
  "totalAmountSuccessfulOrdersSixMonths": "123.45",
  "totalAmountSuccessfulOrdersThreeMonths": "123.45",
  "totalAmountSuccessfulOrdersTwelveMonths": "123.45"
}

qrcId

Type: string

QR kod raqami

Max length: 2048

Example: example

qrType

Type: string

QR kod turi

Enum: static, dynamic, null

Example: static

shippingAddress

Type: string

Yetkazish manzili Agar buyurtmani olish usuli (PICKUP) “olib ketish” deb tanlangan bo‘lsa, mahsulotni berish punkti manzilini ko‘rsatish kerak.

Max length: 2048

Example: example

shippingPhone

Type: string

Qabul qiluvchining telefon raqami (masalan: +998123456789).

Max length: 2048

Example: example

shippingType

Type: string

Buyurtmani olish usuli

Enum: COURIER, PICKUP, null

Example: COURIER