2025-04-08 ํํธ๋ ์ ์ฐ ์๋ํ ์ ๋ฐ์ดํธ
2025-04-08 ํํธ๋ ์ ์ฐ ์๋ํ ์ ๋ฐ์ดํธ ์์์ ์๋ด๋๋ฆฝ๋๋ค.

์๋
ํ์ธ์, ํํธ๋ ์ ์ฐ ์๋ํํ์
๋๋ค.
ํํธ๋์๊ฒ ์ง๊ธํ ๊ธ์ก์ ๊ณ์ฐํ ๋, ์ ์ฐ๊ธ์ก์ ์ด๋ค ๊ธฐ์ค์ผ๋ก ํด์ํ ์ง ์ ํํ ์ ์๋ ๊ธฐ๋ฅ์ด ์๋กญ๊ฒ ์ถ๊ฐ๋์์ต๋๋ค.
์ด๋ฒ ๊ฐ์ ์ ํตํด ๊ณต๊ธ๊ฐ์ก ๊ธฐ์ค ๋๋ ํฉ๊ณ๊ธ์ก ๊ธฐ์ค ์ค ์ ํํ์ฌ, ๋์ฑ ์ ์ฐํ๊ณ ๋ช
ํํ ์ง๊ธ ๊ธฐ์ค์ ์ค์ ํ ์ ์์ต๋๋ค.
๋ํ, ์ผ๊ด์ง๊ธ ์ ํต์ฅ ๋ฉ๋ชจ(์ ์) ๊ธฐ๋ฅ์ด ๋ ๋์ ์ ๋๊ณ ์ฝ๊ฒ ์ค์ ๋๋๋ก UI๊ฐ ๊ฐ์ ๋์์ต๋๋ค.
์์ฃผ ์ฌ์ฉํ๋ ํต์ฅ ๋ฉ๋ชจ๋ ํ ๋ฒ๋ง ๋ฑ๋กํด๋๋ฉด, ์ง๊ธ ์ ์๋์ผ๋ก ์ ์ฉ๋๋ ํ๋ฒ ์ค์ ํด๋ณด์๋ ๊ฒ ์ด๋จ๊น์?
โ ๏ธ [์ค์] ์ ๋ฐ์ดํธ๋ก ์ธํ API ๋ณ๊ฒฝ์ฌํญ๋ ํ๋จ์์ ๊ผญ ํ์ธํด์ฃผ์ธ์.
๐ ์ฃผ์ ๊ธฐ๋ฅ ์๋ด
1. ์ ์ฐ ์ธ๋ถ ๊ธ์ก ํ์ธ ๊ฐ๋ฅ (๊ณต๊ธ๊ฐ์ก / ๋ฉด์ธ๊ธ์ก / ๋ถ๊ฐ์ธ์ก)
์ง๋ ์ ๋ฐ์ดํธ์์ ์ง์๋ ๋ฉด์ธ๊ธ์ก์ ํ์ฉํ์ฌ ๊ณต๊ธ๊ฐ์ก / ๋ฉด์ธ๊ธ์ก / ๋ถ๊ฐ์ธ์ก์ ๋ถ๋ฆฌํ์ฌ ํ์ธ ํ์ ํ ์ ์์ต๋๋ค.
์ ์ฐ๊ธ์ก์ ๋ค์ ์ธ ๊ฐ์ง ํญ๋ชฉ์ผ๋ก ๊ตฌ๋ถ๋์ด ํ์ธ ๊ฐ๋ฅํฉ๋๋ค:
- ๊ณต๊ธ๊ฐ์ก: ๊ณผ์ธ ๋์ ๊ธ์ก(์ธ์ )
- ๋ฉด์ธ๊ธ์ก: ๋ฉด์ธ ๋์ ๊ธ์ก
- ๋ถ๊ฐ์ธ์ก: ๊ณต๊ธ๊ฐ์ก ๊ธฐ์ค์ผ๋ก ์๋ ๊ณ์ฐ๋ ์ธ๊ธ
์ด ์ ๋ณด๋ฅผ ๊ธฐ๋ฐ์ผ๋ก, ์ง๊ธ ๊ธ์ก ๊ณ์ฐ์ ๊ธฐ์ค์ ์ ํํ ์ ์์ต๋๋ค.
2. ์ง๊ธ๊ธ์ก ์ฐ์ ๊ธฐ์ค ์ ํ ๊ฐ๋ฅ (์ ์ฐ๊ธ์ก ์ทจ๊ธ ๊ธฐ์ค ์ค์ )
์ ์ฐ์ ์ฑ ๋ฑ๋ก ์ ์ง๊ธ๊ธ์ก์ ๊ณ์ฐํ ๋ ์ด๋ค ๊ธฐ์ค์ผ๋ก ์ ์ฐ๊ธ์ก์ ์ฌ์ฉํ ์ง ์ ํํ ์ ์์ต๋๋ค.
์ค์ ๊ฐ | ์ค๋ช | ์ง๊ธ๊ธ์ก ๊ณ์ฐ ๋ฐฉ์ |
---|---|---|
ํฉ๊ณ๊ธ์ก (๊ธฐ๋ณธ๊ฐ) | ์ ์ฐ๊ธ์ก์ ๊ณต๊ธ๊ฐ์ก + ๋ฉด์ธ๊ธ์ก + ๋ถ๊ฐ์ธ ๋ก ๊ฐ์ฃผํ์ฌ ์ง๊ธ | ์ง๊ธ๊ธ์ก = ์ ์ฐ๊ธ์ก |
๊ณต๊ธ๊ฐ์ก | ์ ์ฐ๊ธ์ก์ ๊ณต๊ธ๊ฐ์ก + ๋ฉด์ธ๊ธ์ก ์ผ๋ก ๊ฐ์ฃผํ๊ณ , ๋ถ๊ฐ์ธ๋ ๋ณ๋๋ก ๊ณ์ฐ๋์ด ์ง๊ธ | ์ง๊ธ๊ธ์ก = ์ ์ฐ๊ธ์ก ร 1.1 (๋ถ๊ฐ์ธ ๋ณ๋) |
โ ํ๋ฉด ๋ณ๊ฒฝ ์๋ด
1. ์ ์ฐ ๊ท์น ์ค์ ํ์ด์ง ๋ฆฌ๋ด์ผ
- ๊ธฐ์กด์ ์ ์ฐ ์ ์ฑ ๊ด๋ฆฌ > ์ ์ฐ ๊ท์น ํญ์ด โ์ค์ โ ํญ์ผ๋ก ๋ณ๊ฒฝ๋์์ต๋๋ค.
- ๊ตฌ์กฐ: ์ ์ฐ ์ ์ฑ ์ค์ / ์ง๊ธ ๊ธ์ก ์ค์ ์ผ๋ก ๊ตฌ์ฑ
- ์ ์ฐ ๊ธ์ก ์ทจ๊ธ ๊ธฐ์ค ์ค์ ์ด ์ถ๊ฐ๋์ด, ์ ์ฐ ๊ธ์ก ๊ณ์ฐ ์ ๋ถ๊ฐ์ธ ํฌํจ ์ฌ๋ถ๋ฅผ ์ค์ ํ ์ ์์ต๋๋ค.

