API 문서
전체 API
서비스
실물카드 등록동기
버전: v1
버전: v1
/api/v1/prepay-card/physical/register
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
mobileCardNo
string
필수
길이 : 16
회원에게 발급된 모바일 카드 번호
- 사용자가 실물 카드를 등록하게 되면 모바일 카드도 발급 된다.
par
string
필수
길이 : 27
카드의 PAN(Primary Account Number)을 대체하는 번호
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
400
에러 코드
003_012
메시지
Indicated card issue is not ready to active.
설명
cardApplyNo로 지정한 카드 신청 건이 카드 등록 가능한 상태가 아닌 경우 발생
400
에러 코드
003_013
메시지
Indicated card issue not found error.
설명
cardApplyNo로 지정한 카드 신청 건이 존재하지 않을 경우 발생
400
에러 코드
003_001
메시지
Invalid card info.
설명
입력한 카드정보(카드번호, 만료일, CVC)가 유효하지 않습니다.
400
에러 코드
003_014
메시지
Digital card is already terminated error.
설명
실물 카드와 연결하려는 모바일 카드가 이미 폐기 상태일 경우 발생
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.