사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
이해하기
이 문서는 톡디지털카드를 소개합니다.
톡디지털카드는 카카오톡을 기반으로, 사용자의 아이덴티티를 표현하는 디지털 상의 카드를 발급, 관리, 활용할 수 있는 서비스입니다.
기업, 기관, 단체에서 톡디지털카드를 이용해 카드를 발급할 수 있고, 발급된 카드는 안전하고 신뢰할 수 있는 자격증명으로 활용됩니다.
톡디지털카드 소개

카카오톡 사용자는 자격증명, 멤버십, 아이템 등 다양한 종류의 디지털카드를 발급받아 카카오톡 지갑에서 확인하고, 다양한 활용처에서 이용할 수 있습니다.
디지털카드 서비스 특징

톡디지털카드 서비스는 카카오와 제휴 계약 체결 후 이용 가능합니다. 제휴 문의는 카카오 제휴 안내 사이트에서 할 수 있습니다.
카카오톡 디지털카드 서비스는 두 가지 상품을 제공합니다. 자세한 사용 방법은 아래 문서를 참고합니다.
구현 중 궁금한 사항이나 문제 해결 방법은 아래 문서를 참고합니다.
톡디지털카드는 증명, 멤버십, 소유/수집 등 다양한 분야에서 디지털카드로 발급하여 활용할 수 있습니다.
| 목적 | 설명 및 예시 |
|---|---|
| 증명 |
|
| 멤버십 |
|
| 소유 및 수집 |
|
톡디지털카드 발급 분야

사용자는 톡디지털카드를 사용해 아래와 같은 기대 효과를 얻을 수 있습니다.
- 오프라인 현장에서 디지털카드를 보여주고, 실시간으로 인증 정보를 확인할 수 있습니다.
- 카카오톡 친구들에게 내가 보유한 디지털카드를 톡 프로필 인증배지로 공개할 수 있습니다.
- 별도 앱 설치 없이 카카오톡만으로 이용할 수 있습니다.
- 카드나 증명서 없이 온라인 및 오프라인에서 내 카드를 쉽게 인증하고 활용할 수 있습니다.
디지털카드 상세 정보

톡프로필 인증배지

파트너는 톡디지털카드를 사용해 아래와 같은 기대 효과를 얻을 수 있습니다.
- 디지털카드 인증을 연동하여, 특정 서비스의 사용권한을 부여하거나 프로모션을 진행할 수 있습니다.
- 고객의 전화번호(카카오계정)만으로 즉각적인 카드 발급 및 관리가 가능합니다.
- 특정 디지털카드를 가진 고객만 조회 가능한 차별적인 컨텐츠나 혜택을 카카오 서비스나 자사 서비스에 적용할 수 있습니다.
- 카카오톡 채널, 카카오 광고, 챗봇과 같은 카카오 서비스와 연동하면 타겟팅 메시지로 맞춤형 마케팅 전략(고객 관리 등)을 실행할 수 있습니다.
파트너 서비스 사용 예시

발급된 카드는 외부 서비스에서도 조회하여 활용할 수 있습니다.
사용자가 서비스 이용 및 혜택을 받을 수 있도록 디지털카드 정보 활용 및 제공에 대한 동의와 카카오 인증서 서명을 포함한 전반적인 시스템을 제공합니다.
발급된 디지털카드를 인증하여 활용하려면 디지털카드 제출을 참고합니다.
디지털 카드 제출 과정

