Fill cart with itemsClient-side
put/v2/project/{project_id}/cart/fill
Fills the cart with items. If the cart already has an item with the same SKU, the existing item will be replaced by the passed value.
SecurityAuthForCart
Request
path Parameters
| project_id required | integer Project ID. You can find this parameter in your Publisher Account next to the name of the project. Example: 44056 |
Request Body schema: application/json
Responses
200
The cart with items was successfully returned.
Request samples
- Payload
- curl
- JavaScript
- Node.js
- Python
- C#
- Go
- Java
application/json
{- "items": [
- {
- "sku": "booster_mega_1",
- "quantity": 123
}
]
}Response samples
- 200
application/json
{- "cart_id": "cart_id",
- "is_free": false,
- "items": [
- {
- "attributes": [ ],
- "description": "Take it, take it all! All of Xsollas riches in one Mega Booster.",
- "groups": [
- {
- "external_id": "powerups",
- "name": "Power Ups"
}
], - "inventory_options": {
- "consumable": {
- "usages_count": 1
}, - "expiration_period": null
}, - "is_free": false,
- "is_bonus": false,
- "name": "Xsolla Booster Mega",
- "price": {
- "amount": "50.0000000000000000",
- "amount_without_discount": "100.0000000000000000",
- "currency": "USD"
}, - "quantity": 123,
- "sku": "booster_mega_1",
- "type": "virtual_good",
- "virtual_item_type": "consumable",
- "virtual_prices": [ ],
- "promotions": [
- {
- "name": "Bonus promotion",
- "date_start": "2020-04-15T16:16:00+03:00",
- "date_end": "2026-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "bonus": [
- {
- "quantity": 1,
- "name": "Xsolla Minigun",
- "sku": "minigun_1",
- "type": "virtual_good"
}
]
}
], - "can_be_bought": true,
- "vp_rewards": [
- {
- "item_id": 175232,
- "sku": "value_point_1",
- "amount": 130,
- "name": "Value point",
}, - {
- "item_id": 186321,
- "sku": "clan_value_point_sku_1",
- "amount": 50,
- "name": "Clan Reward VP 1",
- "is_clan": true
}
], - "limits": {
- "per_user": {
- "available": 3,
- "recurrent_schedule": {
- "interval_type": "weekly",
- "reset_next_date": 1746057600
}, - "total": 5
}
}, - "periods": [
- {
- "date_from": "2020-08-11T10:00:00+03:00",
- "date_until": "2020-08-11T20:00:00+03:00"
}
]
}
], - "warnings": [
- {
- "sku": "booster_mega_21",
- "quantity": 1,
- "errorCode": 4001,
- "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = booster_mega_2 not found"
}
], - "price": {
- "amount": "6150.0000000000000000",
- "amount_without_discount": "6150.0000000000000000",
- "currency": "USD"
}, - "promotions": [
- {
- "name": "Bonus promotion",
- "date_start": "2020-04-15T16:16:00+03:00",
- "date_end": "2026-04-15T16:16:00+03:00",
- "discount": {
- "percent": "50.00"
}, - "bonus": [
- {
- "quantity": 1,
- "name": "Xsolla Minigun",
- "sku": "minigun_1",
- "type": "virtual_good"
}
]
}
]
}
