API ๋ฌธ์
์ ์ฒด API
์๋น์ค
์นด๋ ๋ฐฐ์ก ์ํ ์กฐํ๋๊ธฐ
๋ฒ์ : v1
๋ฒ์ : v1
/api/v1/card/delivery/inquiry
์๋ต ํค๋
X-KM-Correlation-Id
string
ํ์
๊ธธ์ด : 20
์ ๋ฌธ ์ถ์ ์ ์ํ ๊ฑฐ๋๋ฒํธ
- ํ์ : yyMMddHHmiSS-xxxxxxx
- xxxxxxx : 7์๋ฆฌ, Hex String
X-KM-Crypto-Key-Id
string
์ต์
๊ธธ์ด : 32
๋ฐ์ดํฐ์๋ณตํธํ ํค ID
- ์๋น์ค ์ฌ์ ์์ ํ๋ก์ ํธ์์ ์์ฑ ์ ๋ถ์ฌํ ID์ ๋๋ค
- Callback์ผ๋ก ์ ๋ฌ๋ ๊ฒฝ์ฐ ์๋น์ค ์ฌ์ ์์๊ฒ ๋ฐ๊ธ๋ ํค ์ค ๊ฐ์ฅ ๋จผ์ ๋ฐ๊ธ๋ ํค๋ฅผ ์ฌ์ฉ ํฉ๋๋ค.
์๋ต ํ๋ผ๋ฏธํฐ
status
string
ํ์
์ต์ : 1 , ์ต๋ : 12
์นด๋ ๋ฐฐ์ก ์ํ
- READY : ์ ์ ๋๊ธฐ
- RECEIPT : ์ ์
- PRE_SHIPPING : ๋ฐฐ์ก ์ค๋น ์ค
- SHIPPING : ๋ฐฐ์ก ์ค
- ARRIVAL : ๋ฐฐ์ก ์๋ฃ
- LOST : ๋ถ์ค
- RETURN : ๋ฐ์ก
- CANCEL : ๋ฐฐ์ก ์ทจ์
- ETC : ๊ธฐํ(์์คํ
์ฅ์ )
์๋ต ์ฝ๋
Detailed classification and addition of error for unseccessful withfrawal
200
์๋ฌ ์ฝ๋
000_000
๋ฉ์์ง
Success.
์ค๋ช
์ฑ๊ณต
400
์๋ฌ ์ฝ๋
000_002
๋ฉ์์ง
Invalid input parameter.
์ค๋ช
์ ๋ ฅ ํ๋ผ๋ฏธํฐ ์ค๋ฅ์ ๋๋ค.
400
์๋ฌ ์ฝ๋
001_006
๋ฉ์์ง
Wallet user not found.
์ค๋ช
ํ์์ด ์๋๊ฑฐ๋ ํํดํ ํ์์ ๋๋ค.
400
์๋ฌ ์ฝ๋
003_001
๋ฉ์์ง
Invalid card info.
์ค๋ช
์ ๋ ฅํ ์นด๋์ ๋ณด(์นด๋๋ฒํธ, ๋ง๋ฃ์ผ, CVC)๊ฐ ์ ํจํ์ง ์์ต๋๋ค.
ํ ์คํธ ๋ฐ์ดํฐ
Request
Response
Try It!์ ํด๋ฆญํ์ฌ
์
๋ ฅํ Request์ Response๋ฅผ ํ์ธํ์ธ์.