릴로
개발자 문서사용자 가이드
커스텀몰 API / 주문 객체 (Order · Item · Shipment)

커스텀몰 API  /  주문 객체

주문 객체 (Order · Item · Shipment)

주문 조회 응답에 들어가는 객체예요. 이름은 카페24와 같고, 릴로 전용 필드는 설명에 ‘확장’이라고 적었어요.

Order

order_idstring필수

주문 번호

order_datestring필수

주문 시각 (ISO 8601)

itemsItem[]필수

주문 품목

member_idstring선택

회원 ID. 비회원 주문이면 빼요

payment_datestring선택

결제 시각

paidstring선택

결제 여부 "T"/"F"

payment_methodstring[]선택

결제 수단 (예: ["card"])

payment_amountstring선택

결제 금액

actual_order_amountobject선택

shipping_fee(배송비), total_amount_due(결제할 금액). 결제 전이라 payment_amount가 0이면 total_amount_due로 안내해요

buyerobject선택

주문자. 이름·연락처는 마스킹

receiversobject[]선택

배송지 name, cellphone, zipcode, address1, address2. 이름·연락처는 마스킹

shipmentsShipment[]선택

배송 정보. 넣으면 배송 조회 엔드포인트를 생략할 수 있어요

currencystring선택

확장. 통화 (없으면 KRW)

status / status_labelstring선택

확장. 릴로 표준 상태와 화면 이름 — 상태 매핑 참고

order_urlstring선택

확장. 고객이 볼 주문 상세 URL

customsobject선택

확장·준비 중. 통관 상태 — 아래 참고

Item

order_item_codestring필수

품목 코드

product_namestring필수

상품 이름

quantitynumber필수

수량

order_statusstring필수

카페24 상태 코드 (예: N30)

product_nostring선택

상품 번호

option_valuestring선택

옵션 (예: Color=Ivory, Size=M)

product_pricestring선택

상품 가격. 실제 단가는 product_price + option_price

option_pricestring선택

옵션 추가 금액

claim_statusstring선택

클레임 상태

shipped_date / delivered_datestring선택

출고·배송 완료 시각

imagestring선택

확장. 상품 사진의 절대 https URL. 빈 문자열은 안 돼요 — 옵션 사진이 없으면 상품 대표 이미지

status / status_labelstring선택

확장. 품목별 릴로 표준 상태와 화면 이름

자주 하는 실수 — 품목 사진이 빈 값

품목 image에는 상품 사진의 절대 https URL을 넣어 주세요. 빈 문자열("")은 안 돼요. 주문한 옵션에 사진이 따로 없으면 그 상품의 대표 이미지를 넣어 주세요. 옵션 ID로만 사진을 찾으면 빈 값이 나오기 쉬워요.

품목 image — 좋은 예 / 나쁜 예
// Good — the option has no photo, so use the product's main image
"image": "https://cdn.mall.example.com/products/77/main.jpg"

// Bad — empty string or relative path
"image": ""
"image": "/products/77/main.jpg"

Shipment

tracking_nostring필수

송장 번호

shipping_company_namestring필수

택배사 이름. 없으면 shipping_company_code(카페24 코드)로 이름을 찾아요

shipping_codestring선택

배송 코드

shipping_company_codestring선택

카페24 택배사 코드

statusstring선택

standby(대기) · shipping(배송중) · shipped(완료)

itemsobject[]선택

이 배송에 담긴 품목의 order_item_code

tracking_urlstring선택

확장. 배송 조회 URL

shipped_datestring선택

확장. 출고 시각

통관 상태 (준비 중)

해외 배송 주문은 customs(확장)에 통관 상태를 넣을 수 있도록 형식을 예약해 두었어요. 릴로가 읽기 시작하면 변경 이력에 알려 드릴게요.

customs 형식
"customs": {
  "status": "pending" | "in_progress" | "duty_required" | "cleared" | "failed",
  "label": "Customs clearance in progress",
  "note": "Duty notice sent by SMS"
}
이전주문 조회다음상태 매핑
주문 객체 (Order · Item · Shipment) · 개발자 문서 | 릴로