New Payment Platform, KONA PLATE

API Documentation

All API

Service

Pre-paid Card
Debit Card

Application for Issuance and Delivery of Prepaid CardSync

Version: v1

POST

/api/v1/prepay-card/issue/delivery

If a member wants to select, issue and receive a prepaid card, delivery is processed to the requested address.

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

회원정보

userId

number

Required

Min : 1 , Max : 9999999999999999999

회원 ID

회원가입 시 부여되는 회원의 고유 ID입니다.

addressInfo

object

Conditional

배송지 정보

조건 필드 : "isDeliveryRequired"가 "true " 값일 경우 설정

address

string

Required

Min : 1 , Max : 255

카드 배송지 도로명 주소

addressDetail

string

Required

Min : 1 , Max : 255

카드 배송지 도로명 상세주소

zipCode

string

Required

Length : 5

카드 배송지 우편번호

serviceId

string

Required

Length : 15

카드 상품 ID

카드 상품에 부여한 고유 식별 값입니다.

isDeliveryRequired

boolean

Optional

true

false

실물카드 배송 여부

모바일 카드만 발급할 경우 "false"로 설정해야 합니다.

기본값 : true
true : 실물카드 배송 신청
false : 실물카드 배송을 신청하지 않음

purpose

string

Optional

Min : 1 , Max : 10

발급 목적. 특정 목적의 카드 발급이 필요할 경우 설정. (기본값 = null)

GIFTABLE: 선물하기 목적의 카드 생성

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. serviceId

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_024

Message

Card delivery should be required in case of normal type.

Description

For normal type cards, delivery is required.(A mobile card is unable to be issued, and only a mobile card issuance is requested)

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 - For normal type cards, delivery is required

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)회원 등록 계좌 조회 회원 계좌 정보 조회 자동충전 계좌 등록 회원 계좌 삭제