| 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) 전체 이전 |