구독 · 결제 · 토큰

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

💡 누가 쓰나요? AI 사용량(토큰)이 떨어져 충전이 필요한 분, 영수증을 뽑아 회계 처리하려는 분, 그리고 회사의 구독 플랜을 정하거나 팀 인원만큼 라이선스를 늘리고 줄이는 회사 마스터. 결제·플랜 변경·해지·환불·자동 충전 설정은 회사 마스터만 할 수 있고, 다른 구성원은 구독 정보를 조회만 합니다.

ℹ️ 가시성 조건 — 이 문서의 내 구독 탭과 토큰 충전 진입점은 결제 기능이 열려 있는 환경에서만 보입니다. 아직 열리지 않은 환경에서는 프로필 메뉴의 내 구독 항목, 내 조직 화면의 내 구독 탭, 헤더 토큰 충전 버튼이 숨겨집니다.

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

1. 내 구독 탭 열기 — 내 조직 › 내 구독

진입: 우상단 프로필 메뉴 → 내 구독^{가시성 조건} → 내 조직 화면의 내 구독 탭이 열립니다(tflowx.com/my/organization?tab=subscription). 내 조직 화면에서 직접 내 구독 탭을 눌러도 됩니다. 예전 주소 /my/subscription 은 이 탭으로 이어집니다. ✨ UPDATED (2026-10)

내 구독 탭 안은 다시 4개 하위 탭으로 나뉩니다. 프로필 메뉴의 내 구독 에 마우스를 올리면 플랜 · 청구 · 토큰 사용량 하위 탭으로 바로 가는 항목이 펼쳐집니다.

파생 화면으로 영수증(/my/subscription/receipt/:id)과 결제 완료(/my/subscription/thanks)가 있습니다. 라이선스를 조직원에게 배정하는 것은 같은 화면의 부서 탭 › 라이선스 보기에서 합니다. → 라이선스

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

2-1. 내 구독 카드

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

• 다음 결제 정보에는 결제 예정일과 함께 다음 주기에 청구될 라이선스 수가 표시됩니다. 라이선스 감액을 예약해 둔 상태라면 "현재 수량 → 줄어들 수량" 형태로 표시되고, 경고 안내와 함께 예약 취소 버튼이 나타납니다 — 적용일 전이라면 언제든 감액 예약을 되돌릴 수 있습니다.
• 무료 체험 중에는 다음 결제일 대신 체험 만료일이 표시됩니다. → 2-4. 무료 체험
• 운영팀이 무상으로 제공한 이용권이면 무상 제공 만료일이 표시되고, 무료 카드 버튼에 **"무상 제공 중 · N일 남음"**이 보입니다. ✨ NEW (2026-10)
• 회사 마스터가 아닌 구성원에게는 카드 위에 "조회만 할 수 있습니다" 안내가 뜨고 결제·변경·해지·환불 버튼이 비활성화됩니다. ✨ NEW (2026-10)

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

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

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

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

무료 체험도 마찬가지로 조직에 소속된 뒤 회사 마스터만 시작할 수 있습니다(체험 토큰·이력이 회사 공유 풀에 쌓이기 때문). ✨ UPDATED (2026-10)

2-3. 변경 확인 흐름

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

1. 변경 미리보기: 오늘 청구 금액, 오늘 환불액, 다음 결제 금액을 계산해 보여 줍니다(취소 수수료는 없습니다).
2. 변경 확인 모달: 위 금액 내역과, 라이선스를 줄이거나 더 저렴한 플랜·짧은 주기로 바꾸는 경우(다운그레이드) 는 예약 적용일을 함께 보여 줍니다. ✨ UPDATED (2026-10)
3. 적용: 확인을 누르면 변경이 반영됩니다.

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

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

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

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

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

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

3. 정기결제 — 결제 수단 등록

결제 실패로 구독이 멈췄다면 — "결제 실패로 구독이 일시 정지되었습니다" 또는 결제 수단이 비활성이라는 안내가 뜬 경우입니다. 내 조직 › 내 구독 탭 › 홈에서 카드를 다시 등록하거나 다른 카드로 바꿔 결제하면 곧바로 복구됩니다.

첫 결제와 자동 결제 수단(등록 카드) 을 한 번에 등록합니다.

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

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

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

3-1. 결제 실패 안내

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

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

3-2. 자동 갱신과 결제 실패 시 일정 ✨ NEW (2026-10)

정기결제는 다음 결제일 당일(한국 시간 0시 직후) 등록된 카드로 자동 청구됩니다. 결제일보다 먼저 청구하지 않습니다.

