배송추적 조회

주문에 딸린 발주(배송) 단위​​로 운송장·택배사·배송추적 상태와 추적 이력을 조회해요.

발송처리로 운송장을 넣으면 그 뒤 택배사가 알려주는 단계는 Bootpay가 자동으로 모아요. 서비스 서버는 택배사를 직접 조회할 필요 없이 이 API만 읽으면 돼요.

Basic 인증과 user:order_detail scope가 필요해요. 구매자 화면에서는 Bootpay-User-JWT 또는 secretKey 인증의 user_id를 지정하면 그 회원의 주문만 조회해요. 필드와 오류 전체는 주문 API 원문를 확인해요.

API 엔드포인트

요청 파라미터

코드 예제

curl -X GET "https://api.bootapi.com/v1/orders/25071182085082524116/purchases" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

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.get('orders/25071182085082524116/purchases')
console.log(response)javascript

응답

성공 응답

[
  {
    "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"
      }
    ]
  }
]json

필드 설명은 주문 상세와 같아요.

추적 단계 읽는 법

d_ts는 택배사가 알려준 단계​​예요. 값은 커머스 Enum에서 확인해요.

에러 코드