API 목록 v2

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

토큰 API

액세스 토큰 발급

기본정보

액세스 토큰 유효시간은 2시간이며, 만료되면 재발급이 필요합니다.

메서드	URL
POST	https://mob-b2b-dev.kakao.com/external/v1/oauth/token

요청 헤더

이름	설명
Content-Type	Content-Type: application/x-www-form-urlencoded;charset=utf-8 요청 데이터 타입

요청 본문

이름	타입	설명	필수	기본값
corporation_id	String	기업 ID (T 비즈 ID) (관리시스템 > 설정 > 계정정보 > T 비즈 ID 확인)	O	-
client_secret	String	클라이언트 시크릿 (관리시스템 > 설정 > 카카오 T 비즈니스 API > Client secret 발급)	O	-

응답 본문

이름	타입	설명	필수
access_token	String	액세스 토큰	O
token_type	String	토큰 타입	O
expires_in	Integer	유효시간(초)	O

요청 예시

curl -X 'POST' \
  'https://mob-b2b-dev.kakao.com/external/v1/oauth/token' \
  -H 'Content-Type: application/x-www-form-urlencoded;charset=utf-8' \
  -d 'corporation_id=03942158' \
  -d 'client_secret=Yxu98vJy_69uAaYQF4_Af5PvmSUm0YeSaFTxU3sdkLo'
Bash
복사

성공 응답 예시

HTTP/1.1 200 OK
{
  "access_token": "6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E",
  "token_type": "Bearer",
  "expires_in": 7200
}
JSON
복사

만료 응답 예시

HTTP/1.1 400 Bad Request
{
  "error": "Access token이 유효하지 않거나 만료됐습니다. 토큰을 다시 발급받아주세요.",
  "code": 90030,
  "statusCode": 400
}
JSON
복사

직원 API

직원 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v1/members/{id}

요청 헤더

이름	설명	필수	기본값
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O	-
x-mob-b2b-privacy	x-mob-b2b-privacy: true 개인정보 암호화 여부 (암호화 필요시 biz.cs@kakaomobility.com 으로 문의)	X	false

요청 경로 변수

이름	타입	설명
id	String	시스템 내 직원 식별 고유 ID

응답 본문

이름	타입	설명	필수	암호화 가능
id	String	시스템 내 직원 식별 고유 ID	O	X
name	String	직원명	O	X
department	String	부서명	O	X
identifier	String	직원 ID (사번, 이메일 등)	O	O
mobile_phone	String	휴대전화번호	O	O
status	String	직원 상태, 아래 영문 코드 중 하나 created (미인증): 직원으로 등록되어 있으나 직원이 T앱에서 인증을 완료하지 않아, 카카오 T 비즈니스 이용이 불가한 상태 connected (인증 완료): T앱에서 직원의 인증이 완료되어 카카오 T 비즈니스 이용이 가능한 상태 refused (인증 거부): 직원이 T앱에서 스스로 인증을 거부하여 T 비즈니스 이용 불가한 상태 blocked (휴직): 직원의 카카오 T 비즈니스 이용이 제한된 상태	O	X
confirmed_at	String	직원 인증 일시 (yyyy-MM-dd HH:mm:ss)	X	X
group_ids	String[]	그룹 ID를 담은 JSON 배열	O	X

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v1/members/AAAA1111' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "id": "AAAA1111",
  "name": "홍길동",
  "department": "부서명",
  "identifier": "사번",
  "mobile_phone": "01012341234",
  "status": "connected",
  "confirmed_at": "2023-01-01 00:00:00",
  "group_ids": [
    "BBBB2222", "CCCC3333"
  ]
}
JSON
복사

직원 수정

기본정보

메서드	URL
PUT	https://mob-b2b-dev.kakao.com/external/v1/members/{id}

요청 헤더

이름	설명	필수	기본값
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O	-
x-mob-b2b-privacy	x-mob-b2b-privacy: true 개인정보 암호화 여부 (암호화 필요시 biz.cs@kakaomobility.com 으로 문의)	X	false

