과금청구 관리

API별로 발생한 월 단위 과금 청구 정보를 조회 및 관리할 수 있습니다.

  • 포털 관리자는 모든 사용자의 API 과금 정보를 조회 가능합니다.

  • 제공기관 관리자는 자신의 소속기관에서 등록한 API를 이용 중인 사용자의 과금 정보만 조회 가능합니다.

과금 정보 규칙

다음은 '과금 정보 기본 규칙'에 대한 설명입니다.

  • 매월 1일 08시에 전월에 발생한 과금 정보가 해당 메뉴에 자동 업데이트됩니다.

  • 현재 월의 과금 정보는 표시되지 않습니다.

    예) 현재 날짜가 2024년 3월 23일인 경우: '3월 청구분’의 과금 정보는 4월 1일에 확인 가능

  • 사용자가 '이용 중지'를 하거나, 관리자가 '운영 중지'를 하여 더이상 API를 사용할 수 없게 된 경우에도 동일하게 다음달 1일에 과금 정보가 발생합니다.

  • 과금 정보를 업데이트할 때, '납부 상태''입금 대기' 상태가 기본값으로 표시됩니다.

    단, 이용 요금이 0원(무과금 또는 API 미이용의 경우)인 과금 데이터는 '납부 완료' 상태로 자동 표시됩니다.

과금 데이터가 '입금 대기'일 경우에는 아래의 규칙이 적용됩니다.

  • 사용자(개인회원, 이용기관 사용자)가 회원탈퇴를 신청할 때, 자신이 신청해서 이용 중인 API의 납부 상태가 하나라도 '입금 대기' 상태이면 회원탈퇴가 불가능합니다.

  • 사용자가 애플리케이션을 삭제할 때, 해당 애플리케이션으로 이용했던 API의 납부 상태가 하나라도 '입금 대기' 상태이면 삭제가 불가능합니다.

과금청구 현황 조회

  1. API 포털에 관리자 계정으로 로그인 후 [운영 관리] > [과금청구 관리]를 클릭합니다.

    figure billing management navi

  2. 과금청구 관리 페이지가 열립니다. 해당 화면에 진입 시 기본값으로는 결과 미검색 상태로 화면 표시가 됩니다.

    figure billing management main

    • ① 조건 설정 영역

      항목 설명

      청구월

      현재 연월(YYYY-MM)이 표시됩니다. (기본값)

      조회 조건

      드롭다운 메뉴에서 API명, APP명, 이용기관, 신청자 중 조회할 조건을 선택합니다.

      [텍스트 필드 입력 조건]

      • 최대 50자까지 입력(공백 포함)

      • 영문/한글/숫자만 입력 가능

      제공기관

      전체 혹은 각 제공기관 목록 중 선택합니다.

      제공기관 관리자가 해당 화면에 접근 시에는 자신의 제공기관 이름이 고정으로 표시됩니다.

      납부 상태

      전체, 납부 완료, 입금 대기 중 조회하려는 옵션을 선택합니다.

      [초기화] 버튼

      검색 결과를 초기화하여 기본 검색 조건 상태로 변경합니다.

      [검색] 버튼

      입력 또는 선택한 검색 조건의 결과값을 출력합니다. 검색 결과가 없을 경우, 하단 리스트 영역에 '조회된 데이터가 없습니다.' 텍스트가 표시 됩니다.

      Like 검색 방식이 사용되며, 2개 이상의 검색 조건을 설정 후 검색할 경우 AND 검색 방식이 적용됩니다.

    • ② 총 금액 표시 영역

      현재 검색 결과 기준 총 이용 요금, 총 할인 요금, 총 최종 요금이 표시됩니다.

    • ③ 검색 결과 영역

      상단의 검색 조건 입력 후 [검색] 버튼을 클릭하면 조건에 해당하는 데이터가 목록으로 표시됩니다. 목록의 각 항목은 과금청구 상세 조회를 참고합니다. 목록의 각 항목을 클릭하면 해당 데이터의 상세 화면이 실행됩니다.

    • ④ [엑셀 다운로드] 버튼

      현재 검색 결과 기준으로 리스트 영역의 정보를 엑셀 파일로 자동 다운로드합니다.

