New Payment Platform, KONA PLATE

API Documentation

All API

Service

Pre-paid Card
Debit Card

Reissuance of Prepaid Card (Replacement Issuance)Sync

Version: v1

POST

/api/v1/prepay-card/reissue/delivery

If a member wants to reissue and receive the prepaid card selected, delivery is processed to the requested address. Depending on the policy, a reissuance fee may be charged to the member upon request for reissuance. Card reissuance is allowed in the following case. - The card that the user has registered is lost (suspended)

Request Headers

X-KM-User-AspId

string

Required

Length : 15

ASP ID

ID given to the service provider.
The ID is provided at the time of contract.

X-KM-Correlation-Id

string

Required

Length : 20

Transaction number for tracking trasncription

Form : yyMMddHHmiSS-xxxxxxx
xxxxxxx : 7digit, Hex String

X-KM-Access-Key

string

Conditional

Length : 40

Access Key created by Project

Excluding the case for Callback API

X-KM-Crypto-Key-Id

string

Optional

Length : 32

Data Encryption/Decryption Key ID

Given ID from creating the service provider's project
Required value when requesting data encryption.

X-KM-Tran-Token

string

Required

Length : 66

Refer to Common header information - X-KM-Tran-Token Guide page

X-KM-Tran-Time

string

Required

Length : 14

Client Request Time

Form : YYYYMMDDHHMMSS

X-KM-Time-Zone

string

Required

Length : 3

International Standard Time (UTC, KST, ...)

Request Parameters

Encrypted|

Check out

Guidelines

for more information.

userInfo

object

Required

Member information

userId

number

Required

Min : 1 , Max : 9999999999999999999

Member ID

- Member's unique ID given when registering for membership

addressInfo

object

Conditional

Delivery address information

- Condition field : Setting if "isDeliveryRequired" is "true"

address

string

Required

Min : 1 , Max : 255

Road name address for card delivery

addressDetail

string

Required

Min : 1 , Max : 255

Road name address detail for card delivery

zipCode

string

Required

Length : 5

Zip code of card delivery address

cardInfo

object

Required

Card information

oldCardNo

string

Required

Length : 16

Old card number
The card to be reissued

isDeliveryRequired

boolean

Optional

true

false

Delivery of physical card
When issuing a mobile card only, this field should be set to "false".

- Default: true
- true : Apply for physical card delivery
- false : Do not apply for physical card delivery

Response Headers

X-KM-Correlation-Id

string

Required

Length : 20

Transaction number for tracking trasncription

Form : yyMMddHHmiSS-xxxxxxx
xxxxxxx : 7digit, Hex String

X-KM-Crypto-Key-Id

string

Optional

Length : 32

Data encryption/decryption key ID

Given ID from creating the service provider's project
If it is passed as a callback, the first key issued among the keys issued to the service provider is used.

Response Parameters

Encrypted|

Check out

Guidelines

for more information.

cardApplyNo

string

Required

Length : 22

Card application number

- (Member) A unique number generated when applying for issuance/delivery of a mobile card or physical card

mobileCardNo

string

Optional

Length : 16

(Mobile card) Card number

mobileCardCVC

string

Optional

Length : 3

(Mobile card) Card verification code

- Card Verification Code

mobileCardPar

string

Optional

Length : 27

PAR of mobile card

Response Code

Detailed classification and addition of error for unseccessful withfrawal

200

Error code

000_000

Message

Success.

Description

Success

400

Error code

000_002

Message

Invalid input parameter. userId

Description

Invalid input parameter

400

Error code

001_006

Message

Wallet user not found.

Description

Non-member or a member who has canceled membership

400

Error code

003_018

Message

Card is already reissued error.

Description

This card has been reissued before.

400

Error code

003_019

Message

User bank account invalid.

Description

Invalid member account

400

Error code

003_020

Message

There is in progress reissue type card apply no.

Description

Card reissuance in progress

400

Error code

003_048

Message

Invalid next service id.

Description

