구독 · 결제 · 토큰

TFlow의 유료 기능은 구독(플랜 + 라이선스 수량) 으로 이용하고, AI 기능은 토큰으로 동작합니다. 이 두 가지를 관리하는 곳이 My Subscription 화면이며, 정기결제는 PayVerse 통합결제로 처리됩니다.

💡 누가 쓰나요? 회사의 구독 플랜을 정하거나 팀 인원만큼 라이선스를 늘리고 줄이는 결제 담당자·관리자, AI 사용량(토큰)이 떨어져 충전이 필요한 분, 영수증을 뽑아 회계 처리하려는 분. 실제 결제·플랜 변경은 보통 회사의 Master(최고 관리자) 가 진행합니다.

ℹ️ 가시성 조건 — 이 문서의 구독 관리 메뉴와 토큰 충전 진입점은 운영 설정 billingEnabled(서버 BILLING_ENABLED)가 켜진 환경에서만 보입니다. 결제 기능이 아직 열리지 않은 환경에서는 사이드바 구독 관리 항목과 헤더 토큰 충전 버튼이 숨겨집니다.

🖼️ 화면 캡처 My Subscription 홈 탭 전체 — 내 구독 카드 + 플랜 카드 + 자동 충전 토글 📍 tflowx.com/my/subscription · 저장 위치 images/common/subscription-home.png

1. My Subscription 화면 열기

진입: 사이드바 설정 > 구독 관리^{가시성 조건} → tflowx.com/my/subscription

화면은 4개 탭으로 구성됩니다.

파생 화면으로 영수증(/my/subscription/receipt/:id)과 결제 완료(/my/subscription/thanks)가 있습니다.

2. 홈 탭 — 구독 현황과 플랜

2-1. 내 구독 카드

현재 구독 상태를 한 장의 카드로 보여 줍니다.

• 다음 결제 정보에는 결제 예정일과 함께 다음 주기에 청구될 라이선스 수가 표시됩니다. 라이선스 감액을 예약해 둔 상태라면 "현재 수량 → 줄어들 수량" 형태로 표시되고, 경고 안내와 함께 예약 취소 버튼이 나타납니다 — 적용일 전이라면 언제든 감액 예약을 되돌릴 수 있습니다.
• 무료 체험 중에는 다음 결제일 대신 체험 만료일이 표시됩니다. → 2-4. 무료 체험

2-2. 플랜 선택 · 라이선스 수량 조절

플랜 카드 아래 수량 스텝퍼로 라이선스 개수를 정합니다. 스텝퍼 값과 현재 구독을 비교해 버튼 라벨이 자동으로 바뀝니다.

⚠️ 최소 라이선스 가드 — 라이선스 수는 현재 조직원 수를 커버할 수 있는 최소치(현재 조직원 수 ÷ 라이선스당 사용자 수) 미만으로는 줄일 수 없습니다. 더 줄이려면 먼저 조직원 배정을 정리해야 합니다. → 라이선스

⚠️ 조직 등록이 먼저입니다 ✨ NEW (2026-08) — 구독은 조직(회사) 단위로 관리되므로, 아직 어떤 조직에도 속해 있지 않으면 결제를 진행할 수 없습니다. 이 경우 홈 탭 위쪽에 "구독을 시작하려면 조직 등록이 먼저 필요합니다" 안내가 뜨고 플랜 카드의 결제 버튼이 비활성화됩니다. 안내의 조직 등록하기 버튼으로 이동해(tflowx.com/my/organization) 조직을 만든 뒤 다시 시도하세요.

무료 체험은 조직이 없어도 시작할 수 있습니다. 체험 중에 조직을 만들면 체험 이력이 그 조직으로 자동 승계됩니다.

2-3. 변경 확인 흐름

버튼을 누르면 바로 결제되지 않고 미리보기 → 확인 모달 순서로 진행됩니다.

1. 변경 미리보기(previewChange): 오늘 청구 금액, 취소 수수료, 환불액, 다음 결제 금액을 계산합니다.
2. 변경 확인 모달(SubscriptionChangeConfirm): 위 내역(breakdown)과, 라이선스를 줄이는 경우 예약 감액 적용일을 함께 보여 줍니다.
3. 적용(applyChange): 확인을 누르면 변경이 반영됩니다.

• 카드 하단에는 상황에 따라 해지 / 재구독 / 환불 버튼이 표시됩니다.

🖼️ 화면 캡처 플랜 변경 확인 모달 — 특히 라이선스 감소 시의 "예약 감액" 안내 + 금액 breakdown(오늘 청구 / 취소 수수료 / 오늘 환불 / 다음 결제) 📍 tflowx.com/my/subscription · 저장 위치 images/common/subscription-change-confirm.png

2-4. 무료 체험 (Free Plan)

아직 구독·체험 이력이 없는 회사라면, 홈 탭에 "N일 무료 체험 시작" 배너가 표시됩니다(현재 3일).