2. ์ง๊ธ ๋ด์ญ ๊ด๋ฆฌ - ํ ์ด๋ธ ํญ๋ชฉ ์ถ๊ฐ
- ์ง๊ธ ๋ด์ญ ํ
์ด๋ธ์ ์๋ ํญ๋ชฉ๋ค์ด ์ถ๊ฐ๋์ด ์ค์ ํญ์์ ์ ํํ ์ง๊ธ ๊ธฐ์ค์ ํ๋์ ํ์ธํ ์ ์์ต๋๋ค.
์์ฒ์ง์์ธ์ก ์ฐจ๊ฐ ์ฌ๋ถ
: ์ฐจ๊ฐ / ๋ฏธ์ฐจ๊ฐ์ ์ฐ ๊ธ์ก ์ทจ๊ธ ๊ธฐ์ค
: ํฉ๊ณ ๊ธ์ก / ๊ณต๊ธ๊ฐ์ก

3. ์ผ๊ด์ง๊ธ ๊ธฐ๋ณธ ์ค์ UI ๊ฐ์
- ์ผ๊ด์ง๊ธ ์ ํต์ฅ ์ ์ ๋ฉ๋ชจ๋ฅผ ๋ฏธ๋ฆฌ ๋ฑ๋กํ๋ฉด, ๋งค๋ฒ ์๋์ผ๋ก ์ ์ฉ๋ฉ๋๋ค.
- ์ด ํธ๋ฆฌํ ๊ธฐ๋ฅ์ ํ์ฉ๋๋ฅผ ๋์ด๊ธฐ ์ํด UI ๋์์ธ์ด ๊ฐ์ ๋์์ต๋๋ค.
โจ ํ ๋ฒ๋ง ์ค์ ํด๋๋ฉด, ๋ฐ๋ณต ์์ ์์ด ๊ฐํธํ๊ฒ ์ง๊ธ ๋ฉ๋ชจ๊ฐ ์ ์ฉ๋ฉ๋๋ค.

