Search

카카오 T 비즈니스 API v2

업무용으로 이용한 카카오 T 이용 내역을 사내 시스템에 연동하고 싶으신가요? 비즈니스 API를 활용하여 간편하게 자동화해 보세요.
💡 본 문서는 최신 버전(v2) 기준입니다. 신규 연동 시 v2 사용을 권장드리며, 기존 이용 고객은 [카카오 T 비즈니스 API v1]을 참고해 주세요.
💬 문의
[우측 > 하단 > 채팅 상담] 또는 비즈니스 메일(biz.cs@kakaomobility.com)로 문의 주세요.
🕑 상담시간
평일 10시 - 17시 (주말, 공휴일 제외)

API 연동

개발환경 API 연동과 테스트를 먼저 진행 하신 후 운영환경 API를 연동해 주세요.

API 목록

도메인

항목
도메인
카카오 T 비즈니스 API
개발환경 : https://mob-b2b-dev.kakao.com 운영환경 : [관리시스템 > 설정 > 카카오 T 비즈니스 API 연동정보 > 운영환경 API 도메인]
카카오 T 비즈니스 API 관리시스템

연동 프로세스

순서
API 연동 개발자 역할
카카오 T 비즈니스 운영자 역할
1. 사용할 API 확인
[API 목록 v2] 중 필요한 API를 확인해 주세요. 제공 중인 API 외 다른 API가 필요하거나, 제공 중인 API에 추가 스펙이 필요하다면 biz.cs@kakaomobility.com 으로 문의해 주세요. ※ 제공 중인 API의 스펙은 당사의 사정에 의해 추가/수정/삭제될 수 있습니다.
2. [개발환경] 관리시스템 계정 생성
[개발환경 관리시스템]에 접속하신 후 계정을 만들어 주세요. ※ 개발환경에서는 인증문자가 발송되지 않습니다. 가입/로그인 시 휴대전화 인증번호: 1234 입력
3. [개발환경] 그룹 생성 및 설정
운영 계획에 맞춰 [관리시스템 > 그룹 관리]에서 그룹 생성 및 설정을 완료해 주세요. • 그룹은 직원의 묶음을 뜻합니다. 목적 단위(야근, 외근 등)나 팀 단위(경영지원팀, 영업팀 등)로 자유롭게 그룹을 구성할 수 있습니다. 1명의 직원이 여러 그룹에 동시에 속할 수 있습니다. 그룹별 결제 카드 및 이용 제한 조건(위치 제한, 시간 제한, 결제 한도 설정)을 달리 설정할 수 있습니다.
• 등록된 직원 인증 처리
4. [개발환경] API 연동
카카오 T 비즈니스 API 호출시 필요한 액세스 토큰을 발급하기 위해서는 클라이언트 시크릿(Client secret) 발급과 T 비즈 ID 확인이 필요합니다. T 비즈 ID: [관리시스템 > 설정 > 계정정보 > T 비즈 ID] 클라이언트 시크릿: [관리시스템 > 설정 > 카카오 T 비즈니스 API 연동정보 > Client secret] 클라이언트 시크릿과 T 비즈 ID를 통해 [액세스 토큰 발급 API] 를 호출하여 액세스 토큰을 발급해주세요. 발급된 액세스 토큰을 통해 원하시는 카카오 T 비즈니스 API(이용내역·그룹·직원 등 API)를 테스트해주세요. ※ 개발환경에서는 직원/카드가 등록되어있는경우 클라이언트 시크릿 최초 발급시 이용내역 테스트 데이터가 생성됩니다. ※ 클라이언트 시크릿 재발급 시 기존 클라이언트 시크릿과 액세스토큰은 즉시 만료됩니다. ※ 클라이언트 시크릿 발급은 (분당 1회/일일 5회)로 제한됩니다. ※ 액세스 토큰의 유효시간은 2시간이며, 만료 시 재발급이 필요합니다.
• 테스트 카드 등록 • 이용내역 테스트 데이터 생성
5. [개발환경] 허용 IP 설정 (Whitelist)
카카오 T 비즈니스 API 요청을 허용할 IP를 등록해주세요. [관리시스템 > 설정 > 카카오 T 비즈니스 API 연동정보 > 허용 IP] ※ 등록된 IP가 있으면 등록된 IP에서만 API 호출이 가능합니다. 미등록 시 전체 IP가 허용됩니다.
6. [운영환경] API 연동
개발환경 연동 프로세스에 맞춰 운영환경도 동일하게 연동해주세요.

운영 환경 서비스 시나리오

순서
관리자 역할
직원 역할
이용 가능한 API
1. 회원 가입
2. 결제 수단 등록
• 기본 이용료 결제 수단 선택 (공용 법인 카드 OR 가상계좌 OR 직원의 개인 결제수단)
3. 그룹 생성 및 설정
• 이용 목적을 기준으로 그룹 생성 • 그룹별 결제 카드 설정 • 사내 정책에 따라 그룹별 결제한도/호출 제한 설정
4. 직원 등록
• 이용 대상 직원 등록 ※ 관리자가 직원을 등록하면 직원에게 인증 알림톡 발송
5. 직원 인증
• 직원 인증 알림톡 미수신시 인증 알림톡 재발송
1. 인증 알림톡 수신 2. [카카오 T 앱 > 비즈니스 탭]에서 인증번호 입력
6. 호출, 이용, 결제
1. 호출 2. 그룹(이용 목적) 선택 3. 이동서비스 이용 4. 기등록된 결제 수단으로 자동 결제
• 비즈 퀵 API 호출, 호출 상태 조회, 호출 취소, 예약 등 [카카오 T 비즈 퀵 호출 가이드]
7. 이용 내역 확인
[관리시스템]에서 직원 이용 내역 확인 (출, 도착지, 결제 금액, 이용 사유, 승하차 시간 등)

API 연동 사례

1. 카드 승인 내역과 이용 내역을 ERP 시스템에 자동 매핑 가능합니다.
2. 상품별 이용 내역을 월별로 정리할 수 있습니다.
3. 내비 기록을 가져와 차량 운행 일지를 작성할 수 있습니다.

자주 묻는 질문

Q. 비즈니스 API 이용 시 추가 비용이 발생하나요?
Q. 우리 회사가 원하는 기능이 비즈니스 API로 구현가능할지 모르겠어요.
Q. 비즈니스 API로 택시 호출도 가능한가요?
Q. 비즈니스 API로 어떤 정보를 주고 받는지 알수있나요?
Q. 이미 카카오 T 비즈니스를 사용하고 있는 기업도 비즈니스 API를 이용할 수 있나요?
Q. 직원 인증 메시지는 언제 발송되나요?
Q. 이용 내역 등 데이터를 실시간으로 조회할 수 있나요?
Q. 삭제한 직원의 이용 내역도 조회할 수 있나요?
Q. 그룹웨어/ERP 솔루션사입니다. 회원사의 카카오 T 비즈니스 이용 내역을 당사 솔루션에서 연동 제공하려면 어떻게 해야하나요?
Q. 청구 요금을 조회할 수 있나요?