ApiBilling

API 과금 엔진 — 원가 추정, 안전마진, 고객별 판매가, 역마진 보정

상태

항목	값
Layer	composite
Tier	Business
Status	released
Version	1.0.0
가격	Free (subscription)
**카�
�고리**	AI / LLM

개요

개요

ApiBilling 은 multi-saas-kit 의 API 과금/정산 엔진� 니다. ApiUsageAnalytics 가 실제 사용량과 provider 실제 비용 동기화를 담당하고, ApiBilling 은 그 위에서 4개 레이어의 금액 정� 을 관리합니다.

1. provider raw cost estimate — provider 가격표 기준 예측 원가
2. buffered internal cost — retry/fallback/장애/지원 비용을 반영한 내부 안전마진 원가
3. customer rate card — tenant/customer 별 판매 단가
4. reconciliation adjustment — 실제 원가 확정 후 역마진 발생 시 다음 정산 주기 보정

핵심 기능

• API 상품 코드(product_code)별 내부 원가 정�

• tenant 별 rate card 및 상품별 판매 단가

• billing event 단위의 계산 snapshot 보존

• 정� 변경 audit log 자동 기록

• 실제 provider cost 확정 후 역마진 보정 adjustment 생성

• 고객 화면용 금액 presenter 와 운영자 화면용 presenter 분리

• billing event 생성과 사후 정산의 transaction 보장

• usage log 삭제 시에도 billing event 보존

• rate card 누락을 rate_card_missing 상태로 � 시 기록

ApiUsageAnalytics 와의 관계

• ApiUsageAnalytics: usage log, actual cost sync, spend-log aggregation
• ApiBilling: pricing policy, rate card, customer billable amount, reconciliation

두 플러그인은 같은 usage event 를 보지만 � 임이 다� 니다. 고객에게 � �출되는 사용금액은 ApiBilling 의 customer billable amount 를 기준으로 표시합니다.

라이선스

MIT

의존성

• ApiUsageAnalytics

---

🛒 Plugin Store에서 보기: store.codebase.how/plugins/api-billing