API Documentation
All API
Service
Search for Mobile Card Application Information Linkable to Physical CardSync
Version: v1
Version: v1
/api/v1/issued-cards/pre-issue/waiting/physical
Request Headers
Request Parameters
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
issuedCardList
array of objects
Required
List of mobile card application information
issuedCardList_item
object
Optional
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
Used as an input value when registering a physical card
issueType
string
Required
Min : 1 , Max : 7
Card application type
- ISSUE : (New) A member newly applies for a card
- REISSUE : (Reissuance) A member reports the loss of the old card and reissues the card.
digital
object
Required
Mobile card information
cardNo
string
Required
Length : 16
(Mobile card) Card number
par
string
Required
Length : 27
PAR
- Number that replaces PAN(Primary Account Number) of the card
serviceId
string
Required
Min : 1 , Max : 15
(Mobile card) Card product ID
- Unique ID assigned to a card product
serviceName
string
Required
Min : 1 , Max : 255
(Mobile card) Card product name
mobileCardCVC
string
Required
Length : 3
(Mobile card) Card verification code
- Card Verification Code
status
string
Required
Min : 1 , Max : 15
Card application status
- READY : Application in progress
- COST_PAYING : Charge in progress
- COST_PAID : Charge completed
- COST_PAY_FAILED : (End of application) Failed to charge
- DIGITAL_ISSUED : Mobile issuance completed
- PHYSICAL_ISSUED : Physical card issuance completed
- SHIPPING : Shipping in progress
- CANCEL : (End of application) Cancel application
- ISSUE_FAILED : (End of application) Application failed
- RETURNED : (End of application) Card returned
- COMPLETE : (End of application) Completion of application and registration of physical card
values
object
Required
Card balance and point information
balance
number
Required
Min : 0 , Max : 9999999999
(Mobile card) Balance
points
array of objects
Optional
(Mobile Card) Point information
points_item
object
Optional
policyType
string
Optional
Length : 2
(Mobile Card) Point Policy Type
- 00 : User Point
- 01 : Policy allowance
- 02 : Incentive
- 03 : Welfare point (salary)
- 04 : Welfare Point (expense)
- 05 : Affiliate
- 06 : Corporate Point
- 07 : Donation point (for beneficiaries)
policyId
string
Optional
Min : 1 , Max : 15
(Mobile Card) Point policy ID
policyName
string
Optional
Min : 1 , Max : 255
(Mobile Card) Point policy name
amount
number
Optional
Min : 0 , Max : 9999999999
(Mobile card) Points balance
requester
string
Required
Min : 1 , Max : 3
Inflow channel for card application
- APP : Apply in App
- CC : Apply through the customer center
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.
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_011
Message
Invalid card info.
Description
Invalid card information entered (card number, expiry date and CVC)
400
Error code
003_049
Message
Not found issued cards.
Description
발급된 카드를 찾을 수 없음.
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!