• 재시도 기간 동안은 그대로 이용할 수 있습니다. 카드 한도·유효기간을 미리 확인해 두면 다음 시도에서 결제됩니다.
• 재시도에서 결제되더라도 결제 주기는 원래 결제일 기준으로 유지됩니다(예: 10월 4일 결제가 10월 5일에 성공해도 다음 결제일은 11월 4일).
• 일시 정지된 뒤에도 카드를 다시 등록해 결제하면 곧바로 복구됩니다.

4. 청구 탭 — 결제 내역

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

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

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

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

토큰이 소진됐다는 안내가 떴다면 — 상단 번개(⚡) 잔액 위젯을 눌러 토큰 충전 모달에서 토큰 팩을 고르면 즉시 충전됩니다. 챗봇 대화 중이었다면 충전 모달이 자동으로 열립니다.

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

✨ 토큰은 회사가 함께 씁니다 (2026-10) — 잔액은 사람이 아니라 소속 회사의 공유 풀에 있습니다. 회사 구성원 누가 쓰든 같은 풀에서 빠지고, 지급·충전도 풀로 들어갑니다. 아직 어떤 회사에도 소속(승인)되지 않은 계정은 토큰이 없어 AI 기능을 쓸 수 없습니다 — 회사를 만들거나 가입 승인을 받으세요.

지급 규칙 — 유료 구독(무상 제공 포함) 회사에는 매일 라이선스당 100만 토큰(그날 자정까지 유효)과 결제 주기마다 라이선스당 1,000만 토큰(연간 요금제도 매달, 1년 유효)이 들어갑니다. 지급은 그날 누군가 처음 잔액을 보거나 AI 기능을 쓸 때 자동으로 됩니다. 무료 체험은 시작 때 300만 토큰 한 번이며 체험이 끝나거나 유료로 바꾸면 남은 체험분은 사라집니다. 쓰다 모자라면 잔액이 마이너스가 될 수 있고, 다음 지급이 그 빚부터 메웁니다.

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

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

• 결제 기능이 열려 있는 환경에서는 위젯을 클릭하면 토큰 충전 모달이 열립니다.^{가시성 조건}
• 잔액은 색상(정상/주의/경고)으로 상태를 나타냅니다.
• 위젯에 마우스를 올리면 회사 풀 잔액의 출처별 분해(일일 지급 · 월 지급 · 구매 · 보상 · 빚 등 — 0 인 항목은 숨김)가 보입니다. 일일 지급분은 그날 자정(한국 시간)이 지나면 사라집니다. ✨ NEW (2026-10)

5-2. 토큰 충전 모달

충전은 회사 카드로 결제돼 회사 풀에 들어갑니다. 누가 여느냐에 따라 모달이 다르게 보입니다. ✨ UPDATED (2026-10)

• 회사 마스터: ① 토큰 팩을 고릅니다(큰 팩에는 할인 배지). ② 회사 유료 구독의 결제 카드로 결제합니다. ③ 지금 그 카드로 결제할 수 없으면 창을 열 때 바로 이유가 보이고 충전 버튼이 꺼집니다 — 구독을 해지했으면 재구독, 유료 구독이 없으면(체험만으로는 결제 카드가 없습니다) 유료 구독 시작, 원화(국내 카드) 구독이면 토큰 팩(달러)을 아직 살 수 없습니다. ✨ UPDATED (2026-10)
• 내 구독 탭의 자동 충전 칸 맨 위 지금 충전 으로도 같은 창이 열립니다. 팀원이 보낸 충전 요청이 있으면 그 줄에 누가 · 언제 · 그때 잔액이 보이고, 충전하면(수동·자동) 사라집니다. 충전 요청 알림을 누르면 이 창이 바로 열립니다. ✨ NEW (2026-10)
• 일반 구성원: 기본적으로 직접 충전할 수 없고 마스터에게 충전 요청 버튼이 보입니다. 누르면 회사 마스터에게 앱 알림과 메일이 갑니다(회사당 1시간에 1회). 이미 요청이 가 있으면(다른 팀원이 보낸 것 포함) 창을 열 때 누가 몇 분 전에 요청했는지와 다시 보낼 수 있는 시각이 보이고 버튼이 꺼집니다. 회사 자동 충전이 켜져 있으면 잔액이 기준 이하가 되면 자동으로 채워진다는 안내도 함께 보입니다.
• 마스터가 팀원 충전 허용(5-3)을 켠 회사의 구성원은 팩을 직접 살 수 있습니다 — 회사 카드로 결제되며 자동 충전 하루 한도 안에서만 됩니다.

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

5-3. 자동 충전 토글

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

