다음 결제일·예상 요금 조회

GET/crm-core/v1/plans/me/next-billing
다음 자동 갱신일과 그 시점에 결제될 예상 금액의 breakdown을 반환한다. seatCharge(인원 × 단가), estimatedOverage(추정 초과 요금), subtotal(공급가액), taxAmount(VAT), totalCharge(최종 청구가)로 구성된다. 대시보드 요금 위젯에서 "다음 청구 미리보기" 렌더링에 사용한다.

Response

Name	Type	Required	Description
nextBillingDate	date		다음 결제 예정일 (= subscriptionRenewsAt). FREE/INACTIVE면 null
tier	string		현재 티어
paidSeats	number		현재 유료 좌석 수
scheduledSeats	number		다음 갱신일에 적용될 좌석 수
unitPrice	number		1인 월 단가 (KRW, VAT 포함)
breakdown	Object		결제 금액 내역
breakdown.seatCharge	number		좌석 요금 (paidSeats × unitPrice, VAT 포함)
breakdown.estimatedOverage	number		추정 초과 요금 (현재는 0, 스냅샷 시점에 계산)
breakdown.subtotal	number		공급가액 (VAT 제외 소계)
breakdown.taxAmount	number		부가세
breakdown.totalCharge	number		최종 청구 금액 (VAT 포함)
note	string	*	플랜별 안내 문구 (FREE / ENTERPRISE / 유료)

Structure

코드 예제

const response = await fetch('https://api.solapi.com/crm-core/v1/plans/me/next-billing', {
  method: 'GET',
  headers: { 'Authorization': 'Bearer ' + TOKEN }
});
const { nextBillingDate, breakdown } = await response.json();
console.log(${new Date(nextBillingDate).toLocaleDateString()}에 ${breakdown.totalCharge.toLocaleString()}원 결제 예정);

import requests
response = requests.get(
    'https://api.solapi.com/crm-core/v1/plans/me/next-billing',
    headers={'Authorization': f'Bearer {TOKEN}'}
)
data = response.json()

curl -X GET 'https://api.solapi.com/crm-core/v1/plans/me/next-billing' \
  -H 'Authorization: Bearer YOUR_TOKEN'