• 시작: 배너 버튼을 누르면 결제 수단(카드) 등록 없이 바로 체험이 시작되고, 시작한 본인에게 라이선스 1좌석이 자동 배정됩니다.
• 자격: 다음 조건을 모두 만족해야 배너가 보입니다 — ① 본인에게 구독·체험 이력이 없음, ② 소속 회사의 멤버 누구도 체험을 쓴 적이 없음, ③ 회사에 유료 구독이 없음. 조건에 해당하지 않으면 배너가 표시되지 않습니다.
• 체험 중 표시: 내 구독 카드에 체험 만료일이 표시됩니다. 자동 충전·해지 버튼은 유료 구독 전용이라 체험 중에는 보이지 않습니다.
• 유료 전환: 체험 중에도 플랜 카드에서 원하는 플랜을 결제하면 즉시 유료 구독으로 전환되고, 진행 중이던 체험은 자동 종료됩니다.

ℹ️ 신규 가입 계정에는 라이선스가 자동으로 발급되지 않습니다. 무료 체험을 시작하거나 구독을 결제하기 전까지는 열람 위주로 이용하게 됩니다. → 라이선스

3. 정기결제 — PayVerse 빌키

첫 결제와 정기결제 빌키(자동 결제 수단) 를 한 번에 등록합니다.

1. 결제 버튼을 누르면 결제 요약 모달이 뜹니다.
2. 카드로 결제하기 를 누르면 PayVerse 결제창이 열립니다. 원화(KRW) 결제는 국내 카드 전용 결제창, 달러(USD) 결제는 해외 카드 결제창으로 각각 열립니다. ✨ UPDATED (2026-08)
3. 여기서 첫 결제 + 빌키 발급이 동시에 이뤄집니다. 이후 정기결제·토큰 충전은 이 빌키로 자동 처리됩니다.
4. 성공하면 결제 완료 화면(/my/subscription/thanks)으로 이동합니다.

ℹ️ 결제창을 X로 닫으면 오류가 아니라 안내 메시지만 표시되고 결제 모달이 그대로 남습니다 — 바로 다시 시도하시면 됩니다. ✨ ⚠️ 통화가 다른 플랜으로 바꾸려면(원화 ↔ 달러) 기존 구독을 해지한 뒤 다시 구독해야 합니다.

ℹ️ 결제가 완료되면 결제한 본인에게 라이선스 1좌석이 자동 배정되어 바로 편집 기능을 쓸 수 있습니다. 나머지 좌석은 조직 관리에서 팀원에게 배정합니다. → 라이선스

ℹ️ 개발·테스트 환경에서는 실제 PayVerse 창 대신 DummyPayverseFrame(모의 결제창)이 뜹니다.

3-1. 결제 실패 안내

실패 원인별로 다른 메시지가 표시됩니다.

🖼️ 화면 캡처 PayVerse 결제 직전 결제 요약 모달 — 플랜·수량·금액 + 카드로 결제하기 📍 tflowx.com/my/subscription · 저장 위치 images/common/payverse-summary.png

4. 결제 내역 탭

지난 정기결제 청구 내역을 표로 조회합니다.

• 표 항목: 날짜 · 플랜 · 단가 · 라이선스 수 · 총액 · 기간 · 상태 · 사유 · 영수증
• 영수증: 상태가 paid(결제 완료) 인 건만 영수증 버튼이 활성화되며, 누르면 새 탭에서 영수증(/my/subscription/receipt/:id)이 열립니다.

ℹ️ 영수증에는 플랜명·이용 기간·결제 금액·거래번호·상태가 실제 결제 데이터 기준으로 표시됩니다. 회계용 증빙으로 그대로 사용할 수 있습니다.

5. AI 토큰 — 잔액 · 충전 · 자동 충전

TFlow의 AI 기능(Lyra 챗봇, CYGNUS·LEO 분석 등)은 토큰으로 동작하며, 사용 시 자동 차감됩니다.

5-1. 헤더 토큰 잔액 위젯

상단 네비게이션 바의 번개(⚡) 아이콘 + 잔액이 현재 토큰을 보여 줍니다.

• billingEnabled 환경에서는 위젯을 클릭하면 토큰 충전 모달이 열립니다.^{가시성 조건}
• 잔액은 색상(정상/주의/경고)으로 상태를 나타냅니다.

5-2. 토큰 충전 모달

1. 토큰 팩을 고릅니다. 큰 팩에는 할인 배지가 붙습니다.
2. 저장된 PayVerse 빌키로 결제합니다.
3. 빌키(결제 수단)가 없으면 "결제수단이 필요합니다"(402) 안내가 뜹니다 — 먼저 정기결제로 결제 수단을 등록하세요.

ℹ️ 챗봇 대화 중 토큰이 소진되면 이 충전 모달이 자동으로 열립니다.

5-3. 자동 충전 토글

잔액이 떨어질 때마다 매번 충전하지 않도록 자동 충전을 켤 수 있습니다.

• 위치: 내 구독 카드 하단(활성 구독이 있을 때만 노출)
• 켜기/끄기 + 일일 한도($) 설정
• 정책 문구 예: "잔액이 X 이하로 내려가면 Y 토큰을 자동 충전합니다($Z)."

