# 注文のライフサイクル

注文のライフサイクルを理解することは、[注文の追跡](https://developers.xsolla.com/ja/virtual-goods/own-ui/client-side-token-generation/set-up-order-tracking/?tabs=100-trackOrderOnClient_200-api&_xm=4170963201673921623)や、アイテムの付与といった購入後ロジックの正確な実装に役立ちます。

注文は以下のステータスを遷移します：

<table>
  <thead>
  <tr>
     <td>ステータス</td>
     <td>説明</td>
     <td>備考</td>
  </tr>
  </thead>
  <tbody>
    <tr>
     <td> <code>new</code> </td>
     <td>注文が作成されました。システムは支払い完了の確認を待っています。</td>
     <td>トランザクションステータスの説明は、<a href="https://developers.xsolla.com/ja/api/pay-station/reports/find-transactions#reports/find-transactions/t=request&in=query&path=status">ペイステーションAPIに関するドキュメント</a>で確認できます。</td>
    </tr>
    <tr>
     <td> <code>paid</code> </td>
     <td>注文の支払いが完了し（トランザクションが<code>done</code>ステータスに移行）、ユーザーにアイテムを付与できる状態です</td>
     <td>支払いが確認されるまで、注文は<code>new</code>ステータスのままとなります。</td>
    </tr>
    <tr>
     <td> <code>done</code> </td>
     <td>アイテムがユーザーに付与されました。</td>
     <td> — </td>
    </tr>
    <tr>
     <td> <code>canceled</code> </td>
     <td>支払いが返金されました。</td>
     <td><a href="https://developers.xsolla.com/ja/api/pay-station/reports/find-transactions#reports/find-transactions/t=request&in=query&path=status">トランザクションステータス</a>が<code>refunded</code>に変更されると、注文はこのステータスに移行します。</td>
    </tr>
    <tr>
     <td> <code>expired</code> </td>
     <td> <a href="https://developers.xsolla.com/ja/api/catalog/limits-overview">制限</a> 付きアイテム、プロモーションコード、またはプロモーションに対して新しい注文を作成すると、そのアイテムを含む過去の未払いの注文はすべて<code>expired</code>ステータスに移行します。支払いが可能なのは最新の注文のみです。</td>
     <td>ユーザーが有効期限切れの注文に対して支払いを試みた場合、支払いUIに <code>2002</code> エラーが表示され、決済は失敗します。</td>
    </tr>
  </tbody>
</table>

![注文のライフサイクル](https://cdn.xsolla.net/developers/current/images/api_docs/order-life-cycle.svg)

<div class="note">
  <p><b>注意</b></p>
  <p>ユーザーが支払いを完了する間に注文が<code>expired</code>ステータスに移行した場合でも、決済自体が成功したときは、注文は<code>expired</code>から<code>paid</code>ステータスに移行します。ただし、これが適用されるのは、決済時にその注文アイテムの購入制限数を超えない場合に限られます。</p>
</div>