/v1/orders/{order_id} - order

Body

application/json

{
  "code": 200,
  "data": {
    "delivery": {
      "actualPrice": "123.45",
      "created": "2025-01-01T00:00:00Z",
      "price": "123.45",
      "status": "NEW",
      "updated": "2025-01-01T00:00:00Z"
    },
    "operations": [
      {
        "amount": "123.45",
        "approvalCode": "example",
        "created": "2025-01-01T00:00:00Z",
        "externalOperationId": "example",
        "operationId": "123e4567-e89b-12d3-a456-426614174000",
        "operationType": "AUTHORIZE",
        "orderId": "example",
        "params": {},
        "reason": "example",
        "status": "PENDING",
        "updated": "2025-01-01T00:00:00Z"
      }
    ],
    "order": {
      "cart": {
        "cartId": "example",
        "coupons": [
          null
        ],
        "discounts": [
          null
        ],
        "externalId": "example",
        "items": [
          null
        ],
        "measurements": {},
        "total": null
      },
      "coolingPeriodExpiresAt": "2025-01-01T00:00:00Z",
      "created": "2025-01-01T00:00:00Z",
      "currencyCode": "RUB",
      "isPrepayment": false,
      "merchantId": "123e4567-e89b-12d3-a456-426614174000",
      "metadata": "example",
      "orderAmount": "123.45",
      "orderId": "example",
      "paymentMethod": {
        "cardLast4": "example",
        "cardNetwork": "AMEX",
        "methodType": "SPLIT"
      },
      "paymentStatus": "PENDING",
      "paymentUrl": "example",
      "reason": "example",
      "updated": "2025-01-01T00:00:00Z"
    }
  },
  "status": "success"
}

Name	Description
code	Type: unknown Default: `200`
data	Type: OrderResponseData Example { "delivery": { "actualPrice": "123.45", "created": "2025-01-01T00:00:00Z", "price": "123.45", "status": "NEW", "updated": "2025-01-01T00:00:00Z" }, "operations": [ { "amount": "123.45", "approvalCode": "example", "created": "2025-01-01T00:00:00Z", "externalOperationId": "example", "operationId": "123e4567-e89b-12d3-a456-426614174000", "operationType": "AUTHORIZE", "orderId": "example", "params": {}, "reason": "example", "status": "PENDING", "updated": "2025-01-01T00:00:00Z" } ], "order": { "cart": { "cartId": "example", "coupons": [ {} ], "discounts": [ {} ], "externalId": "example", "items": [ {} ], "measurements": { "height": 0.5, "length": 0.5, "weight": 0.5, "width": 0.5 }, "total": null }, "coolingPeriodExpiresAt": "2025-01-01T00:00:00Z", "created": "2025-01-01T00:00:00Z", "currencyCode": "RUB", "isPrepayment": false, "merchantId": "123e4567-e89b-12d3-a456-426614174000", "metadata": "example", "orderAmount": "123.45", "orderId": "example", "paymentMethod": { "cardLast4": "example", "cardNetwork": "AMEX", "methodType": "SPLIT" }, "paymentStatus": "PENDING", "paymentUrl": "example", "reason": "example", "updated": "2025-01-01T00:00:00Z" } }
status	Type: string Default: `success` Const: `success`

Delivery

Name	Description
price	Type: string<double> Xaridor uchun yetkazish narxi Example: `123.45`
actualPrice	Type: string<double> Sotuvchi uchun yetkazish narxi Example: `123.45`
created	Type: string<date-time> Yetkazish yaratilgan sana va vaqt (ISO 8601) Example: `2025-01-01T00:00:00Z`
status	Type: string Yetkazish holati Default: `NEW` Enum: `NEW`, `ESTIMATING`, `EXPIRED`, `READY_FOR_APPROVAL`, `COLLECTING`, `PREPARING`, `DELIVERING`, `DELIVERED`, `RETURNING`, `RETURNED`, `FAILED`, `CANCELLED`
updated	Type: string<date-time> Yetkazish yangilangan sana va vaqt (ISO 8601) Example: `2025-01-01T00:00:00Z`

Example

{
  "actualPrice": "123.45",
  "created": "2025-01-01T00:00:00Z",
  "price": "123.45",
  "status": "NEW",
  "updated": "2025-01-01T00:00:00Z"
}

OrderResponseOperation

