1688 API 가격 항목 업데이트
최근 1688 API 플랫폼의 상품 가격 정책이 새롭게 개편되었습니다.
이에 발맞추어 OFF 솔루션의 1688 API 연동 서비스를 이용 중인 고객사 전체 사이트에
API 업데이트 반영 및 상세 화면 가격 표기 로직 개선을 완료했습니다. (반영일 : 2026년 8월 22일)
이번 업데이트가 왜 필요했는지, 그리고 어떤 부분이 바뀌었는지 아래에 정리해 드립니다.
기존 1688 API 문제점: 왜 가격 차이가 발생했을까요?
기존의 환경에서는 상품 상세 화면에서 도매 최저가의 첫 구간 가격만 노출되거나,
1개 단위 구매 시 적용되는 소매가, 샘플가 등이 정확히 반영되지 않는 경우가 있었습니다.
이로 인해 상세 페이지에서 본 금액과 실제 주문/결제 단계에서 적용되는 금액이 달라지는 현상이 발생하기도 했습니다.
실제 결제 자체는 현지 정책에 맞는 정상 금액으로 업데이트 되어 이루어지더라도,
고객이 봤던 상세페이지 금액과 결제 금액이 다른 점으로 인해
고객의 신뢰도를 저하시키고 관리자의 불필요한 CS 업무가 증가되는 일이 있었습니다.
주요 업데이트 사항: 무엇이 달라졌나요?
1688 현지 판매자가 상품 등록 시 소매가 항목이 새로 추가되어
소매가(1개 상품가)와 도매가(2개 이상 상품가)를 구분해서 가격을 설정할 수 있게 되었습니다.
아래의 표는 두 개의 가격 정책의 차이점을 정리한 표입니다.
| 유형 | 소매가 | 도매가 |
|---|---|---|
| 가격 정책 | 1개 구매 시 고정 가격 | 2개 이상 구매 시 고정 가격 (더이상 1개 구간을 포함하지 않음) |
| 최소 주문 수량 (MOQ) | 1개 | 2개부터 시작 |
| 주요 대상 | 샘플 구매, 위탁 구매 | 대량 사입 셀러 |
판매가 설정 시 두개의 가격은 각각 독립적으로 설정되고,
1688 API 시스템은 구매자의 실제 주문 수량에 따라 자동으로 수량에 맞는 가격을 매칭합니다.
이 가격은 주문 뿐 아니라 상품 상세페이지에서 또한 명확하게 나뉘어져 노출되어
고객이 처음부터 실제 결제할 금액을 투명하게 확인하고 주문할 수 있어 불필요한 CS를 크게 줄일 수 있습니다.
적용 기대 효과를 정리하면 아래와 같습니다.
👆 1개 구매 시 소매가 자동 적용
1개 주문 시 1688 판매자가 설정한 1개 구매가(소매가) 로 즉시 계산되어 노출됩니다.
✌ 2개 이상 구매 시 도매가 자동 적용
최소 도매 수량(2개 이상)을 충족할 때, 판매자가 지정한 도매 단가가 자동으로 매칭되어 최종 상품 금액에 반영됩니다.
👍 가격 불일치 해소
상품 상세 화면부터 장바구니, 최종 주문서 작성 및 결제까지
동일한 단가 기준이 유지되어 결제 시점의 금액 변동 혼선을 원천 차단합니다.
소매가 실제 적용 예시
1) 공통 소매가 상품 유형
옵션이 1개인 상품(단일 옵션)이거나, 모든 옵션의 소매가가 동일한 경우입니다.
| 항목 | 설명 |
|---|---|
| 1개 가격(소매가) | 상품 상세 상단에 1개 구매시 적용되는 기준 소매가가 표기되며, 1개 주문 시에는 해당 소매가(14,961원)가 그대로 적용되어 결제됩니다. |
| 2개 이상 가격(도매가) | 각 옵션의 위안화(¥) 옆에 도매가가 노출되며, 수량을 2개 이상으로 변경 시 도매가가 총 상품금액에 실시간 반영됩니다. |
2) 개별 소매가 상품 유형
각각의 옵션별로 소매가 및 도매가가 다른 경우입니다.
| 항목 | 설명 |
|---|---|
| 대표 최저가 및 1개 가격(소매가) | 전체 옵션 중 가장 낮은 도매가가 ‘대표 최저가(판매가)’로 노출되며, 바로 하단에 1개 구매 기준 소매가가 별도 표기됩니다. 이 때 옵션마다 소매가가 다를 수 있어 1개 가격 옆에 이상(≥) 기호가 함께 표시됩니다. |
| 옵션 별 2개 이상 가격(도매가) | 구매자가 수량을 2개 이상 선택하면 판매자가 설정한 도매가 금액이 실시간으로 계산되어 총 상품금액에 즉시 반영됩니다. |
