사이드 메뉴
시작하기
로그인
커뮤니케이션
광고
에러 코드
이 문서는 톡디지털카드 서비스 이용 중 발생할 수 있는 주요 에러와 해결 방법을 안내합니다.
이 외에 에러 코드는 공통 에러 코드를 참고합니다.
디지털카드 데이터 관련 API 요청 시 발생할 수 있는 에러 목록입니다.
| 에러 코드 및 응답 메시지 | 상태 코드 | 원인 | 해결 방법 |
|---|---|---|---|
invalid-partner-id | 404 | 어드민 앱 키에 해당하는 파트너 ID가 존재하지 않는 경우 | 권한 획득 여부 및 어드민 앱 키를 확인 |
channel-creation-failedfailed to created a new channel. publicId={publicId}. err={message} | 500 | 비즈메시지 채널 생성에 실패한 경우 | 재시도, 문제 지속 시 데브톡에 문의 |
디지털카드 디자인 관련 API 요청 시 발생할 수 있는 에러 목록입니다.
| 에러 코드 및 응답 메시지 | 상태 코드 | 원인 | 해결 방법 |
|---|---|---|---|
invalid-parameter | 400 | API 호출 시 잘못된 파라미터 포맷으로 요청한 경우 | 잘못된 UUID와 같은, 요청 파라미터들의 포맷 확인 |
Design definition with id $designDefinitionId not found for partner $partnerId | 400 | 조회된 id의 Design Definition이 없는 경우 | ID 확인 후 재시도 |
invalid-credential-definition-idfailed to retrieve any credential definition. id=$id | 404 | 존재하지 않는 credentialDefinitionId로 요청한 경우 | credentialDefinitionId 확인 |
디지털카드 발급 관련 API 요청 시 발생할 수 있는 에러 목록입니다.
| 에러 코드 및 응답 메시지 | 상태 코드 | 원인 | 해결 방법 |
|---|---|---|---|
invalid-parameter | 400 | API 호출 시 잘못된 파라미터 포맷으로 요청 에러 메시지: 잘못된 UUID와 같은, 요청 파라미터들의 포맷 확인 | 잘못된 UUID와 같은, 요청 파라미터들의 포맷 확인 |
invalid-credential-request | 400 | 디지털카드 데이터가 존재하지 않거나 비활성화 상태인 경우 | credentialDefinitionId 디지털카드 데이터 확인 |
illegal-config failed to issue card. err=design does not exist, id=${credentialTransaction.id} | 400 | 설정된 Design Definition이 없는 경우 | DesignPackage를 디지털카드 디자인 명세 수정 API로 수정 |
failed to issue. webhook info not found. | 400 | 발급요청을 보낼 웹훅 URL이 등록되지 않은 경우 | 웹훅 URL 등록 |
invalid credential state to proceed. id=${credentialTransaction.id} | 400 | 유효하지 않은 발급 transaction 상태인 경우 | transaction의 상태 확인 및 올바른 상태로 재시도 |
failed to retrieve credential definition. err=inactive definition. id=$id | 400 | 유효하지 않은 발급 definition을 사용한 경우 | credential definition의 상태를 확인하여 활성화된 definition을 사용 |
failed to validate the period. validFrom=$from, validUntil=$until | 400 | 발급되는 카드의 유효기간이 이미 만료된 경우 | 카드의 유효기간 정보 재확인 및 재설정 후 요청 |
claim is not compatible with credential definition. fieldName=$fieldName | 400 | 카드 발급 시, 필요한 데이터와 요청 데이터가 불일치하는 경우 | 요청 데이터의 필드와 credential definition의 일치 여부 확인 및 수정 |
already-issued | 409 | 이미 발급된 credentialTransactionId으로 중복 발급 요청한 경우 | 사용자에게 해당 디지털카드가 이미 발급되었음을 안내 |
deleted-request | 410 | 삭제된 credentialTransactionId으로 발급 요청한 경우 | 사용자에게 회수된 디지털카드임을 안내 또는 디지털카드 발급 제안 API로 발급 제안 재요청 |
canceled-request | 410 | 발급 제안이 취소된 credentialTransactionId으로 발급 요청한 경우 | 사용자에게 발급 제안이 취소되었음을 안내 또는 디지털카드 발급 제안 API로 발급 제안 재요청 |
| - | 500 | 메시지 서버 장애로 인한 발송 실패 케이스 | 재시도, 문제 지속 시 데브톡 문의 |
디지털카드 제출 관련 API 요청 시 발생할 수 있는 에러 목록입니다.
| 에러 코드 및 응답 메시지 | 상태 코드 | 원인 | 해결 방법 |
|---|---|---|---|
invalid-parameter | 400 | API 호출 시 잘못된 파라미터 포맷으로 요청 | 잘못된 UUID와 같은, 요청 파라미터들의 포맷 확인 |
Auth info should be given. | 400 | 제출 요청에 필요한 계정 정보(전화번호/생년월일)가 비어있는 경우 | 제출에 필요한 모든 계정 정보(전화번호, 생년월일 등) 입력 확인 |
failed to retrieve any presentation. id={definitionId} | 400 | 유효하지 않은 제출 요청을 시도한 경우 | 요청의 definitionId 값 확인 및 유효성 검증 |
no presentation definition. id={definitionId} | 404 | 존재하지 않는 제출 요청을 시도한 경우 | definitionId의 존재 여부 확인 |
presentation-undefined-error | 500 | 존재하지 않는 제출 결과를 조회한 경우 | 요청한 제출 결과의 존재 여부 재확인 및 입력값 검증 |
| - | 500 | 메시지 서버 장애로 인한 발송을 실패한 경우 | 재시도, 문제 지속 시 데브톡 문의 |