주문 상세

주문번호(order_number)​​로 단일 주문의 상세 정보를 조회해요.

API 엔드포인트

요청 파라미터

코드 예제

const { BootpayCommerce } = require('@bootpay/backend-js')

const commerce = new BootpayCommerce({
    client_key: 'your-commerce-client-key',
    secret_key: 'your-commerce-secret-key',
    mode: 'production'
})

const response = await commerce.order.detail('25071182085082524116')
console.log(response)javascript

from bootpay_backend import BootpayCommerce

commerce = BootpayCommerce(
    client_key='your-commerce-client-key',
    secret_key='your-commerce-secret-key',
    mode='production'
)

response = commerce.order.detail('25071182085082524116')
print(response)python

use Bootpay\ServerPhp\BootpayCommerceApi;

$commerce = new BootpayCommerceApi('your-commerce-client-key', 'your-commerce-secret-key');
$response = $commerce->order->detail('25071182085082524116');
print_r($response);php

import kr.co.bootpay.store.BootpayStore;
import kr.co.bootpay.store.model.request.TokenPayload;
import kr.co.bootpay.store.model.response.BootpayStoreResponse;

TokenPayload tp = new TokenPayload("your-commerce-client-key", "your-commerce-secret-key");
BootpayStore commerce = new BootpayStore(tp).withToken();

BootpayStoreResponse response = commerce.order.detail("25071182085082524116");
System.out.println(response);java

require 'bootpay'

commerce = BootpayStore::RestClient.new(client_key: 'your-commerce-client-key', secret_key: 'your-commerce-secret-key')
response = commerce.order_detail(
  order_number: '25071182085082524116'
)
puts responseruby

import "github.com/bootpay/backend-go/v2"

commerce := bootpay.NewCommerceApi("your-commerce-client-key", "your-commerce-secret-key")
response, err := commerce.Order.Detail("25071182085082524116")
fmt.Println(response)go

using Bootpay.Commerce;

var commerce = new BootpayCommerceApi("your-commerce-client-key", "your-commerce-secret-key");
var response = await commerce.Order.Detail("25071182085082524116");
Console.WriteLine(response);csharp

응답

성공 응답

{
  "order_name": "Professional 플랜",
  "order_number": "25071182085082524116",
  "request_id": "your-order-draft-id",
  "price": 29900,
  "tax_free_price": 0,
  "status": "payment_completed",
  "receipt_status": "receipt_success",
  "receipt_id": "68707c598bbe23d076af189c",
  "purchased_at": "2025-07-11T10:30:00Z",
  "user": {
    "user_id": "67e4b4425ec892162491d0ec",
    "name": "홍길동",
    "email": "user@example.com",
    "phone": "01012345678"
  },
  "result_data": {
    "receipt_id": "receipt_abc123",
    "method_name": "카드결제",
    "card_name": "삼성카드",
    "card_no": "9430-****-****-1234"
  },
  "products": [
    {
      "product_id": "67c95e64d01640bb9859c629",
      "name": "Professional 플랜",
      "quantity": 1,
      "price": 29900
    }
  ],
  "order_purchases": [
    {
      "order_purchase_id": "6870824fb0eacea5cd974f12",
      "order_purchase_number": "P25071182085082524116",
      "status": 4,
      "delivery_company_code": "CJGLS",
      "tracking_number": "620148310301",
      "d_ts": 3,
      "sent_at": "2025-07-12T09:10:00Z",
      "tracking_histories": [
        {
          "trakler_status": "in_transit",
          "delivery_tracking_status": 3,
          "location": "옥천HUB",
          "description": "간선상차 · CJ대한통운",
          "occurred_at": "2025-07-12T21:40:00Z",
          "source": "webhook"
        }
      ]
    }
  ],
  "created_at": "2025-07-11T10:25:00Z"
}json

에러 응답

HTTP 상태 코드(404)는 헤더로 오고, 본문에는 코드 이름이 문자열로 와요.

{
  "error_code": "ORDER_NOT_FOUND",
  "message": "주문내역을 찾지 못했습니다."
}json

응답 필드 설명

발주(배송) 필드

한 주문이 여러 건으로 나뉘어 나가면 order_purchases도 그만큼 늘어요. 운송장은 발주 단위예요.

결제(영수증) 상태 (receipt_status)

자주 쓰는 값만 추렸어요. 전체 값은 결제(영수증) 상태에 있어요. 응답의 상태 값은 영문 enum 문자열이에요.

주문 상태 코드 (status)

에러 코드