New Payment Platform, KONA PLATE

API Documentation

All API

Service

Pre-paid Card
Debit Card

User RegisterSync

Version: v1

POST

/api/v1/user/registration

Processing user(regular member) register of service provider

Request Headers

Request Parameters

Encrypted|

Check out

Guidelines

for more information.

string

Optional

Length : 88

CI, Connection Information

loginId

string

Required

Min : 1 , Max : 80

User's login ID

loginPassword

string

Required

Length : 6

User's password

- The member password is used when logging in, paying, charging, and changing member information.
- Consists of 6 digits.
- The number of passwords is not recommended to have any three same digit in a row. (e.g. 111246)
- The password is not recommended to contain three consecutive numbers. (e.g. 123246)
- The password is not recommended to have a pattern of phone number

birthDate

string

Required

Length : 8

User's date of birth

nationality

string

Required

Min : 6 , Max : 9

User's nationality

gender

string

Required

Min : 4 , Max : 6

User's gender

userName

string

Required

Min : 1 , Max : 100

User's name

mobileNumber

string

Conditional

Min : 10 , Max : 20

User's mobile phone number

string

Required

Min : 1 , Max : 80

User's email

joinChannel

string

Optional

Min : 1 , Max : 20

Service code (OPENAPI)

addressInfo

object

Optional

User's address information

zipCode

string

Required

Min : 5 , Max : 6

Zip code

address

string

Required

Min : 1 , Max : 255

Address

addressDetail

string

Optional

Min : 1 , Max : 255

Address details

tcIdList

array of strings

Optional

Terms and Conditions agreement list

Add string

Response Headers

X-KM-Correlation-Id

string

Required

Length : 20

Transaction number for tracking trasncription

Format : 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.

userId

number

Required

Min : 1 , Max : 9999999999999999999

Member ID

- Member's unique ID given when registering for membership

basicCardInfo

object

Optional

Basic information of a mobile card issued when registering for membership

par

string

Required

Length : 27

Number replacing PAN(Primary Account Number) of the mobile card that is issued when registering for membership

cardNo

string

Required

Length : 16

Card number of the mobile card issued when registering for membership

expiryDate

string

Required

Length : 6

Expiry date of the mobile card issued when registering for membership (Format : YYMMDD)

serviceId

string

Required

Length : 15

Card product ID

- Unique ID assigned to a card product

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 value. loginId

Description

입력 파라미터 오류 - `loginId` 필수 정보가 빈 문자열인 경우

400

Error code

000_003

Message

Missing required values. loginId

Description

필수값 누락 - `loginId` 필수 정보 요청 null 인 경우

400

Error code

000_015

Message

The length of value does not match. birthDate (반드시 최소값 8과(와) 최대값 8 사이의 크기이어야 합니다.)

Description

필드 길이 오류 - `birthDate` 길이 8 자리 이하인 경우

400

Error code

001_001

Message

User already exists with this loginId.

Description

기 사용 로그인 아이디 입력 오류

400

Error code

001_028

Message

CI data already found for another user.

Description

기 가입 회원 오류

400

Error code

001_009

Message

Terms and conditions data missing.

Description

필수 약관 동의 누락

Test Data

200 - Test succeeded

400 - Invalid input parameter - null string in required information for `loginId`

400 - Required value missing – null in required information request for `loginId`

400 - Field length error – in case of less than 8 digits for `birthDate`

400 - Log in ID already in use

400 - Already registered member

400 - Terms and Conditions were not agreed

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