쇼피파이 관리자에서 voidX AI 앱을 열면 "홈" 탭 아래에 "플랜·사용량" 카드가 있습니다. 구독 상태, 이번 30일 주기의 토큰 사용량, 충전팩 잔액을 보고 플랜 선택·변경과 충전팩 구매를 시작하는 자리입니다.
요금 결제와 청구는 쇼피파이가 처리합니다. 플랜 목록과 가격은 쇼피파이의 플랜 선택 페이지에, 청구 내역은 쇼피파이 청구서에 있고, 이 카드는 그 결과로 바뀐 상태를 보여줍니다.
화면 구성
| 영역 | 보여주는 것 |
|---|---|
| 배지 (카드 오른쪽 위) | "플랜 없음", "Light", "Premium", "일시 중지" 중 하나 |
| 상태 안내 | 조치가 필요할 때만 뜨는 안내 |
| 이번 30일 주기 사용량 | 사용 토큰 / 제공 토큰 게이지, "남은 토큰", "{날짜}에 리셋" |
| 충전팩 토큰 | 충전팩 잔액, "{토큰 수} 토큰 충전 · $가격" 버튼 |
| 플랜 선택 / 플랜 변경 | 쇼피파이 플랜 선택 페이지를 여는 버튼, 옆에 "{시각} 기준" |
"{시각} 기준"은 상태를 조회한 시각입니다. 카드는 앱 홈을 열 때 갱신되고, 다른 탭이나 창에 갔다가 돌아오면 다시 조회합니다. 쇼피파이에서 결제 정보를 고친 뒤 화면이 그대로라면 앱 홈을 새로고침합니다.
상태별 안내
| 배지 | 안내 | 상태 |
|---|---|---|
| 플랜 없음 | "플랜을 선택하면 AI 상담원이 스토어에서 대화를 시작해요" | 구독 없음, 충전팩 없음. 대화 차단 |
| 플랜 없음 | "구독 없이 충전팩 토큰으로 이용 중이에요" | 구독 없음, 충전팩 토큰으로 대화 중 |
| Light / Premium | 안내 없음 | 정상 |
| Light / Premium | "이번 주기 토큰을 모두 사용했어요" | 이번 주기 토큰 소진 |
| Light / Premium | "구독이 {날짜}에 만료될 예정이에요" | 앱 삭제 후 재설치. 주기 말에 종료 |
| 일시 중지 | "결제에 문제가 있어 구독이 일시 중지됐어요" | 쇼피파이 청구서 결제 문제로 청구 중단 |
"이번 주기 토큰을 모두 사용했어요"가 보이면 충전팩 토큰이 있을 때는 그 토큰으로 대화가 이어지고, 없으면 대화가 멈춥니다. 안내에 적힌 날짜가 다음 주기 시작일입니다.
"일시 중지"는 구독이 끊긴 것이 아니라 쇼피파이가 청구를 멈춘 상태입니다. 쇼피파이 청구서의 결제 정보를 갱신하면 같은 주기로 돌아오고, 그동안은 충전팩 토큰만 사용됩니다.
토큰이 쓰이는 순서
구독 토큰을 먼저 쓰고, 이번 주기 토큰이 소진되면 충전팩 토큰을 씁니다. 둘 다 없으면 방문자가 대화를 열었을 때 "지금은 AI 상담을 이용할 수 없어요. 불편을 드려 죄송합니다."가 표시되고 대화는 열리지 않습니다. 답변 도중에 토큰이 바닥나면 "답변이 여기서 멈췄어요. 불편을 드려 죄송합니다."가 붙습니다.
| 종류 | 적립 시점 | 사용 순서 | 만료 |
|---|---|---|---|
| 구독 토큰 | 30일 주기 시작일 | 먼저 사용 | 주기 시작일에 소멸 후 재적립. 이월 없음 |
| 충전팩 토큰 | 충전팩 구매 승인 시 | 구독 토큰 소진 후 사용 | 만료 없음 |
구독이 끝난 뒤에도 남은 충전팩 토큰은 그대로 남아 대화에 쓰입니다.
플랜 선택과 변경
- "플랜 선택" 또는 "플랜 변경"을 누릅니다. 쇼피파이 플랜 선택 페이지가 열립니다.
- 플랜을 고르고 승인합니다.
- 앱 홈으로 돌아오면 "플랜 변경을 확인하고 있어요" 안내 뒤에 배지가 새 플랜으로 바뀝니다.
플랜 변경은 올리든 내리든 즉시 적용됩니다. 이번 주기의 제공 토큰이 새 플랜의 양으로 바뀌고, 이번 주기에 이미 쓴 토큰은 그대로 셉니다. 상위 플랜으로 올리면 남은 토큰이 바로 늘어나고, 하위 플랜으로 내리면 이미 쓴 양이 새 제공량을 넘어 게이지가 가득 찬 상태로 보일 수 있습니다.
플랜을 바꾸면 승인한 시각부터 새 30일 주기가 시작됩니다. 남은 기간의 요금 정산은 쇼피파이가 청구서에서 처리합니다.
Premium에서 Light로 내리면 "상담원 설정"에 저장한 말투와 규칙은 지워지지 않고 적용만 멈춥니다. 다시 Premium으로 올리면 그대로 되살아납니다.
충전팩 구매
충전팩은 플랜을 구독 중일 때만 구매할 수 있습니다. 구독 전에는 버튼이 비활성화되고 "충전팩은 구독 중에만 구매할 수 있어요."가 표시됩니다.
- "충전팩 토큰" 아래에서 "{토큰 수} 토큰 충전 · $가격" 버튼을 누릅니다. 100만 토큰과 250만 토큰 두 가지입니다.
- 쇼피파이 승인 페이지가 열리면 결제를 승인합니다. 충전팩은 구매할 때마다 이 승인을 거칩니다.
- 앱 홈으로 돌아오면 "충전팩 토큰이 적립됐어요." 안내와 함께 잔액이 늘어납니다.
"결제 결과를 아직 확인하지 못했어요. 승인이 완료되면 자동으로 적립돼요."가 보이면 쇼피파이가 결제를 처리하는 중이거나 승인 페이지를 떠나 결정하지 않은 상태입니다. 승인한 결제라면 잠시 뒤 자동으로 적립되고, 승인하지 않았다면 적립되지 않습니다. 같은 팩을 다시 누르면 결제가 두 번 될 수 있으므로 잔액이 바뀌는지 먼저 확인합니다. "결제가 승인되지 않아 적립되지 않았어요."는 승인 페이지에서 결제를 거절한 경우입니다.
"일시 중지" 상태에서는 "결제 문제가 해결되면 충전팩을 다시 구매할 수 있어요."가 표시되고 구매가 막힙니다.
해지
쇼피파이 앱 구독의 해지는 앱 삭제입니다. 쇼피파이 관리자 > 앱에서 voidX AI를 삭제하면 구독은 현재 주기 말까지 유지되고 만료일에 끝납니다. 남은 기간의 요금은 돌려받지 않습니다.
같은 주기 안에 앱을 다시 설치하면 승인 화면 없이 바로 열리고 "구독이 {날짜}에 만료될 예정이에요" 안내가 뜹니다. 계속 쓰려면 "플랜 선택 페이지 열기"를 눌러 플랜을 다시 승인합니다. 다시 승인하면 그 시각부터 새 30일 주기가 시작됩니다. 만료 뒤에 다시 설치하면 "플랜 없음" 상태에서 시작하고, 남아 있던 충전팩 토큰은 그대로 쓸 수 있습니다.
다음 단계
- 설치 절차는 쇼피파이 앱을 참고하세요.
- 토큰이 차감되는 규칙은 토큰과 사용량을 참고하세요.
- 대화가 막혔을 때의 점검은 토큰 소진을 참고하세요.
- 방문자와 에이전트가 나눈 대화는 대화 내역 (쇼피파이)를 참고하세요.