주문정보 조회 – Kakao Shopping Open API

주문번호 단위의 상세 정보를 제공합니다.

클레임(취소,교환,반품) 정보는 조회시점에 클레임 진행중/완료 상태인 경우에만 조회되며 최종 클레임 정보만 연동됩니다.

요청

GET /v1/shopping/order?order_id={order_id} HTTP/1.1
Content-type: application/json

키	타입	필수여부	설명
order_id	Long	필수	주문번호

응답

<응답바디>

필드명	설명
id	주문번호
orderBase	주문 기본 정보
orderer	주문자 정보
orderProduct	상품 주문 정보
orderDelivery	배송 정보
orderDeliveryRequest	배송지 정보
orderClaimCancel	취소 정보
orderClaimExchange	교환 정보
orderClaimReturn	반품 정보
orderTicket	이용권/e쿠폰 발송 정보
orderTicketReceiver	이용권/e쿠폰 수신자 정보

<응답성공>

예시1) 배송 중 상태

{
  "id": 3000805151,
  "orderBase": {
    "id": 3000805151,
    "paymentId": 3000749085,
    "channelType": "STORE",
    "status": "ShippingProgress",
    "createdAt": "20240604140633",
    "paidAt": "20240604140719",
    "modifiedAt": "20240604145319"
  },
  "orderer": {
    "phoneNumber": "+82 10-1234-1234"
  },
  "orderProduct": {
    "id": 10044612,
    "name": "OPEN API 가이드 상품",
    "sellerItemNo": "",
    "optionContent": "",
    "quantity": 1,
    "productPrice": 7700,
    "optionPrice": 0,
    "sellerDiscountPrice": 300,
    "sellerCouponDiscountPrice": 0,
    "adminDiscountPrice": 0,
    "settlementBasicPrice": 7400,
    "baseFee": 244,
    "displayFee": 0,
    "afCommissionFee": 0,
    "discountFee": 0,
    "refererCode": "",
    "brandName": "카카오",
    "deliveryAmountOriginId": 1460896,
    "deliveryAmountPayPointTime": "PayedToOrder",
    "deliveryAmountType": "PAID",
    "deliveryAmount": 2500,
    "areaAdditionalDeliveryAmount": 0
  },
  "orderDeliveryRequest": {
    "receiverName": "홍길동",
    "receiverAddress": "경기 성남시 분당구 판교역로 166 (백현동, 카카오 판교 아지트) 카카오",
    "receiverAddress1": "경기 성남시 분당구 판교역로 166 (백현동, 카카오 판교 아지트)",
    "receiverAddress2": "카카오",
    "receiverPhoneNumber": "",
    "receiverMobileNumber": "010-1234-1234",
    "zipcode": "13529",
    "roadZipCode": "13529",
    "requirement": ""
  },
  "orderDelivery": {
    "deliveryRequestAt": "20240604140719",
    "confirmedAt": "20240604145301",
    "invoiceRegisteredAt": "20240604145319",
    "shippingMethod": "SHIPPING",
    "deliveryCompanyCode": "CJGLS",
    "invoiceNumber": "1234567890"
  }
}

예시2) 결제 취소 완료 상태 (주문 확인 전)