요청 경로 변수

이름	타입	설명
id	String	시스템 내 직원 식별 고유 ID

요청 본문

이름	타입	설명	필수	암호화 가능
mobile_phone	String	휴대전화번호 직원의 휴대전화번호가 수정되면 수정된 번호로 인증 알림톡 자동 발송 (운영환경인 경우에 한함)	O	O
group_ids	String[]	그룹 ID를 담은 JSON 배열	O	X
name	String	직원명 null일 경우 공백 값으로 수정	X	O
department	String	부서명 null일 경우 공백 값으로 수정	X	O
status	String	직원 상태, 아래 영문 코드 중 하나 created (미인증): 직원으로 등록되어 있으나 직원이 T앱에서 인증을 완료하지 않아, 카카오 T 비즈니스 이용이 불가한 상태 connected (인증 완료): T앱에서 직원의 인증이 완료되어 카카오 T 비즈니스 이용이 가능한 상태 refused (인증 거부): 직원이 T앱에서 스스로 인증을 거부하여 T 비즈니스 이용 불가한 상태 blocked (휴직): 직원의 카카오 T 비즈니스 이용이 제한된 상태	X	X

응답 본문

이름	타입	설명	필수	암호화 가능
id	String	시스템 내 직원 식별 고유 ID	O	X
name	String	직원명	O	X
department	String	부서명	O	X
identifier	String	직원 ID (사번, 이메일 등)	O	O
mobile_phone	String	휴대전화번호	O	O
status	String	직원 상태, 아래 영문 코드 중 하나 created (미인증): 직원으로 등록되어 있으나 직원이 T앱에서 인증을 완료하지 않아, 카카오 T 비즈니스 이용이 불가한 상태 connected (인증 완료): T앱에서 직원의 인증이 완료되어 카카오 T 비즈니스 이용이 가능한 상태 refused (인증 거부): 직원이 T앱에서 스스로 인증을 거부하여 T 비즈니스 이용 불가한 상태 blocked (휴직): 직원의 카카오 T 비즈니스 이용이 제한된 상태	O	X
confirmed_at	String	직원 인증 일시 (yyyy-MM-dd HH:mm:ss)	X	X
group_ids	String[]	그룹 ID를 담은 JSON 배열	O	X

요청 예시

curl -X 'PUT' \
  'https://mob-b2b-dev.kakao.com/external/v1/members/AAAA1111' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E' \
	-d '{
	  "mobile_phone": "01012341234",
	  "group_ids": ["BBBB2222", "CCCC4444"]
	}'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "id": "AAAA1111",
  "name": "홍길동",
  "department": "부서명",
  "identifier": "사번",
  "mobile_phone": "01012341234",
  "status": "connected",
  "confirmed_at": "2023-01-01 00:00:00",
  "group_ids": [
    "BBBB2222", "CCCC4444"
  ]
}
JSON
복사

직원 삭제

기본정보

메서드	URL
DELETE	https://mob-b2b-dev.kakao.com/external/v1/members/{id}

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 경로 변수

이름	타입	설명
id	String	시스템 내 직원 식별 고유 ID

요청 예시

curl -X 'DELETE' \
  'https://mob-b2b-dev.kakao.com/external/v1/members/AAAA1111' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
JSON
복사

직원 등록

기본정보

메서드	URL
POST	https://mob-b2b-dev.kakao.com/external/v1/members

요청 헤더

이름	설명	필수	기본값
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O	-
x-mob-b2b-privacy	x-mob-b2b-privacy: true 개인정보 암호화 여부 (암호화 필요시 biz.cs@kakaomobility.com 으로 문의)	X	false

요청 본문

