기본료와 최소 사용료

• 월 기본료(base_fee): 그 달 사용량이 있는 고객에게 붙는 고정 금액입니다.
• 월 최소 사용료(minimum_amount): 사용료가 이 금액보다 작으면 차액을 더해 최소 이 금액을 청구합니다.

​

계산 순서

​

10원 미만 버림

• 월 기본료 9,999원으로 저장하면 기본료 라인은 9,990원입니다.
• 월 최소 사용료 15,005원으로 저장하면 15,000원을 기준으로 차액을 계산합니다.
• 월 기본료가 10원보다 작으면(예: 5원) 기본료 라인이 생기지 않습니다.

​

요금제가 붙는 고객

• 미터의 단위 변환과 반올림을 거친 수량으로 판단합니다. 수량이 반올림으로 0이 된 조합은 사용량으로 보지 않습니다.
• 단가가 없는 조합의 사용량도 사용량으로 셉니다. 단가를 등록하지 않은 조합만 쓴 고객도 기본료가 붙고, 사용료가 0원이므로 최소 사용료 전액이 조정 라인으로 청구됩니다. 단가 없는 사용량은 청구 예정액 응답의 unpriced_usages에 나옵니다. 단가는 차원과 속성 조합에서 조합마다 정확히 맞춰 등록하세요.
• 집계한 값이 음수인 조합(예: 상계 이벤트로 합이 음수가 된 조합)은 사용량으로 보지 않습니다. 이 조합은 0원으로 보고 라인에서 빠지며 negative_usages에 나옵니다.

​

공통 요금제와 고객 요금제

• 고객 요금제가 있으면 그 고객에게는 공통 요금제를 쓰지 않습니다. 두 요금제를 더하지 않고 고객 요금제가 공통 요금제를 대신합니다. 예를 들어 공통 요금제가 기본료 500원, 최소 사용료 1,000원이고 고객 요금제가 기본료 200원, 최소 사용료 400원이면, 사용료 100원인 그 고객의 청구 예정액은 100원 + 조정 300원 + 기본료 200원 = 600원입니다.
• 그 달에 적용되는 고객 요금제 버전이 없으면(첫 버전의 시작 월 전, 모든 버전의 종료 월이 지난 뒤, 가장 늦은 버전이 보관으로 멈춘 뒤) 그 고객에게는 공통 요금제가 적용됩니다.
• 고객 id는 고객 등록 응답의 id입니다. 외부 고객 ID가 아닙니다. 자세한 내용은 고객 등록과 ID 대응을 보세요.

​

적용 기간과 버전

• 이번 달은 한국 시간(KST) 기준입니다. 매월 1일 00:00 KST가 지나면 지난달 요금제는 새로 넣거나 바꿀 수 없습니다. 시각 규칙은 시간 규칙을 보세요.
• 같은 대상(공통 또는 같은 고객)과 같은 시작 월로 다시 등록하면 그 버전을 덮어쓰고 201을 돌려줍니다. 새 버전이 생기지 않습니다.
• 요금은 일할 계산하지 않습니다. 월 중간에 등록해도 그 달 전체에 적용되고, 이번 달에 시작한 버전을 덮어쓰면 이번 달 1일부터의 청구 예정액이 모두 바뀝니다.
• 한 달에 걸리는 버전이 여럿이면 시작 월이 가장 늦은 버전을 씁니다.
• 확정한 인보이스는 요금제를 바꿔도 바뀌지 않습니다.

​

요금제 등록하기

curl -X POST https://meterengine.com/v1/price-plans \
  -H "Authorization: Bearer me_test_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "effective_from": "2026-11",
    "base_fee": 500,
    "minimum_amount": 12000
  }'

const response = await fetch("https://meterengine.com/v1/price-plans", {
  method: "POST",
  headers: {
    Authorization: "Bearer me_test_xxxxxxxx",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    effective_from: "2026-11",
    base_fee: 500,
    minimum_amount: 12000,
  }),
});
const plan = await response.json();

{
  "id": "3f6c1d2a-9b4e-4c7a-8e15-6d2f0a9b7c34",
  "customer_id": null,
  "effective_from": "2026-11",
  "effective_until": null,
  "base_fee": 500,
  "minimum_amount": 12000,
  "archived_at": null,
  "archived_from": null
}

​

등록할 때의 오류

​

요금제 조회와 함정

curl "https://meterengine.com/v1/price-plans?status=all" \
  -H "Authorization: Bearer me_test_xxxxxxxx"

{
  "price_plans": [
    {
      "id": "3f6c1d2a-9b4e-4c7a-8e15-6d2f0a9b7c34",
      "customer_id": null,
      "effective_from": "2026-11",
      "effective_until": null,
      "base_fee": 500,
      "minimum_amount": 12000,
      "archived_at": null,
      "archived_from": null
    }
  ]
}

​

보관과 복원