Artikel in den Warenkorb legenServer-side
Legt Artikel in den aktuellen Warenkorb. Wenn der Warenkorb bereits einen Artikel mit derselben SKU enthält, wird der vorhandene Artikel durch den übergebenen Wert ersetzt.
path Parameters
| project_id required | integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt. Example: 44056 |
query Parameters
header Parameters
| x-user-for | string Die Benutzerkennung kann mithilfe des Xsolla-Login-Benutzer-JWT oder des Bezahlstation-Zugriffstokens übermittelt werden. Example: ACCESS_TOKEN/LOGIN_JWT |
| x-user-id | string <= 32 characters Sie können Ihre eigene Benutzer-ID verwenden, wenn Sie einen Warenkorb mit Spielen verkaufen. Example: UNIQUE_ID |
Request Body schema: application/json
required | Array of objects non-empty |
| country | string = 2 characters Zweistelliger Ländercode in Großbuchstaben gemäß ISO 3166-1 Alpha-2. Weitere Informationen zu den von Xsolla unterstützten Ländern finden Sie in der Dokumentation. |
| currency | string = 3 characters Die im Warenkorb angezeigte Währung des Artikelpreises. Dreistelliger Code pro ISO 4217. Detaillierte Informationen zu Von Xsolla unterstützte Währungen. |
Der Warenkorb mitsamt der Artikel wurde erfolgreich zurückgegeben.
Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.
Der Nutzer wurde nicht gefunden. Stellen Sie sicher, dass der Token x-user-for oder x-user-id korrekt ist.
Ungültiger Warenkorb. Prüfen Sie, ob der Warenkorb existiert, gefüllt ist und alle Artikel darin kostenpflichtig sind.
- 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"
}
]
}
