안녕하세요. 카카오톡 스토어입니다.
톡스토어에 추가상품 설정 기능이 Open API에도 적용될 예정으로 사전 안내 드립니다.
- 적용예정일 : 2026년 9월 9일 (수) 오후중
- 적용 대상 : 톡스토어
추가상품 이란?
- 추가상품은 본상품 구매 시 함께 구매하기 좋은 부가 상품을 등록할 수 있는 기능입니다.
- 예시) 본상품-수영복 / 추가상품-수모, 수경 등
- 추가상품은 반드시 본상품과 함께 구매가능하며, 단독 구매는 불가합니다.
◼︎ 톡스토어 상품 조회/등록/수정
- 상품 조회/등록/수정 시, 추가상품 정보가 추가됩니다.
1) 대상 API
- 상품 등록/수정 : POST /v1/store/product/register, POST /v1/store/product/update
- 상품 조회 : GET /v1/store/product
2) ProductRequest에 필드 추가
| 필드명 | 타입 | 필수여부 | 설명 |
| additionalProduct | AdditionalProduct | 선택 | 추가상품 정보 |
◼︎ 톡스토어 추가상품 조회/등록/수정
- 상품에 등록된 추가상품을 조회/등록/수정할 수 있도록 API가 신규 추가 됩니다.
1) 대상 API
- 추가상품 등록/수정 : POST /v1/store/product/additional-product/update?productId=
- 추가상품 조회 : GET /v1/store/product/additional-product
2) AdditinalProduct 데이터 타입 신규 추가
◼︎ 톡스토어 상품문의 조회
- 추가상품 주문에 대한 문의인 경우, 응답값에 ‘추가상품명 : 추가상품값’ 정보가 포함됩니다.
1) 대상 API
- 상품 문의 조회 : GET /v1/store/qna
2) Qna에 필드 추가
| 필드명 | 타입 | 필수여부 | 설명 |
| additionalProduct | String | 비필수 | 추가상품 주문에 대한 문의인 경우, 추가상품 텍스트 |
◼︎ 주문정보 조회
- 주문 상품이 추가구성상품인 경우, 응답값에 추가구성상품 관련 정보가 포함됩니다.
- 주문정보 조회 시 추가구성상품 정보를 확인할 수 있도록 OrderProduct에 필드가 추가됩니다.
1) 대상 API
- 주문 정보 조회 : GET /v1/shopping/order?order_id={order_id}
- 주문 정보 복수 조회 : GET /v1/shopping/orders/bulk?order_ids={order_ids}
2) OrderProduct에 필드 추가
| 필드명 | 타입 | 설명 |
| additionalSellerItemNo | Long | 추가구성상품의 판매자 자체 관리용 상품번호 (판매자 입력값) |
| additionalSellerItemOptionCode | String | 추가구성상품의 판매자 자체 관리용 옵션 코드 (판매자 입력값) |
| additionalProductName | String | 추가구성 상품명 |
| additionalProductPrice | BigDecimal | 추가구성 상품 판매가 × 주문수량 |
3) 추가 상품 응답 정책
- 아래와 같이 본상품 필드에는 본상품 값이, additional* 필드에는 추가구성상품 값이 담기며, 가격/정산 관련 필드는 추가구성상품 기준으로 계산됩니다.
| 필드명 | 값 | 비고 |
| id | 본상품의 상품 ID | 본상품 정보 |
| name | 본상품의 상품명 | 본상품 정보 |
| additionalProductName | 추가구성 상품명 | 추가상품 정보 |
| additionalSellerItemNo | 판매자 자체 관리용 상품번호 | 추가상품 정보 |
| additionalSellerItemOptionCode | 판매자 자체 관리용 옵션 코드 | 추가상품 정보 |
| quantity | 추가구성상품 주문 수량 | 추가상품 기준 |
| productPrice | 0 | - |
| additionalProductPrice | 추가구성 상품 판매가 × 주문수량 | 추가상품 기준 계산 |
| discountPrice | 추가상품 기준 할인금액 | 추가상품 기준 계산 |
| settlementBasicPrice | 추가상품 기준 정산금액 | 추가상품 기준 계산 |
톡스토어 추가상품 관련한 상세한 정책은 판매자센터 공지사항을 참고해주시기 바라며,
궁금하신 점이 있을 경우 http://kko.to/G5xpSFS4j 을 통해 문의 부탁드립니다.
감사합니다.