🖼️ 화면 캡처 헤더 토큰 잔액 위젯 + 토큰 충전 모달(토큰 팩·할인 배지) + 자동 충전 토글 📍 tflowx.com/my/subscription · 저장 위치 images/common/token-charge.png

ℹ️ 매일 지급되는 기본 토큰 ✨ UPDATED (2026-08) — 일일 기본 토큰은 라이선스를 보유한 사용자에게 지급됩니다. 라이선스가 없으면 지급되지 않으니, 조직 관리자에게 라이선스 배정을 요청하세요. (배정받은 당일부터 다시 지급됩니다.)

6. 외부 API 키 탭 (PAT)

Claude Desktop, ChatGPT 등 외부 AI 챗봇에서 TFlow 데이터에 접근하기 위한 개인 액세스 토큰(PAT)을 관리합니다.

• 발급: API 키 발급 을 누르면 pat_tflow_... 형태의 키가 생성됩니다.
• 보관 주의: 발급된 키는 한 번만 표시됩니다. 반드시 안전한 곳에 복사해 두세요.
• 유효 기간: 기본 90일, 만료 후 재발급이 필요합니다.
• 재발급: 재발급 을 누르면 기존 키는 즉시 폐기되고 새 키가 발급됩니다.
• Claude Desktop 설정 복사: 버튼 한 번으로 Claude Desktop용 JSON 설정을 클립보드에 복사할 수 있습니다.

💡 외부 연동 설정 방법은 MCP 연동 가이드를 참고하세요.

7. 환불 정책

• 라이선스를 줄이면 확인 모달(SubscriptionChangeConfirm)에 예약 감액 안내와 적용일, 그리고 오늘 청구 / 취소 수수료 / 오늘 환불 / 다음 결제 breakdown이 표시됩니다.
• 즉, 축소분은 이번 주기까지 사용하고 다음 주기부터 요금이 줄어드는 구조입니다.
• 감액 예약 후 마음이 바뀌면, 적용일 전까지 내 구독 카드의 다음 결제 정보에서 예약 취소 로 되돌릴 수 있습니다.

⚠️ "7일 이내 + 완전 미사용" 전액 환불은 결제 직후 실수·변심을 위한 안전장치입니다. 조금이라도 유료 기능을 사용했다면 현금 환불 대신 정기결제 중단(만료까지 이용)으로 처리됩니다.

💡 문제 해결 (FAQ)

구독 관리 진입과 결제수단

Q. 사이드바에 "구독 관리"가 없어요. A. 결제 기능이 열리지 않은 환경(billingEnabled OFF)에서는 구독 관리 메뉴와 토큰 충전 진입점이 숨겨집니다.^{가시성 조건} 운영 환경에서 안 보이면 관리자에게 문의하세요.

Q. 토큰을 충전하려는데 "결제수단이 필요합니다"라고 떠요. A. 저장된 PayVerse 빌키가 없어서입니다. 먼저 구독 결제(또는 카드 등록)로 결제 수단을 등록하면 이후 토큰 충전이 그 빌키로 처리됩니다.

Q. 라이선스를 줄였는데 요금이 그대로예요. A. 라이선스 축소는 즉시 환불이 아니라 다음 정기결제일부터 예약 감액됩니다. 이번 주기까지는 기존 수량으로 청구되고, 다음 주기부터 줄어든 금액이 청구됩니다. 예약을 되돌리려면 적용일 전에 내 구독 카드의 예약 취소 를 누르세요.

무료 체험과 결제 버튼

Q. 무료 체험 배너가 안 보여요. A. 무료 체험은 본인과 회사 모두 구독·체험 이력이 전혀 없는 경우에만 시작할 수 있습니다. 회사 멤버 중 누군가 이미 체험을 사용했거나, 회사에 유료 구독이 있으면 배너가 표시되지 않습니다. → 2-4. 무료 체험

Q. 결제 버튼이 비활성화되어 눌리지 않아요. ✨ NEW (2026-08) A. 아직 소속된 조직이 없으면 결제를 진행할 수 없습니다. 홈 탭 위쪽 안내의 조직 등록하기 버튼으로 /my/organization 화면에서 조직을 먼저 만들어 주세요. 조직 등록 후 화면을 새로 고치면 결제 버튼이 활성화됩니다. (구독 관리 권한이 없는 계정에서도 버튼이 비활성화됩니다.)

라이선스·영수증·만료

Q. 라이선스 수를 더 줄이고 싶은데 버튼이 막혀요. A. 현재 조직원 수를 커버하는 최소치 미만으로는 줄일 수 없습니다. 조직 라이선스 배정에서 조직원 배정을 먼저 정리한 뒤 다시 줄여 주세요.

Q. 영수증 버튼이 비활성화되어 있어요. A. 영수증은 상태가 paid(결제 완료) 인 결제 건만 발급됩니다. 실패·대기 상태에서는 활성화되지 않습니다.

Q. 구독이 만료되면 데이터가 사라지나요? A. 아니요. 접속이 완전히 막히지는 않으며 계정·프로젝트 데이터는 읽기 전용으로 유지됩니다. 단, 매일 지급되는 기본 토큰은 라이선스를 보유한 사용자에게만 제공됩니다.