메인 콘텐츠로 건너뛰기
확정한 인보이스는 고치거나 지우거나 취소할 수 없습니다. 인보이스를 수정, 삭제, 취소, 무효화, 재발행하는 API와 화면이 없고, 같은 고객과 달로 다시 확정해도 새 인보이스가 생기지 않습니다. 테스트 환경에서 확정한 인보이스도 같습니다.

확정할 때 고정되는 값

아래 값은 확정할 때 저장되고, 조회할 때 다시 계산하지 않습니다. GET /v1/invoices와 GET /v1/invoices/{id}는 언제 불러도 확정 시점의 값을 돌려줍니다.
  • 기본료와 최소 사용료 조정 라인에는 미터가 없어 billable_metric_name이 null입니다.
  • invoice_number는 고객에게 보여 주는 인보이스 번호이며 세금계산서나 영수증 번호가 아닙니다. MeterEngine은 전자세금계산서를 발행하지 않습니다. 공급자 정보를 보세요.

확정한 고객의 그 달 늦은 이벤트

확정한 고객에게 확정 뒤 들어온 그 달 이벤트는 청구되지 않습니다. 이벤트는 저장되지만 그 고객의 그 달 인보이스에는 더해지지 않고, 다음 달 금액에도 들지 않습니다. 집계 마감(다음 달 1일 13:00 KST) 전에 확정했다면 마감 전까지 받은 이벤트도 여기에 해당합니다. 확정 시점에 따른 차이는 인보이스 수동 확정을 보세요. 보낸 이벤트는 고치거나 지울 수 없습니다. 확정한 달은 어느 미터든 정정할 수 없으니, 잘못 보낸 이벤트는 확정 전에 바로잡으세요. 방법은 사용량 이벤트 보내기를 보세요.

확정 뒤에도 바뀌는 것

인보이스 자체는 그대로이고, 인보이스에 딸린 아래 기록만 바뀝니다.
  • 수납 상태와 결제 시도: 결제를 요청하고 결과가 확인되면 수납 상태가 바뀝니다.
  • 결제 취소: 결제를 취소해도 인보이스 금액은 바뀌지 않습니다. 자세한 내용은 결제 취소를 보세요.
  • 조회 링크: 고객에게 보여 줄 조회 링크를 만들거나 폐기할 수 있습니다. 고객에게 인보이스 보여 주기를 보세요.
콘솔 ‘수납과 취소’ 화면에서 고객을 눌러 여는 수납 화면에도 ‘확정 금액은 결제와 취소 이후에도 보존됩니다’라고 표시됩니다.

잘못 확정했을 때

확정한 인보이스를 바로잡는 기능은 없습니다. 할 수 있는 일은 아래뿐입니다.
  • 결제는 자동으로 시작되지 않으므로, 금액이 틀린 인보이스에는 결제를 요청하지 않을 수 있습니다.
  • 이미 결제했다면 결제 취소로 금액 일부나 전부를 돌려줄 수 있습니다. 이때도 인보이스의 확정 금액은 그대로 남습니다.
그래서 아래 점검을 확정 전에 마치는 것이 중요합니다.

확정 전 점검

아래 항목은 확정한 뒤에는 고칠 수 없습니다. 확정하기 전에 청구 예정액(GET /v1/invoices/draft?month=YYYY-MM 또는 콘솔 ‘청구 검토’ 화면)에서 확인하세요.
  1. 업무 환경: 확정하려는 업무 환경이 맞는지 봅니다. 콘솔 확인 창 제목에 업무 환경 이름이 나옵니다.
  2. 집계 마감: 지난달이면 다음 달 1일 13:00 KST가 지났는지 봅니다. 콘솔 ‘청구 검토’ 화면에 ‘집계 기준 2026-11-01 13:00 KST까지 받은 사용량’처럼 표시되면 마감이 지난 달입니다.
  3. 단가 없는 사용량: 고객마다 unpriced_usages가 빈 배열인지 봅니다. 콘솔에서는 ‘기타 (단가 없음)’ 줄입니다. 이 사용량은 청구되지 않고, 끝난 달에는 단가를 새로 넣을 수 없습니다. 조합 규칙은 차원과 속성 조합을 보세요.
  4. 음수 사용량: 고객마다 negative_usages가 빈 배열인지 봅니다. 여기에 나온 조합은 금액 0원으로 보고 라인에서 빠집니다.
  5. 청구에서 빠진 이벤트: 미터와 맞지 않는 type, 숫자가 아닌 값처럼 금액에 들지 않은 이벤트가 없는지 봅니다. 확인 방법은 보낸 데이터 확인하기를 보세요.
  6. 고객 이름과 미터 이름: 인보이스에 남는 이름이 맞는지 봅니다. 확정 뒤에 고쳐도 인보이스에는 반영되지 않습니다.
모두 확인했으면 인보이스 수동 확정의 절차로 확정합니다.

확정 뒤 할 일

확정한 뒤 인보이스마다 결제를 요청해야 합니다. MeterEngine은 메일을 보내지 않으니 인보이스 안내도 도입사가 직접 전달합니다.

첫 결제 요청과 결과 확인

확정한 인보이스의 결제를 요청하고 결과를 확인합니다.

고객에게 인보이스 보여 주기

조회 링크를 만들어 고객에게 전달합니다.

고객 카드 등록 링크

결제할 카드가 없는 고객에게 카드 등록 링크를 보냅니다.

결제 취소

결제한 금액을 돌려줄 때 씁니다. 인보이스 금액은 바뀌지 않습니다.