API Documentation
All API
Service
Physical Card RegistrationSync
Version: v1
Version: v1
POST
/api/v1/prepay-card/physical/register
Registering a physical card in the member's app.
Applied to prepaid cards
The following scenarios occur in physical card registration.
① Registration of prepaid card with pre-issuance attribute:
A mobile card is issued first and the physical card is delivered and registered.
When the member registers a physical card, it is linked to the issued mobile card.
However, the physical card to be registered must not have transaction history, and if there is transaction history, case ② will be applied.
② Registration of a prepaid card that is not a pre-issuance attribute:
If it is not a prepaid card with a pre-issuance attribute, a mobile card is not issued at the time of application. When the prepaid card is registered, a mobile card is issued
and it is registered by being linked to the physical card.
③ Registration of a physical card for the card applied for reissuance:
If a member applies for reissuance of a prepaid card with pre-issuance attributes, a mobile card is issued first when he or she applies for reissuance, the balance is transferred to the newly issued mobile card, and the physical card is delivered.
If the member registers the delivered physical card, it will be linked to the issued mobile card.
If the prepaid card applied for reissuance is not a pre-issuance attributes, a mobile card is issued when registering the physical card, the balance is transferred from the old card to the newly issued mobile card, and the physical card is registered.
④Registration of the prepaid card on the mobile card to be linked to the debit card:
When registering a debit card, he physical card is linked to the mobile card issued.
Request Headers
Request Parameters
Encrypted|
Check out
Guidelines
for more information.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.mobileCardNo
string
Required
Length : 16
Mobile card number issued to a member
- When a user registers a physical card, a mobile card is also issued.
par
string
Required
Length : 27
Number that replaces the PAN(Primary Account Number) of a card
Response Code
Detailed classification and addition of error for unseccessful withfrawal
200
Error code
000_000
Message
Success.
Description
Success
400
Error code
003_012
Message
Indicated card issue is not ready to active.
Description
When the card application specified with cardApplyNo is not allowed to be registered
400
Error code
003_013
Message
Indicated card issue not found error.
Description
When the card application specified with cardApplyNo does not exist
400
Error code
003_001
Message
Invalid card info.
Description
Invalid card information entered (card number, expiry date and CVC)
400
Error code
003_014
Message
Digital card is already terminated error.
Description
When the mobile card to be linked to the physical card is already discarded
Test Data
200 - Test succeeded
200 - Test succeeded
200 - Test succeeded – Request without OPTIONAL parameter
400 - When the card application specified with cardApplyNo is not allowed to be registered
400 - When the card application specified with cardApplyNo does not exist
400 - Invalid card information entered (card number, expiry date and CVC)
400 - When the mobile card to be linked to the physical card is already discarded
400 - User is already mapped to card
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)회원 등록 계좌 조회회원 계좌 정보 조회자동충전 계좌 등록회원 계좌 삭제Microdeposit Verification(1 KRW)Microdeposit Verification CheckApplication 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주카드 설정카드에 연결된 가상계좌 조회Application for Issuance and Delivery of Debit CardCancellation of Card ApplicationSearch for Card Delivery StatusPhysical Card RegistrationSearch for CardModification of the Card’s StateModification of the Card’s LimitDiscarding a CardApplying For Income Tax DeductionInquiry of Card Tax Deduction Status주카드 설정Issuance of Disposable TokenChargeCancellation of ChargeChecking Result of Charge & Cancellation of ChargeChecking Transaction History기준 하한 및 월정액 자동 충전 활성화기준 하한 자동 충전 등록기준 하한 및 월정액 자동 충전 목록 조회기준 하한 자동 충전 수정월 정액 자동 충전 등록월 정액 자동 충전 수정기준 하한 및 월정액 자동 충전 등록 해제결제 시 자동 충전 등록결제 시 자동 충전 등록 해제결제 시 자동 충전 목록 조회Issuance of Disposable TokenSearch for Refund FeeRefundChecking Refund ResultSystem RechargingSystem Recharging CancelSystem RefundSystem Partial Refund신용카드 충전 거래 생성신용카드 충전 취소 요청편의점 충전/출금 요청Deposit Transaction InquiryDeposit Balance InquiryIssuance of Disposable TokenPaymentCancellation of PaymentNetwork Cancellation of Payment Checking Transaction HistoryChecking History of Point TransactionSearch for CardReservations & Cancellations of Point UseChecking History of Point Transaction관리자 포인트 지급관리자 포인트 환수Stamp card accumulation history inquiryCheck the list of stamp cards held by memberInquiry the list of mileage cards owned by member.Mileage card accumulation history inquiryTransfer to CardTransfer to Card ReceivingCard Transfer RejectionCard Transfer CancellationIssuance of Disposable Token for ATMATM Withdrawal ReservationATM Withdrawal Reservation CancelATM withdrawal information inquiry선불카드 선물하기선불카드 선물하기 취소선불카드 선물하기 유효성 검증선불카드 선물하기 수락선불카드 선물하기 거절받은 카드/쿠폰 선물 목록 조회보낸 카드/쿠폰 선물 목록 조회카드 선물 수락 V2카드 선물하기 V2Transfer card balanceBalance Transfer Card Information Inquiry현금영수증 발행 요청현금영수증 발행 취소현금영수증 국세청 승인오류 요청현금영수증 식별 정보 등록현금영수증 식별 정보 조회현금영수증 식별 정보 삭제현금영수증 가맹점 등록현금영수증 가맹점 수정Creation of merchant groupsMerchant Group ModifyMerchant Group InquiryMerchant Information InquiryAdding merchants to merchant groupsMerchant removal from merchant groups신용카드 자동충전 설정(기준 하한)신용카드 자동충전 설정(월정액)신용카드 자동충전 활성화신용카드 자동충전 목록 조회신용카드 자동충전 설정 해제신용카드 자동 충전 설정 변경카드 상품 전체 조회 (관리자용)카드 상품 상세 조회 (관리자용)발급 카드 목록 조회 (관리자용)카드 상품 생성 API (관리자용)카드 선물 내역 조회 (관리자용)