이름	타입	설명	필수	암호화 가능
identifier	String	직원 ID (사번, 이메일 등)	O	O
mobile_phone	String	휴대전화번호 휴대전화번호로 인증 알림톡 자동 발송 (운영환경인 경우에 한함)	O	O
group_ids	String[]	그룹 ID를 담은 JSON 배열	O	X
name	String	직원명 null일 경우 공백 값으로 저장	X	O
department	String	부서명	X	O
status	String	직원 상태, 아래 영문 코드 중 하나 created (미인증): 직원으로 등록되어 있으나 직원이 T앱에서 인증을 완료하지 않아, 카카오 T 비즈니스 이용이 불가한 상태 connected (인증 완료): T앱에서 직원의 인증이 완료되어 카카오 T 비즈니스 이용이 가능한 상태 refused (인증 거부): 직원이 T앱에서 스스로 인증을 거부하여 T 비즈니스 이용 불가한 상태 blocked (휴직): 직원의 카카오 T 비즈니스 이용이 제한된 상태	X	X

응답 본문

이름	타입	설명	필수	암호화 가능
id	String	시스템 내 직원 식별 고유 ID	O	X
name	String	직원명	O	X
department	String	부서명	X	X
identifier	String	직원 ID (사번, 이메일 등)	O	O
mobile_phone	String	휴대전화번호	O	O
status	String	직원 상태, 아래 영문 코드 중 하나 created (미인증): 직원으로 등록되어 있으나 직원이 T앱에서 인증을 완료하지 않아, 카카오 T 비즈니스 이용이 불가한 상태 connected (인증 완료): T앱에서 직원의 인증이 완료되어 카카오 T 비즈니스 이용이 가능한 상태 refused (인증 거부): 직원이 T앱에서 스스로 인증을 거부하여 T 비즈니스 이용 불가한 상태 blocked (휴직): 직원의 카카오 T 비즈니스 이용이 제한된 상태	O	X
confirmed_at	String	직원 인증 일시 (yyyy-MM-dd HH:mm:ss)	X	X
group_ids	String[]	그룹 ID를 담은 JSON 배열	O	X

요청 예시

curl -X 'POST' \
  'https://mob-b2b-dev.kakao.com/external/v1/members' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E' \
  -d '{
  "identifier": "사번",
  "mobile_phone": "01012341234",
  "name": "홍길동",
  "department": "부서명",
  "group_ids": [
    "BBBB2222"
    ]
  }'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "id": "AAAA1111",
  "name": "홍길동",
  "department": "부서명",
  "identifier": "사번",
  "mobile_phone": "01012341234",
  "status": "created",
  "confirmed_at": null,
  "group_ids": [
    "BBBB2222"
  ]
}
JSON
복사

인증 알림톡 발송

기본정보

직원이 알림톡 미수신시 인증 알림톡 발송 API를 통해 인증 알림톡을 재발송할 수 있습니다. 운영환경에서만 알림톡이 발송됩니다.

메서드	URL
POST	https://mob-b2b-dev.kakao.com/external/v1/members/{id}/send_tms

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 경로 변수

이름	타입	설명
id	String	시스템 내 직원 식별 고유 ID

요청 예시

curl -X 'POST' \
  'https://mob-b2b-dev.kakao.com/external/v1/members/AAAA1111/send_tms' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
JSON
복사

직원 상태 휴직으로 변경

기본정보

인증 완료 상태인 직원에 한해서 휴직 상태로 변경합니다.

메서드	URL
POST	https://mob-b2b-dev.kakao.com/external/v1/members/block

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 본문

이름	타입	설명	필수
members	String	휴직으로 변경할 시스템 내 직원 식별 고유 ID 목록 "," (쉼표)로 구분	O

응답 본문

이름	타입	설명	필수
-	MembersBlockingResult[]	휴직 상태로 변경 결과를 담은 JSON 배열	O

MembersBlockingResult

이름	타입	설명	필수
id	String	시스템 내 직원 식별 고유 ID	O
status_code	Integer	응답 상태 코드 (0: 성공)	O
status_msg	String	응답 상태 메시지	O

