콘텐츠로 이동

[WORKSOUT] 즉시 구매 결제 바텀시트

Screen ID Screen Title Screen Path
PAY-CHK-02 즉시 구매 결제 바텀시트 (SH_110_Payment_BottomSheet) PDP “즉시 구매하기” 클릭 시 진입

PDP(pdp-detail.md)에서 “즉시 구매하기” 버튼 클릭 시 열리는 결제 바텀시트다. 사이즈 선택, 배송지 설정, 할인·예치금, 결제 수단, 현금영수증, 총 결제 금액 표시를 하나의 바텀시트 안에서 슬라이드 전환으로 처리한다.

주의: 장바구니 경유 메인 결제 페이지(SH_131_Payment)는 별도 화면 PAY-CHK-01(다른 작업자 담당, Cart/payment.md)이다. 이 문서는 PDP 즉시 구매 전용 바텀시트(PAY-CHK-02)만 다룬다.

원본: 쇼핑 · 상품상세 마스터.md(SH_110_Payment_BottomSheet) 전체.


항목 KR / 공통 기준 JP
즉시 구매하기 활성 조건 사이즈 + 배송지 + 결제 수단 + 필수 동의 2종 완료 동일
필수 동의 항목 주문정보 동의 + 제3자 제공 동의 동일
필수값 미입력 표시 해당 항목 옆 ! 아이콘 동일
하위 시트 전환 방식 Bottom Sheet 내 슬라이드 전환 (풀페이지 전환 아님) 동일
항목 기준
선택 불가 current_stock = 0 (회색 처리)
마지막 재고 current_stock = 1마지막 재고입니다.
숫자 사이즈 정렬 오름차순
알파벳 사이즈 정렬 XS → S → M → L → XL → XXL
OS / Free 단독 옵션일 때만 표시

재고값(current_stock) 계산 규칙은 공통 ERP 재고 매핑 참고. 이 문서에서 재정의하지 않는다.

퀴즈 상품 처리

상태 결과
사이즈 미선택 + 답변 미입력 저장 후 메인 시트 복귀 가능
사이즈 선택 + 답변 미입력 문제의 답을 입력하세요.
사이즈 선택 + 오답 오답입니다. 문제를 확인해주세요. → 모달 닫힘 + 상품 첫 화면 이동
사이즈 선택 + 정답 정상 저장
항목 기준
최대 배송지 수 5개
초과 시 메시지 배송지는 최대 5개까지 추가할 수 있습니다
기존 배송지 정렬 updated_ts DESC
신규 필수값 배송지명, 받는 사람, 전화번호, 주소
추가 완료 시 방금 추가한 배송지 자동 선택
항목 KR 기준 JP
쿠폰 드롭다운 선택 동일
적립금 100원 단위, 전체 사용 버튼 동일 (JP 적용 여부 별도 확인)
예치금 1원 단위, 전체 사용 버튼 비노출
총 할인 한도 [쿠폰 + 적립금 + 예치금] ≤ 최종 결제 금액 [쿠폰 + 적립금] ≤ 최종 결제 금액
한도 초과 시 최대 적용 가능 금액으로 자동 보정 동일
항목 KR 기준 JP
간편 결제 토스 API 연동 카드 목록, 최신 등록순, 최근 카드 자동 선택 GMO PG 체계로 별도 구성
다른 결제 방법 신용카드 / 에스크로 계좌이체 / 카카오페이 / 네이버페이 / 토스페이 GMO PG 결제 수단 목록 별도 확인 필요
카드 추가 토스 API GMO PG 방식
항목 KR 기준 JP
노출 조건 예치금 1원 이상 입력 시 비노출 (예치금 없음)
옵션 소득공제 / 지출공제 / 미발행
항목 기준
상품 금액 current_price
상품 할인 discounted_rate = 0-0원 / 1 이상 → -(initial - current)
배송비 current_price < 100,000원 → 3,000원 / 그 외 → 0원

  • 실시간 할인 합산 계산은 별도 계산 API 또는 주문 계산 로직이 담당한다. 이 화면은 입력 규칙과 표시 기준만 확정한다.
  • 재고 표시 규칙은 공통 ERP 재고 매핑을 SSOT로 참조한다.

엔드포인트 호출 시점
POST /v1/products/sizes 사이즈 선택 Bottom Sheet 진입 시
기능 API
목록 조회 GET /v1/users/addresses
추가 PUT /v1/users/address
수정 PUT /v1/users/address/{addressId}
기능 API
보유 쿠폰 조회 GET /v1/coupon/user

확인 항목 정상 기준
사이즈 옵션 1개 이상
배송지 기존 주소 또는 신규 등록 가능
현금영수증 미노출 (KR) 예치금 입력 여부 확인
퀴즈 답변 question 존재 시 입력 요구
즉시 구매 버튼 비활성 필수 3종 + 동의 2종 모두 완료 여부
증상 예상 원인 1차 조치
결제 BS — 사이즈 미노출 사이즈 API 실패 옵션 API 응답 확인
결제 BS — 카드 추가 실패 (KR) 토스 연동 오류 외부 연동 상태 확인 후 재시도 안내
결제 BS — 퀴즈 저장 실패 정답 검증 실패 서버 메시지 확인

항목 내용
재고 관련 표시값 current_stock 계산 규칙은 공통 ERP 재고 매핑 참고
JP GMO PG 결제 수단 목록 마스터 원문에도 “별도 확인 필요”로 명시되어 있어 개발팀 확인 필요

버전 날짜 변경 내용
v1.0 2026-07-30 최초 작성 — 쇼핑 · 상품상세 마스터.md(SH_110_Payment_BottomSheet) 전체 이전