API 문서
전체 API
서비스
실물카드와 연결 가능한 모바일카드 신청 정보 조회동기
버전: v1
버전: v1
/api/v1/issued-cards/pre-issue/waiting/physical
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
issuedCardList
array of objects
필수
모바일카드 신청 정보 목록
issuedCardList_item
object
옵션
cardApplyNo
string
필수
길이 : 22
카드 신청 번호
- (회원) 모바일 카드 또는 실물 카드를 발급/배송 신청할때 생성되는 고유 번호
실물카드 등록 시 입력 값으로 사용됩니다.
issueType
string
필수
최소 : 1 , 최대 : 7
카드 신청 타입
- ISSUE : (신규) 회원이 카드를 신규 신청한 경우 입니다.
- REISSUE : (재발급) 회원이 기존의 카드를 분실 신고하여 발급 받을 경우 입니다.
digital
object
필수
모바일카드 정보
cardNo
string
필수
길이 : 16
(모바일카드) 카드 번호
par
string
필수
길이 : 27
PAR
- 카드의 PAN(Primary Account Number)을 대체하는 번호
serviceId
string
필수
최소 : 1 , 최대 : 15
(모바일카드) 카드 상품 ID
- 카드 상품에 부여한 고유 식별 값입니다.
serviceName
string
필수
최소 : 1 , 최대 : 255
(모바일카드) 카드 상품명
mobileCardCVC
string
필수
길이 : 3
(모바일카드) 카드 인증 코드
- Card Verification Code
status
string
필수
최소 : 1 , 최대 : 15
카드 신청 상태
- READY : 신청 진행 중
- COST_PAYING : 비용 부과 진행 중
- COST_PAID : 비용 부과 완료
- COST_PAY_FAILED : (신청 종료) 비용 부과 실패
- DIGITAL_ISSUED : 모바일 발급 완료
- PHYSICAL_ISSUED : 실물 카드 발급 완료
- SHIPPING : 배송 진행 중
- CANCEL : (신청 종료) 신청 취소
- ISSUE_FAILED : (신청 종료) 신청 실패
- RETURNED : (신청 종료) 반송된 카드
- COMPLETE : (신청 종료) 신청 완료 및 실물 카드 등록 완료
values
object
필수
카드의 잔액 및 포인트 정보
balance
number
필수
최소 : 0 , 최대 : 9999999999
(모바일카드) 잔액
points
array of objects
옵션
(모바일카드) 포인트 정보
points_item
object
옵션
policyType
string
옵션
길이 : 2
(모바일카드) 포인트 정책 타입
- 00 : 유저포인트
- 01 : 정책수당
- 02 : 인센티브
- 03 : 복지포인트(급여성)
- 04 : 복지포인트(경비성)
- 05 : 제휴
- 06 : 법인포인트
- 07 : 기부포인트(수혜자 제공용)
policyId
string
옵션
최소 : 1 , 최대 : 15
(모바일카드) 포인트 정책 아이디
policyName
string
옵션
최소 : 1 , 최대 : 255
(모바일카드) 포인트 정책 명
amount
number
옵션
최소 : 0 , 최대 : 9999999999
(모바일카드) 보유 포인트 금액
requester
string
필수
최소 : 1 , 최대 : 3
카드 신청 유입 채널 정보
- APP : App에서 신청
- CC : 고객센터를 통한 신청
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
400
에러 코드
000_002
메시지
Invalid input parameter.
설명
입력 파라미터 오류입니다.
400
에러 코드
001_006
메시지
Wallet user not found.
설명
회원이 아니거나 탈퇴한 회원입니다.
400
에러 코드
003_011
메시지
Invalid card info.
설명
입력한 카드정보(카드번호, 만료일, CVC)가 유효하지 않습니다.
400
에러 코드
003_049
메시지
Not found issued cards.
설명
발급된 카드를 찾을 수 없음.
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.