요청 예시

curl -X 'POST' \
  'https://mob-b2b-dev.kakao.com/external/v1/members/block' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E' \
  -d '{
    "members": "AAAA1111,AAAA2222"
  }'
Bash
복사

응답 예시

HTTP/1.1 200 OK
[
  {
    "id": "AAAA1111",
    "status_code": 0,
    "status_msg": "성공"
  },
  {
    "id": "AAAA2222",
    "status_code": 0,
    "status_msg": "성공"
  }
]
JSON
복사

직원의 휴직 상태 해제

기본정보

메서드	URL
POST	https://mob-b2b-dev.kakao.com/external/v1/members/unblock

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 본문

이름	타입	설명	필수
members	String	휴직을 해제할 시스템 내 직원 식별 고유 ID 목록 "," (쉼표)로 구분	O

응답 본문

이름	타입	설명	필수
-	MembersUnblockingResult[]	휴직 상태 해제 결과를 담은 JSON 배열	O

MembersUnblockingResult

이름	타입	설명	필수
id	String	시스템 내 직원 식별 고유 ID	O
status_code	Integer	응답 상태 코드 (0: 성공)	O
status_msg	String	응답 상태 메시지	O

요청 예시

curl -X 'POST' \
  'https://mob-b2b-dev.kakao.com/external/v1/members/unblock' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E' \
  -d '{
    "members": "AAAA1111,AAAA2222"
  }'
Bash
복사

응답 예시

HTTP/1.1 200 OK
[
  {
    "id": "AAAA1111",
    "status_code": 0,
    "status_msg": "성공"
  },
  {
    "id": "AAAA2222",
    "status_code": 0,
    "status_msg": "성공"
  }
]
JSON
복사

인증 완료 직원 목록 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v2/members/connected

요청 헤더

이름	설명	필수	기본값
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O	-
x-mob-b2b-privacy	x-mob-b2b-privacy: true 개인정보 암호화 여부 (암호화 필요시 biz.cs@kakaomobility.com 으로 문의)	X	false

요청 쿼리 파라미터

이름	타입	설명	필수	기본값
start_date	String	조회 시작일 (yyyy-MM-dd)	X	-
end_date	String	조회 종료일 (yyyy-MM-dd)	X	-
page	Integer	페이지 번호	X	1
per	Integer	한 페이지에 가져올 직원 최대 수 (최대: 100)	X	20

응답 본문

이름	타입	설명	필수	암호화 가능
count	Integer	인증 완료 직원 전체 개수	O	X
members	ConnectedMember[]	인증 완료 직원을 담은 JSON 배열	O	X

ConnectedMember

이름	타입	설명	필수	암호화 가능
id	String	시스템 내 직원 식별 고유 ID	O	X
name	String	직원명	O	X
department	String	부서명	X	X
identifier	String	직원 ID (사번, 이메일 등)	O	O
mobile_phone	String	휴대전화번호	O	O
status	String	직원 상태, 아래 영문 코드 중 하나 created (미인증): 직원으로 등록되어 있으나 직원이 T앱에서 인증을 완료하지 않아, 카카오 T 비즈니스 이용이 불가한 상태 connected (인증 완료): T앱에서 직원의 인증이 완료되어 카카오 T 비즈니스 이용이 가능한 상태 refused (인증 거부): 직원이 T앱에서 스스로 인증을 거부하여 T 비즈니스 이용 불가한 상태 blocked (휴직): 직원의 카카오 T 비즈니스 이용이 제한된 상태	O	X
confirmed_at	String	직원 인증 일시 (yyyy-MM-dd HH:mm:ss)	O	X
group_ids	String[]	그룹 ID를 담은 JSON 배열	O	X

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v2/members/connected?start_date=2023-01-01&end_date=2023-01-31&page=1&per=2' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "count": 10,
  "members" : [
		{
		  "id": "AAAA1111",
		  "name": "홍길동1",
		  "department": "부서명",
		  "identifier": "사번1",
		  "mobile_phone": "01012341234",
		  "status": "connected",
		  "confirmed_at": "2023-01-01 00:00:00",
		  "group_ids": [
		    "BBBB2222", "CCCC3333"
		  ]
    },
		{
		  "id": "AAAA2222",
		  "name": "홍길동2",
		  "department": "부서명",
		  "identifier": "사번2",
		  "mobile_phone": "01012341235",
		  "status": "connected",
		  "confirmed_at": "2023-01-01 00:00:00",
		  "group_ids": [
		    "BBBB2222", "CCCC3333"
		  ]
    }
  ]
}
JSON
복사