{
  "id": 345277571,
  "orderBase": {
    "id": 345277571,
    "paymentId": 1237291,
    "channelType": "STORE",
    "talkDealOrder": "Y",
    "groupDiscountRoomId": 1234567891,
    "status": "PayCancelComplete",
    "createdAt": "20220811173009",
    "paidAt": "20220811173014",
    "canceledAt": "20220811190851",
    "modifiedAt": "20220811190851"
  },
  "orderer": {
    "phoneNumber": "+82 140****23"
  },
  "orderProduct": {
    "id": 10023832,
    "name": "샌박66d18c00 모던 사각 물빠짐 수저통 1+1(+행주1P) 외 리빙용품24종 /3개이",
    "sellerItemNo": "",
    "optionContent": "",
    "quantity": 1,
    "productPrice": 20000,
    "optionPrice": 0,
    "sellerDiscountPrice": 14100,
    "sellerCouponDiscountPrice": 0,
    "adminDiscountPrice": 0,
    "settlementBasicPrice": 5900,
    "baseFee": 590,
    "displayFee": 0,
    "afCommissionFee": 0,
    "discountFee": 0,
    "refererCode": "",
    "brandName": "",
    "deliveryAmountOriginId": 1383915,
    "deliveryAmountPayPointTime": "PayedToOrder",
    "deliveryAmountType": "FREE",
    "deliveryAmount": 0,
    "areaAdditionalDeliveryAmount": 0
  },
  "orderDeliveryRequest": {
    "receiverName": "테***",
    "receiverAddress": "경기 성남시 분당구 ***로 166 ***",
    "receiverAddress1": "경기 성남시 분당구 ***로 166",
    "receiverAddress2": "***",
    "receiverPhoneNumber": "",
    "receiverMobileNumber": "010-99**-**77",
    "zipcode": "13***",
    "roadZipCode": "13***",
    "requirement": ""
  },
  "orderDelivery": {
    "deliveryRequestAt": "20220811173015",
    "shippingMethod": "SHIPPING"
  }
}

예시3) 결제 취소 완료 상태 (주문 확인 후 )

{
  "id": 3000805512,
  "orderBase": {
    "id": 3000805512,
    "paymentId": 3000749348,
    "channelType": "STORE",
    "status": "ShippingCancelComplete",
    "createdAt": "20240604181704",
    "paidAt": "20240604181715",
    "canceledAt": "20240604182006",
    "modifiedAt": "20240604182006"
  },
  "orderer": {
    "phoneNumber": "+82 10-1234-1234"
  },
  "orderProduct": {
    "id": 10044612,
    "name": "OPEN API 가이드 상품",
    "sellerItemNo": "",
    "optionContent": "",
    "quantity": 1,
    "productPrice": 7700,
    "optionPrice": 0,
    "sellerDiscountPrice": 300,
    "sellerCouponDiscountPrice": 0,
    "adminDiscountPrice": 0,
    "settlementBasicPrice": 7400,
    "baseFee": 244,
    "displayFee": 0,
    "afCommissionFee": 0,
    "discountFee": 0,
    "refererCode": "",
    "brandName": "카카오",
    "deliveryAmountOriginId": 1461151,
    "deliveryAmountPayPointTime": "PayedToOrder",
    "deliveryAmountType": "PAID",
    "deliveryAmount": 2500,
    "areaAdditionalDeliveryAmount": 0
  },
  "orderDeliveryRequest": {
    "receiverName": "이*",
    "receiverAddress": "경기 성남시 분당구 ***로 166 ***",
    "receiverAddress1": "경기 성남시 분당구 ***로 166",
    "receiverAddress2": "***",
    "receiverPhoneNumber": "",
    "receiverMobileNumber": "010-94**-**32",
    "zipcode": "13***",
    "roadZipCode": "13***",
    "requirement": ""
  },
  "orderDelivery": {
    "deliveryRequestAt": "20240604181715",
    "confirmedAt": "20240604181838",
    "shippingMethod": "SHIPPING"
  },
  "orderClaimCancel": {
    "claimId": 68470,
    "claimItemId": 89352,
    "claimItemStatus": "ShippingCancelComplete",
    "referType": "FRONT",
    "createdAt": "20240604181950",
    "modifiedAt": "20240604182007",
    "reasonCodeId": 1,
    "reasonCodeName": "구매의사취소",
    "reasonComment": "배송 전 취소요청합니다."
  }
}

예시4) 교환 완료 상태

