샵바이 API 운영자 점검: 7월 정기 업데이트 8건의 응답값·파라미터 변경

한 줄 결론

NHN커머스 샵바이(shop by) 솔루션을 이용하는 쇼핑몰을 대상으로, 기획전 카테고리 필터링, 쿠폰 번호 및 명칭 응답, 관련 상품 재고 수량 확인 등 프론트엔드 커스텀 및 운영 효율성을 높일 수 있는 8건의 API 정기 업데이트가 2026년 7월 1일 자로 배포 완료되었습니다.

적용 대상 빠른 판별

공식 자료로 확인된 변경 내용

2026년 7월 1일 자로 배포된 샵바이(shop by) 정기 업데이트는 총 8건이며, 주로 프론트엔드에서 호출하는 Shop API와 백엔드에서 호출하는 Server API의 응답값 및 파라미터 추가로 구성되어 있습니다. 이를 통해 쇼핑몰 운영자는 고객에게 더욱 정교한 쇼핑 경험을 제공할 수 있습니다. 상세한 변경 내역은 다음과 같습니다.

1. 기획전 섹션 상품 조회 API 개선 (카테고리 응답값 및 필터 추가)

• 대상 API: shop API [GET] /display/events/{eventNo}/sections/{sectionNo}
• 상세 내용: 기획전 내 상품을 진열하고 조회할 때, 요청 파라미터와 필터가 새롭게 추가되었습니다. 추가된 요청 파라미터는 displayCategoryNos, categoryViewType이며, 필터로는 displayCategoryInfo, multiLevelCategories, flatCategories가 포함됩니다.
• 실무 활용: 이를 통해 대규모 기획전 페이지 내에서 특정 카테고리에 속한 상품만 세밀하게 필터링하여 노출하는 탭(Tab) 기능이나 카테고리 네비게이션 기능을 자체적으로 구현할 수 있게 되었습니다.

2. 추가상품 조회 API 개선 (추가상품 전용 여부 응답값 추가)

• 대상 API: shop API [GET] /products/{productNo}/extra-products
• 상세 내용: 본 상품에 딸린 추가상품을 조회할 때, 해당 상품이 ‘추가상품 전용’인지 여부를 식별할 수 있는 extraProductOnly 응답 파라미터가 추가되었습니다.
• 실무 활용: 장바구니나 상품 상세 페이지에서 추가상품이 단독으로 결제되는 것을 방지하고, 본 상품과 함께 구매해야만 하는 종속적인 상품임을 프론트엔드 로직에서 명확히 제어할 수 있습니다.

3. 상품 진열 API 개선 (스티커명 응답값 추가)

• 대상 API: shop API [GET] /display/sections/{sectionNo}/products, [GET] /display/sections/ids/{sectionId}/products
• 상세 내용: 진열 번호나 진열 ID로 상품 상세 정보를 조회할 때, 상품에 부착된 스티커의 이름(products[].stickerInfos[].name)을 응답값으로 받을 수 있도록 개선되었습니다.
• 실무 활용: 기존에는 이미지 형태의 스티커만 처리하기 용이했다면, 이제는 텍스트 기반의 스티커 UI를 렌더링하거나 스티커 명칭(예: ‘MD추천’, ‘무료배송’)을 활용한 마케팅 강조 및 검색 필터링이 용이해집니다.

4. 상품 상세 및 검색 API 개선 (쿠폰번호 응답값 추가)

• 대상 API: shop API [GET] /products/{productNo}, /products/search, /products/search-by-nos, /products/best-seller/search, /products/best-review/search, /profile/recent-products, /profile/like-products, /products/bundle-shipping
• 상세 내용: 상품 조회 시 최대 쿠폰 할인 금액(maxCouponNo)과 일반 쿠폰 할인 금액(discountCouponNo)에 해당하는 정확한 ‘쿠폰번호’가 응답 파라미터로 추가되었습니다.
• 실무 활용: 고객이 상품 목록이나 상세 페이지를 볼 때, 단순히 ‘최대 할인가’만 보여주는 것을 넘어 “어떤 쿠폰을 다운로드하고 적용해야 해당 할인가가 나오는지” 명확히 추적하고 안내하는 UI를 구성할 수 있습니다.

5. 관련상품 조회 API 개선 (재고수량 응답값 추가)

• 대상 API: shop API [GET] /products/{productNo}/related-products
• 상세 내용: 특정 상품의 관련 상품 정보를 조회할 때, 해당 관련 상품의 재고수량(stockCnt)이 응답값에 포함됩니다.
• 실무 활용: 품절된 관련 상품을 프론트엔드에서 자동으로 숨기거나, ‘품절 임박’ 등의 뱃지 UI를 관련 상품 추천 영역에도 즉각적으로 반영하여 고객의 헛걸음을 방지하고 구매 전환율을 높일 수 있습니다.

6. CI 중복확인하기 API 개선 (탈퇴회원 탐지)

