본문 바로가기메인 메뉴 바로가기사이드 메뉴 바로가기

kakao developers

관련사이트

사이드 메뉴

카카오맵

검색

이 문서는 톡디지털카드를 소개합니다.

톡디지털카드는 카카오톡을 기반으로, 사용자의 아이덴티티를 표현하는 디지털 상의 카드를 발급, 관리, 활용할 수 있는 서비스입니다.

기업, 기관, 단체에서 톡디지털카드를 이용해 카드를 발급할 수 있고, 발급된 카드는 안전하고 신뢰할 수 있는 자격증명으로 활용됩니다.

톡디지털카드 소개

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

디지털카드 서비스 특징

톡디지털카드 서비스는 카카오와 제휴 계약 체결 후 이용 가능합니다. 제휴 문의는 카카오 제휴 안내 사이트에서 할 수 있습니다.

카카오톡 디지털카드 서비스는 두 가지 상품을 제공합니다. 자세한 사용 방법은 아래 문서를 참고합니다.

구현 중 궁금한 사항이나 문제 해결 방법은 아래 문서를 참고합니다.

톡디지털카드는 증명, 멤버십, 소유/수집 등 다양한 분야에서 디지털카드로 발급하여 활용할 수 있습니다.

목적설명 및 예시
증명
  • 소속이나 신분을 증명
    • (예: 톡학생증, 톡사원증, 지역주민카드 등)
  • 기술, 자격, 능력을 증명
    • (예: 공인자격증, 국가기술자격증, 골프 스코어, 토익 성적표, 각종 수료증 등)
  • 공공기관 및 기관의 증명(증명서 기반)
    • (예: 다자녀카드, 거주인증카드, 자격카드 등)
멤버십
  • 멤버십 및 권리 보장
    • (예: 카카오헬스케어 환자카드, 멜론회원등급 카드, VIP멤버십카드, 브런치 작가 카드 등)
  • 온/오프라인 접근 권한 부여
    • (예: 공연 및 전시회 티켓류, 온·오프라인 컨텐츠 구독권 등)
  • 관심사/취향 표현(사용자 활동 기반)
    • (예: MBTI카드, 코리아둘레길 카드 등)
소유 및 수집
  • 유·무형 자산의 소유
    • (예: 내차인증카드, 주주인증카드 등)
  • 사물 또는 서비스의 보증 및 권리
    • (예: 정품인증서, 디지털보증서, A/S 증서 등)
  • 디지털 자산 및 수집품 소유
    • (예: 아이돌 팬카드, 스포츠 카드, 디지털아트 등)

톡디지털카드 발급 분야

사용자는 톡디지털카드를 사용해 아래와 같은 기대 효과를 얻을 수 있습니다.

  • 오프라인 현장에서 디지털카드를 보여주고, 실시간으로 인증 정보를 확인할 수 있습니다.
  • 카카오톡 친구들에게 내가 보유한 디지털카드를 톡 프로필 인증배지로 공개할 수 있습니다.
  • 별도 앱 설치 없이 카카오톡만으로 이용할 수 있습니다.
  • 카드나 증명서 없이 온라인 및 오프라인에서 내 카드를 쉽게 인증하고 활용할 수 있습니다.

디지털카드 상세 정보

톡프로필 인증배지

파트너는 톡디지털카드를 사용해 아래와 같은 기대 효과를 얻을 수 있습니다.

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

파트너 서비스 사용 예시

발급된 카드는 외부 서비스에서도 조회하여 활용할 수 있습니다.

사용자가 서비스 이용 및 혜택을 받을 수 있도록 디지털카드 정보 활용 및 제공에 대한 동의와 카카오 인증서 서명을 포함한 전반적인 시스템을 제공합니다.

발급된 디지털카드를 인증하여 활용하려면 디지털카드 제출을 참고합니다.

디지털 카드 제출 과정

용어설명
연동연동이란 기능 설계, 개발, 운영을 비롯한 일련의 과정으로 파트너가 톡디지털카드 서비스와 연결하여 서비스를 이용하는 행위 일체를 뜻합니다.
톡디지털카드 서비스는 현재 직접 연동 방식만을 제공합니다.
파트너톡디지털카드 서비스를 이용하는 플랫폼 또는 서비스입니다. 파트너는 서비스 단위로 카카오디벨로퍼스에서 앱을 만들고, 해당 앱의 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) 형식입니다.

도움이 되었나요?