{"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/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?tabs=100-trackOrderOnClient_200-api&_xm=4170963201673921623)，并正确实现购买后逻辑，例如商品交付。\n\n订单会经历以下状态：\n\n<table>\n  <thead>\n  <tr>\n     <td>状态</td>\n     <td>描述</td>\n     <td>备注</td>\n  </tr>\n  </thead>\n  <tbody>\n    <tr>\n     <td> <code>new</code> </td>\n     <td>订单已创建。系统正在等待付款确认。</td>\n     <td>交易状态说明请参阅<a href=\"https://developers.xsolla.com/zh/api/pay-station/reports/find-transactions#reports/find-transactions/t=request&in=query&path=status\">支付收银台API文档</a>。</td>\n    </tr>\n    <tr>\n     <td> <code>paid</code> </td>\n     <td>订单已支付（交易已流转至<code>done</code>状态），可以向用户发放商品。 </td>\n     <td>在付款确认前，订单会保持<code>new</code>状态。 </td>\n    </tr>\n    <tr>\n     <td> <code>done</code> </td>\n     <td>商品已发放给用户。 </td>\n     <td> — </td>\n    </tr>\n    <tr>\n     <td> <code>canceled</code> </td>\n     <td>付款已退款。 </td>\n     <td>当<a href=\"https://developers.xsolla.com/zh/api/pay-station/reports/find-transactions#reports/find-transactions/t=request&in=query&path=status\">交易状态</a>变更为<code>refunded</code>时，订单会流转至此状态。 </td>\n    </tr>\n    <tr>\n     <td> <code>expired</code> </td>\n     <td> 对于<a href=\"https://developers.xsolla.com/zh/api/catalog/limits-overview\">限购</a>商品、兑换码或促销活动，创建新订单时，任何包含该商品且此前未支付的订单都会流转至<code>expired</code>状态。只有最新订单可以付款。 </td>\n     <td>如果用户尝试支付已过期的订单，支付UI将显示<code>2002</code>错误，付款将失败。 </td>\n    </tr>\n  </tbody>\n</table>\n\n![订单生命周期](https://cdn.xsolla.net/developers/current/images/api_docs/order-life-cycle.svg)\n\n<div class=\"note\">\n  <p><b>注：</b></p>\n  <p>如果用户正在完成付款时订单流转至<code>expired</code>状态，但付款成功，则订单会从<code>expired</code>流转至<code>paid</code>状态。仅当付款后不会超出订单中商品的购买限制时，此规则才适用。</p>\n</div>"},"itemId":"order-life-cycle","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/order-life-cycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}