재발급으로 유효한 카드 상품 ID가 아닙니다.

400

Error code

007_001

Message

Bank account not found.

Description

등록된 계좌가 없음.

400

Error code

003_044

Message

User is not authenticated.

Description

사용자 신분증 인증이 되지 않을 경우 발생(해외결제카드 신청시)

400

Error code

003_051

Message

Card cost payment fail. network issue.

Description

카드 비용 부과 실패. 외부 PG사와 네트워크 이슈

Show All

Test Data

200 - Test succeeded

200 - Test succeeded_Issuing only a mobile card

400 - Invalid input parameter

400 - Non-member or a member who has canceled membership

400 - This card has been reissued before.

400 - Invalid member account

400 - Card reissuance in progress

400 - 재발급으로 유효한 카드 상품 ID가 아닙니다.

400 - 등록된 계좌가 없음.

400 - 사용자 신분증 인증이 되지 않을 경우 발생(해외결제카드 신청시)

400 - 카드 비용 부과 실패. 외부 PG사와 네트워크 이슈

400 - 카드 비용 부과 실패. 회원의 은행 계좌가 유효하지 않음.

400 - 카드 비용 부과 실패. 은행 계좌의 소유주와 출금 요청한 회원이 일치하지 않음.

400 - 카드 비용 부과 실패. 출금 실패

400 - 카드 비용 부과 실패. 재발급을 위한 비용 부과가 진행 중임.

400 - 카드 비용 부과 실패. 계좌에 잔액이 충분하지 않음

400 - 카드 비용 부과 실패. 회원이 오픈뱅킹 약관 미동의

400 - 카드 비용 부과 실패. 오픈뱅킹에서 전문 처리 시, 전문 오류로 발생

400 - 카드 비용 부과 실패. 기타 원인

Loading ...

Request

Response

Click Try It!
to start a Request and see the Response here!

User Register Search for Member Information Member Password Reset and Change Member Information Change Membership Cancellation Checking Log in ID check Activation of Dormant Member Search for Terms and Conditions List Terms and Conditions Agreement/Withdrawal CI 값으로 회원 정보 조회 회원 로그인 ID 중복 확인 회원 비밀번호 검증 회원 인증 정보 조회 Financial Institution List Inquiry Real Name Verification for Account holder Authentication code generation before ARS authentication.Bank account registration via PG Search for Account Registration Status Balance Limit Increase(Individual card)회원 등록 계좌 조회 회원 계좌 정보 조회 자동충전 계좌 등록 회원 계좌 삭제 Issuance of Disposable Token Charge Cancellation of Charge Checking Result of Charge & Cancellation of Charge Checking Transaction History Application for Issuance and Delivery of Prepaid Card Cancellation of Card Application Reissuance of Prepaid Card (Replacement Issuance)Reissuance & Renewal of Prepaid Card to be Expired Search for Card Delivery Status Search for Mobile Card Application Information Linkable to Physical Card Physical Card Registration Search for Card Unregistered card inquiry Modification of the Card’s State Discarding a Card Balance Limit Increase(Individual card)Balance Limit Increase(Coporate card)Inquiry of Coporate Card Identification Status Applying For Income Tax Deduction Inquiry of Card Tax Deduction Status Card-User Mapped Inquiry Card Product ID Inquiry 주카드 설정 카드에 연결된 가상계좌 조회 User Register Search for Member Information Member Password Reset and Change Member Information Change Membership Cancellation Checking Log in ID check Activation of Dormant Member Search for Terms and Conditions List Terms and Conditions Agreement/Withdrawal CI 값으로 회원 정보 조회 회원 로그인 ID 중복 확인 회원 비밀번호 검증 회원 인증 정보 조회 Financial Institution List Inquiry Real Name Verification for Account holder Authentication code generation before ARS authentication.Bank account registration via PG Search for Account Registration Status Balance Limit Increase(Individual card)회원 등록 계좌 조회 회원 계좌 정보 조회 자동충전 계좌 등록 회원 계좌 삭제