API ๋ฌธ์
์ ์ฒด API
์๋น์ค
ํ์ ๊ฐ์ ๋๊ธฐ
๋ฒ์ : v1
๋ฒ์ : v1
/api/v1/user/registration
์๋ต ํค๋
X-KM-Correlation-Id
string
ํ์
๊ธธ์ด : 20
์ ๋ฌธ ์ถ์ ์ ์ํ ๊ฑฐ๋๋ฒํธ
- ํ์ : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7์๋ฆฌ, Hex String
X-KM-Crypto-Key-Id
string
์ต์
๊ธธ์ด : 32
๋ฐ์ดํฐ์๋ณตํธํ ํค ID
- ํ๋ก์ ํธ ์์ฑ ์ ๋ถ์ฌ๋๋ ID์ ๋๋ค.
- Callback์ผ๋ก ์ ๋ฌ๋ ๊ฒฝ์ฐ ์๋น์ค ์ฌ์ ์์๊ฒ ๋ฐ๊ธ๋ ํค ์ค ๊ฐ์ฅ ๋จผ์ ๋ฐ๊ธ๋ ํค๋ฅผ ์ฌ์ฉ ํฉ๋๋ค.
์๋ต ํ๋ผ๋ฏธํฐ
userId
number
ํ์
์ต์ : 1 , ์ต๋ : 9999999999999999999
ํ์ ID
- ํ์๊ฐ์ ์ ๋ถ์ฌ๋๋ ํ์์ ๊ณ ์ ID์ ๋๋ค.
basicCardInfo
object
์ต์
ํ์ ๊ฐ์ ์ ๋ฐ๊ธ๋๋ ๋ชจ๋ฐ์ผ ์นด๋ ๊ธฐ๋ณธ์ ๋ณด
par
string
ํ์
๊ธธ์ด : 27
ํ์ ๊ฐ์ ์ ๋ฐ๊ธ๋ ๋ชจ๋ฐ์ผ ์นด๋ ์นด๋์ PAN(Primary Account Number)์ ๋์ฒดํ๋ ๋ฒํธ
cardNo
string
ํ์
๊ธธ์ด : 16
ํ์ ๊ฐ์ ์ ๋ฐ๊ธ๋ ๋ชจ๋ฐ์ผ ์นด๋ ์นด๋ ๋ฒํธ
expiryDate
string
ํ์
๊ธธ์ด : 6
ํ์ ๊ฐ์ ์ ๋ฐ๊ธ๋ ๋ชจ๋ฐ์ผ ์นด๋ ์นด๋ ์ฌ์ฉ ์ ํจ๊ธฐ๊ฐ (Format : YYMMDD)
serviceId
string
ํ์
๊ธธ์ด : 15
์นด๋ ์ํ ID
- ์นด๋ ์ํ์ ๋ถ์ฌํ ๊ณ ์ ์๋ณ ๊ฐ์ ๋๋ค.
์๋ต ์ฝ๋
Detailed classification and addition of error for unseccessful withfrawal
200
์๋ฌ ์ฝ๋
000_000
๋ฉ์์ง
Success.
์ค๋ช
์ฑ๊ณต
400
์๋ฌ ์ฝ๋
000_002
๋ฉ์์ง
Invalid input value. loginId
์ค๋ช
์ ๋ ฅ ํ๋ผ๋ฏธํฐ ์ค๋ฅ - `loginId` ํ์ ์ ๋ณด๊ฐ ๋น ๋ฌธ์์ด์ธ ๊ฒฝ์ฐ
400
์๋ฌ ์ฝ๋
000_003
๋ฉ์์ง
Missing required values. loginId
์ค๋ช
ํ์๊ฐ ๋๋ฝ - `loginId` ํ์ ์ ๋ณด ์์ฒญ null ์ธ ๊ฒฝ์ฐ
400
์๋ฌ ์ฝ๋
000_015
๋ฉ์์ง
The length of value does not match. birthDate (๋ฐ๋์ ์ต์๊ฐ 8๊ณผ(์) ์ต๋๊ฐ 8 ์ฌ์ด์ ํฌ๊ธฐ์ด์ด์ผ ํฉ๋๋ค.)
์ค๋ช
ํ๋ ๊ธธ์ด ์ค๋ฅ - `birthDate` ๊ธธ์ด 8 ์๋ฆฌ ์ดํ์ธ ๊ฒฝ์ฐ
400
์๋ฌ ์ฝ๋
001_001
๋ฉ์์ง
User already exists with this loginId.
์ค๋ช
๊ธฐ ์ฌ์ฉ ๋ก๊ทธ์ธ ์์ด๋ ์ ๋ ฅ ์ค๋ฅ
400
์๋ฌ ์ฝ๋
001_028
๋ฉ์์ง
CI data already found for another user.
์ค๋ช
๊ธฐ ๊ฐ์ ํ์ ์ค๋ฅ
400
์๋ฌ ์ฝ๋
001_009
๋ฉ์์ง
Terms and conditions data missing.
์ค๋ช
ํ์ ์ฝ๊ด ๋์ ๋๋ฝ
ํ ์คํธ ๋ฐ์ดํฐ
Request
Response
Try It!์ ํด๋ฆญํ์ฌ
์
๋ ฅํ Request์ Response๋ฅผ ํ์ธํ์ธ์.
