구매결정된 주문 단건에 대하여 정산 상세 정보를 제공합니다.
구매결정일+1일 오전 9시부터 조회 가능하며, 데이터 대사 등의 상황으로 +/- 시간편차는 존재할 수 있습니다.
* 공통헤더영역의 channel-ids을 통해 채널별 검색이 가능합니다.
채널ID는 1(선물하기), 101(톡스토어)로 설정 가능하며, 채널값을 입력하지 않을 경우 정산 데이터 조회가 불가한 점 참고 부탁드립니다.
요청
GET /v1/shopping/settlement/details/order?page=0&size=500&orderId={orderId}
HTTP/1.1
Content-type: application/json| 키 | 타입 | 필수여부 | 설명 |
|---|---|---|---|
| page | Integer | X | 요청 페이지 번호. 기본값 1 |
| size | Integer | X | 요청 페이지당 데이터 수. 기본값 500 최대 1000 |
| orderId | Long | 필수 | 주문번호 조회 값 |
응답
<응답바디>
| 필드명 | 타입 | 설명 |
|---|---|---|
| paymentId | Long | 결제번호 |
| originDeliveryAmountId | Long | 최초배송비번호 |
| orderId | Long | 주문번호 |
| settlementType | SettlementType | 주문상태 |
| settlementTermType | SettlementTermType | 정산주기 |
| settlementBaseDate | String |
정산기준일 : ‘구매결정일’ 또는 ‘구매결정 후 취소/환불일’ |
| settlementConfirmDate | String |
정산확정일 : 정산주기에 따라 판매대금이 확정되는 일자
- 톡스토어(일1회) : 정산기준일+1일+1영업일 - 선물하기(월1회) : 정산기준일 당월 1일~말일 => 다음월 1일 - 선물하기(월2회) : 정산기준일 당월 1일~15일 => 당월 16일 정산기준일 당월 16일~말일 => 다음월 1일 |
| channelName | String | 채널 [선물하기/톡스토어] |
| productItemId | Long | 상품번호 |
| productName | String | 상품명 |
| sellerId | Long | 판매자번호 |
| sellerName | String | 판매자명 |
| payMainMethod | PayMainMethod | 결제수단 |
| productStandardAmount | BigDecimal | 상품주문금액 |
| sellerTotalDiscountAmount | BigDecimal | 판매자할인금액합계 (*2025/5/28 필드명 변경) |
| productSellerDiscountAmount |
BigDecimal | 판매자즉시할인 (*2025/5/28 신규값) |
| SellerDiscountSpreadAmount | BigDecimal | 소문내기판매자할인 |
| groupDiscountAmount | BigDecimal | 톡딜할인 |
| sellerCouponDiscountAmount | BigDecimal | 판매자할인쿠폰 |
| digitalCardDiscountAmount | BigDecimal | 인증할인 |
| sellerCartCouponAmount | BigDecimal | 판매자장바구니할인쿠폰 |
| settlementBaseAmount | BigDecimal |
정산기준금액 : 수수료를 산정하는 기준금액
= 상품주문금액-판매자할인금액 |
| deliveryAmount | BigDecimal | 선불배송비 |
| returnDeliveryAmount | BigDecimal | 반품배송비 |
| orderQuantity | Long | 수량 |
| commissionTotalRate | BigDecimal | 수수료율합계 |
| commissionTotalAmount | BigDecimal |
수수료합계 : 주문 건에 대해 산정된 최종수수료
= 기본수수료+추가수수료 |
| settlementConfirmAmount | BigDecimal |
판매정산금액 : 주문 건에 대해 산정된 정산금액
= 정산기준금액-수수료합계 |
| orderAdminTotalDiscountAmount | BigDecimal | 카카오할인금액합계 |
예시
<응답성공>
- 요청
GET /v1/shopping/settlement/details/order?orderId=3000126952
HTTP/1.1
Content-type: application/json
- 응답값
{
"contents": [
{
"paymentId": 3000111317,
"originDeliveryAmountId": 1417557,
"orderId": 3000142429,
"settlementType": "DeliveryItemDecision",
"settlementTermType": "Daily",
"settlementBaseDate": "2023-08-31",
"settlementConfirmDate": "2023-09-04",
"channelName": "카카오톡 스토어",
"productItemId": "10032203",
"productName": "[쇼핑하기 영중소 수수료할인 확대 테스트]영세 판매자",
"sellerId": 10000876,
"sellerName": "정산테스트5",
"payMainMethod": "Card",
"productStandardAmount": 10000,
"sellerTotalDiscountAmount": 7000,
"productSellerDiscountAmount": 1000,
"sellerDiscountSpreadAmount": 500,
"groupDiscountAmount": 300,
"sellerCouponDiscountAmount": 2000,
"digitalCardDiscountAmount": 200,
"sellerCartCouponAmount": 3000,
"settlementBaseAmount": 9000,
"deliveryAmount": 0,
"returnDeliveryAmount": 0,
"orderQuantity": 1,
"commissionTotalRate": 1.67,
"commissionTotalAmount": 151,
"settlementConfirmAmount": 8849,
"orderAdminTotalDiscountAmount": 0
}
],
"last": true,
"totalCount": 1,
"condition": {
"page": 1,
"size": 500,
"orderId": 3000142429
}
}