| 용어 | 설명 |
|---|---|
| 연동 | 연동이란 기능 설계, 개발, 운영을 비롯한 일련의 과정으로 파트너가 톡디지털카드 서비스와 연결하여 서비스를 이용하는 행위 일체를 뜻합니다. 톡디지털카드 서비스는 현재 직접 연동 방식만을 제공합니다. |
| 파트너 | 톡디지털카드 서비스를 이용하는 플랫폼 또는 서비스입니다. 파트너는 서비스 단위로 카카오디벨로퍼스에서 앱을 만들고, 해당 앱의 REST API 키, 어드민 키로 톡디지털카드 서비스 API를 호출합니다. 이 문서에서는 디지털카드 발급 기능을 이용하는 파트너를 발급처, 디지털카드 제출 기능을 이용하는 파트너를 제출처라 칭하기도 합니다. |
| 앱 | 카카오 API 플랫폼을 이용하기 위해 필요한 사업자의 서비스 등록 정보입니다. 카카오디벨로퍼스에서 앱을 등록할 수 있으며, 앱에는 카카오 API 호출에 필요한 키 값이 포함됩니다. 앱 이름, 회사명, 아이콘은 최종 사용자에게 노출될 수 있습니다. 자세한 내용은 카카오디벨로퍼스 앱 만들기를 참고합니다. 톡디지털카드 서비스를 이용하려면 발급처는 앱을 소유해야 하며, 해당 앱은 발급처의 사업자 정보를 등록한 비즈 앱이어야 합니다. |
| 비즈니스 채널 | 서비스를 소유한 사업자의 정보를 등록한 카카오톡 채널을 지칭합니다. 카카오톡 채널 관리자센터에서 카카오톡 채널을 등록하거나 비즈니스 채널로 전환할 수 있습니다. |
| 채널 메시지 | 파트너가 발급 또는 제출을 요청하기 위한 메시지와 발급처가 진행한 디지털카드의 삭제, 회수, 수정 등의 알림을 위한 메시지를 톡디지털카드 공식 채널로 사용자에게 발송합니다. |
| 카카오톡 채널 친구 추가 | 파트너의 앱과 연결된 카카오톡 채널로 마케팅을 하기 위한 카카오톡 채널 친구 추가 동의항목을 설정할 수 있습니다. 해당 동의항목은 디지털카드 발급 또는 제출을 위해 받아야 하는 동의 화면에 [선택 동의] 항목으로 함께 노출됩니다. 카카오톡 채널을 참고합니다. |
| 허용 IP 주소 | 디지털카드 API는 앱 어드민 키(Admin key)를 사용해 호출해야 하기 때문에, 보안 유지를 위해 허용 IP 주소를 파트너로부터 별도로 전달받아 등록하고 있습니다. 등록하지 않은 IP로 요청하는 API 호출은 모두 실패합니다. |
| 용어 | 설명 |
|---|---|
| 발급처 | 디지털카드 발급 기능을 이용하는 파트너, '파트너' 참고 |
| 발급 | 카카오톡 사용자의 카카오계정에 디지털카드를 부여하는 행위입니다. 발급 방식은 앱 전환 방식과 채널 메시지 방식이 있습니다. |
| 파트너 약관 | 디지털카드를 발급하기 위해 사용자에게 동의받아야 하는 약관으로, 디지털카드 발급 목적으로 카카오에게 제공하는 개인정보 제3자 제공 동의 약관 상세 전문입니다. 카드의 상세 정보 등록 시 해당 약관 전문 URL을 포함하면 디지털카드 발급 과정에서 함께 동의를 받을 수 있습니다. |
| 회수 | 사용자에게 발급된 카드를 발급처가 API로 삭제하는 행위입니다. 이미 사용자에게 발급된 카드가 삭제되기 때문에, 회수 전 사용자가 인지할 수 있도록 확실히 안내해야 합니다. |
| 본인인증 | 디지털카드 발급 과정에서 발급 대상자의 정보 일치를 확인하는 옵션입니다. 발급처가 보유한 본인 확인 정보와 카카오계정의 본인 정보 간 일치 여부를 확인하여 발급의 정확도를 높일 수 있는 옵션입니다. 발급처는 카카오계정 본인인증 또는 카카오톡 인증 서비스 전자서명 과정을 추가해 발급 대상을 검증할 수 있습니다. |
| 발급 웹훅 URL | 디지털카드 발급 및 삭제 과정에 필요한 정보를 요청하거나 전달하기 위해, 톡디지털카드 서비스에서 호출할 발급처의 서버 URL 입니다. 외부에서 호출이 가능한 URL인지 미리 체크가 필요합니다. |
| 용어 | 설명 |
|---|---|
| 제출처 | 톡디지털카드를 제출한 파트너, '파트너' 참고 |
| 제출 | 사용자가 본인 확인 또는 혜택 제공을 목적으로 디지털카드 데이터를 전달하거나, 외부 서비스에 제출하는 행위입니다. 제출 시 카카오 인증서 서명을 통해 신뢰성을 확보하고 있습니다. |
| 제출대상검증 | 디지털카드 제출 과정에서 제출 대상자의 정보 일치를 필수적으로 확인합니다. 제출처가 전달한 제출 대상자 정보를 토대로 일치하는 카카오계정을 식별하고, 제출에 필요한 디지털카드 보유 여부를 확인합니다. |
| 제출 웹훅 URL | 제출 결과를 받을 제출처의 서버 URL 입니다. 외부에서 호출이 가능한 URL인지 미리 체크가 필요합니다. |
| 용어 | 설명 |
|---|---|
| partnerId | 발급처 또는 제출처의 파트너 등록번호입니다. |
| appId | 디지털카드 API 사용 권한을 부여할 카카오디벨로퍼스 앱 ID입니다. |
| appUserId | 앱에 연결된 회원번호입니다. |
| appKey | 앱 키는 API 호출 시 앱 인증을 위해 사용됩니다. 디지털카드 API 사용을 위한 어드민 키를 카카오디벨로퍼스 사이트의 앱 관리 페이지의 [앱] > [일반] > [앱 키]에서 확인할 수 있습니다. |
| channelPublicId | 카카오톡 채널의 프로필 ID입니다. 카카오톡 채널 URL 뒷자리에 문자열로 구성되어 있습니다. (예: http://pf.kakao.com/_vkH) 참고: 카카오톡 채널 프로필 ID 확인 방법 |
| 용어 | 설명 |
|---|---|
| credentialTransactionId | 발급요청 접수번호입니다. 각 발급요청에 대해 발급되는 고유 값으로 API 호출 시 파라미터로 사용합니다. 값은 범용 고유 식별자(UUID) 형식입니다. |
| credentialDefinitionId | 디지털카드의 발급데이터 명세 고유 번호로, 디지털카드의 종류를 의미합니다. 발급처가 발급할 디지털카드의 규격과 항목을 정의하고 관리하는 단위입니다. 한 발급처가 다수의 데이터 명세(credentialDefinitionId)를 생성 및 발급하고 운영할 수 있습니다. 값은 범용 고유 식별자(UUID) 형식입니다. |
| designDefinitionId | 디지털카드의 디자인 명세 고유 번호로, 디지털카드의 디자인 종류를 의미합니다. 발급할 디지털카드의 공통 적용 디자인을 관리하는 단위로, 한 데이터 명세(credentialDefinitionId)에 복수의 디자인 명세(designDefinitionId)를 적용할 수도 있습니다. 값은 범용 고유 식별자(UUID) 형식입니다. |
| cardId | 사용자에게 발급된 디지털카드의 고유 번호입니다. 디지털카드 회수, 내용 확인 시 사용합니다. |
| 용어 | 설명 |
|---|---|
| presentationTransactionId | 제출요청 접수번호입니다. 각 제출요청에 대해 발급되는 고유 값으로 API 호출 시 파라미터로 사용합니다. 값은 범용 고유 식별자(UUID) 형식입니다. |
| presentationDefinitionId | 디지털카드의 제출데이터 명세 고유 번호입니다. 제출처에게 제출될 데이터의 규격과 항목이 정의된 정보를 관리하는 단위로, 한 파트너가 사용자로부터 제출 받고자하는 카드/정보에 따라 다수의 제출데이터 명세(credentialDefinitionId)을 생성하고 운영할 수 있습니다. 값은 범용 고유 식별자(UUID) 형식입니다. |