{
  "id": 3000805154,
  "orderBase": {
    "id": 3000805154,
    "paymentId": 3000749088,
    "channelType": "STORE",
    "status": "ExchangeShippingComplete",
    "createdAt": "20240604140813",
    "paidAt": "20240604140835",
    "modifiedAt": "20240604170401"
  },
  "orderer": {
    "phoneNumber": "+82 10-1234-1234"
  },
  "orderProduct": {
    "id": 10044612,
    "name": "OPEN API 가이드 상품",
    "sellerItemNo": "",
    "optionContent": "",
    "quantity": 1,
    "productPrice": 7700,
    "optionPrice": 0,
    "sellerDiscountPrice": 300,
    "sellerCouponDiscountPrice": 0,
    "adminDiscountPrice": 0,
    "settlementBasicPrice": 7400,
    "baseFee": 244,
    "displayFee": 0,
    "afCommissionFee": 0,
    "discountFee": 0,
    "refererCode": "",
    "brandName": "카카오",
    "deliveryAmountOriginId": 1460899,
    "deliveryAmountPayPointTime": "PayedToOrder",
    "deliveryAmountType": "PAID",
    "deliveryAmount": 2500,
    "areaAdditionalDeliveryAmount": 0
  },
  "orderDeliveryRequest": {
    "receiverName": "홍길동",
    "receiverAddress": "경기 성남시 분당구 판교역로 166 (백현동, 카카오 판교 아지트) 카카오",
    "receiverAddress1": "경기 성남시 분당구 판교역로 166 (백현동, 카카오 판교 아지트)",
    "receiverAddress2": "카카오",
    "receiverPhoneNumber": "",
    "receiverMobileNumber": "010-1234-1234",
    "zipcode": "13529",
    "roadZipCode": "13529",
    "requirement": "빨리 배송해주세요!plz"
  },
  "orderDelivery": {
    "deliveryRequestAt": "20240604140835",
    "confirmedAt": "20240604145301",
    "invoiceRegisteredAt": "20240604145319",
    "deliveredAt": "20240425171900",
    "shippingMethod": "SHIPPING",
    "deliveryCompanyCode": "CJGLS",
    "invoiceNumber": "1234567890"
  },
  "orderClaimExchange": {
    "claimId": 68430,
    "claimItemId": 89312,
    "claimItemStatus": "SHIPPING_COMPLETE",
    "claimRequestUser": "구매자",
    "reasonCodeId": 17,
    "reasonCodeName": "변심에 의한 상품 교환",
    "reasonComment": "사유:교환테스트",
    "referType": "SELLER",
    "createdAt": "20240604165120",
    "modifiedAt": "20240604170401",
    "completedAt": "20240604170401",
    "returnAddressId": 140148,
    "returnMethod": "택배",
    "collectType": "SELLER",
    "pickupName": "홍**",
    "pickupZipCode": "13***",
    "pickupRoadZipCode": "13***",
    "pickupAddress1": "경기 성남시 분당구 ***로 166 (**동, 카카오 판교 아지트)",
    "pickupAddress2": "***",
    "pickupMobileNumber": "010-****-1234",
    "pickupPhoneNumber": "",
    "exchangeName": "홍**",
    "exchangeZipCode": "13***",
    "exchangeRoadZipCode": "13***",
    "exchangeAddress1": "경기 성남시 분당구 ***로 166 (**동, 카카오 판교 아지트)",
    "exchangeAddress2": "***",
    "exchangeMobileNumber": "010-****-1234",
    "exchangePhoneNumber": "",
    "exchangeMethod": "SHIPPING",
    "exchangeDeliveryCompanyId": 2,
    "exchangeDeliveryCompanyCode": "CJGLS",
    "exchangeInvoiceNumber": "0123456789",
    "exchangeShippingFee": 6000,
    "exchangeShippingFeeMethod": "DirectAmount",
    "exchangeShippingFeeMethodLabel": "판매자에게 직접 송금"
  }
}

예시5) 반품 결제 취소 완료 상태

