카드 소유 여부 확인

API Description

Doc. No. A3S14V1
API Title 카드관리 > 카드 소유 여부 확인
API Description 카드의 회원정보를 조회하여, 요청 받은 CI 와 비교하여 카드 소유자 여부를 조회하는 API 입니다.
카드의 소유자가 맞는 경우, 코나 회원 ID를 반환합니다.
Protocol HTTP Interface Type SYNC
HTTP METHOD POST Request URL /api/v1/card/verify-owner
Data Encryption Request : YES / Response : NO

Request Parameter

Field Type Length MOC Description
cardNo STRING 16 MANDATORY 카드 번호
ci STRING 88 MANDATORY CI(Connection Information)
- 서비스 중복 가입 또는 외부 서비스 연계 시 개인을 식별하기 위한 정보로서 통신사 본인인증 등을 통해 얻을 수 있습니다.
- 외부 서비스와의 연동이 필요없는 서비스 사업자의 경우에는 별도의 개인을 식별 값을 부여하여 사용 가능 합니다.

Response Parameter

Field Type Length MOC Description
isCardOwner BOOLEAN MANDATORY 카드 소유자 여부
userId NUMBER 0~999999999999 OPTIONAL 카드 소유자인 경우 회원 ID
- 소유자가 아닌 경우에는 null
response OBJECT MANDATORY 응답 결과 값
└ code STRING 1~7 MANDATORY 응답 결과 코드
└ description STRING 1~255 MANDATORY 응답 결과 상세 설명

Response Code

HTTP Status Error code Message Description
프로토콜 항목의 "공통 Error Message 정보"에서 추가 확인 바랍니다.
400 003_068 Unregistered card. 회원 등록이 되지 않은 무기명 카드입니다.
400 003_069 The cardholder is not a RGL grade 카드 소유자가 정회원이 아님니다.(CI 정보 없음)
400 006_029 Card is not found with the card no. 해당 카드 번호의 카드를 찾을 수 없습니다.

Example

Request


            

        

        

            

                
Response