API Documentation
All API
Service
Search for CardSync
Version: v1
Version: v1
/api/v1/user/card/list
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
cardDataInfo
array of objects
Required
์นด๋ ์ ๋ณด ๋ชฉ๋ก
cardDataInfo_item
object
Optional
par
string
Required
Length : 27
์นด๋์ PAN(Primary Account Number)์ ๋์ฒดํ๋ ๋ฒํธ
limits
object
Optional
๊ฒฐ์ ํ๋ ์ ๋ณด
์ง๋ถ์นด๋์ธ ๊ฒฝ์ฐ์๋ง ์๋ต๋ฐ์ดํฐ์ ํฌํจ๋ฉ๋๋ค.
day
number
Optional
Min : 0 , Max : 9999999999
์ผ ๊ฒฐ์ ํ๋
once
number
Optional
Min : 0 , Max : 9999999999
1ํ ๊ฒฐ์ ํ๋
month
number
Optional
Min : 0 , Max : 9999999999
์ ๊ฒฐ์ ํ๋
balance
number
Required
Min : 0 , Max : 9999999999
์นด๋์ ์ถฉ์ ๋์ด ์๋ ์์ก ์ ๋ณด
pendingAmount
number
Required
Min : 0 , Max : 9999999999
์ถฉ์ ๋๊ธฐ๊ธ ๊ธ์ก
- ์นด๋์ ํ๋๋ฅผ ์ด๊ณผํ๋ ์ถฉ์ ์์ฒญ์ด ์ ์๋์ด, ์์ง ์ฒ๋ฆฌ๋์ง ์๊ณ ์ถฉ์ ๋๊ธฐ ์ค์ธ ๊ธ์ก.
isNamed
boolean
Required
์นด๋ ๊ธฐ๋ช ํ ์ฌ๋ถ
- ๊ธฐ๋ช ํ๋? ๋ฌด๊ธฐ๋ช ์ผ๋ก ๋ฐํ๋ ์นด๋๋ฅผ ์ ๋ถ์ ์์ง๊ธ์๋จ์ ๋ฒ์์ ์ ํ๋ '์ค์ง๋ช ์ ์ธ์ฆ' ๋๋ '์๊ธ๊ณ์ข์ ์ฐ๊ฒฐํ๋ ๋ฐฉ์'์ ํตํ์ฌ ํด๋น ์ ๋ถ์ ์์ง๊ธ์๋จ์ ์ด์ฉ์๋ก ํน์ ํ๋ ํ์๋ฅผ ๋งํฉ๋๋ค.
bankInfo
object
Optional
์ง๋ถ์นด๋์ ์ฐ๊ฒฐ๋ ๊ณ์ข ์ ๋ณด
์ง๋ถ์นด๋์ธ ๊ฒฝ์ฐ์๋ง ์๋ต๋ฐ์ดํฐ์ ํฌํจ๋ฉ๋๋ค.
bankName
string
Required
Min : 1 , Max : 10
์ํ ์ด๋ฆ
accountNo
string
Required
Min : 1 , Max : 20
์ํ ๊ณ์ข ๋ฒํธ
enableFIC
boolean
Required
ํ๊ธIC ํฌํจ ์ฌ๋ถ
- true : ํ๊ธIC ํฌํจ
- false : ํ๊ธIC ๋ฏธํฌํจ
์ง๋ถ์นด๋์ธ ๊ฒฝ์ฐ์๋ง ์๋ต๋ฐ์ดํฐ์ ํฌํจ๋ฉ๋๋ค.
serviceId
string
Required
Length : 15
์นด๋ ์ํ ID
- ์นด๋ ์ํ์ ๋ถ์ฌํ ๊ณ ์ ์๋ณ ๊ฐ์ ๋๋ค.
expiryDate
string
Required
Length : 8
์นด๋ ์ฌ์ฉ ์ ํจ๊ธฐ๊ฐ
- ํ์ : yyyyMMdd
refundable
boolean
Required
์นด๋์ ํ๋ถ ๊ฐ๋ฅ ์ฌ๋ถ
remittable
boolean
Required
์นด๋์ ์ก๊ธ ๊ฐ๋ฅ ์ฌ๋ถ
์๋ ํญ๋ชฉ์ ๋ํ ์์ก ์ก๊ธ ๊ฐ๋ฅ ์ฌ๋ถ๋ฅผ ์ค์ ํฉ๋๋ค.
- ํด๋ ์ ํ๋ฒํธ๋ก ์ก๊ธ
- ์นด๋๋ฒํธ๋ก ์ก๊ธ
cardApplyNo
string
Optional
Length : 22
์นด๋ ์ ์ฒญ ๋ฒํธ
- (ํ์) ๋ชจ๋ฐ์ผ ์นด๋ ๋๋ ์ค๋ฌผ ์นด๋๋ฅผ ๋ฐ๊ธ/๋ฐฐ์ก ์ ์ฒญํ ๋ ์์ฑ๋๋ ๊ณ ์ ๋ฒํธ
serviceName
string
Required
Min : 1 , Max : 255
์นด๋ ์ํ๋ช
mobileCardNo
string
Optional
Length : 16
(๋ชจ๋ฐ์ผ์นด๋) ์นด๋ ๋ฒํธ
rechargeable
boolean
Required
์นด๋์ ์ถฉ์ ๊ฐ๋ฅ ์ฌ๋ถ
์๋ ํญ๋ชฉ์ ์ถฉ์ ๊ฐ๋ฅ์ฌ๋ถ๋ฅผ ์ค์ ํฉ๋๋ค.
- OFFLINE ๋จ๋ง๊ธฐ ์ถฉ์
- ๊ฐ์ธ๊ณ์ข ์ถฉ์
- ํฌํ์ ํตํ ADMIN ์ถฉ์
cardPointInfo
array of objects
Optional
์นด๋ ํฌ์ธํธ ์ ๋ณด
cardPointInfo_item
object
Optional
autoUse
boolean
Required
ํฌ์ธํธ ์๋์ฌ์ฉ ์ฌ๋ถ
- ํฌ์ธํธ ์ ์ฑ ์ ์ค์ ๋ ๊ฐ
pointName
string
Required
Min : 1 , Max : 255
ํฌ์ธํธ ์ ์ฑ ๋ช
pointPolicyId
string
Required
Length : 15
ํฌ์ธํธ ์ ์ฑ ID
remainingPoint
number
Optional
Min : 0 , Max : 9999999999
(ํ์) ํฌ์ธํธ ์์ก
- ํ์์ด ๊ฐ์ง๊ณ ์๋ ํฌ์ธํธ์ ์์ก
physicalCardNo
string
Optional
Length : 16
(์ค๋ฌผ์นด๋) ์นด๋ ๋ฒํธ
serviceImageUrl
string
Required
Min : 1 , Max : 255
์นด๋ ์ํ์ ์ด๋ฏธ์ง ํ์ผ URL
autoReloadStatus
string
Optional
Min : 1 , Max : 8
์นด๋์ ์๋์ถฉ์ ์ํ
- ACTIVE : ํ์ฑํ
- INACTIVE : ๋นํ์ฑํ
- NONE : ์ค์ ์ํจ
mobileCardStatus
string
Required
Min : 1 , Max : 7
(๋ชจ๋ฐ์ผ์นด๋) ์นด๋์ ์ํ
- ACTIVE : ์ ์
- SUSPENDED : ์ค์ง
minRechargeAmount
number
Required
Min : 0 , Max : 9999999999
์นด๋์ ์ถฉ์ ์ ์ต์ ์ถฉ์ ๊ธ์ก
physicalCardStatus
string
Optional
Min : 1 , Max : 7
(์ค๋ฌผ์นด๋) ์นด๋์ ์ํ
- ACTIVE : ์ ์
- SUSPENDED : ์ค์ง
rechargeableAmount
number
Required
Min : 0 , Max : 9999999999
์นด๋์ ์ถฉ์ ๊ฐ๋ฅํ ๊ธ์ก
- ๋ฌด๊ธฐ๋ช ์นด๋์ ๊ฒฝ์ฐ = ๋ฌด๊ธฐ๋ช ์นด๋ ์ต๋ ์ถฉ์ ๊ธ์ก(maxNonRealNameRechargeAmount) - ์นด๋์์ก(balance)
- ๊ธฐ๋ช ํ๋ ์นด๋์ ๊ฒฝ์ฐ = ๊ธฐ๋ช ํ์นด๋ ์ต๋ ์ถฉ์ ๊ธ์ก(maxRealNameRechargeAmount) - ์นด๋์์ก(balance)
์ถฉ์ ๊ฐ๋ฅ ๊ธ์ก(์)
- maxNonRealNameRechargeAmount = 500000
- maxRealNameRechargeAmount = 2000000
- balance = 300000
๋ฌด๊ธฐ๋ช ์นด๋์ธ ๊ฒฝ์ฐ = 200000(500000 - 300000)
๊ธฐ๋ช ํ๋ ์นด๋์ธ ๊ฒฝ์ฐ = 1700000(2000000 - 300000)
personalRechargeable
boolean
Required
์นด๋์ ๊ฐ์ธ๊ณ์ข๋ฅผ ํตํ ์ถฉ์ ๊ฐ๋ฅ ์ฌ๋ถ
maxRealNameRechargeAmount
number
Required
Min : 0 , Max : 9999999999
๊ธฐ๋ช ํ๋ ์นด๋์ ์ถฉ์ ํ ์ ์๋ ์ต๋ ๊ธ์ก
maxNonRealNameRechargeAmount
number
Required
Min : 0 , Max : 9999999999
๋ฌด๊ธฐ๋ช ์นด๋์ ์ถฉ์ ํ ์ ์๋ ์ต๋ ๊ธ์ก
rechargeUnitAmt
number
Optional
Min : 0 , Max : 9999999999
์ถฉ์ ๋จ์ ์ค์
cardLifeStatus
string
Required
Length : 2
์นด๋ ์์ฅ ์ํ ๊ตฌ๋ถ๊ฐ
- 30 : ์ ์ง
- 60 : ํ์ฑํ
- 90 : ์ญ์
cardBizStatus
string
Required
Length : 2
์นด๋์ํ ์ฝ๋
- 31: ์นด๋ ๋ถ์ค๋ก ์ธํ ์ ์งใ
- 36: ์นด๋ ์๋ น ์ ์ ์ง
- 3A: ์นด๋ ์ฌ๋ฐ๊ธ์ผ๋ก ์ธํ ์ค์ง
- 60: ์ ์
- 61: ์นด๋ ๋ถ์ค ์ ๊ณ ํด์ง
- 35: ์นด๋ ์ ํจ ๊ธฐ๊ฐ ๋ง๋ฃ๋ก ์ธํ ์ค์ง
accTransferStatus
string
Required
Length : 1
๋ชจ๋ ์ด์ฒด ์งํ์ํ (์ถฉ์ ์ทจ์, ํ๋ถ์ด์ฒด ์งํ ์ํ)
- 0 : ํด๋น ์์
- 1 : ์ด์ฒด ์งํ์ค
enableVirtualAccountPendingAmount
boolean
Required
๊ฐ์๊ณ์ข ์ถฉ์ ๋๊ธฐ๊ธ ์ฌ์ฉ ์ฌ๋ถ
virtualAccountMaxPendingAmount
number
Required
Min : 0 , Max : 9999999999
๊ฐ์๊ณ์ข ์ถฉ์ ๋๊ธฐ๊ธ ์ต๋ ๊ธ์ก
- ์นด๋ ์์ก + ์ถฉ์ ๋๊ธฐ๊ธ ์์ก์ ์ต๋ ํ์ฉ ๊ธ์ก
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. userId
Description
Invalid input parameter
400
Error code
000_003
Message
Missing required values. userId
Description
Missing required parameter
400
Error code
001_006
Message
Wallet user not found.
Description
Non-member or a member who has canceled membership
Test Data
Request
Response
Click Try It!
to start a Request and see the Response here!