구독·결제 서버 매뉴얼
사내 서비스 공통 구독·결제 API 서버를 이해하고 운영하고, 연동·확장하기 위한 안내서입니다. 처음이라면 왼쪽 사용자 매뉴얼부터, 연동·배포가 목적이면 개발자 매뉴얼을 보세요.
📘
사용자 매뉴얼
처음 사용하는 사람을 위한 전체 프로세스·관리자 콘솔·대시보드 안내.
00. 구독·결제 서버 전체 개요이 문서는 이 서버를 처음 접하는 분이 "이게 무엇이고, 어떤 흐름으로 동작하는지"를 그림과 함께 한눈에 이해하도록 돕습니다. 세부 화면·연동 방법은 각 섹션의 링크를 따라가세요.
11. 관리자 콘솔 사용하기구독·결제 시스템의 관리자 콘솔은 구독 현황을 보고, 결제를 관리하고, 서비스와 요금제를 설정하는 웹 화면입니다. 이 문서는 콘솔에 처음 들어가는 방법(로그인)과 화면 전체 구조, 그리고 두 가지
22. 카드(결제수단) 관리이 문서는 관리자 콘솔에서 고객의 결제 카드를 어디서 보고, 어떻게 활성/비활성으로 관리하는지 안내합니다.
33. 구독 관리이 문서는 관리자 콘솔의 구독 메뉴에서 구독을 찾아보고, 상태를 이해하고, 필요할 때 직접 손을 대는 방법(강제취소·만료일 연장·수동 재결제)을 안내합니다.
44. 요금제 관리서비스가 고객에게 판매할 구독 요금제를 만들고 관리하는 화면입니다. 가격, 결제 주기(년·월·주·일), 첫 구독 할인, 상시 할인, 체험 기간을 한곳에서 설정합니다.
55. 일반결제와 환불(취소)서비스에서 일어난 결제 내역을 확인하고, 일반결제(단건 결제)를 취소(환불) 하는 화면입니다. 구독 정기결제와 일반결제를 한 목록에서 함께 볼 수 있습니다.
66. 계정 관리관리자 콘솔에 로그인하는 계정을 만들고 관리하는 화면입니다. 어드민 콘솔을 사용할 수 있는 사람은 모두 여기서 만든 계정으로 로그인합니다.
77. 전체 설정결제 서버 전체에 적용되는 정책을 한 곳에서 관리하는 화면입니다. 좌측 메뉴 전체 설정에서 들어갑니다.
88. 감사 로그시스템에서 일어난 중요한 일들을 시간순으로 기록한 이력입니다. 좌측 메뉴 감사 로그에서 들어갑니다.
99. 대시보드관리자 콘솔에 로그인하면 가장 먼저 보이는 화면이 대시보드입니다. 이번 달 매출 요약, 구독 상태 현황, 12개월·30일 추이 그래프, 그리고 우측 패널(최근 결제·미수 구독·만료 임박)을 한 화면
🛠️
개발자 매뉴얼
설치·설정·배포(docker), 서비스용 API, 기능별 코드 흐름, 어드민 화면.
1010. 설치·설정·배포구독·결제 API 서버를 로컬 개발 환경에서 띄우는 절차부터 docker로 운영 배포하는 절차까지 정리한다. 핵심 원칙은 하나다 — PostgreSQL(DB)은 개발·배포 둘 다 별도 docker(
1111. 서비스 연동 API이 문서는 사내 외부 서비스(진료 앱·쇼핑몰 등)가 구독·결제 서버에 직접 호출하는 REST API 전체 레퍼런스입니다. 인증(HMAC 서명)부터 카드·구독·결제·조회, 그리고 서버가 서비스로 보내
1212. 카드 보관함(Card Vault) 기능이 문서는 카드 보관함 기능을 호출 진입(라우트)부터 반환까지 코드 흐름으로 따라갑니다. 카드 등록·교체·삭제·활성/비활성 토글, 빌링키 암호화 보관, 비활성 카드 결제 차단, 카드별 결제내역 표시
1313. 구독 기능이 문서는 구독 기능을 호출 진입(라우트/스케줄러)부터 반환까지 코드 흐름으로 따라갑니다. 생성(첫 결제/체험)·자동연장(스케줄러)·상태 전이·취소/재개/연장/수동결제·강제취소를 다룹니다.
1414. 일반결제·취소·정산 기능이 문서는 구독 없이 발생하는 1회성(단건) 결제와 그 취소(환불), 그리고 매출·환불·순매출을 합산하는 정산/대시보드 집계가 코드에서 어떻게 흐르는지 추적한다. 호출 진입점 → 서비스 함수(fil
1515. 서비스 알림(아웃고잉 웹훅) 기능구독·결제·카드·요금제의 상태가 바뀌면, 본 시스템은 서비스가 등록한 notificationurl로 JSON을 POST한다. 이를 "서비스 알림(아웃고잉 웹훅)"이라 부른다. 이 문서는 이벤트 종류
1616. 어드민 화면별 설명이 문서는 htmx 어드민(/admin/)을 화면별로 정리한 개발자용 지도입니다. 각 화면의 경로(GET/POST)·라우트 함수 위치(file:line)·템플릿·하는 일·필요 권한을 표로 정리하므로