Name	Description
amount	Type: string<double> Operatsiya summasi fiat valyutada Example: `123.45`
operationId	Type: string<uuid> Max length: `2048` Example: `123e4567-e89b-12d3-a456-426614174000`
operationType	Type: string Enum: `AUTHORIZE`, `BIND_CARD`, `REFUND`, `CAPTURE`, `VOID`, `RECURRING`, `PREPAYMENT`, `SUBMIT`
orderId	Type: string Max length: `2048` Example: `example`
approvalCode	Type: string Protsessing markazidan olingan tranzaksiya tasdiqlash kodi. Example: `example`
created	Type: string<date-time> Operatsiya yaratilgan sana va vaqt (ISO 8601) Example: `2025-01-01T00:00:00Z`
externalOperationId	Type: string Sotuvchi tomonidagi tranzaksiya identifikatori Max length: `2048` Example: `example`
params	Type: object Example `{}`
reason	Type: string Xatolik sababi Max length: `2048` Example: `example`
status	Type: string Default: `PENDING` Enum: `PENDING`, `SUCCESS`, `FAIL`
updated	Type: string<date-time> Operatsiya yangilangan sana va vaqt (ISO 8601) Example: `2025-01-01T00:00:00Z`

Example

{
  "amount": "123.45",
  "approvalCode": "example",
  "created": "2025-01-01T00:00:00Z",
  "externalOperationId": "example",
  "operationId": "123e4567-e89b-12d3-a456-426614174000",
  "operationType": "AUTHORIZE",
  "orderId": "example",
  "params": {},
  "reason": "example",
  "status": "PENDING",
  "updated": "2025-01-01T00:00:00Z"
}

Coupon

Name	Description
value	Type: string Kupon kodi Max length: `2048` Example: `example`
description	Type: string Kupon tavsifi Max length: `2048` Example: `Скидка 3%`
status	Type: string Enum: `VALID`, `INVALID`, `EXPIRED`, `null` Example: `VALID`

Example

{
  "description": "Скидка 3%",
  "status": "VALID",
  "value": "example"
}

Discount

Name	Description
amount	Type: string<double> Chegirma summasi Example: `123.45`
description	Type: string Matnli tavsif Max length: `2048` Example: `example`
discountId	Type: string Sotuvchi tizimidagi chegirma identifikatori Max length: `2048` Example: `example`

Example

{
  "amount": "123.45",
  "description": "example",
  "discountId": "example"
}

CartItemFeatures

Name

Description

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

Example

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

Measurements

Name	Description
height	Type: number Balandligi, metrda
length	Type: number Uzunligi, metrda
weight	Type: number Og‘irligi, kilogrammda
width	Type: number Kengligi, metrda

Example

{
  "height": 0.5,
  "length": 0.5,
  "weight": 0.5,
  "width": 0.5
}

ItemQuantity

Name

Description

count

Type: string<double>

Buyurtmadagi mahsulot miqdori

Example: 123.45

available

Type: string<double>

Mahsulot uchun maksimal mavjud miqdor

Example: 123.45

Example

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

CartItem

