Наполнение корзины по ID корзины товарамиServer-side
Заполняет корзину товарами по идентификатору корзины. Если в корзине уже есть товар с таким же артикулом, существующий товар будет заменен на переданное значение.
path Parameters
| project_id required | integer ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта. Example: 44056 |
| cart_id required | string ID корзины. Example: custom_id |
query Parameters
header Parameters
| x-user-for | string Идентификатор пользователя может быть передан с помощью JWT пользователя Авторизации Иксолла или токена доступа Платежей Иксолла). Example: ACCESS_TOKEN/LOGIN_JWT |
| x-user-id | string <= 32 characters Вы можете использовать свой собственный ID пользователя при продаже корзины с играми. Example: UNIQUE_ID |
Request Body schema: application/json
required | Array of objects non-empty |
| country | string = 2 characters Двухбуквенное обозначение страны в верхнем регистре согласно стандарту ISO 3166-1 alpha-2. Список стран, поддерживаемых Xsolla, приведен в документации. |
| currency | string = 3 characters Валюта, в которой указаны цены товаров в корзине. Трехбуквенный код в соответствии с ISO 4217. Подробную информацию о валютах, поддерживаемых Xsolla, смотрите в документации. |
Корзина с товарами успешно возвращена.
Данные для базовой аутентификации не переданы или ошибочны. Убедитесь, что использовали базовую аутентификацию и проверьте правильность учетных данных.
Пользователь не найден. Убедитесь, что верно указали токен x-user-for или x-user-id.
Недействительная корзина. Убедитесь, что корзина существует, не пуста и все товары в ней не бесплатны.
- Payload
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
{- "currency": "USD",
- "items": [
- {
- "quantity": 2,
- "sku": "com.xsolla.cup01"
}, - {
- "quantity": 1,
- "sku": "com.xsolla.t-shirt01"
}, - {
- "quantity": 1,
- "sku": "com.xsolla.cup01"
}, - {
- "quantity": 1,
- "sku": "com.xsolla.hat01"
}
]
}- 200
- 401
- 404
- 422
{- "cart_id": "cart_id",
- "is_free": false,
- "items": [
- {
- "attributes": [ ],
- "can_be_bought": true,
- "description": "The cup of tea",
- "groups": [
- {
- "external_id": "cups",
- "name": "Cups"
}
], - "is_bonus": false,
- "is_free": false,
- "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "name": "Cup",
- "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "5.99",
- "amount_without_discount": "5.99",
- "currency": "USD"
}, - "promotions": [ ],
- "quantity": 2,
- "sku": "com.xsolla.cup01",
- "type": "physical_good",
- "virtual_prices": [ ],
- "vp_rewards": [
- {
- "amount": 130,
- "item_id": 175232,
- "name": "Value point",
- "sku": "com.xsolla.value_point_1"
}, - {
- "amount": 50,
- "is_clan": true,
- "item_id": 186321,
- "name": "Clan Reward VP 1",
- "sku": "com.xsolla.clan_value_point_1"
}
]
}, - {
- "attributes": [ ],
- "can_be_bought": true,
- "description": "Wonderful white T-shirt",
- "groups": [ ],
- "is_bonus": false,
- "is_free": false,
- "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "name": "White T-shirt",
- "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": {
- "amount": "3.99",
- "amount_without_discount": "4.99",
- "currency": "USD"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "com.xsolla.minigun_1",
- "type": "virtual_good"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "name": "Bonus promotion"
}
], - "quantity": 1,
- "sku": "com.xsolla.t-shirt01",
- "type": "physical_good",
- "virtual_prices": [ ],
- "vp_rewards": [
- {
- "amount": 130,
- "item_id": 175232,
- "name": "Value point",
- "sku": "com.xsolla.value_point_1"
}, - {
- "amount": 50,
- "is_clan": true,
- "item_id": 186321,
- "name": "Clan Reward VP 1",
- "sku": "com.xsolla.clan_value_point_1"
}
]
}, - {
- "attributes": [ ],
- "can_be_bought": true,
- "description": "Wonderful white T-shirt",
- "groups": [
- {
- "external_id": "clothes",
- "name": "Clothes"
}
], - "is_bonus": false,
- "is_free": true,
- "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "name": "Cat's cup",
- "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
], - "price": null,
- "promotions": [ ],
- "quantity": 1,
- "sku": "com.xsolla.cup01",
- "type": "physical_good",
- "virtual_prices": [ ],
- "vp_rewards": [
- {
- "amount": 130,
- "item_id": 175232,
- "name": "Value point",
- "sku": "com.xsolla.value_point_1"
}, - {
- "amount": 50,
- "is_clan": true,
- "item_id": 186321,
- "name": "Clan Reward VP 1",
- "sku": "com.xsolla.clan_value_point_1"
}
]
}
], - "price": {
- "amount": "15.97",
- "amount_without_discount": "22.96",
- "currency": "USD"
}, - "promotions": [
- {
- "bonus": [
- {
- "name": "Xsolla Minigun",
- "quantity": 1,
- "sku": "com.xsolla.minigun_1",
- "type": "virtual_good"
}
], - "date_end": "2026-04-15T16:16:00+03:00",
- "date_start": "2020-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "name": "Bonus promotion"
}
], - "warnings": [
- {
- "errorCode": 4001,
- "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = hut01 not found",
- "quantity": 1,
- "sku": "com.xsolla.hat01"
}
]
}
