결제 · 환불 · 정산
핵심 요약
결제는 주문 → 확인 → 라이선스 발급 → 환불 → 원장 기록으로 연결됩니다. 현재 지원 범위는 Mock 또는 Toss TEST이며 실결제 운영 검증이 아닙니다.
경로를 선택한 뒤 구매와 환불을 테스트하고 정합성 대사 문서에서 확인할 증적을 살펴보세요.
YetdaPay는 판매자 스토어의 주문, 결제, 라이선스 발급과 금융 기록을 연결합니다. 현재 이 안내는 Mock 또는 Toss TEST 키 기반 구현을 설명합니다.
실거래 운영 여부
PAYMENT_LIVE_ENABLED=false가 현재 설정입니다. 실 PG 결제 승인, 실제 정산 지급, 외부 정산 대사의 운영 검증은 완료되지 않았습니다. 이 문서를 실 결제 운영 승인으로 사용하지 마세요.
주요 흐름
| 단계 | 내용 |
|---|---|
| Checkout | 주문 생성과 결제 준비 |
| Payment | Mock 확정 또는 Toss TEST 확인 |
| License | 결제 조건에 따른 라이선스 발급 |
| Refund | 환불 시도 선기록 → PG 취소 → 내부 반영 |
| Settlement | 정산 대상 금액·수수료 계산과 기록 |
| Reconciliation | 내부 원장·사용권·결제 상태 비교 |
Mock 결제
Mock 제공자 경로에서는 하나의 D1 배치로 주문·결제·라이선스·원장·감사·Outbox 이벤트를 기록하도록 구현되어 있습니다.
Toss TEST 결제
Toss 위젯 결과를 확인하고, 서명 검증된 웹훅 수신 시 PG 상태를 재조회하는 경로가 존재합니다. 외부 API·장애 상황에 대한 실연동 범위는 별도 검증이 필요합니다.
환불·정산
환불 시도는 refund_attempts에 기록되며, 결과가 불확실하면 needs_review가 될 수 있습니다. 정산은 지급 완료가 아닌 정산액 산정과 구분해 이해해야 합니다.