Link Поиск Меню Развернуть Документ

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

Для создания группы заказов от разных поставщиков с единым приемом оплаты, необходимо использовать следующий метод API:

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

Пример запроса
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"
    }
  ]
}

OrderContainerRequest

СвойствоОбязательноеТипОписаниеПример значения
merchantIdдаstring(36)Идентификатор основгонго магазина (маркетплейса или агрегатора)019e207b-b0fe-ae2f-43e7-17054f15913d
originalCurrencyIdдаstring(3) enumКод валюты группы заказов в соответствии с ISO 4217RUB, 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Дата создания заказа2020-12-22T00:00:00+00:00
statusдаstring(50) enumСтатус заказа, pending - Ожидает оплаты, completed - успешная оплатаcompleted, pending,
paidAtнетdatetimeДата оплаты заказа (если оплачен)2020-12-22T00:00:00+00:00

Читать далее »