• 대상 API: shop API [GET] /profile/ci/exists
• 상세 내용: 회원의 본인인증 CI(연계정보) 중복을 확인하는 API가 개선되어, 기존 가입자뿐만 아니라 ‘탈퇴회원’의 CI 중복 여부까지 탐지하도록 수정되었습니다.
• 실무 활용: 신규 가입 혜택(쿠폰, 포인트 등)을 노리고 탈퇴 후 즉시 재가입하는 어뷰징 행위를 원천적으로 차단하고, 쇼핑몰의 재가입 제한 정책(예: 탈퇴 후 30일간 재가입 불가)을 시스템적으로 완벽하게 통제할 수 있습니다.

7. 쿠폰 발급 API 개선 (쿠폰명 응답값 추가)

• 대상 API: server API [POST] /coupons/issues
• 상세 내용: 회원번호와 쿠폰번호를 통해 쿠폰을 발급하는 서버 API 호출 시, 발급된 쿠폰의 이름(couponName)이 응답 파라미터로 반환됩니다.
• 실무 활용: 백엔드에서 쿠폰 발급 처리가 완료된 직후, 알림톡이나 푸시 메시지를 통해 고객에게 “[여름 정기 세일 50% 할인] 쿠폰이 발급되었습니다”와 같이 정확한 쿠폰 명칭을 포함한 개인화된 알림 메시지를 즉시 발송할 수 있습니다.

8. 주문조회 API 개선 (내 주문쿠폰번호, 상품 쿠폰 번호 응답값 추가)

• 대상 API: server API [GET] /orders (v1.1)
• 상세 내용: 주문 내역을 조회하는 서버 API 내에 해당 주문에 사용된 장바구니 쿠폰번호(cartCouponNo)와 상품 쿠폰번호(productCouponNo)가 응답 파라미터로 추가되었습니다.
• 실무 활용: 자체 구축한 ERP나 정산 시스템에서 주문 데이터를 수집할 때, 어떤 주문에 어떤 쿠폰이 사용되었는지 정확히 매핑할 수 있습니다. 이를 통해 프로모션별 비용 정산 및 마케팅 성과 분석(ROI)을 고도화할 수 있습니다.

실무자가 오해하기 쉬운 부분

1. API 업데이트와 프론트엔드 자동 반영의 차이
본 업데이트는 샵바이 시스템 내부의 ‘API 응답값 및 파라미터 추가’에 관한 내용입니다. 샵바이 API를 활용해 자체적인 프론트엔드(쇼핑몰 화면)를 구축한 경우, 단순히 API가 업데이트되었다고 해서 쇼핑몰 화면이 자동으로 바뀌지 않습니다. 개발팀에서 추가된 응답값(예: 스티커명, 재고수량 등)을 호출하여 화면에 노출하도록 코드를 수정하고 배포해야만 실제 쇼핑몰 방문 고객에게 변경사항이 반영됩니다.

2. 탈퇴회원 CI 중복 탐지로 인한 가입 오류 가능성
CI 중복확인 API가 탈퇴회원의 CI까지 탐지하도록 변경됨에 따라, 기존에 탈퇴 후 즉시 재가입이 가능하도록 느슨하게 운영되던 쇼핑몰의 경우 프론트엔드 회원가입 로직에서 예기치 않은 가입 차단(중복 알림)이 발생할 수 있습니다. 자사의 회원가입 및 재가입 정책과 본 API의 동작 방식이 부합하는지 반드시 사전 테스트가 필요합니다.

3. Shop API와 Server API의 구분 적용
이번 업데이트에는 프론트엔드에서 주로 호출하는 Shop API(기획전, 상품조회 등)와 백엔드 서버에서 호출하는 Server API(쿠폰 발급, 주문 조회)가 혼재되어 있습니다. 개발팀에 업무를 요청할 때, 프론트엔드 담당자와 백엔드/ERP 연동 담당자에게 각각 관련된 API 명세 변경 사항을 정확히 구분하여 전달해야 혼선을 방지할 수 있습니다.

지금 할 일

가장 먼저 자사몰의 개발 및 유지보수를 담당하는 조직(내부 개발팀 또는 외주 에이전시)에 2026년 7월 1일 자 샵바이 API 업데이트 내역을 공유해야 합니다. 특히 자체적인 기획전 페이지를 운영 중이거나, 외부 ERP를 통해 주문을 수집하고 있는 경우 이번에 추가된 파라미터들을 활용하여 기존 시스템의 불편함을 개선할 수 있는 기회입니다.

마케팅 및 기획 부서에서는 관련상품 영역의 품절 상품 노출 문제나, 기획전 내 카테고리 필터 부재로 인한 고객 이탈이 없었는지 점검하시기 바랍니다. 문제가 있었다면 신규 API 응답값을 활용한 UI 개선안을 기획하여 개발팀에 요건을 전달하는 것이 좋습니다. 또한, CS 부서와 협력하여 탈퇴회원의 재가입 관련 문의가 증가하지 않는지 확인하고, 변경된 CI 중복 탐지 로직에 맞춰 고객 안내 매뉴얼을 현행화해야 합니다.