과금청구 상세 조회

  1. [운영 관리] > [과금청구 관리] 메뉴를 클릭합니다.

  2. 과금청구 관리 화면의 목록에서 각 항목을 클릭하면 해당 과금청구 현황에 대한 상세 조회 화면이 나타납니다.

    과금청구 상세 화면에서는 수정 화면으로 진입이 불가능하며 과금 청구 정보의 삭제도 불가능합니다.

    • ① 신청 정보

      figure billing details

      항목 설명

      API명

      과금청구 대상인 API 이름

      APP명

      해당 API를 이용하는 사용자의 애플리케이션 이름

      청구월

      과금청구 기준이 되는 API의 실제 이용월

      납부상태

      납부 상태 (납부 완료, 입금 대기)

      이용기관

      이용기관의 이름

      신청자

      신청자의 이름

      요금 구분

      과금 정책의 요금 구분 (건별, 월별, 구간별)

      이용 신청일

      사용자가 해당 API의 이용 신청을 한 신청일자

      납부 상태 등록자/등록일시

      관리자가 [납부 상태 변경] 버튼을 통해 납부 상태를 변경할 경우 자동으로 표시되는 정보입니다.

      납부 상태를 여러 차례 변경한 경우에는 가장 최근 변경 기준의 등록자, 등록일시가 표시됩니다.

    • ② 납부상태 변경

      해당 과금 정보의 납부 상태를 변경하는 기능으로, 관리자는 납부 상태를 자유롭게 변경할 수 있습니다.

      [과금청구 상세] 페이지의 신청 정보 필드 옆의 [납부상태 변경] 버튼을 클릭합니다.

      figure change payment status button

      납부 상태 변경 화면이 나타나면 납부 상태(입금 대기, 납부 완료)를 변경합니다.

      figure change payment status dialog

      '납부 상태 변경' 화면의 [적용] 버튼을 클릭하면 해당 과금 정보의 납부 상태가 즉시 변경 완료됩니다.

    • ③ 요금 정보

      요금에 대한 상세 내용을 조회합니다.

      figure pricing info

      항목 설명

      이용 요금 (원)

      과금 정책에 따라 청구되는 금액이 표시됩니다.

      이용 건수 (건)

      청구월에 사용한 API 이용건수(성공건수 기준)가 표시됩니다.

      할인 요금 (원)

      '할인 정보 관리' 화면에서 입력한 할인 요금 정보가 표시됩니다.

      • 할인 정보를 입력하지 않은 경우: 공란으로 표시

      • 할인 정보가 여러 번 수정될 경우: 가장 최근에 등록한 기준으로 할인 요금 표시

      할인 사유

      '할인 정보 관리' 화면에서 입력한 할인 사유 정보가 표시됩니다.

      • 할인 정보를 입력하지 않은 경우: 공란으로 표시

      • 할인 정보가 여러 번 수정될 경우: 가장 최근에 등록한 기준으로 할인 사유 표시

      할인 정보 등록자/등록일시

      할인 정보를 입력한 관리자 이름과 등록일시가 표시됩니다.

      • 할인 정보를 입력하지 않은 경우: 공란으로 표시

      • 할인 정보가 여러 번 수정될 경우: 가장 최근에 등록한 기준으로 등록자 및 등록일시 표시

      최종 요금 (원)

      이용 요금에서 할인 요금을 뺀 최종 청구 금액입니다.

      할인 요금 정보가 없을 경우, 이용 요금과 동일합니다.

    • ④ 할인 정보 관리

      관리자의 판단에 의해 할인을 적용할 때 사용하는 기능으로, 관리자는 할인 정보를 자유롭게 변경할 수 있습니다. 할인 정보는 수기 입력으로만 적용 가능합니다.

      [과금청구 상세] 페이지의 요금 정보 필드 옆의 [할인 정보 관리] 버튼을 클릭합니다.

      figure discount info buttons

      '할인 정보 관리' 화면이 실행되면 할인 요금과 할인 사유(최대 20자 입력 가능)를 입력합니다.

      figure discount info dialog

      이때, 할인 요금은 해당 과금 정보의 이용 금액을 초과하여 입력할 수 없습니다. '할인 정보 관리' 화면의 [적용] 버튼을 클릭하면 해당 과금 정보에 할인 정보가 자동으로 표시됩니다.

    • ⑤ 과금 정책 확인

      해당 API에 적용중인 과금 정책 정보를 확인하는 기능입니다.

      [과금청구 상세] 페이지의 요금 정보 필드 옆의 [과금 정책 확인] 버튼을 클릭합니다.

      figure billing policy info buttons

      '과금 정책' 화면이 나타나면 과금 정책 상세 정보를 확인할 수 있습니다.

    • ⑥ 과금 이력

      해당 API를 이용하면서 발생하였던 과금 청구 이력이 청구월 단위로 표시됩니다.

      figure billing history

      '상세정보' 항목의 [보기] 버튼을 클릭하면 해당 청구월의 과금 상세 정보 화면이 실행됩니다.