Создание заказа с использованием реквизитов продавца
Для интеграции с банками и крупными платежными агрегаторамии (далее Агент) используется специальный режим сценария создания заказа, который не требуется идентификационные данные магазина Инвойсбокс, вместо них используется реквизиты юр. лица. Основное отличие заключается в:
- ИНН и КПП вместо идентифкатора магазина
- Авторизационные данные агента вместо авторизационных данных магазина
Для создания заказа, необходимо вызвать следующий метод API:
- метод:
POST
- ресурс:
/v3/adapter/api/subagent/order
- тело запроса - объект CreateAgentOrderRequest
- тело ответа - объект OrderResponse
- Возможные ошибки
Пример запроса
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": 371.88,
"successUrl": "https://merchant.ru/order/xxx?result=success",
"failUrl": "https://merchant.ru/order/xxx?result=fail",
"returnUrl": "https://merchant.ru/order/xxx?result=return",
"vatAmount": 61.98,
"basketItems": [
{
"sku": "5fe0adcfa7fb4",
"name": "Бронирование номера",
"measure": "шт.",
"measureCode": "796",
"grossWeight": 0,
"netWeight": 0,
"quantity": 3,
"amount": 123.96,
"amountWoVat": 103.3,
"totalAmount": 371.88,
"totalVatAmount": 61.98,
"vatCode": "RUS_VAT20",
"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": "2017-04-11T16:00:00-08:00",
"checkoutTime": "2017-04-13T11:00:00-08:00"
},
"expirationDate": "2020-12-22T00:00:00+00:00",
"languageId": "ru",
"currencyId": "RUB",
"description": "Оплата номера в отеле",
"customer": {
"type": "private",
"name": "Peter",
"phone": "79001112233",
"email": "peter@domain.com",
"vatNumber": "",
"registrationAddress": ""
}
}
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 |
Если продавец не найден в системе Инвойсбокс, то будет возвращена ошибка.