在购物车里添加商品

Digital Distribution Hub API

In-Game Store & Buy Button API

概览

下载API定义

用户属性

管理

个性化目录

捆绑包

管理

购物车和付款

购物车（客户端侧）

购物车（服务器侧）

支付（客户端）

支付（服务器端）

订单

免费商品

通用

Webhook

预订

商户

通用区域

游戏密钥

权利

管理

玩家物品库

客户端

管理

跨平台物品库

促销活动

通用

虚拟物品和货币

管理

虚拟支付

NFT商品

管理

限制

管理

REWARD CHAINS & VALUE POINTS

管理

客户端

Pay Station API

Publisher Account API

Subscriptions API

Webhooks

在购物车里添加商品

put/v2/project/{project_id}/cart/fill

在购物车里添加商品。如果购物车中已有具有相同SKU的商品，则现有商品将被传入的值替换。

SecurityAuthForCart

Request

path Parameters

project_id

required

integer

项目编号。您可以在您的发布商帐户项目名称旁边。

Example: 44056

Request Body schema: application/json

required

Array of objects

商品清单。

Array

sku required	string Default: "booster_mega_1"
quantity required	number Default: 123

Responses

200

已成功返回含商品的购物车。

Request samples

application/json

{"items": [{"quantity": 123,
"sku": "booster_mega_1"
}
]
}

Response samples

application/json

{"cart_id": "cart_id",
"is_free": false,
"items": [{"attributes": [ ],
"can_be_bought": true,
"description": "Take it, take it all! All of Xsollas riches in one Mega Booster.",
"groups": [{"external_id": "powerups",
"name": "Power Ups"
}
],
"image_url": "https://cdn.xsolla.net/img/misc/images/e9f2f4a634bc96ea03b5d5ceadd7c55f.png",
"inventory_options": {"consumable": {"usages_count": 1
},
"expiration_period": null
},
"is_bonus": false,
"is_free": false,
"limits": {"per_user": {"available": 3,
"recurrent_schedule": {"interval_type": "weekly",
"reset_next_date": 1746057600
},
"total": 5
}
},
"name": "Xsolla Booster Mega",
"periods": [{"date_from": "2020-08-11T10:00:00+03:00",
"date_until": "2020-08-11T20:00:00+03:00"
}
],
"price": {"amount": "50.0000000000000000",
"amount_without_discount": "100.0000000000000000",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "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": 123,
"sku": "booster_mega_1",
"type": "virtual_good",
"virtual_item_type": "consumable",
"virtual_prices": [ ],
"vp_rewards": [{"amount": 130,
"image_url": "https://cdn3.xsolla.com/img/misc/images/54c0cf9d345817cdacfdde198db178e0.jpg",
"item_id": 175232,
"name": "Value point",
"sku": "value_point_1"
}
]
}
],
"price": {"amount": "6150.0000000000000000",
"amount_without_discount": "6150.0000000000000000",
"currency": "USD"
},
"promotions": [{"bonus": [{"image_url": "https://cdn.xsolla.net/img/misc/images/2fc5c491a47413a8e8000447889093c2.png",
"name": "Xsolla Minigun",
"quantity": 1,
"sku": "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 = booster_mega_2 not found",
"quantity": 1,
"sku": "booster_mega_21"
}
]
}