Order API

주문 API

quote 기반으로 주문을 생성하고, 주문 상태를 조회하는 외부 고객사 전용 API입니다. 주문 생성과 상태 조회는 반드시 함께 구현해야 합니다.

제공 엔드포인트

POST /api/v1/orders — 주문 생성
GET /api/v1/orders/{orderId} — 주문 상태 조회
GET /api/v1/orders — 주문 목록 조회

핵심 제약

주문 생성은 반드시 quoteId 기반이어야 합니다.
Idempotency-Key 헤더가 필요합니다.
개발자 계정에 빌링카드가 등록되어 있어야 합니다.
등록 카드 결제 성공 후에만 배차를 요청합니다.
배차 접수 실패 시 원 결제를 자동으로 전액 취소합니다.

주문 생성 예시

JSON 요청

{
  "quoteId": "qt_xxxxx",
  "serviceType": "standard",
  "senderName": "홍길동",
  "senderPhone": "01011112222",
  "receiverName": "김철수",
  "receiverPhone": "01033334444",
  "clientOrderId": "partner-order-1001"
}

응답 예시

JSON 응답

{
  "success": true,
  "data": {
    "orderId": "ord_xxxxx",
    "orderNumber": "4150",
    "status": "confirmed",
    "paymentStatus": "paid",
    "providerStatus": "ordered",
    "payment": {
      "mode": "registered_billing_card",
      "charged": true
    }
  }
}