그룹 API

그룹 목록 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v1/groups

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

응답 본문

이름	타입	설명	필수
-	Group[]	그룹 정보를 담은 JSON 배열	O

Group

이름	타입	설명	필수
id	String	그룹 ID	O
name	String	그룹명	O
status	String	그룹 상태, 아래 영문 코드 중 하나 enabled (활성화) disabled (비활성화) deactivated (삭제)	O
description	String	그룹 설명	O

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v1/groups' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
[
  {
    "id": "BBBB2222",
    "name": "그룹1",
    "status": "enabled",
    "description": "자동으로 생성된 기본그룹 입니다."
  },
  {
    "id": "CCCC3333",
    "name": "그룹2",
    "status": "disabled",
    "description": ""
  }
]
JSON
복사

그룹 이용사유 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v1/groups/use_reason_type

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 쿼리 파라미터

이름	타입	설명	필수
group_ext_id	String	그룹 ID	O

응답 본문

이름	타입	설명	필수
reason_type	String	이용사유 유형, 아래 영문 코드 중 하나 text (입력형) selection (선택형) selection_plus (선택형 + 입력형) selection_text (선택형 → 입력형)	O
reason_type_txt	String	이용사유 유형(한글)	O
description1	String	이용사유 설명 1	O
options1	String	선택 옵션 1	O
description2	String	이용사유 설명 2	O
options2	String	선택 옵션 2	O
is_required	Boolean	이용사유 입력 필수 여부	O

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v1/groups/use_reason_type?group_ext_id=BBBB2222' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "reason_type": "text",
  "reason_type_txt": "입력형",
  "description1": "",
  "options1": "",
  "description2": "",
  "options2": "",
  "is_required": false
}
JSON
복사

파트너의 그룹 목록 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v1/groups/partner

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 쿼리 파라미터

이름	타입	설명	필수	기본값
page	Integer	페이지 번호	X	1
per	Integer	한 페이지에 가져올 그룹 목록 최대 수 (최대: 100)	X	20

응답 본문

이름	타입	설명	필수
count	Integer	파트너의 그룹 전체 개수	O
groups	Group[]	그룹 정보를 담은 JSON 배열	O

Group

이름	타입	설명	필수
corporation_id	String	기업 ID	O
corporation_name	String	기업명	O
group_id	String	그룹 ID	O
group_name	String	그룹명	O
group_status	String	그룹 상태, 아래 영문 코드 중 하나 enabled (활성화) disabled (비활성화) deactivated (삭제)	O
group_description	String	그룹 설명	O

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v1/groups/partner' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
    "count": 1,
    "groups": [
        {
            "corporation_id": "A1B2C3D4",
            "corporation_name": "기업명",
            "group_id": "BBBB2222",
            "group_name": "기본그룹",
            "group_status": "enabled",
            "group_description": "자동으로 생성된 기본그룹 입니다."
        }
    ]
}
JSON
복사

결제 API

결제 승인 내역 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v1/payment_approvals

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 쿼리 파라미터

