Создание группы заказов

Группа заказов от разных поставщиков с единым приёмом оплаты создаётся одним запросом:

метод: POST
ресурс: /v3/billing/api/order/order-container
тело запроса - объект OrderContainerRequest
тело ответа - объект OrderContainerResponse
Возможные ошибки

Примечание

Каждый заказ внутри группы заказов имеет базовую структуру, описанную в документации Создание заказа. Перед использованием данного метода рекомендуется ознакомиться с основной документацией по созданию заказа.

Пример запроса

POST /v3/billing/api/order/order-container
Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e
Content-Type: application/json
User-Agent: MyApp 1.0
Accept: application/json
{
  "merchantId": "019e207b-b0fe-ae2f-43e7-17054f15913d",
  "originalCurrencyId": "RUB",
  "originalAmount": 246,
  "originalVatAmount": 11.72,
  "merchantOrderIdVisible": "zakaz-123",
  "returnUrl": "https://marketplace.com#return",
  "successUrl": "https://marketplace.com#success",
  "failUrl": "https://marketplace.com#fail",
  "customer": {
    "vatNumber": "7736642031",
    "phone": "79045173703",
    "email": "gb@invbox.ru",
    "taxRegistrationReasonCode": "770901001",
    "name": "ООО ЮРлицо",
    "registrationAddress": "101000, г. Москва, Лубянский проезд, д.19",
    "isLegal": true,
    "type": "legal"
  },
  "orders": [
    {
      "basketItems": [
        {
          "sku": "1",
          "name": "Позиция заказа магазина маркетплейса",
          "type": "service",
          "paymentType": "full_payment",
          "measureCode": "796",
          "quantity": 1,
          "vatCode": "RUS_VAT5",
          "amount": 123,
          "amountWoVat": 117.14,
          "totalAmount": 123,
          "totalVatAmount": 5.86
        }
      ],
      "expirationDate": "2026-05-25T17:11:28+03:00",
      "merchantOrderId": "222222/333",
      "description": "Оплата заказа магазина маркетплейса",
      "amount": 123,
      "vatAmount": 5.86,
      "merchantId": "019e2094-8403-89f0-1a75-953e2103cfc2",
      "currencyId": "RUB"
    },
    {
      "basketItems": [
        {
          "sku": "1",
          "name": "Комиссия маркетплейса",
          "type": "service",
          "paymentType": "full_payment",
          "measureCode": "796",
          "quantity": 1,
          "vatCode": "RUS_VAT5",
          "amount": 123,
          "amountWoVat": 117.14,
          "totalAmount": 123,
          "totalVatAmount": 5.86
        }
      ],
      "expirationDate": "2026-05-25T17:11:28+03:00",
      "merchantOrderId": "1111/2222",
      "description": "Оплата заказа комиссии маркетплейса",
      "amount": 123,
      "vatAmount": 5.86,
      "merchantId": "019e207b-b0fe-ae2f-43e7-17054f15913d",
      "currencyId": "RUB"
    }
  ]
}

Ответ (по схеме):

