사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
유료 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 사용 한도]에서 유료 API의 사용 한도를 설정하거나 상태를 확인할 수 있습니다.
| 항목 | 설명 |
|---|---|
| 기간별 한도 | 일 한도 또는 월 한도 |
| 최대 사용 한도 | 사용 가능한 유료 API에서 카카오톡 공유 유료 설정 시, 일 한도와 월 한도 설정 가능 한도가 설정되지 않은 경우(무제한), - 표시 |
| 사용 금액 | 일간 또는 월간 유료 API 사용 금액 한도가 설정되지 않은 경우(무제한), - 표시 한도가 설정된 경우, 사용 금액은 5분 단위로 집계 1시간 단위로 집계되는 [유료 API 사용 내역] 페이지와 사용 금액이 다를 수 있음 |
| 사용률 | 최대 사용 금액 대비 사용 금액 비율 |
| 상태 | 유료 API 호출 가능 상태
중요: 일 또는 월 한도 둘 중 하나라도 한도 초과 시, API 호출 불가 API 호출 제한을 해제하려면 더 높은 금액으로 한도 변경 |
| 관리 | 한도 금액을 변경하려면 [설정]을 눌러 [한도 금액]의 입력값 변경 한도 제한 없이 API를 호출하도록 허용하려면, 입력란을 비워두고(공란) 저장 |
내 앱과 연결된 비즈월렛을 변경하거나 연결을 해제할 수 있습니다. 자세한 방법은 비즈월렛 관리를 참고합니다.
비즈월렛 연결 해제 조건
- 비즈월렛 관리자만 가능
- 모든 유료 사용 API를 [사용 안 함]으로 설정
- 월렛의 잔액이 0 이상
앱 관리 페이지의 [유료 API] > [비즈 월렛 관리]에서 비즈월렛의 생성과 앱 연결 외에도 사업자, 결제 카드, 관리자와 같은 상세 정보를 변경할 수 있습니다. 앱의 오너 또는 에디터이고, 비즈월렛의 관리자인 경우에만 비즈월렛 관리가 가능합니다.
- [앱] > [유료 API] > [비즈월렛 관리]에서 비즈월렛 생성 가능
- 세금계산서를 발급받을 실제 정산 주체의 정보로 비즈월렛을 생성해야 함
- [앱] > [유료 API] > [비즈월렛 관리]에서 사용 가능 상태인 비즈월렛을 앱과 연결 가능
- 자동 결제 카드가 연결되어 있는 비즈월렛만 앱과 연결 가능
- [앱] > [유료 API] > [비즈월렛 연결 관리]에서 앱과 연결된 비즈월렛 변경 가능
- 자동 결제 카드가 연결되어 있는 비즈월렛으로만 변경 가능
- [앱] > [유료 API] > [비즈월렛 연결 관리]에서 앱과 비즈월렛 연결 해제 가능
- 비즈월렛은 즉시 연결 해제할 수 없으며 연결 해제 예약만 가능
- 연결 해제 예약 시, 다음 날 자정(0시) 이후 당월 유료 사용량에 대한 청구 금액 자동 결제 후 앱과 비즈월렛의 연결이 해제됨
앱의 관리자 변경은 멤버, 비즈월렛의 관리자 변경은 멤버 초대 및 관리자 요청을 참고합니다.
앱 관리 페이지의 [유료 API] > [유료 API 사용 내역]에서 유료 API 사용량과 예상 청구 금액을 확인할 수 있습니다. 아래 화면 구성 요소에 대한 상세 설명을 참고합니다.
| 항목 | 설명 |
|---|---|
| API | 사용 가능한 유료 API 이름 |
| 유료 사용량 | 해당 월 집계된 유료 사용량 |
| 단가 | 유료 사용량 1건당 가격 |
| 사용 금액 | 유료 사용량과 단가를 곱한 금액 |
| 합계 | 각 유료 API 사용 금액의 합 |
| 부가세액 | 합계에 대한 10%의 부가세, 예상 청구 금액에는 반영되지 않음 |
| 청구 금액 | 합계와 부가세액의 합, 실제 비즈월렛으로 청구되는 금액 |