이름	타입	설명	필수	기본값
start_date	String	조회 시작일 (yyyy-MM-dd) 시작일과 종료일 범위는 최대 한 달	O	-
end_date	String	조회 종료일 (yyyy-MM-dd) 시작일과 종료일 범위는 최대 한 달	O	-
page	Integer	페이지 번호	X	1
per	Integer	한 페이지에 가져올 결제 승인 내역 최대 수 (최대: 100)	X	20

응답 본문

이름	타입	설명	필수
count	Integer	결제 승인 내역 전체 개수	O
payment_approvals	PaymentApproval[]	결제 승인 내역을 담은 JSON 배열	O

PaymentApproval

이름	타입	설명	필수
id	Long	결제 승인 ID	O
payment_item_id	Long	결제 아이템 ID	O
amount	Integer	금액	O
pay_type	String	결제 타입, 아래 영문 코드 중 하나 PAYMENT (결제) CANCEL (취소)	O
approval_no	String	카드사 승인 번호	X
org_date_time	String	카드사 승인 일시 (yyyy-MM-dd HH:mm:ss)	X
card_number	String	카드 번호	X

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v1/payment_approvals?start_date=2023-01-01&end_date=2023-01-31&page=1&per=2' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "count": 10,
  "payment_approvals" : [
    {
      "id": 1000,
      "payment_item_id": 2000,
      "amount": 8100,
      "pay_type": "PAYMENT",
      "approval_no": "999999998",
      "org_date_time": "2023-01-01 00:00:00",
      "card_number": "000001"
    },
    {
      "id": 1001,
      "payment_item_id": 2001,
      "amount": 5000,
      "pay_type": "PAYMENT",
      "approval_no": "999999999",
      "org_date_time": "2023-01-01 00:00:00",
      "card_number": "000001"
    }
  ]
}
JSON
복사

이용 내역 API

기업 이용 내역 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v2/orders

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 쿼리 파라미터

이름	타입	설명	필수	기본값
start_date	String	조회 시작일 (yyyy-MM-dd) 시작일과 종료일 범위는 최대 한 달	O	-
end_date	String	조회 종료일 (yyyy-MM-dd) 시작일과 종료일 범위는 최대 한 달	O	-
page	Integer	페이지 번호	X	1
per	Integer	한 페이지에 가져올 이용 내역 최대 수 (최대: 100)	X	20
search_by_payment_at	Boolean	조회 기준 (false: 이용일시, true: 결제일시)	X	false
vertical_code	String	버티컬 코드, 아래 영문 코드 중 하나 TAXI (택시) DRIVER (대리) LOGISTICS (퀵∙배송) CONSIGNMENT (탁송) DOBO (도보 배송) KORAIL (기차) NAVI (내비) COMMUTEBUS (통근 셔틀) BLACK (블랙)	X	-
member_identifier	String	직원 사번	X	-

응답 본문

이름	타입	설명	필수
count	Integer	이용 내역 전체 개수	O
orders	Order[]	이용 내역을 담은 JSON 배열	O

Order

이름	타입	설명	필수
id	String	이용 내역 ID	O
service_fare	Integer	이용 요금	O
toll	Integer	통행료	O
platform_fee	Integer	플랫폼 수수료	O
group_id	String	그룹 ID	O
group_name	String	그룹명	O
vertical_code	String	버티컬 코드, 아래 영문 코드 중 하나 taxi (택시) driver (대리) logistics (퀵∙배송) consignment (탁송) dobo (도보 배송) korail (기차) navi (내비) commutebus (통근 셔틀) black (블랙)	O
vertical_product_code	String	버티컬 상품 종류	O
vertical_product_name	String	버티컬 상품명	O
dropoff_location_gap	Integer	목적지-도착지 거리	O
taxi_kind	String	택시 종류, 아래 영문 코드 중 하나 medium (중형) large (대형) deluxe (모범) luxury (고급) compact (경형) small (소형) unknown (택시가 아님)	O
payment_items	PaymentItem[]	결제 정보를 담은 JSON 배열	O
use_code	String	이용 사유	X
call_time	String	호출 일시 (yyyy-MM-dd HH:mm:ss)	X
departure_time	String	출발 일시 (yyyy-MM-dd HH:mm:ss)	X
arrival_time	String	도착 일시 (yyyy-MM-dd HH:mm:ss)	X
departure_point	String	탑승 위치	X
arrival_point	String	도착 위치	X
waypoints	String	경유지	X
member_id	String	시스템 내 이용 직원 식별 고유 ID	X
member_name	String	이용 직원명	X
member_identifier	String	이용 직원 ID (사번, 이메일 등)	X
member_department	String	이용 직원 부서명	X
car_model	String	자동차 모델명	X
car_number	String	자동차 등록번호	X
taxi_company_name	String	운수회사명	X
total_distance	Integer	총 주행 거리(m)	X

