API 문서
전체 API
서비스
미등록 카드 조회동기
버전: v1
버전: v1
/api/v1/unregister/card/info
요청 헤더
요청 파라미터
응답 헤더
X-KM-Correlation-Id
string
필수
길이 : 20
전문 추적을 위한 거래번호
- 형식 : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7자리, Hex String
X-KM-Crypto-Key-Id
string
옵션
길이 : 32
데이터암복호화 키 ID
- 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
- Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.
응답 파라미터
cardDataInfo
object
필수
카드 정보
par
string
필수
길이 : 27
카드의 PAN(Primary Account Number)을 대체하는 번호
serviceId
string
필수
길이 : 15
카드 상품 ID
- 카드 상품에 부여한 고유 식별 값입니다.
serviceName
string
필수
최소 : 1 , 최대 : 255
카드 상품명
serviceImageUrl
string
필수
최소 : 1 , 최대 : 255
카드 상품의 이미지 파일 URL
affiliateId
string
필수
길이 : 15
같은 ASP 내에서 제휴사를 구별하기 위한 값
rechargeable
boolean
필수
카드의 충전 가능 여부
아래 항목의 충전 가능여부를 설정합니다.
- OFFLINE 단말기 충전
- 개인계좌 충전
- 포탈을 통한 ADMIN 충전
refundable
boolean
필수
카드의 환불 가능 여부
remittable
boolean
필수
카드의 송금 가능 여부
아래 항목에 대한 잔액 송금 가능 여부를 설정합니다.
- 휴대 전화번호로 송금
- 카드번호로 송금
personalRechargeable
boolean
필수
카드의 개인계좌를 통한 충전 가능 여부
balance
number
필수
최소 : 0 , 최대 : 9999999999
카드에 충전되어 있는 잔액 정보
expiryDate
string
필수
길이 : 8
카드 사용 유효기간
- 형식 : yyyyMMdd
physicalCardNo
string
옵션
길이 : 16
(실물카드) 카드 번호
physicalCardStatus
string
옵션
최소 : 1 , 최대 : 7
(실물카드) 카드의 상태
- ACTIVE : 정상
- SUSPENDED : 중지
mobileCardNo
string
옵션
길이 : 16
(모바일카드) 카드 번호
mobileCardStatus
string
옵션
최소 : 1 , 최대 : 7
(모바일카드) 카드의 상태
- ACTIVE : 정상
- SUSPENDED : 중지
maxNonRealNameRechargeAmount
number
필수
최소 : 0 , 최대 : 9999999999
무기명 카드에 충전할 수 있는 최대 금액
maxRealNameRechargeAmount
number
필수
최소 : 0 , 최대 : 9999999999
기명화된 카드에 충전할 수 있는 최대 금액
minRechargeAmount
number
필수
최소 : 0 , 최대 : 9999999999
카드에 충전시 최소 충전금액
rechargeableAmount
number
필수
최소 : 0 , 최대 : 9999999999
카드에 충전 가능한 금액
- 무기명 카드의 경우 = 무기명카드 최대 충전금액(maxNonRealNameRechargeAmount) - 카드잔액(balance)
- 기명화된 카드의 경우 = 기명화카드 최대 충전금액(maxRealNameRechargeAmount) - 카드잔액(balance)
충전 가능 금액(예)
- maxNonRealNameRechargeAmount = 500,000
- balance = 300,000
- rechargeableAmount = 200,000 (maxNonRealNameRechargeAmount - balance)
overseaPaymentable
boolean
옵션
해외결제 가능여부
cardPointInfo
array of objects
옵션
카드 포인트 정보
cardPointInfo_item
object
옵션
pointPolicyId
string
필수
길이 : 15
포인트 정책 ID포인트 정책명
pointName
string
필수
최소 : 1 , 최대 : 255
포인트 정책명
remainingPoint
number
옵션
최소 : 0 , 최대 : 9999999999
(회원) 포인트 잔액
- 회원이 가지고 있는 포인트의 잔액
autoUse
boolean
옵션
포인트 자동사용 여부
rechargeUnitAmt
number
옵션
최소 : 0 , 최대 : 9999999999
충전 단위 설정
응답 코드
Detailed classification and addition of error for unseccessful withfrawal
200
에러 코드
000_000
메시지
Success.
설명
성공
테스트 데이터
Request
Response
Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.