• 위치: 내 구독 카드 하단(활성 구독이 있을 때만 노출)
• 켜기/끄기 + 일일 한도($) 설정 — 회사 카드로 결제되는 설정이라 회사 마스터만 바꿀 수 있습니다.
• 정책 문구 예: "잔액이 X 이하로 내려가면 Y 토큰을 자동 충전합니다($Z)." — 기준은 회사 풀 잔액입니다.
• 하루 한도에 도달하면 더는 자동으로 채워지지 않고 마스터에게 알림이 갑니다(그날 1회). 수동으로 충전하거나 한도를 올리세요. ✨ NEW (2026-10)
• 같은 카드 아래 팀원 충전 허용 토글 ✨ NEW (2026-10) — 켜면 마스터가 아닌 승인 구성원도 충전 모달에서 토큰 팩을 살 수 있습니다(회사 카드, 자동 충전 하루 한도에 포함). 기본은 꺼짐.

5-4. 회사 사용량 보기 (마스터) ✨ NEW (2026-10)

토큰 사용량 탭 위쪽에 회사 마스터에게만 회사 공유 풀 사용량 절이 보입니다 — 선택한 달의 사람별 사용량(부서 포함)과 지급·충전·회수 내역(매일 지급, 월 지급, 구매, 자동 충전, 보상, 회수). 구성원은 자기 사용량만 봅니다.

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

ℹ️ 매일 지급되는 기본 토큰 ✨ UPDATED (2026-10) — 일일 토큰은 사람이 아니라 회사 풀에 라이선스 수 × 100만씩 들어갑니다(월 지급은 라이선스 수 × 1,000만). 라이선스를 늘리면 그날부터 늘어난 만큼 더 들어오고, 줄이면 다음 결제일부터 줄어듭니다. 개인에게 따로 지급되는 토큰은 없습니다.

6. 외부 연동 탭 — 외부 API 키 (PAT)

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

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

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

7. 환불 정책

• 라이선스를 줄이면 확인 모달에 예약 감액 안내와 적용일, 그리고 오늘 청구 / 오늘 환불 / 다음 결제 금액 내역이 표시됩니다.
• 즉, 축소분은 이번 주기까지 사용하고 다음 주기부터 요금이 줄어드는 구조입니다.
• 감액·플랜 변경 예약 후 마음이 바뀌면, 적용일 전까지 내 구독 카드의 다음 결제 정보에서 예약 취소 로 되돌릴 수 있습니다.
• 업그레이드(월→연, 더 비싼 플랜)는 지금처럼 즉시 적용됩니다 — 새 플랜을 결제하고, 이전 플랜의 남은 기간은 날짜 비율로 환불됩니다(수수료 없음).

⚠️ "7일 이내 + 완전 미사용" 환불은 결제 직후 실수·변심을 위한 안전장치입니다. 조금이라도 유료 기능을 사용했다면 현금 환불 대신 정기결제 중단(만료까지 이용)으로 처리됩니다. 환불액에서는 결제 대행사에 이미 지급된 결제 수수료 상당액(결제 금액의 3%) 이 공제되며, 이 환불은 회사당 1년에 1회만 가능합니다. 환불 요청 창과 결제 화면에 같은 내용이 안내됩니다.

💡 문제 해결 (FAQ)

내 구독 탭 진입과 결제수단

Q. 프로필 메뉴에 "내 구독"이 없고, 내 조직 화면에도 내 구독 탭이 안 보여요. A. 결제 기능이 아직 열리지 않은 환경에서는 내 구독 항목·탭과 토큰 충전 진입점이 숨겨집니다.^{가시성 조건} 그래도 안 보이면 회사 마스터에게 문의하세요. 예전 사이드바의 구독 관리 메뉴는 없어지고 내 조직 › 내 구독 탭이 그 자리입니다(2026-10).

Q. 토큰을 충전하려는데 지금은 충전할 수 없다고 떠요. A. 토큰 충전은 회사 유료 구독의 결제 카드로 합니다(카드만 따로 등록하는 화면은 없습니다). 구독을 해지했으면 재구독하면 바로 충전되고, 체험 중이거나 유료 구독이 없으면 유료 구독을 시작하면 그 카드로 충전됩니다. 원화(국내 카드) 구독은 토큰 팩(달러)을 아직 살 수 없습니다.

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

무료 체험과 결제 버튼

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

Q. 결제 버튼이 비활성화되어 눌리지 않아요. ✨ UPDATED (2026-10) A. 아직 소속된 조직이 없으면 결제를 진행할 수 없습니다. 홈 탭 위쪽 안내의 조직 등록하기 버튼으로 /my/organization 화면에서 조직을 먼저 만들어 주세요. 조직 등록 후 화면을 새로 고치면 결제 버튼이 활성화됩니다. 회사에 가입 신청만 해 둔 상태(승인 전)도 아직 소속이 없는 것으로 봅니다.

조직에 소속돼 있어도 회사 마스터가 아니면 결제·변경·해지·환불 버튼이 비활성화됩니다. 마스터에게 진행을 요청하거나, 마스터 권한을 받아 주세요.

라이선스·영수증·만료

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

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

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