New Payment Platform, KONA PLATE

API Documentation

All API

Service

Pre-paid Card
Debit Card

Real Name Verification for Account holderSync

Version: v1

POST

/api/v1/bankaccounts/user/valid

Checking whether the member's name and the account holder's name entered are the same. * Account register A member should register a withdrawal account in order to charge the card. The following two steps are needed. 1. Verification of the real name of the account holder 2. ARS authentication The account will be registered and the prepaid card will be charged from your account.

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.

bankAccount

string

Required

Min : 1 , Max : 20

Bank account number

bankCode

string

Required

Length : 3

Bank code

Shinhan Bank	088	Kookmin Bank	004
Woori Bank	020	KEB Hana Bank	081
Industrial Bank of Korea	003	Korea Development Bank	002
Agricultural Cooperation Unit	011	NH Nonghyup	012
Standard Chartered First Bank Korea	023	KakaoBank	090
Korea Post Office	071	Saemaeul Finance firm	045
National Federation of Fisheries Cooperatives	007	National Credit Union Federation of Korea	048
Pusan Bank	032	Kyongnam Bank	039
Kwangju Bank	034	Jeonbuk Bank	037
National Forestry Cooperative Federation	064	Daegu Bank	031
Jeju Bank	035	K Bank	089
Savings Bank	050	Toss Bank	092
Citi Bank Korea	027	Samsung Securities	240
Hanhwa Investment & Securities	269	Shinhan Investment Corp	278
Kyobo Securities	261

birthDate

string

Required

Length : 6

Member’s date of birth

- Format : yyyyMMdd

userId

number

Required

Min : 1 , Max : 9999999999999999999

Member ID

- Member's unique ID given when registering for membership

userName

string

Required

Min : 1 , Max : 100

Member’s name

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 Code

Detailed classification and addition of error for unseccessful withfrawal

200

Error code

000_000

Message

Success

Description

Success

400

Error code

002_001

Message

Bank account is length over limit or including not-number digit.

Description

계좌의 길이가 잘못되었거나 숫자가 아닌 값을 포함하고 있습니다.

400

Error code

002_002

Message

No response name check api.

Description

PG사와 통신 오류가 발생하여 계좌의 예금주 실명 조회 실패 했습니다.

400

Error code

002_003

Message

Names are not matched.

Description

계좌의 예금주 실명과 회원의 실명이 다릅니다.

400

Error code

002_004

Message

Bank is not valid to check account info.

Description

은행 업무 개시 전으로 계좌 정보 수신 불가능 합니다.

400

Error code

002_005

Message

User info not found.

Description

입력한 회원 정보(생년월일)로 은행 계좌 정보를 찾을 수 없습니다.

400

Error code

002_006

Message

Bank is not valid.

Description

은행의 서비스 가능 시간이 아님에 따라(시스템 점검/야간 지연 등) 계좌 정보 확인 불가능 합니다.

400

Error code

002_007

Message

Bank account is not found.

Description

입력한 계좌 번호로 은행 계좌를 찾을 수 없습니다.

400

Error code

002_008

Message

Bank account's status is not valid.

Description

거래 불가 상태의 계좌입니다.

400

Error code

002_009

Message

Bank account is not valid for holder's name check.

Description

입력한 계좌는 실명 확인 용도로 사용할 수 없습니다.

Show All

Test Data

200 - Test succeeded

400 - The account number has an invalid length or contains a non-numeric value.

400 - There was a communication error with the PG company and the account holder's real name inquiry failed.

400 - The account holder's real name and the member's real name are different.

400 - It is not possible to receive account information before the business hour of banking operations.

400 - The bank account information was not found with the member information entered (date of birth).

400 - Account information cannot be checked since it is not the bank's service hours (system check/night delay, etc.)

400 - The bank account was not found with the account number entered.

400 - This account is in a non-tradable state.

400 - The account entered cannot be used for real-name verification.

400 - It is not possible to receive account information before the business hours of banking operations.

400 - The error is due to system processing delay.

400 - It is a non-participating institution.

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