Order API 응답 모델

타입은 packages/shared/src/(order-preview-result.ts, order-create-result.ts, trade.ts, logistics-trace.ts)에 있습니다. 모든 금액: fen.

StandardOrderPreviewResult {#standard-order-preview-result}

order preview에서 반환됩니다.

필드	타입	설명
`success`	boolean	결제 총액, 판매자 그룹, 요청 라인, 구매 가능성 및 적용 가능한 거래 방식이 모두 검증된 경우에만 `true`
`total.merchandise`	Money \| null	상품 소계; 실제로 알 수 없을 때만 `null`
`total.payment`	Money	총 결제 금액
`total.shipping`	Money \| null	중국 내 배송비; 알려진 무료 배송은 `amount: 0`인 Money
`sellers[]`	array	판매자별 그룹, `lines[]`와 수수료 포함
`unavailable_lines[]`	array	검증 실패 또는 재고 부족
`trade_types[]`	array	1688 전용
`promotions`	object	존재하는 경우 1688 프로모션
`code` / `message`	string	`LINE_UNAVAILABLE`, `UNSUPPORTED_TRADE_MODE`, `PREVIEW_INCOMPLETE` 등의 선택적 비즈니스 상태
`monetary_unit`	string	standard preview에서는 항상 `CNY_minor`
`request_id`	string	요청 상관 ID

해석 가능하지만 불완전한 standard preview는 HTTP 200과 success:false를 반환합니다. 기존 호환성을 위해 1688의 명시적 SKU, 재고, MOQ 및 마켓 제한 오류는 HTTP 502 CHANNEL_UPSTREAM_ERROR를 유지합니다. response_format:"upstream"에서는 HTTP 200에도 upstream 비즈니스 실패가 포함될 수 있으므로 원본 upstream.success, code, message와 중첩 필드를 확인하세요.

StandardOrderCreateResult {#standard-order-create-result}

필드	타입	설명
`order_id`	string	pay, detail, trace에 사용
`total.payment`	Money	결제할 금액
`order_list[]`	array	하위 주문 / 판매자별 분리
`failed_offers[]`	array	`success: true`에서도 부분 생성 실패 가능
`outer_purchase_id`	string	Taobao 멱등성 키
`payment_url`	string	Taobao 선택적 결제 URL

StandardOrderPayResult {#standard-order-pay-result}

Taobao self 표준 모드는 주문 조회로 결제를 확인한 경우에만 success: true를 반환합니다. code: "0" 또는 기존 성공 응답은 출금 증거가 아닙니다. pending은 Gateway의 미확인 상태이지 공식 대기열 상태가 아닙니다.

필드	설명
`success`	Taobao self 표준 모드: 주문 조회로 결제를 확인한 경우만 true
`pending` / `payment_status`	`success` / `pending` / `failed` / `unknown`
`payment_submission_status`	새 선택 필드: `submitted` / `rejected` / `unknown`
`payment_recovery`	새 선택 필드: `action`, `reason`, `elapsed_seconds`. API
`order_status` / `order_status_raw`	Taobao self
`upstream_request_id`	Taobao self
`pay_channel`	1688
`error_code` / `error_message`	명시적 거절 사유; pending/unknown에서는 없을 수 있음

StandardOrderDetail {#standard-order-detail}

필드	설명
`status`	예: `wait_payment`, `wait_shipment`, `shipped`
`refund_status`	읽기 전용; 환불 API는 공개되지 않음
`amounts`	`total`, `product_total`, `shipping_fee`, `refund`(fen)
`line_items[]`	`sku_specs`, `status`를 포함한 상품 행
`times`	`created_at`, `paid_at`, `shipped_at`, …
`domestic_parcels[]`	창고 모드 → fulfillment

UnifiedLogisticsTrace {#unified-logistics-trace}

domestic trace에서 반환됩니다.

필드	설명
`packages[]`	`tracking_number`, `carrier`, `steps[]`
`cross_border_packages[]`	1688 크로스보더 노드 — 국제 풀필먼트가 아님

StandardOrderCancelResult {#standard-order-cancel-result}

필드	설명
`success`	취소 접수 여부(계속 처리될 수 있음)
`pending`	Taobao 비동기 취소
`sub_order_ids`	부분 취소가 영향을 준 id

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support