페이지 이동경로
  • 문서>
  • 앱 설정>
  • 유료 API

앱 설정

유료 API

이 문서는 유료 API 사용 시 필요한 설정에 대해 안내합니다.

사용 가능한 유료 API무료 제공 쿼터를 소진한 경우, 비즈월렛에 결제 수단을 연결해 API를 추가로 호출할 수 있습니다. 아래 항목별 안내를 확인합니다.

참고: 유료 호출 요금

API별 유료 호출 요금은 추가 쿼터 사용 요금에서 확인할 수 있습니다.

유료 API 사용 과정

유료 API 설정의 전체 과정을 안내합니다. 과정별 참고 문서에서 자세한 내용을 확인할 수 있습니다.

순서 작업 설정 및 확인 위치 참고 문서
1 비즈월렛 생성 [유료 API] > [비즈월렛 관리] 비즈월렛 관리
2 유료 결제 시 사용할 결제 카드를 비즈월렛에 등록 카카오비즈니스의 [내 비즈월렛] > [내 결제 카드] 결제 카드 관리
3 비즈월렛과 앱과 연결 [유료 API] > [비즈월렛 관리] 비즈월렛 관리
4 유료 API 사용 설정 [유료 API] > [사용 가능한 유료 API] 유료 사용 설정
5 월 단위로 유료 API 사용량과 예상 청구 금액 확인 [유료 API] > [유료 API 사용 내역] 유료 사용량
6 매달 1일 오전 1시 경 비즈월렛으로 월별 청구 금액 자동 결제 카카오비즈니스의 [내 비즈월렛] > [결제 내역] 거래 내역/변경 이력 확인

일반

연결된 비즈월렛

앱 관리 페이지의 [유료 API] > [일반] > [연결된 비즈월렛]에서 앱과 연결된 비즈월렛 정보를 확인할 수 있습니다. 비즈월렛 생성, 연결, 변경, 해제 방법은 비즈월렛 관리를 참고합니다.

참고: 비즈월렛

기능 소개, 결제, 세금계산서 발행 등 비즈월렛에 대한 자세한 정보는 비즈니스 가이드에서 확인할 수 있습니다.

사용 가능한 유료 API

앱 관리 페이지의 [유료 API] > [일반] > [사용 가능한 유료 API]에서 유료 사용 설정이 가능한 API 목록을 확인할 수 있습니다. 앱이 권한을 가지고 있는 항목만 목록에 표시됩니다. API별 실제 사용량을 집계하고 요금을 청구하는 세부 API 목록은 추가 쿼터 사용 요금에서 확인할 수 있습니다.

API 설명 관련 문서
카카오맵 웹과 앱 서비스에서 사용할 수 있는 카카오맵의 콘텐츠와 데이터 제공 지도
로컬
유료 사용 설정

[유료 API] > [일반] > [사용 가능한 유료 API]에서 각 유료 API의 [설정]을 선택해 사용 가능한 유료 API의 유료 사용 여부를 설정할 수 있습니다. 유료로 사용하도록 설정하려면 앱과 비즈월렛이 서로 연결되어 있어야 합니다.

설정 설명
사용 안 함 유료로 사용하지 않도록 설정
사용 중 유료로 사용하도록 설정
유료 사용량에 따라 비즈월렛으로 비용 청구
주의: 유료 사용 설정 변경

유료 API의 설정을 [사용 중]에서 [사용 안 함]으로 변경할 경우, 쿼터 초과 에러로 서비스 장애가 발생할 수 있습니다. 설정 변경 시 서비스 상태와 쿼터 잔여량을 반드시 확인해야 합니다.

비즈월렛 연결 관리

내 앱과 연결된 비즈월렛을 변경하거나 연결을 해제할 수 있습니다. 자세한 방법은 비즈월렛 관리를 참고합니다.

비즈 월렛 연결 해제 조건
  • 비즈월렛 관리자만 가능
  • 모든 유료 사용 API를 [사용 안 함]으로 설정
  • 월렛의 잔액이 0 이상

비즈월렛 관리

앱 관리 페이지의 [유료 API] > [비즈 월렛 관리]에서 비즈월렛의 생성과 앱 연결 외에도 사업자, 결제 카드, 관리자와 같은 상세 정보를 변경할 수 있습니다. 앱의 오너 또는 에디터이고, 비즈월렛의 관리자인 경우에만 비즈월렛 관리가 가능합니다.

생성

  • [앱] > [유료 API] > [비즈월렛 관리]에서 비즈월렛 생성 가능
  • 세금계산서를 발급받을 실제 정산 주체의 정보로 비즈월렛을 생성해야 함

연결

  • [앱] > [유료 API] > [비즈월렛 관리]에서 사용 가능 상태인 비즈월렛을 앱과 연결 가능
  • 자동 결제 카드가 연결되어 있는 비즈월렛만 앱과 연결 가능

변경

  • [앱] > [유료 API] > [비즈월렛 연결 관리]에서 앱과 연결된 비즈월렛 변경 가능
  • 자동 결제 카드가 연결되어 있는 비즈월렛으로만 변경 가능

연결 해제

  • [앱] > [유료 API] > [비즈월렛 연결 관리]에서 앱과 비즈월렛 연결 해제 가능
  • 비즈월렛은 즉시 연결 해제할 수 없으며 연결 해제 예약만 가능
    • 연결 해제 예약 시, 다음 날 자정(0시) 이후 당월 유료 사용량에 대한 청구 금액 자동 결제 후 앱과 비즈월렛의 연결이 해제됨
참고: 관리자 변경

앱의 관리자 변경은 멤버, 비즈월렛의 관리자 변경은 멤버 초대 및 관리자 요청을 참고합니다.

유료 API 사용 내역

앱 관리 페이지의 [유료 API] > [유료 API 사용 내역]에서 유료 API 사용량과 예상 청구 금액을 확인할 수 있습니다. 아래 화면 구성 요소에 대한 상세 설명을 참고합니다.

항목 설명
API 사용 가능한 유료 API 이름
유료 사용량 해당 월 집계된 유료 사용량
단가 유료 사용량 1건당 가격
사용 금액 유료 사용량과 단가를 곱한 금액
합계 각 유료 API 사용 금액의 합
부가세액 합계에 대한 10%의 부가세, 예상 청구 금액에는 반영되지 않음
청구 금액 합계와 부가세액의 합, 실제 비즈월렛으로 청구되는 금액