Создание заказа с использованием реквизитов продавца

При интеграции с банками и крупными платёжными агрегаторами (далее — Агент) заказ создаётся в особом режиме: идентификационные данные магазина Инвойсбокс не нужны, вместо них передаются реквизиты юрлица. Отличий два:

ИНН и КПП вместо идентификатора магазина
авторизационные данные агента вместо авторизационных данных магазина

Заказ в этом режиме создаётся отдельным методом:

метод: POST
ресурс: /v3/adapter/api/subagent/order

Важно

Метод обслуживается отдельным модулем: его схема не входит в публикуемый набор, поэтому консоль «Выполнить» для него недоступна. Перед интеграцией сверьте контракт с технической поддержкой.

тело запроса - объект CreateAgentOrderRequest
тело ответа - объект OrderResponse
Возможные ошибки

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

Примечание

Пример ниже намеренно показан на обычном ресурсе /v3/billing/api/order/order: тело агентского заказа отличается только блоком seller. Субагентский ресурс /v3/adapter/api/subagent/order принимает то же тело; используйте его, если работаете по субагентской схеме.

POST /v3/billing/api/order/order
Authorization: Bearer b37c4c689295904ed21eee5d9a48d42e
Content-Type: application/json
User-Agent: MyApp 1.0
Accept: application/json
{
  "seller": {
    "type": "counterparty",
    "vatNumber": "232323232323",
    "taxRegistrationReasonCode": "232323232323"
   },
  "merchantOrderId": "m-1608560079",
  "amount": 366.00,
  "successUrl": "https://shop.example.com/order/4412?result=success",
  "failUrl": "https://shop.example.com/order/4412?result=fail",
  "returnUrl": "https://shop.example.com/order/4412?result=return",
  "vatAmount": 66.00,
  "basketItems": [
    {
      "sku": "5fe0adcfa7fb4",
      "name": "Бронирование номера",
      "measure": "шт.",
      "measureCode": "796",
      "grossWeight": 0,
      "netWeight": 0,
      "quantity": 3,
      "amount": 122.00,
      "amountWoVat": 100.00,
      "totalAmount": 366.00,
      "totalVatAmount": 66.00,
      "vatCode": "RUS_VAT22",
      "type": "service",
      "paymentType": "full_prepayment"
    }
  ],
  "metaData": {
    "@type": "LodgingReservation",
    "reservationId": "abc456",
    "reservationStatus": "https://schema.org/ReservationConfirmed",
    "underName": {
      "@type": "Person",
      "name": "John Smith"
    },
    "reservationFor": {
      "@type": "LodgingBusiness",
      "name": "Hilton San Francisco Union Square",
      "address": {
        "@type": "PostalAddress",
        "streetAddress": "333 O'Farrell St",
        "addressLocality": "San Francisco",
        "addressRegion": "CA",
        "postalCode": "94102",
        "addressCountry": "US"
      },
      "telephone": "415-771-1400"
    },
    "checkinTime": "2026-08-12T16:00:00-08:00",
    "checkoutTime": "2026-08-14T11:00:00-08:00"
  },
  "expirationDate": "2026-12-22T00:00:00+00:00",
  "languageId": "ru",
  "currencyId": "RUB",
  "description": "Оплата номера в отеле",
  "customer": {
    "type": "legal",
    "name": "ООО «Ромашка»",
    "phone": "79001112233",
    "email": "buh@example.invbox.ru",
    "vatNumber": "7701234560",
    "taxRegistrationReasonCode": "770101001",
    "registrationAddress": "190000, Санкт-Петербург, Невский пр. 147, офис 321"
  }
}

Ответ:

{
  "data": {
    "id": "01771534-1a57-f184-dee3-ebeb91dded75",
    "merchantOrderId": "O-12345",
    "status": "created",
    "amount": 19658.45,
    "vatAmount": 3276.41,
    "currencyId": "RUB",
    "createdAt": "2026-08-01T10:00:00+03:00",
    "expirationDate": "2026-08-04T10:00:00+03:00",
    "paymentUrl": "https://pay.invoicebox.ru/order/01771534-1a57-f184-dee3-ebeb91dded75"
  }
}

CreateAgentOrderRequest

Объект включает в себя все поля CreateOrderRequest а так же:

Свойство	Тип	Описание	Пример значения
seller *	Seller	Данные продавца	`{"type": "counterparty", "vatNumber":"232323232323", "taxRegistrationReasonCode": "232323232323"}`

Seller

Повторяет свойства объекта CreateOrderRequest с дополнительными свойствами:

Свойство	Тип	Описание	Пример значения
type *	string(36)	Тип продавца, доступные значения: `counterparty`	`counterparty`
countryId *	string(3)	Страна, доступные значения: `RUS`	`RUS`
vatNumber *	string(20)	ИНН	`7710044140`
taxRegistrationReasonCode	string(9)	КПП	`770201001`

Если продавец не найден в системе Инвойсбокс, то будет возвращена ошибка.