{
  "id": 3000805166,
  "orderBase": {
    "id": 3000805166,
    "paymentId": 3000749099,
    "channelType": "STORE",
    "status": "ReturnCancelComplete",
    "createdAt": "20240604141534",
    "paidAt": "20240604141705",
    "canceledAt": "20240604170421",
    "modifiedAt": "20240604170421"
  },
  "orderer": {
    "phoneNumber": "+82 10-1234-1234"
  },
  "orderProduct": {
    "id": 10044612,
    "name": "OPEN API 가이드 상품",
    "sellerItemNo": "",
    "optionContent": "",
    "quantity": 1,
    "productPrice": 7700,
    "optionPrice": 0,
    "sellerDiscountPrice": 300,
    "sellerCouponDiscountPrice": 0,
    "adminDiscountPrice": 0,
    "settlementBasicPrice": 7400,
    "baseFee": 244,
    "displayFee": 0,
    "afCommissionFee": 0,
    "discountFee": 0,
    "refererCode": "",
    "brandName": "카카오",
    "deliveryAmountOriginId": 1460911,
    "deliveryAmountPayPointTime": "PayedToOrder",
    "deliveryAmountType": "PAID",
    "deliveryAmount": 6000
  },
  "orderDeliveryRequest": {
    "receiverName": "홍**",
    "receiverAddress": "경기 성남시 분당구 ***로 166 ***",
    "receiverAddress1": "경기 성남시 분당구 ***로 166",
    "receiverAddress2": "***",
    "receiverPhoneNumber": "",
    "receiverMobileNumber": "010-12**-**34",
    "zipcode": "13***",
    "roadZipCode": "13***",
    "requirement": "빨리 배송해 주세요!"
  },
  "orderDelivery": {
    "deliveryRequestAt": "20240604141705",
    "confirmedAt": "20240604145301",
    "invoiceRegisteredAt": "20240604145319",
    "deliveredAt": "20240425171900",
    "shippingMethod": "SHIPPING",
    "deliveryCompanyCode": "CJGLS",
    "invoiceNumber": "1234567890"
  },
  "orderClaimReturn": {
    "claimId": 68441,
    "claimItemId": 89323,
    "claimItemStatus": "RETURN_CANCEL_COMPLETE",
    "reasonCodeId": 8,
    "reasonCodeName": "변심에 의한 구매의사 취소",
    "reasonComment": "",
    "referType": "SELLER",
    "createdAt": "20240604170345",
    "modifiedAt": "20240604170421",
    "completedAt": "20240604170421",
    "returnAddressId": 140148,
    "returnMethod": "택배",
    "returnDeliveryCompanyId": 2,
    "returnDeliveryCompanyCode": "CJGLS",
    "returnInvoiceNumber": "0123456789",
    "returnShippingFee": 6000,
    "returnShippingFeeMethod": "Deducted",
    "returnShippingFeeMethodLabel": "환불금에서 차감",
    "collectType": "SELLER",
    "pickupName": "홍**",
    "pickupZipCode": "13***",
    "pickupRoadZipCode": "13***",
    "pickupAddress1": "경기 성남시 분당구 ***로 166 (**동, 카카오 판교 아지트)",
    "pickupAddress2": "***",
    "pickupMobileNumber": "010-****-1234",
    "pickupPhoneNumber": ""
  }
}

예시 6) 해외배송 주문

{
"id": 0,
"orderBase": {
"id": 0,

... 생략...

"orderDeliveryRequest": {
"receiverName": "string",
"receiverAddress": "string",
"receiverAddress1": "string",
"receiverAddress2": "string",
"receiverPhoneNumber": "string",
"receiverMobileNumber": "string",
"zipcode": "string",
"roadZipCode": "string",
"requirement": "string",
"personalClearanceCode": "Strinag"
 },
"orderDelivery": {
"deliveryRequestAt": "2024-11-01T04:50:31.235Z",
"confirmedAt": "2024-11-01T04:50:31.235Z",
"invoiceRegisteredAt": "2024-11-01T04:50:31.235Z",
"deliveredAt": "2024-11-01T04:50:31.235Z",
"shippingMethod": "SHIPPING",
"deliveryCompanyCode": "CJGLS",
"invoiceNumber": "string",
"isInternational":true
 },
"orderClaimCancel": {
"claimId": 0,

... 생략...
}

<응답실패>

{
	"code": -800,
	"msg": "카카오톡 스토어 에러입니다.",
	"extras": {
		"error_message": "해당 주문정보에 접근할수 없습니다.",
		"error_code": -23005,
		"error_category": "order"
	}
}

이 섹션의 문서

요청

응답

관련 문서