크레딧 충전과 만료
XenoCI는 선불 USD 크레딧에서 실행한 초만큼 차감합니다, 요율, 충전 방법, 충전 건별 1년 만료, 잔액이 0일 때의 동작, 사용하지 않은 충전 건의 7일 환불을 설명합니다
XenoCI는 선불 크레딧제입니다, 조직 지갑에 USD 크레딧을 충전해 두면 잡이 실행한 초만큼 차감됩니다, 구독, 최소 약정, 자동 충전은 없습니다
요율
| 항목 | 값 |
|---|---|
| 분당 요율 (런칭가) | US$0.0396, 부가세 포함 |
| 정가 | US$0.078 (취소선 표시, 49% 할인) |
| 과금 단위 | 초 단위, 잡마다 최소 60초, 초 미만은 버림, 예시는 요금 |
| 금액 | 과금 초 × 분당 단가 / 60을 센트 단위로 반올림, 잔액과 사용액은 항상 센트 두 자리 |
| 요율 고정 시점 | 잡이 대기열을 떠나 준비를 시작하는 순간, 잡 응답의 rate_usd_per_min |
| 1시간 빌드 | US$2.38 |
과금되지 않는 것
- VM 준비 시간(슬롯 확보부터 스크립트 시작까지)
- 대기 중이나 준비 중에 취소한 잡(0분)
- 플랫폼 오류(
platform_error)로 끝난 잡, 서버 재시작으로 끊긴 잡
충전하기
소유자와 관리자만 충전할 수 있습니다, 결제는 원화 카드 결제(PortOne 경유)이고 USD 크레딧이 적립됩니다
- 콘솔 왼쪽 아래 크레딧 또는 크레딧 구매를 누릅니다
- 금액을 고릅니다, US$5, US$20, US$50, US$100 또는 기타에서 US$5 이상 US$1,000 이하의 정수
- 결제 수단을 고르고 필요하면 사업자 등록번호(선택)를 넣습니다, 번호는 저장만 되고 세금계산서는 발행되지 않습니다
- 총 결제 금액(원화)을 확인하고 주문을 누르면 결제창이 열립니다
- 결제가 끝나면 잔액에 바로 적립됩니다
| 규칙 | 내용 |
|---|---|
| 가격 | 부가세 포함, US$N을 충전하면 US$N을 내고 US$N 크레딧을 받습니다 |
| 원화 금액 | ceil(USD × 고정 환율), 환율은 주문 때 고정됩니다 |
| 고정 환율 | 한국은행 고시 매매기준율 × 1.02, KST 영업일마다 한 번 정해지고 주말과 공휴일은 직전 영업일 값 |
| 주문 유효 시간 | 60분, 지나면 만료되고 새 주문을 만듭니다 |
| 환율이 없을 때 | 그날 환율이 아직 없으면 충전이 잠시 닫힙니다(fx_rate_unavailable) |
CLI와 MCP는 결제를 하지 않습니다, xenocast credits topup --open은 콘솔 충전 링크만 엽니다
잔액의 세 가지 숫자
| 이름 | 뜻 |
|---|---|
잔액 (balance) | 원장 합계 |
사용 가능 (available) | 만료되지 않은 충전 건의 남은 합에서 실행 중인 잡이 이미 쓴 금액을 뺀 값, 새 잡 승인은 이 값으로 합니다 |
사용 중 (reserved) | 실행 중인 잡이 이미 쓴 금액, 잡이 시작되면 1분이 잡히고 그 뒤 실행한 만큼 늘어납니다 |
콘솔 크레딧 화면, xenocast credits, MCP credits 도구, API 잔액 조회에서 봅니다
만료
- 충전 한 번이 한 건이고 결제일로부터 1년 뒤 같은 시각(UTC)에 만료됩니다, 2월 29일 결제는 2월 28일에 만료됩니다
- 여러 건이 있으면 만료가 빠른 건부터 먼저 씁니다
- 만료된 금액은 원장에
expiry행으로 남고 잔액에서 빠집니다 - 콘솔 크레딧 → 충전 건에 건마다 만료일과 남은 금액, 곧 만료 표시가 있습니다
잔액이 0이 되면
| 상황 | 동작 |
|---|---|
| 새 잡 제출 | 사용 가능 잔액이 1분 요금(US$0.04)보다 적으면 402 insufficient_credit, 응답에 잔액과 topup_url |
| 실행 중인 잡 | 잔액이 다음 1분을 감당하지 못하면 잡을 멈춥니다, 잡 상태와 end_reason은 credit_exhausted이고 멈춘 순간까지 실행한 초만 과금합니다 |
| 대기 중인 잡 | 슬롯을 받는 순간 다시 검사해 잔액이 없으면 credit_exhausted로 끝납니다 |
| 정산 | 잔액은 음수가 되지 않습니다, 살아 있는 충전 건까지만 차감합니다 |
CLI, MCP, GitHub Action은 이 오류를 종료 코드 3으로 끝내고 충전 링크를 한 줄로 남깁니다
알림
| 알림 | 언제 |
|---|---|
| 낮은 잔액 | 사용 가능 잔액이 US$1.19(런칭가 30분어치) 이하로 떨어지는 순간, 조직당 24시간에 한 번 |
| 잔액 소진 | 실행 중인 잡이 credit_exhausted로 끊겼을 때, 충전 주기마다 한 번 |
수신자는 소유자와 관리자이고 알림에서 종류별로 끌 수 있습니다
7일 환불
사용하지 않은 충전 건은 결제 승인 후 7일 안에 콘솔에서 바로 환불할 수 있습니다
충전 내역 열기
크레딧 → 충전 내역에서 환불할 건을 찾습니다
환불 신청
그 건의 환불을 누르고 확인 창에서 다시 환불을 누릅니다, 신청하는 순간 그 건의 크레딧이 잔액에서 빠져 잡이 더는 쓰지 못합니다
결과 확인
결제한 원화 전액이 카드로 취소되고 크레딧 원장에
withdrawal행이 남습니다, 환불 메일이 갑니다
환불할 수 있는 건
| 조건 | 내용 |
|---|---|
| 기간 | 그 건의 결제 승인 후 7일 안 |
| 사용 여부 | 그 건에서 1센트도 차감되지 않은 건만, 조금이라도 쓰였으면 환불할 수 없습니다 |
| 상태 | 이미 환불, 부분 환불, 결제 분쟁이 있었던 건은 환불할 수 없습니다 |
| 결제 확인 | 서버가 결제사에 승인 완료인지 다시 확인한 뒤 취소합니다 |
| 실행 중인 잡 | 그 건을 잠근 뒤 남은 잔액으로 실행 중인 잡을 정산할 수 없으면 신청이 거절됩니다, 잡이 끝난 뒤 다시 신청하세요 |
| 같은 건 두 번 | 같은 건에 다시 신청하면 처음 신청의 결과를 그대로 돌려줍니다 |
| 횟수 | 조직마다 30일에 3번까지입니다 |
충전 건마다 따로 판단합니다, 크레딧은 만료가 빠른 건부터 쓰이므로 예를 들어 US$50을 충전해 US$30을 쓰고 US$100을 더 충전한 뒤 US$20을 더 쓰면, US$50 건이 다 쓰이고 US$100 건은 그대로 남아 US$100 건을 환불할 수 있습니다
- 7일이 지나면
409 withdrawal_window_closed, 그 밖의 조건에 맞지 않으면409 refund_not_allowed이고 이유는details.reason에 있습니다 (credit_in_use,too_many_refunds등) - API로는 충전 청약철회를 씁니다
- 환불한 금액은 티어 누적 충전액에서 빠지지만 티어는 내려가지 않습니다
- 이 환불은 고객이 요청한 정상 취소라서 결제 분쟁(차지백)으로 보지 않고 계정에 아무 제한도 생기지 않습니다