Konaplate logo

API Documentation

All API

Service


Balance Limit Increase(Individual card)Sync

Version: v1


Version: v1

POST

/api/v1/user/namedcard

After verifying the member's real-name authentication and connected bank account information, we process the card's real-name registration and credit limit increase. "Real-name registration"? It refers to the act of identifying the user of a prepaid electronic payment means, which is originally issued anonymously, through methods defined by law, such as 'real-name authentication' or 'connecting with a bank account.' For cards that are not real-name registered, the maximum balance limit is set at 500,000 KRW. Once real-name registration is completed, the balance limit can be increased up to 2,000,000 KRW. The balance limit after real-name registration is policy-driven and can be set within 2,000,000 KRW.

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


userId

number

Required

Min : 1 , Max : 9999999999999999999

Member’s ID

-It is a member’s unique ID granted in case of member’s sign-up.

isCheckNamedYn

string

Required

Length : 1

Whether to verify the actual name or the connection information of the deposit account

-Y : Verified
-N : Not Verified

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

001_006

Message

Wallet user not found

Description

Wallet user not found


400

Error code

011_001

Message

Missing identity verification

Description

Missing identity verification

Test Data

200 - Success


200 - Success
400 - Wallet user not found
400 - Missing identity verification
Loading ...

Request

Loading...

Response

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


User RegisterSearch for Member InformationMember Password Reset and ChangeMember Information ChangeMembership CancellationChecking Log in ID checkActivation of Dormant MemberSearch for Terms and Conditions ListTerms and Conditions Agreement/WithdrawalCI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회Financial Institution List InquiryReal Name Verification for Account holderAuthentication code generation before ARS authentication.Bank account registration via PGSearch for Account Registration StatusBalance Limit Increase(Individual card)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제Issuance of Disposable TokenChargeCancellation of ChargeChecking Result of Charge & Cancellation of ChargeChecking Transaction HistoryApplication for Issuance and Delivery of Prepaid CardCancellation of Card ApplicationReissuance of Prepaid Card (Replacement Issuance)Reissuance & Renewal of Prepaid Card to be ExpiredSearch for Card Delivery StatusSearch for Mobile Card Application Information Linkable to Physical CardPhysical Card RegistrationSearch for CardUnregistered card inquiryModification of the Card’s StateDiscarding a CardBalance Limit Increase(Individual card)Balance Limit Increase(Coporate card)Inquiry of Coporate Card Identification StatusApplying For Income Tax DeductionInquiry of Card Tax Deduction StatusCard-User Mapped InquiryCard Product ID Inquiry주카드 설정카드에 연결된 가상계좌 조회User RegisterSearch for Member InformationMember Password Reset and ChangeMember Information ChangeMembership CancellationChecking Log in ID checkActivation of Dormant MemberSearch for Terms and Conditions ListTerms and Conditions Agreement/WithdrawalCI 값으로 회원 정보 조회회원 로그인 ID 중복 확인회원 비밀번호 검증회원 인증 정보 조회Financial Institution List InquiryReal Name Verification for Account holderAuthentication code generation before ARS authentication.Bank account registration via PGSearch for Account Registration StatusBalance Limit Increase(Individual card)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제