| # | 영역 | 필드 | 타입 | 옵션 값 / 제약사항 | 입력 예시 |
|---|
| ① 후원 완료 모달 |
| 1 | 완료 헤더 | 결과 표시 | modal | 커밋 성공 후에만 노출.
정정 v2.46 — 실패는 두 갈래다. 승인 거절이면 공통 상태 ⑤ 결제 실패(차감 없음), 승인 뒤 우리 트랜잭션 실패면 공통 상태 ⑬ 승인됨·반영 확인 중으로 간다. 후자는 돈이 이미 나간 상태라 “후원되지 않았습니다”로 보내면 안 된다. 문구는 states.html 이 정본이고 여기서 다시 쓰지 않는다 | — |
| 2 | 금액 내역 | 정가 / 할인 / 결제 캐시 | readonly | donations.list_price_cash · discount_rate_snapshot · amount_cash — v2.28 신설 스냅샷. 크리에이터가 나중에 할인율을 바꿔도 이 영수증 값은 변하지 않음 | 10,000 / −1,000 / 9,000 |
| 3 | 잔액 | 남은 캐시 | readonly | wallet_transactions.balance_after(건별 잔액 스냅샷)를 그대로 표시 — 별도 재조회하지 않음 | 23,000 캐시 |
| 4 | CTA | 확인 / 후원 내역 보기 | button × 2 | 확인은 모달만 닫고 후원 페이지 유지(연속 후원 유도), 두 번째는 /me 후원 내역으로 이동 | — |
| ② 후원 내역서 |
| 5 | 헤더 | 상태 / 문서번호 | badge + readonly | donations.status 4종(pending/completed/cancelled/refunded)을 그대로 뱃지로. 문서번호는 DON-YYYYMMDD-순번 | 완료 / DON-20260813-000482 |
| 6 | 상세 | 일시·크리에이터·유형·상품·금액·메시지 | readonly grid | 유형은 donation_type 12종(v2.28 정정). 유형별 부가 내용(음성 파일·영상 구간·퀘스트 조건 등)은 donation_payloads에서 조인해 유형에 맞는 행만 추가 노출 | 시그니처 / 치킨 한 마리 |
| 7 | 고지 | 세금 증빙 아님 안내 | readonly note | 후원은 캐시 차감(내부 거래)이라 부가세 대상이 아니고, 부가세는 충전 결제에서 발생 — 두 문서를 반드시 분리해야 회계·CS가 어긋나지 않음 | — |
| ③ 결제(충전) 영수증 |
| — | 반영 확인 중인 결제 v2.46 | 목록 병합 | readonly | 승인만 나고 반영이 안 된 건도 목록에 보여야 한다. payments 행은 본 트랜잭션에서 생기므로 그 건은 payments 에 없다 — 목록을 payments 만으로 만들면 돈은 나갔는데 화면에 아무 흔적이 없다. v_payment_history(§14.0 ⑬)로 병합해 “반영 확인 중” 배지와 함께 표시한다. 영수증은 발급하지 않는다 — 아직 확정된 거래가 아니다 | 11,000원 · 반영 확인 중 |
| 8 | 헤더 | 승인 상태 / PG TID | badge + readonly | payments.status(approved/cancelled/failed) + pg_tid — TID는 환불·대사(reconciliation)의 키 | 승인 / 2026081321031947 |
| 9 | 금액 | 공급가액 / 부가세 / 결제금액 / 충전 캐시 | readonly | supply_amount_krw + vat_amount_krw = amount_krw. 1캐시 = 1원 고정이므로 충전 캐시 = 공급가액(§00 캐시 모델 v2.28) | 10,000 / 1,000 / 11,000 / 10,000캐시 |
| 10 | 자동 충전 | is_auto_billing 표시 | readonly | 잔액 부족으로 후원 도중 자동 충전된 건임을 명시 — 도너가 “내가 결제한 적 없다”고 오인하는 CS를 줄이기 위한 필수 표기 | "후원 중 자동 충전됨" |
| ④ /me 후원 내역 진입점 |
| 11 | 목록 | 증빙 열 | link × 2 | 내역서는 모든 건, 영수증은 donations.payment_id가 있는 건(그 후원과 함께 결제가 일어난 경우)만 노출. 기존 “영수증 다운로드” 단일 버튼은 두 문서를 구분하지 않아 오해를 만들었음 | "내역서 · 영수증" |