신개념 결제 플랫폼, KONA PLATE

API 문서

전체 API

서비스

선불카드
체크카드

카드 폐기동기

버전: v1

POST

/api/v1/card/terminate

회원이 보유한 등록된 카드를 폐기합니다. 카드를 폐기할 경우 모바일카드와 연결된 모든 실물카드가 폐기되어 더 이상 사용이 불가능합니다. 아래와 같은 경우에는 카드를 폐기할 수 없습니다. - 카드에 잔액이 있는 경우 - 카드에 포인트가 남아있는 경우 - 송금 진행 중인 카드 (송금 보낸 금액이 있으나 상대방이 수락하지 않은 상태) - 충전 취소/환불 처리 진행 중인 경우 (취소/환불 신청 후 해당 금액 미입금 상태)

요청 헤더

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

필수

길이 : 14

클라이언트 요청 시간

형식 : YYYYMMDDHHMMSS

X-KM-Time-Zone

string

필수

길이 : 3

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

요청 파라미터

응답 헤더

X-KM-Correlation-Id

string

필수

길이 : 20

전문 추적을 위한 거래번호

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

X-KM-Crypto-Key-Id

string

옵션

길이 : 32

데이터암복호화 키 ID

서비스 사업자의 프로젝트에서 생성 시 부여한 ID입니다
Callback으로 전달될 경우 서비스 사업자에게 발급된 키 중 가장 먼저 발급된 키를 사용 합니다.

응답 코드

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

에러 코드

001_047

메시지

Invalid card info

설명

카드 정보가 유효하지 않을 경우

400

에러 코드

001_052

메시지

Active card has balance

설명

카드에 잔액이 남아있을 경우

400

에러 코드

001_059

메시지

Can not delete basic card

설명

베이직 카드를 삭제하려고 시도 했을 경우

400

에러 코드

001_061

메시지

Cannot delete Sub card directly, Sub Card will be automatically deleted when Main card deleted.

설명

메인 카드 삭제가 아닌 서브 카드를 바로 삭제하려는 경우

400

에러 코드

001_062

메시지

Card is married to cardSe. Disconnect before delete.

설명

Marry 된 카드를 삭제하려고 시도 했을 경우.

테스트 데이터

200 - 성공

400 - 잘못된 입력값

400 - 유저를 찾을수 없음

400 - 카드 정보가 유효하지 않을 경우

400 - 카드에 잔액이 남아있을 경우

400 - 베이직 카드를 삭제하려고 시도 했을 경우

400 - 메인 카드 삭제가 아닌 서브 카드를 바로 삭제하려는 경우

400 - Marry 된 카드를 삭제하려고 시도 했을 경우

Loading ...

Request

Response

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

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