[FAQ] 결제/쿠폰

Slack QA 로그(원본 129건) 중 결제/쿠폰 영역에서 반복 질문되거나 확정된 답변 7건을 정리했다. ⚠ 배지가 붙은 항목은 과거 오답/정정 이력이 있거나 아직 결론이 나지 않은 주제이니 답변을 그대로 신뢰하지 말고 표시된 대로 재검증할 것.

Q16. 쿠폰이 적용가능한지 어디서 확인할 수 있어(상품상세/장바구니/결제)?

상품상세: 쿠폰API 호출 없이 최대할인가만 표시(구체 쿠폰목록은 안보임), 쿠폰불가상품이면 unavailableCoupon 메시지. 장바구니/결제: GET /v1/coupons로 보유쿠폰 전체목록 조회 + checkout-amount API로 실제 적용가능여부/할인액 계산. isSelectApply=true면 선택적용(대상상품만), false면 전체적용(제외상품만 빼고). issuedType=DISCOUNT_KEY(할인코드)는 useCoupon Hook에서 필터링되어 쿠폰 드롭다운에 안 보임(발급형이 아니라 즉시입력형이라 별도 처리).

출처 [[78]]

Q17. 쿠폰 할인액이 상품별로 균등분배 안되고 한 상품에 몰빵되는게 정상이야?

정상. CouponApplyService.kt에서 할인율/정액 쿠폰 모두 상품가격 비율로 분배 후, 소수점 버림(setScale DOWN)으로 생기는 오차를 마지막 상품(가격 오름차순 기준)에 몰아서(+=) 총액을 맞추는 의도된 설계. KR/JP 로직 완전 동일(KR에만 earnMileageAmount 필드 추가).

출처 [[119]] · 확인 필요 시 담당자: 유석진

Q18. 구매확정하면 마일리지가 바로 지급돼, 배치로 지급돼?

미확인. 확정된 정답 없음 - 과거 두 차례 확정적으로 “배치로 지급된다”고 답했다가 근거(존재여부가 불확실한 클래스명)를 검증하지 못한 채 스스로 철회함.

⚠미해결/신뢰성주의: 재질문 시 실제 코드(OrderConfirmService/MileageService)를 직접 열어 확인할 것

출처 [[48]]

Q19. 구매확정 시 마일리지 소수점은 어떻게 처리돼?

정수만 지급. earnedMileage*count 계산 후 .toLong()으로 소수점 버림(반올림 아닌 truncate). 0.9→0원, 1.5→1원, 9.9→9원.

출처 [[82]]

Q20. DB를 수기로 변경해서 적립금을 지급해도 돼?

권장 안됨. MileageBackofficeService.create()가 잔액갱신+이력저장+ERP동기화+트랜잭션을 한번에 보장하므로 이걸 사용해야 함. DB트리거/CDC로 감지해 자동지급하는 방식은 순환참조 위험이 있어 비권장.

출처 [[59]]

Q21. 주문상세의 “총 결제금액-배송비” 표시값은 totalPrice를 그대로 쓰는거야, totalPrice-deliveryPrice를 계산한거야 (KR)?

미확정. 반복된 검증 시도에서 답이 계속 뒤집히거나 형식적 정정만 반복되며 최종 결론이 나지 않음.

⚠미해결/신뢰성주의(최우선): 이 주제는 봇 답변을 그대로 믿지 말고 코드(OrderProductItem.tsx, payload.content[].totalPrice)를 직접 확인할 것

출처 [[100]]

Q22. 결제수단 관리 화면(JP)은 어떻게 구현돼있어?

JP 사이트는 결제수단 관리 섹션 전체가 코드상 주석처리(비활성화)돼 있음. 주석 안 구조 추정: 카드요약+修正する 버튼→PaymentMethodModal. 실제 동작 화면은 존재하지 않음. 영역 타이틀: お支払い方法管理.

⚠국가 주의: KR 기준 답변(카드형 UI, Toss연동)과 혼동 주의 - 질문 시 국가 명시 필수

출처 [[21]][[22]][[23]]