{"templateId":"openapi_docs","sharedDataIds":{"openAPIDocsStore":"oas-@l10n/ko/api/catalog/index.yaml","sidebar":"sidebar-@l10n/ko/catalog-en.sidebars.yaml"},"props":{"definitionId":"@l10n/ko/api/catalog/index.yaml","dynamicMarkdocComponents":[],"baseSlug":"/ko/api/catalog","seo":{"title":"주문 수명 주기","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"주문 수명 주기를 이해하면 [주문을 추적](https://developers.xsolla.com/ko/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/ko/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/ko/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/ko/api/catalog/limits-overview\">한정</a> 아이템, 프로모션 코드 또는 프로모션에 대한 새 주문을 생성하면 해당 아이템이 포함된 기존 미결제 주문은 모두 <code>expired</code> 상태로 변경됩니다. 가장 최근에 주문한 상품에 대해서만 결제가 가능합니다. </td>\n     <td>사용자가 만료된 주문에 대해 비용 결제를 시도하면 <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.217.32"},"lang":"ko","env":{"PUBLIC_REDOCLY_BRANCH_NAME":"realm"}}},"pagePropGetterError":{"message":"","name":""}},"slug":"/ko/api/catalog/order-life-cycle","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}