PaymentItem

이름	타입	설명	필수
id	Long	결제 ID	O
status	String	결제 상태, 아래 영문 코드 중 하나 init (결제 요청) paid (결제 승인) unpaid (결제 실패/미수) payment_cancelled (결제 취소)	O
item_type	String	결제 유형, 아래 영문 코드 중 하나 fare (운행 요금) platform_fee (플랫폼 사용료) cancel_fee (취소 수수료) business_call_charge (플러스 이용료) noshow_fee (노쇼 수수료) call_fee (호출/예약 이용료) etc_fee (기타비용(실비))	O
amount	Integer	결제 금액	O
approval_no	String	카드사 승인 번호	X
org_date_time	String	카드사 승인 일시 (yyyy-MM-dd HH:mm:ss)	X
card_number	String	카드 번호	X

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v2/orders?start_date=2023-01-01&end_date=2023-01-31&page=1&per=1' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "count": 10,
  "orders": [
    {
      "id": "A1B2C3D4",
      "service_fare": 8100,
      "toll": 0,
      "platform_fee": 0,
      "use_code": "",
      "call_time": "2023-01-01 15:31:13",
      "departure_time": "2023-01-01 15:31:13",
      "arrival_time": "2023-01-01 15:31:26",
      "departure_point": "경기 용인시 수지구 신수로 767",
      "arrival_point": "경기 성남시 분당구 판교역로 지하 160",
      "member_id": "AAAA1111",
      "member_name": null,
      "member_identifier": "사번",
      "member_department": null,
      "group_id": "BBBB2222",
      "group_name": "기본그룹",
      "car_model": null,
      "car_number": null,
      "taxi_company_name": null,
      "taxi_kind": "unknown",
      "vertical_code": "logistics",
      "vertical_product_code": "quick_economy",
      "vertical_product_name": "퀵 이코노미",
      "total_distance": null,
      "dropoff_location_gap": 0,
      "payment_items": [
        {
          "id": 9999,
          "status": "payment_cancelled",
          "item_type": "fare",
          "amount": 8100,
          "approval_no": "999919999",
          "org_date_time": "2023-01-01 15:31:25",
          "card_number": "000001"
        }
      ]
    }
  ]
}
JSON
복사

기업의 파트너 이용 내역 조회

기본정보

메서드	URL
GET	https://mob-b2b-dev.kakao.com/external/v1/orders/partner

요청 헤더

이름	설명	필수
Authorization	Authorization: Bearer {Access token} 인증방식, 액세스 토큰으로 인증 요청	O

요청 쿼리 파라미터

이름	타입	설명	필수	기본값
start_date	String	조회 시작일 (yyyy-MM-dd) 시작일과 종료일 범위는 최대 한 달	O	-
end_date	String	조회 종료일 (yyyy-MM-dd) 시작일과 종료일 범위는 최대 한 달	O	-
page	Integer	페이지 번호	X	1
per	Integer	한 페이지에 가져올 이용 내역 최대 수 (최대: 100)	X	20

응답 본문

이름	타입	설명	필수
count	Integer	이용 내역 전체 개수	O
orders	PartnerOrder[]	이용 내역을 담은 JSON 배열	O

