Konaplate logo

API 문서

전체 API

서비스


미등록 카드 조회동기

버전: v1


버전: v1

POST

/api/v1/unregister/card/info

회원에게 미등록된 카드를 조회합니다. 카드의 카드 번호, 유효기간, CVC를 통해 조회할 수 있습니다.

요청 헤더


X-KM-User-AspId

string

필수

길이 : 15

ASP ID

  • 서비스 사업자에게 부여한 ID입니다.
  • ID는 계약 시 제공됩니다.

X-KM-Correlation-Id

string

필수

길이 : 20

전문 추적을 위한 거래번호

  • 형식 : yyMMddHHmiSS-xxxxxxx
  • xxxxxxx : 7자리, Hex String

X-KM-Access-Key

string

조건부

길이 : 40

프로젝트에서 생성된 Access Key

  • Callback API 인 경우는 제외합니다.

X-KM-Crypto-Key-Id

string

옵션

길이 : 32

데이터암복호화 키 ID

  • 서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
  • 데이터 암호화 요청 시 필수 입력값입니다. (Data Encryption = Y)

X-KM-Tran-Token

string

필수

길이 : 66

공통 Header 정보 - X-KM-Tran-Token

X-KM-Tran-Time

string

필수

길이 : 16

클라이언트 요청 시간

  • 형식 : YYYYMMDDHH24MISS

X-KM-Time-Zone

string

필수

길이 : 3

시간대 정보 (UTC, KST, ...)

요청 파라미터

암호화 처리|
더 자세한 정보는
가이드라인
을 참조하세요.

cardNo

string

필수

길이 : 16

조회할 카드의 카드 번호

expiryDate

string

필수

길이 : 4

조회할 카드의 카드 사용 유효기간

cardCVC

string

필수

길이 : 3

조회할 카드의 카드 인증 코드(CVC)

응답 헤더


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

옵션

cardPointInfo_item content

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.

설명

성공

테스트 데이터

400 - 카드번호를 잘못 입력하였거나 없는 정보입니다.


400 - 카드번호를 잘못 입력하였거나 없는 정보입니다.
400 - 카드번호 길이가 잘못되었습니다.
400 - 필수 파라미터가 누락되었습니다.
400 - 유저에게 등록된 카드 정보 입니다.
Loading ...

Request

Loading...

Response

Try It!을 클릭하여
입력한 Request의 Response를 확인하세요.


회원 가입회원 정보 조회회원 비밀번호 재설정 및 변경회원 정보 변경회원 탈퇴회원 로그인 ID 확인휴면 회원 해제약관 목록 조회약관 동의 및 철회CI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회금융사 목록 조회계좌 예금주 실명 검증ARS 인증 전 인증코드 생성PG를 통한 은행 계좌 등록계좌 등록 상태 조회기명화 및 한도상향(개인)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제일회용 토큰 발급계좌 충전계좌 충전취소충전 및 충전취소 결과 확인거래내역 확인선불카드 발급 및 배송 신청카드 신청 취소선불카드 재발급(교체발급)만료 예정 선불카드 재발급 갱신카드 배송 상태 조회실물카드와 연결 가능한 모바일카드 신청 정보 조회실물카드 등록보유카드 조회미등록 카드 조회카드 상태 변경카드 폐기기명화 및 한도상향(개인)기명화 및 한도상향(법인)법인 기명화 여부 조회소득공제 신청카드 소득공제 신청 여부 조회카드 매핑 회원 조회카드 상품ID로 상품 정보 조회주카드 설정카드에 연결된 가상계좌 조회회원 가입회원 정보 조회회원 비밀번호 재설정 및 변경회원 정보 변경회원 탈퇴회원 로그인 ID 확인휴면 회원 해제약관 목록 조회약관 동의 및 철회CI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회금융사 목록 조회계좌 예금주 실명 검증ARS 인증 전 인증코드 생성PG를 통한 은행 계좌 등록계좌 등록 상태 조회기명화 및 한도상향(개인)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제