Name	Description
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	All of 1 type Type: ItemQuantity Example `{ "available": "123.45", "count": "123.45" }` Buyurtmadagi mahsulot miqdori Example `{ "available": "123.45", "count": "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	All of 1 type Type: CartItemFeatures Example `{ "pointsDisabled": false, "tariffModifier": "VERY_LOW" }` Mahsulot promo parametrlari Example `{ "pointsDisabled": false, "tariffModifier": "VERY_LOW" }`
finalPrice	Type: string<double> Pozitsiya va savat bo‘yicha barcha chegirmalar hisobga olingan holdagi mahsulotning birlik narxi Example: `123.45`
measurements	All of 1 type Type: Measurements Example `{ "height": 0.5, "length": 0.5, "weight": 0.5, "width": 0.5 }` Mahsulotning o‘lchamlari va og‘irligi. `PHYSICAL` turidagi mahsulotlar uchun majburiy Example `{ "height": 0.5, "length": 0.5, "weight": 0.5, "width": 0.5 }`
pointsAmount	Type: string<double> O‘zbekistonda mavjud emas. Example: `123.45`
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`
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`
type	Type: string Mahsulot turi. Yetkazish xizmatlari bilan integratsiya uchun muhim Default: `UNSPECIFIED` Enum: `PHYSICAL`, `DIGITAL`, `UNSPECIFIED`
unitPrice	Type: string<double> Chegirmasiz bir dona mahsulotning to‘liq narxi Example: `123.45`

Example

{
  "description": "example",
  "discountedUnitPrice": "123.45",
  "features": {
    "pointsDisabled": false,
    "tariffModifier": "VERY_LOW"
  },
  "finalPrice": "123.45",
  "measurements": {
    "height": 0.5,
    "length": 0.5,
    "weight": 0.5,
    "width": 0.5
  },
  "pointsAmount": "123.45",
  "productId": "example",
  "quantity": {
    "available": "123.45",
    "count": "123.45"
  },
  "skuId": "example",
  "subtotal": "123.45",
  "title": "example",
  "total": "123.45",
  "type": "UNSPECIFIED",
  "unitPrice": "123.45"
}

CartTotal

Name

Description

amount

Type: string<double>

Barcha chegirmalar hisobga olingan savat qiymati.

Example: 123.45

pointsAmount

Type: string<double>

O‘zbekistonda mavjud emas.

Example: 123.45

Example

{
  "amount": "123.45",
  "pointsAmount": "123.45"
}

Cart

Name	Description
items	Type: CartItem[] Savatchadagi mahsulotlar roʻyxati Example `[ { "description": "example", "discountedUnitPrice": "123.45", "features": { "pointsDisabled": false, "tariffModifier": "VERY_LOW" }, "finalPrice": "123.45", "measurements": { "height": 0.5, "length": 0.5, "weight": 0.5, "width": 0.5 }, "pointsAmount": "123.45", "productId": "example", "quantity": { "available": "123.45", "count": "123.45" }, "skuId": "example", "subtotal": "123.45", "title": "example", "total": "123.45", "type": "UNSPECIFIED", "unitPrice": "123.45" } ]`
cartId	Type: string Yandex tomonidagi savat identifikatori. Max length: `2048` Example: `example`
coupons	Type: Coupon[] Savatga qo‘llangan kuponlar Example `[ { "description": "Скидка 3%", "status": "VALID", "value": "example" } ]`
discounts	Type: Discount[] Savatga qo‘llangan chegirmalar Example `[ { "amount": "123.45", "description": "example", "discountId": "example" } ]`
externalId	Type: string Sotuvchi tomonidagi savat identifikatori Max length: `2048` Example: `example`
measurements	Type: Measurements Example `{ "height": 0.5, "length": 0.5, "weight": 0.5, "width": 0.5 }`
total	All of 1 type Type: CartTotal Example `{ "amount": "123.45", "pointsAmount": "123.45" }` Toʻlovga yoʻnaltiriladigan savatchaning yakuniy qiymati Default: `null`

Example

{
  "cartId": "example",
  "coupons": [
    {
      "description": "Скидка 3%",
      "status": "VALID",
      "value": "example"
    }
  ],
  "discounts": [
    {
      "amount": "123.45",
      "description": "example",
      "discountId": "example"
    }
  ],
  "externalId": "example",
  "items": [
    {
      "description": "example",
      "discountedUnitPrice": "123.45",
      "features": {
        "pointsDisabled": false,
        "tariffModifier": "VERY_LOW"
      },
      "finalPrice": "123.45",
      "measurements": {
        "height": 0.5,
        "length": 0.5,
        "weight": 0.5,
        "width": 0.5
      },
      "pointsAmount": "123.45",
      "productId": "example",
      "quantity": {
        "available": "123.45",
        "count": "123.45"
      },
      "skuId": "example",
      "subtotal": "123.45",
      "title": "example",
      "total": "123.45",
      "type": "UNSPECIFIED",
      "unitPrice": "123.45"
    }
  ],
  "measurements": null,
  "total": null
}

PaymentMethod

Name	Description
methodType	Type: string Const: `SPLIT` Example: `example`
cardLast4	Type: string Max length: `2048` Example: `example`
cardNetwork	Type: string To‘lov tizimi Enum: `AMEX`, `DISCOVER`, `JCB`, `MASTERCARD`, `MAESTRO`, `VISAELECTRON`, `VISA`, `MIR`, `UNIONPAY`, `UZCARD`, `HUMOCARD`, `UNKNOWN`, `UNDEFINED`, `null` Example: `AMEX`

Example

{
  "cardLast4": "example",
  "cardNetwork": "AMEX",
  "methodType": "SPLIT"
}

BaseMerchantApiOrder

Name	Description
cart	All of 1 type Type: Cart Example { "cartId": "example", "coupons": [ { "description": "Скидка 3%", "status": "VALID", "value": "example" } ], "discounts": [ { "amount": "123.45", "description": "example", "discountId": "example" } ], "externalId": "example", "items": [ { "description": "example", "discountedUnitPrice": "123.45", "features": { "pointsDisabled": false, "tariffModifier": "VERY_LOW" }, "finalPrice": "123.45", "measurements": { "height": 0.5, "length": 0.5, "weight": 0.5, "width": 0.5 }, "pointsAmount": "123.45", "productId": "example", "quantity": { "available": "123.45", "count": "123.45" }, "skuId": "example", "subtotal": "123.45", "title": "example", "total": "123.45", "type": "UNSPECIFIED", "unitPrice": "123.45" } ], "measurements": null, "total": null } Savat Example { "cartId": "example", "coupons": [ { "description": "Скидка 3%", "status": "VALID", "value": "example" } ], "discounts": [ { "amount": "123.45", "description": "example", "discountId": "example" } ], "externalId": "example", "items": [ { "description": "example", "discountedUnitPrice": "123.45", "features": null, "finalPrice": "123.45", "measurements": null, "pointsAmount": "123.45", "productId": "example", "quantity": null, "skuId": "example", "subtotal": "123.45", "title": "example", "total": "123.45", "type": "UNSPECIFIED", "unitPrice": "123.45" } ], "measurements": null, "total": null }
currencyCode	Type: string Buyurtma valyutasining uch harfli kodi (ISO 4217). Enum: `RUB`, `UZS` Max length: `2048`
coolingPeriodExpiresAt	Type: string<date-time> Sovutish muddati tugash sanasi va vaqti (ISO 8601) Example: `2025-01-01T00:00:00Z`
created	Type: string<date-time> Buyurtma yaratilgan sana va vaqt (ISO 8601) Example: `2025-01-01T00:00:00Z`
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. Default: `false`
merchantId	Type: string<uuid> Max length: `2048` Example: `123e4567-e89b-12d3-a456-426614174000`
metadata	Type: string Tugmani ishga tushirish vaqtida uzatilgan ixtiyoriy ma’lumotlar Max length: `2048` Example: `example`
orderAmount	Type: string<double> Qaytarishlar, yetkazish, chegirmalar va promokodlarni hisobga olgan holda to‘lov uchun buyurtmaning to‘liq qiymati Example: `123.45`
orderId	Type: string /orders xizmatiga uzatilgan sotuvchi tomonidagi buyurtma ID raqami. Max length: `2048` Example: `example`
paymentMethod	Type: PaymentMethod Example `{ "cardLast4": "example", "cardNetwork": "AMEX", "methodType": "SPLIT" }`
paymentStatus	Type: string Batafsil ma’lumotni Operatsiya holatlari bo‘limidan o‘qing. Enum: `PENDING`, `AUTHORIZED`, `CAPTURED`, `VOIDED`, `REFUNDED`, `CONFIRMED`, `PARTIALLY_REFUNDED`, `FAILED`, `null` Example: `PENDING`
paymentUrl	Type: string Buyurtma uchun to‘lov havolasi Max length: `2048` Example: `example`
reason	Type: string Buyurtma bekor qilinish sababi. `VOIDED` va `FAILED` holatlari uchun qo‘llaniladi. Max length: `2048` Example: `example`
updated	Type: string<date-time> Buyurtma yangilangan sana va vaqt (ISO 8601) Example: `2025-01-01T00:00:00Z`

Example

{
  "cart": {
    "cartId": "example",
    "coupons": [
      {
        "description": "Скидка 3%",
        "status": "VALID",
        "value": "example"
      }
    ],
    "discounts": [
      {
        "amount": "123.45",
        "description": "example",
        "discountId": "example"
      }
    ],
    "externalId": "example",
    "items": [
      {
        "description": "example",
        "discountedUnitPrice": "123.45",
        "features": null,
        "finalPrice": "123.45",
        "measurements": null,
        "pointsAmount": "123.45",
        "productId": "example",
        "quantity": null,
        "skuId": "example",
        "subtotal": "123.45",
        "title": "example",
        "total": "123.45",
        "type": "UNSPECIFIED",
        "unitPrice": "123.45"
      }
    ],
    "measurements": {
      "height": 0.5,
      "length": 0.5,
      "weight": 0.5,
      "width": 0.5
    },
    "total": null
  },
  "coolingPeriodExpiresAt": "2025-01-01T00:00:00Z",
  "created": "2025-01-01T00:00:00Z",
  "currencyCode": "RUB",
  "isPrepayment": false,
  "merchantId": "123e4567-e89b-12d3-a456-426614174000",
  "metadata": "example",
  "orderAmount": "123.45",
  "orderId": "example",
  "paymentMethod": {
    "cardLast4": "example",
    "cardNetwork": "AMEX",
    "methodType": "SPLIT"
  },
  "paymentStatus": "PENDING",
  "paymentUrl": "example",
  "reason": "example",
  "updated": "2025-01-01T00:00:00Z"
}

OrderResponseData

Name	Description
delivery	Type: Delivery Example `{ "actualPrice": "123.45", "created": "2025-01-01T00:00:00Z", "price": "123.45", "status": "NEW", "updated": "2025-01-01T00:00:00Z" }`
operations	Type: OrderResponseOperation[] Example `[ { "amount": "123.45", "approvalCode": "example", "created": "2025-01-01T00:00:00Z", "externalOperationId": "example", "operationId": "123e4567-e89b-12d3-a456-426614174000", "operationType": "AUTHORIZE", "orderId": "example", "params": {}, "reason": "example", "status": "PENDING", "updated": "2025-01-01T00:00:00Z" } ]`
order	Type: BaseMerchantApiOrder Example { "cart": { "cartId": "example", "coupons": [ { "description": "Скидка 3%", "status": "VALID", "value": "example" } ], "discounts": [ { "amount": "123.45", "description": "example", "discountId": "example" } ], "externalId": "example", "items": [ { "description": "example", "discountedUnitPrice": "123.45", "features": null, "finalPrice": "123.45", "measurements": null, "pointsAmount": "123.45", "productId": "example", "quantity": null, "skuId": "example", "subtotal": "123.45", "title": "example", "total": "123.45", "type": "UNSPECIFIED", "unitPrice": "123.45" } ], "measurements": { "height": 0.5, "length": 0.5, "weight": 0.5, "width": 0.5 }, "total": null }, "coolingPeriodExpiresAt": "2025-01-01T00:00:00Z", "created": "2025-01-01T00:00:00Z", "currencyCode": "RUB", "isPrepayment": false, "merchantId": "123e4567-e89b-12d3-a456-426614174000", "metadata": "example", "orderAmount": "123.45", "orderId": "example", "paymentMethod": { "cardLast4": "example", "cardNetwork": "AMEX", "methodType": "SPLIT" }, "paymentStatus": "PENDING", "paymentUrl": "example", "reason": "example", "updated": "2025-01-01T00:00:00Z" }

Example

{
  "delivery": {
    "actualPrice": "123.45",
    "created": "2025-01-01T00:00:00Z",
    "price": "123.45",
    "status": "NEW",
    "updated": "2025-01-01T00:00:00Z"
  },
  "operations": [
    {
      "amount": "123.45",
      "approvalCode": "example",
      "created": "2025-01-01T00:00:00Z",
      "externalOperationId": "example",
      "operationId": "123e4567-e89b-12d3-a456-426614174000",
      "operationType": "AUTHORIZE",
      "orderId": "example",
      "params": {},
      "reason": "example",
      "status": "PENDING",
      "updated": "2025-01-01T00:00:00Z"
    }
  ],
  "order": {
    "cart": {
      "cartId": "example",
      "coupons": [
        {}
      ],
      "discounts": [
        {}
      ],
      "externalId": "example",
      "items": [
        {}
      ],
      "measurements": {
        "height": 0.5,
        "length": 0.5,
        "weight": 0.5,
        "width": 0.5
      },
      "total": null
    },
    "coolingPeriodExpiresAt": "2025-01-01T00:00:00Z",
    "created": "2025-01-01T00:00:00Z",
    "currencyCode": "RUB",
    "isPrepayment": false,
    "merchantId": "123e4567-e89b-12d3-a456-426614174000",
    "metadata": "example",
    "orderAmount": "123.45",
    "orderId": "example",
    "paymentMethod": {
      "cardLast4": "example",
      "cardNetwork": "AMEX",
      "methodType": "SPLIT"
    },
    "paymentStatus": "PENDING",
    "paymentUrl": "example",
    "reason": "example",
    "updated": "2025-01-01T00:00:00Z"
  }
}

/v1/orders/

Request

Path parameters

Responses

200 OK

Body

Delivery

OrderResponseOperation

Coupon

Discount

CartItemFeatures

Measurements

ItemQuantity

CartItem

CartTotal

Cart

PaymentMethod

BaseMerchantApiOrder

OrderResponseData

Maqola foyda berdimi?