{
  "data": {
    "id": "01771534-1a57-f184-dee3-ebeb91dded75",
    "merchantId": "01771534-1a57-f184-dee3-ebeb91dded75",
    "originalCurrencyId": "01771534-1a57-f184-dee3-ebeb91dded75",
    "originalAmount": 100.5,
    "originalVatAmount": 100.5,
    "expirationDate": "2026-08-03T12:00:00+03:00",
    "customer": {
      "type": "string",
      "name": "string",
      "phone": "string",
      "email": "string",
      "vatNumber": "string",
      "countryId": "01771534-1a57-f184-dee3-ebeb91dded75",
      "registrationAddress": "string",
      "taxRegistrationReasonCode": "string"
    },
    "invoiceSetting": {
      "customerLocked": false,
      "customerLockedFields": {},
      "customerHiddenFields": {},
      "paymentMethodIdLocked": false,
      "paymentMethodId": 1,
      "savePaymentData": false,
      "clientId": "01771534-1a57-f184-dee3-ebeb91dded75",
      "paymentToken": "string",
      "paymentMethodCode": "string",
      "paymentMethodAutosubmit": false,
      "bankDetailId": 1
    },
    "status": "string",
    "returnUrl": "string",
    "successUrl": "string",
    "failUrl": "string",
    "paymentUrl": "string",
    "paymentUrlType": "redirect",
    "paymentPageUrl": "string",
    "payerUserId": "01771534-1a57-f184-dee3-ebeb91dded75",
    "payerCounterpartyId": "01771534-1a57-f184-dee3-ebeb91dded75",
    "systemCounterpartyId": "01771534-1a57-f184-dee3-ebeb91dded75",
    "processable": false,
    "merchantOrderIdVisible": "string",
    "createdAt": "2026-08-03T12:00:00+03:00",
    "internalProperty": {
      "guarantee": false,
      "hold": false,
      "rtp": false,
      "agent": false,
      "rtpExternal": false
    },
    "tags": {},
    "sourceId": "l3"
  },
  "metaData": {
    "totalCount": 1,
    "pageSize": 1,
    "page": 1
  },
  "extendedData": [
    {
      "type": "string",
      "data": {}
    }
  ]
}

OrderContainerRequest

Свойство	Тип	Описание	Пример значения
merchantId *	string(36)	Идентификатор основгонго магазина (маркетплейса или агрегатора)	`019e207b-b0fe-ae2f-43e7-17054f15913d`
originalCurrencyId *	string(3) enum	Код валюты группы заказов в соответствии с ISO 4217	`RUB`, `USD`, `EUR`, `GBP`
originalAmount *	float	Общая сумма группы заказов	`246.00`
originalVatAmount *	float	Общая сумма НДС группы заказов	`11.72`
orders *	array of Order	Массив заказов, входящих в группу. Структура каждого заказа описана в документации по созданию заказа
customer	Customer	Информация о заказчике (если не указана, плательщик сам заполнит на платежной странице)
merchantOrderIdVisible	string(100)	Идентификатор группового заказа, отображаемый на платежной странице	`zakaz-123`
returnUrl	string(1000)	Ссылка для возврата на сайт Магазина
successUrl	string(1000)	Ссылка для перехода на сайт Магазина в случае успешной оплаты
failUrl	string(1000)	Ссылка для перехода на сайт Магазина в случае ошибки оплаты
expirationDate	datetime	Срок действия группы заказов	`2026-05-25T17:11:28+03:00`
languageId	string(2) enum	Язык интерфейса платежной страницы	`ru`, `en`
invoiceSetting	InvoiceSetting	Дополнительные настройки параметров оплаты

OrderContainerResponse

Ответ содержит информацию о созданной группе заказов, включая идентификаторы созданных заказов и ссылки на оплату. Объект повторяет свойства объекта OrderContainerRequest с дополнительными свойствами:

Свойство	Тип	Описание	Пример значения
id *	string(36)	Идентификатор группы заказов в системе Инвойсбокс	`01771534-1a57-f184-dee3-ebeb91dded75`
paymentUrl *	string(1000)	Ссылка для перехода на платёжный шлюз для оплаты заказа
createdAt *	datetime	Дата создания заказа	`2026-12-22T00:00:00+00:00`
status *	string(50) enum	Статус заказа, `pending` - Ожидает оплаты, `completed` - успешная оплата	`completed`, `pending`,
paidAt	datetime	Дата оплаты заказа (если оплачен)	`2026-12-22T00:00:00+00:00`

curl -X POST 'https://api.invoicebox.ru/v3/billing/api/order/order-container' \ -H 'Authorization: Bearer <ВАШ_ТОКЕН>' \ -H 'Content-Type: application/json' \ -H 'User-Agent: MyApp 1.0' \ -d '{ "merchantId": "ffffffff-ffff-ffff-ffff-ffffffffffff", "originalCurrencyId": "string", "originalAmount": 0, "originalVatAmount": 0 }'

Создание группы заказов

OrderContainerRequest

OrderContainerResponse

Параметры запроса — POST