PartnerOrder

이름	타입	설명	필수
id	String	이용 내역 ID	O
corporation_name	String	기업명	O
registration_id	String	사업자번호	O
service_fare	Integer	이용 요금	O
toll	Integer	통행료	O
platform_fee	Integer	플랫폼 수수료	O
group_id	String	그룹 ID	O
group_name	String	그룹명	O
vertical_code	String	버티컬 코드, 아래 영문 코드 중 하나 taxi (택시) driver (대리) logistics (퀵∙배송) consignment (탁송) dobo (도보 배송) korail (기차) navi (내비) commutebus (통근 셔틀) black (블랙)	O
member_id	String	시스템 내 이용 직원 식별 고유 ID	X
member_identifier	String	이용 직원 ID (사번, 이메일 등)	X
member_name	String	이용 직원명	X
member_mobile	String	이용 직원 휴대전화번호	X
taxi_kind	String	택시 종류, 아래 영문 코드 중 하나 medium (중형) large (대형) deluxe (모범) luxury (고급) compact (경형) small (소형) unknown (택시가 아님)	O
payment_items	PaymentItem[]	결제 정보를 담은 JSON 배열	O
use_code	String	이용 사유	X
departure_time	String	출발 일시 (yyyy-MM-dd HH:mm:ss)	X
arrival_time	String	도착 일시 (yyyy-MM-dd HH:mm:ss)	X
departure_point	String	탑승 위치	X
arrival_point	String	도착 위치	X
total_distance	Integer	총 주행 거리(m)	X

PaymentItem

이름	타입	설명	필수
id	Long	결제 ID	O
status	String	결제 상태, 아래 영문 코드 중 하나 init (결제 요청) paid (결제 승인) unpaid (결제 실패/미수) payment_cancelled (결제 취소)	O
item_type	String	결제 유형, 아래 영문 코드 중 하나 fare (운행 요금) platform_fee (플랫폼 사용료) cancel_fee (취소 수수료) business_call_charge (플러스 이용료) noshow_fee (노쇼 수수료) call_fee (호출/예약 이용료) etc_fee (기타비용(실비))	O
amount	Integer	결제 금액	O
approval_no	String	카드사 승인 번호	X
org_date_time	String	카드사 승인 일시 (yyyy-MM-dd HH:mm:ss)	X

요청 예시

curl -X 'GET' \
  'https://mob-b2b-dev.kakao.com/external/v1/orders/partner?start_date=2023-01-01&end_date=2023-01-31&page=1&per=1' \
  -H 'Content-Type: application/json;charset=UTF-8' \
  -H 'Authorization: Bearer 6neA8hUutuLrxAM4MILydd161_T_jnfiYsZAognym3E'
Bash
복사

응답 예시

HTTP/1.1 200 OK
{
  "count": 10,
  "orders": [
    {
      "id": "A1B2C3D4",
      "corporation_name": "A고객사",
      "registration_id": "1111111119",
      "service_fare": 8100,
      "toll": 0,
      "platform_fee": 0,
      "use_code": "",
      "departure_time": "2023-01-01 15:31:13",
      "arrival_time": "2023-01-01 15:31:26",
      "departure_point": "경기 용인시 수지구 신수로 767",
      "arrival_point": "경기 성남시 분당구 판교역로 지하 160",
      "member_id": "AAAA1111",
      "member_identifier": "사번",
      "member_name": "홍길동",
      "member_mobile": "01012341234",
      "group_id": "BBBB2222",
      "group_name": "기본그룹",
      "taxi_kind": "unknown",
      "vertical_code": "logistics",
      "total_distance": null,
      "payment_items": [
        {
          "id": 9999,
          "status": "payment_cancelled",
          "item_type": "fare",
          "amount": 8100,
          "approval_no": "999919999",
          "org_date_time": "2023-01-01 15:31:25"
        }
      ]
    }
  ]
}
JSON
복사