> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# AceDataCloud 플랫폼 주문 상세 조회

> Platform API guide - Ace Data Cloud

주문 ID로 주문을 조회합니다. 이 엔드포인트는 두 가지 읽기 모드를 지원합니다: 익명 액세스는 결제 페이지에 필요한 최소 필드만 반환하며, 주문 소유자가 Account Token을 지참한 경우 전체 상세 정보를 반환합니다.

## 인터페이스 개요

| 항목 | 내용 |
| - | - |
| 메서드 | `GET` |
| URL | `https://platform.acedata.cloud/api/v1/orders/{order_id}` |
| 인증 | 선택 사항; 익명은 최소 프로젝션, 인증된 소유자는 전체 프로젝션 |

`/orders/{id}` 및 `/orders/{id}/`는 현재 모두 사용할 수 있습니다. 주문 ID는 결제 링크의 일부이며, 민감한 불투명 식별자로 간주해야 하므로 공개적으로 전파하지 마십시오.

## 익명 조회

결제 페이지는 로그인 상태가 손실된 경우 직접 읽을 수 있습니다:

```shell theme={null}
export ORDER_ID='당신의 주문 ID'
curl "https://platform.acedata.cloud/api/v1/orders/${ORDER_ID}" \
  -H 'Accept: application/json'
```

익명 응답에는 `id`, `description`, `price`, `state`, `pay_way`, `pay_url`, `expired_at`, `created_at`만 포함됩니다. 계정, Application, Package, 결제 내부 식별자 또는 metadata는 반환하지 않습니다.

## 인증된 조회

```shell theme={null}
export PLATFORM_TOKEN='당신의 계정 토큰'
curl "https://platform.acedata.cloud/api/v1/orders/${ORDER_ID}" \
  -H 'Accept: application/json' \
  -H "Authorization: Bearer ${PLATFORM_TOKEN}"
```

주문 소유자는 `application` / `applications`, `package` / `packages`, `bank_details`, `invoice_automation` 및 모델 필드를 포함한 전체 Order 상세 정보를 받습니다. 인증되었지만 주문 소유자가 아닌 경우 `403`을 반환합니다; 슈퍼 관리자는 제외됩니다.

## 주요 필드

| 필드 | 설명 |
| - | - |
| `state` | `Pending`, `Paid`, `Finished`, `Expired`, `Failed` 또는 `Refunded` |
| `pay_way` | 주문의 현재 결제 방식; 필드명은 `payment_method`가 아닙니다 |
| `pay_url` | 호스팅된 결제 페이지 또는 QR 코드 주소이며, 비어 있을 수 있습니다 |
| `price` | 주문의 최종 결제 금액이며, 현재 주문 모델은 `final_price` 필드를 제공하지 않습니다 |
| `amount` | 패키지 할당량 수량; 인증된 전체 응답에서만 확인할 수 있습니다 |
| `finished_at` | 주문 완료 시간; 필드명은 `paid_at`가 아닙니다 |

전체 응답은 결제 방식에 따라 추가 필드를 포함할 수 있으므로, 클라이언트는 필요에 따라 읽어야 하며 전체 응답의 민감한 metadata를 기록하지 않도록 항상 주의해야 합니다.

## 오류 처리

* `404`: 주문 ID가 존재하지 않습니다.
* `403`: 로그인되었지만 주문 소유자가 아닙니다.
* 익명 요청은 `401`을 반환하지 않습니다; 최소 공개 프로젝션만 받습니다.

## 관련 인터페이스

* [주문 목록 조회](https://platform.acedata.cloud/documents/platform-order-list)
* [충전 주문 생성](https://platform.acedata.cloud/documents/platform-order-create)
* [주문 결제](https://platform.acedata.cloud/documents/platform-order-pay)
* [주문 상태 새로고침](https://platform.acedata.cloud/documents/platform-order-refresh)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.