{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/zh/api/catalog/index.yaml","sidebar":"sidebar-@l10n/zh/catalog-en.sidebars.yaml"},"props":{"definitionId":"@l10n/zh/api/catalog/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/zh/api/catalog","seo":{"title":"概述","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"购物车是一种购买机制，可将多个商品合并到同一个订单中。用户可以使用真实货币购买任意类型、任意数量的商品，也可以使用[兑换码](https://developers.xsolla.com/zh/api/liveops/promotions-promo-codes)。\n\n购物车与特定用户绑定，并存储在艾克索拉侧。您可以通过两种方式识别购物车：通过[用户JWT](https://developers.xsolla.com/zh/api/catalog/section/authentication/authentication-using-user's-jwt)自动识别或通过购物车ID (`cart_id`)识别。\n\n可在客户端侧和服务器侧管理购物车。\n\n在服务器侧，您可以向购物车添加商品，例如在恢复用户会话时。客户端侧支持以下操作：\n\n* 获取当前用户的购物车或按ID获取购物车\n* 向购物车添加商品\n* 更新购物车中的商品\n* 从购物车中删除商品\n\n如需购买购物车中的商品，请使用客户端和服务器的订单创建调用。\n\n购物车使用场景：\n\n1. 实现商店UI，供用户选择商品。\n2. 当用户在商店中选择商品后，将商品加入购物车，例如使用[向购物车添加商品](https://developers.xsolla.com/zh/api/catalog/cart-client-side/cart-fill)调用。在items数组中，您需要传递SKU和所需的商品数量。\n3. 实现购物车查看UI。当用户进入购物车时，使用[获取当前用户的购物车](https://developers.xsolla.com/zh/api/catalog/cart-client-side/get-user-cart)调用显示购物车内容。响应会返回商品最终价格信息，包括折扣和已应用的促销活动。\n4. 实现支付UI的打开逻辑，以便用户支付订单。例如，您可以使用[创建包含指定购物车中所有商品的订单](https://developers.xsolla.com/zh/api/catalog/payment-client-side/create-order-by-cart-id)调用。响应会返回用于打开支付UI的令牌。\n5. 配置订单状态跟踪，例如使用[Webhook](https://developers.xsolla.com/zh/webhooks/)，以便及时接收已成功支付商品的数据，并向用户发放商品。\n\n<div class=\"note\">\n  <p><b>注：</b></p>\n  <p>如需实现游戏内和线上商品销售，请参阅<a href=\"https://developers.xsolla.com/zh/virtual-goods/own-ui/\">集成指南</a>。</p>\n</div>\n\n![购物车和支付流程](https://cdn.xsolla.net/developers/current/images/api_docs/cart-payment-flow.svg)"},"itemId":"cart-and-payment-overview","disableAutoScroll":true,"metadata":{},"compilationErrors":[],"markdown":{"partials":{},"variables":{"rbac":{"teams":["anonymous"]},"user":{},"remoteAddr":{"hostname":"xsolla.redocly.app","port":4000,"ipAddress":"216.73.216.14"},"lang":"zh","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/zh/api/catalog/cart-and-payment-overview","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}