โ ๏ธ API ๋ณ๊ฒฝ ์๋ด
์ฌ์ ๊ณ ์ง๋ deprecated ์์ฑ๋ค์ด ์ญ์ ๋์์ต๋๋ค.
[์ค์] ์ ์ฐ ๋ค๊ฑด ์กฐํ API
GET /platform/partner-settlements
items.type
์ดORDER
ํน์ORDER_CANCEL
์ธ ๊ฒฝ์ฐamount
๊ฐ์ฒด ๋ด์supply
๊ฐ ์ญ์ ๋์์ต๋๋ค.paymentSupply
๋ก ๋์ฒด ์ฌ์ฉํด์ฃผ์๊ธธ ๋ฐ๋๋๋ค.taxFree
๊ฐ ์ญ์ ๋์์ต๋๋ค.paymentTaxFree
๋ก ๋์ฒด ์ฌ์ฉํด์ฃผ์๊ธธ ๋ฐ๋๋๋ค.
[์ค์] ์ ์ฐ ์์ธ ๊ด๋ จ API
๊ด๋ จ API
- GET /platform/transfer-summaries
- GET /platform/transfers/{id}
- POST /platform/transfers/order
- POST /platform/transfers/order-cancel
type
์ดORDER
ํน์ORDER_CANCEL
์ธ ๊ฒฝ์ฐamount
๊ฐ์ฒด ๋ด์supply
๊ฐ ์ญ์ ๋์์ต๋๋ค.paymentSupply
๋ก ๋์ฒด ์ฌ์ฉํด์ฃผ์๊ธธ ๋ฐ๋๋๋ค.taxFree
๊ฐ ์ญ์ ๋์์ต๋๋ค.paymentTaxFree
๋ก ๋์ฒด ์ฌ์ฉํด์ฃผ์๊ธธ ๋ฐ๋๋๋ค.
์ง๊ธ ๋ค๊ฑด ์กฐํ API
GET /platform/payouts
- 200 ์๋ต ์
items
๋ฐฐ์ด ๊ฐ์ฒด ๋ด-
์ง๊ธ ๊ธ์ก ๊ณ์ฐ ๊ด๋ จ ์ต์
deductWht
์์ฒ์ง์์ธ์ก ์ฐจ๊ฐ ์ฌ๋ถ ์ถ๊ฐ๋์์ต๋๋ค.failReason
์ง๊ธ์คํจ์ฌ์ ์ถ๊ฐ๋์์ต๋๋ค.settlementAmountType
์ ์ฐ๊ธ์ก ์ทจ๊ธ ๊ธฐ์ค์ด ์ถ๊ฐ๋์์ต๋๋ค.
-
ํ์ ์ธ๋ถ ๊ธ์ก
supplyAmount
ํ์ ๊ณต๊ธ๊ฐ์ก ์ถ๊ฐ๋์์ต๋๋ค.vatAmount
ํ์ ๋ถ๊ฐ์ธ์ก ์ถ๊ฐ๋์์ต๋๋ค.taxFreeAmont
ํ์ ๋ฉด์ธ๊ธ์ก ์ถ๊ฐ๋์์ต๋๋ค.
-
๊ฐ์ฌํฉ๋๋ค.
ํํธ๋์ ์ฐ ์๋ํ ํ ๋๋ฆผ
์์ฑ์ผ์ 2025๋ 4์ 8์ผ
์ผ๋ฐ ๋ฌธ์ | cs@portone.io |
---|---|
๊ธฐ์ ์ง์ ๋ฌธ์ | support@portone.io |