사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
FAQ
이 문서는 톡디지털카드에 대해 자주 묻는 질문과 답변을 제공합니다.
서비스 기준입니다. 따라서 동일 사업자라도 서비스A와 서비스B에서 디지털카드서비스를 사용하고 싶다면 서비스A와 B를 각각 앱 등록 후 이용기관 등록을 신청합니다.
이미 등록된 발급처 역시 기존 서비스가 아닌 새로운 서비스에서 디지털카드서비스 이용을 원할 경우, 발급처를 새롭게 등록해야 합니다.
가능합니다. 발급처에서 기존 서비스로 카드 정보(credentialDefinition)를 등록해 디지털카드를 추가 발급할 수 있습니다. 또한, 하나의 카드 정보(credentialDefinition)에 복수의 카드 디자인(designDefinition)이 지원되므로 데이터 형태는 같지만, 서로 다른 디자인의 디지털카드를 발급하기 위해 새로운 디자인(designDefinition)을 생성할 수도 있습니다.
새로운 발급처 등록이 필요한 경우, 추가 계약 체결 후 카드 정보를 등록할 수 있습니다.
톡디지털카드 서비스는 카카오톡 기반의 서비스입니다. 따라서 카카오톡을 사용하는 카카오계정에 발급이 가능합니다.
해외 전화번호로 인증된 카카오톡 사용자의 경우 정책에 따라 발급 또는 활용에 제약이 있을 수 있습니다.
이 외의 동일 사용자에게 중복 발급과 같은 카드 발급 정책은 발급처의 판단에 따라 자유롭게 적용할 수 있습니다.
디지털카드 발급을 위해 파트너가 사용자에게 동의받아야 하는 개인정보 제3자 제공동의에 대한 약관입니다. 개인정보가 포함된 카드발급 정보를 카카오에게 제공하는 것에 대한 동의로, 동의받는 주체는 발급처입니다.
디지털카드 서비스는 카드 발급 과정에서 발급처의 동의항목을 함께 동의받을 수 있도록 지원합니다. 이를 위해서는 동의 전문이 담긴 URL을 카드 데이터 등록 시 함께 등록해야 합니다.
톡디지털카드 API는 서버 간 연동(Server to Server)을 원칙으로 합니다.
에러 케이스별 안내되는 화면은 아래와 같습니다. 각 케이스별 해결 방법을 참고해 주세요.
| 에러 | 해결 방법 |
|---|---|
| 페이지를 찾을 수 없습니다. 주소를 다시 확인해 주세요. | 앱스킴 실행 시 사용된 제출웹뷰의 url 형식이 맞지 않을 경우 발생합니다. 제출웹뷰url 형식을 확인하세요. |
| 서비스 오류 안내 예상하지 못한 오류가 발생했습니다. | 카카오 제출 서버의 일시적인 오류입니다. 현상이 지속된다면 제출 연동 담당자에게 문의해 주세요. |
| 주 사용 기기에 있는 카카오톡 톡학생증을 이용해 주세요. 톡학생증 서비스는 주 사용 기기에서만 이용 가능합니다. | 카카오계정 로그인 시, “다른 기기와 함께 사용합니다" 옵션이 활성화 된 채로 로그인한 경우 발생합니다. 해당 옵션을 비활성화(언체크)한 상태로 카카오톡 재 로그인 해 주세요. |
| 제출 대상자 아닙니다. 제출처에 가입된 회원정보와 카카오계정 정보가 일치하지 않아 제출이 불가합니다. | 제출요청API 호출시 사용한 User Info와 카카오톡에 로그인한 카카오계정 정보가 일치하지 않을 경우 노출됩니다. 카카오계정 정보 확인하여 제출요청 해 주세요. |
| 제출이 실패되었습니다 제출처의 시스템 오류가 발생했습니다. 잠시 후 다시 시도해 주세요. | 제출처의 제출웹훅url로 제출결과 알림이 실패할 경우 발생합니다. 카카오에서 호출하는 제출웹훅 url을 확인해 주세요. |
| 제출이 실패되었습니다 제출 요청 유효시간이 지났습니다. 제출 요청한 서비스로 돌아가 다시 시도해 주세요. | transactionId의 유효시간은 10분입니다. 10분이 경과해 제출 과정을 진행하려고 할 때 노출됩니다. 제출처 서비스페이지에서 톡학생증 인증을 다시 시도해 주세요. |
| 제출이 실패되었습니다 카카오 인증이 완료되지 않았습니다. 인증을 완료하여 제출할 수 있어요. | 제출 과정 진행 중, 카카오 인증서 인증이 정상적으로 완료되지 않았을 때 노출됩니다. 카카오 인증서 인증을 완료하여 주세요. |
| 제출이 실패되었습니다 일시적인 오류로 제출에 실패하였습니다. 잠시 후 다시 시도해 주세요. | 카카오 제출 서버의 일시적인 오류입니다. 현상이 지속된다면 제출 연동 담당자에게 문의해 주세요. |
동일한 문제가 지속될 경우, 아래 정보를 전달해 주시면 오류 확인 및 해결 방법을 지원해 드립니다.
- 테스트 기기 단말 정보
- 테스트에 사용한 카카오계정 정보
transactionId- 테스트 케이스(재현 방법)