| Screen ID |
Screen Title |
Screen Path |
| PAY-GIFT-01 |
기프트카드 결제 |
/checkout/gift-card |
회원이 장바구니에서 기프트카드 상품으로 “결제하기”를 클릭했을 때 진입하는 결제 화면(SH_131_Payment_GiftCard). 일반 결제(PAY-CHK-01)와 달리 수령인 정보 입력, 결제 수단 제한, 카카오톡 코드 발송 후처리가 특징이다.
| 항목 |
기준 |
| 헤더 제목 |
“주문 정보” |
| 뒤로가기 |
장바구니 화면으로 이동 |
| 주문 상품 제목 |
“주문 상품 (N개)” |
| 드롭다운 |
기본 펼침 상태 (토글 가능) |
| 상품 정렬 |
장바구니 추가 최신순 |
| 브랜드명 |
WORKSOUT 고정 |
| 사이즈 |
OS 고정 |
운영 주의: 기프트카드 결제 화면의 주문 상품 드롭다운은 일반 결제(PAY-CHK-01, 드롭다운 삭제됨)와 달리 기본 펼침 상태다. 삭제 여부는 구현 최종본 확인 필요.
| 항목 |
기준 |
| 표시 데이터 |
user.name / user.phone_number |
| 수정 가능 여부 |
불가 (비활성화/회색 처리) |
| 항목 |
필수 여부 |
규칙 |
| 수령인 이름 |
필수 |
글자 수 제한 없음 |
| 수령인 휴대폰 앞자리 |
— |
“010” 고정, 수정 불가 |
| 수령인 휴대폰 중간 |
필수 |
숫자 4자리만, 4자리 완성 시 다음 필드 자동 포커스 |
| 수령인 휴대폰 끝자리 |
필수 |
숫자 4자리만 |
| 기프트카드 메시지 |
선택 |
최대 30자, 실시간 카운트 표시, 초과 시 자동 자름 |
| 항목 |
기준 |
| 허용 결제 수단 |
신용카드(기본 선택) / 에스크로 계좌이체 |
| 미지원 결제 수단 |
카카오페이 · 네이버페이 · 토스페이 · 간편결제 · 무통장 입금 등 |
| 쿠폰 |
일반적으로 사용 불가 |
| 마일리지 |
일반적으로 사용 불가 |
| 예치금 |
사용 가능 |
| 배송비 |
0원 (기프트카드 무료배송 고정) |
| 현금영수증 |
예치금 1원 이상 입력 시 노출 |
| 멤버십 마일리지 적립 |
일반적으로 0% (별도 정책 확인) |
운영 주의: 주문 생성 API 요청에는 usedMileage, usedCouponIds 필드가 존재하나, 화면에서는 기본적으로 비활성화 처리한다. 요청 시 각각 0 / 빈 배열로 처리.
| 항목 |
기준 |
| 필수 동의 항목 |
주문 정보 동의 + 제3자 데이터 공유 동의 |
| 결제 버튼 활성 조건 |
수령인 이름 입력 + 휴대폰 번호 완성 + 동의 2종 체크 |
| 버튼 텍스트 |
“총 결제 금액원 (상품 N개) 결제하기” |
| 버튼 클릭 동작 |
수령인 정보 확인 팝업 노출 |
| 항목 |
기준 |
| 노출 시점 |
결제 버튼 클릭 즉시 |
| 팝업 제목 |
“결제 후 수취 정보 변경 불가” |
| 본문 |
“아래 수취 정보로 기프트카드를 전송하시겠습니까?” |
| 주의 문구 |
“*수취 정보 오 기입은 구매자에게 책임이 있습니다.” |
| 표시 정보 |
수령인 이름 · 수령인 연락처(010-0000-0000 형식) · 수령인 메시지(없으면 “메시지 없음”) |
| “동의하고 구매하기” |
주문 생성 및 결제 플로우 진행 |
| “X” |
팝업 닫기, 결제 화면 유지 (입력값 초기화 없음) |
| 항목 |
기준 |
| 결제 완료 화면 |
결제 확인 API 성공 시 이동 |
| 카카오톡 알림 |
백엔드에서 수령인 휴대폰 번호로 기프트카드 코드 및 사용 방법 안내 발송 |
| 발송 시점 |
프론트 완료 화면 노출과 수령인 수신이 동일 시점이 아닐 수 있음 |
엔드포인트: POST /v1/order/port/payment/order/{orderNumber}
| 필드 |
값/설명 |
isGiftCard |
true 고정 |
customerName / customerPhone |
주문자(회원) 정보 |
receiverName / receiverPhone |
수령인 정보 |
shippingRequest |
기프트카드 메시지 (배송 요청이 아님) |
payMethod |
CARD 또는 에스크로 코드 |
usedMileage |
0 |
usedCouponIds |
[] |
usedMoney |
예치금 사용 금액 |
엔드포인트: POST /v1/orders/port/payment/confirm
요청 필드: imp_uid, merchant_uid, utm_* 계열
| 증상 |
예상 원인 |
1차 조치 |
| 수령인 입력 완료인데 버튼 비활성 |
이름/번호/동의 중 누락 |
필수값 + 체크 상태 재확인 |
| 결제 모듈 연결 실패 |
Portone 연동 오류 |
재시도 또는 결제 수단 변경 |
| 결제 완료 후 카카오톡 미발송 |
후처리 실패 |
결제 완료 확인 후 고객센터 안내 + 백엔드 로그 확인 |
| 항목 |
내용 |
| 드롭다운 기본 펼침 유지 여부 |
삭제 여부는 구현 최종본 확인 필요 |
| 멤버십 마일리지 적립률 |
기프트카드 결제 적립 0% 여부 별도 정책 확인 필요 |
| 버전 |
날짜 |
변경 내용 |
| v1.0 |
2026-07-30 |
최초 작성 (결제 비회원 · 기프트 카드 마스터.md 중 SH_131_Payment_GiftCard) |