2025-04-08 ํŒŒํŠธ๋„ˆ ์ •์‚ฐ ์ž๋™ํ™” ์—…๋ฐ์ดํŠธ

2025-04-08 ํŒŒํŠธ๋„ˆ ์ •์‚ฐ ์ž๋™ํ™” ์—…๋ฐ์ดํŠธ ์†Œ์‹์„ ์•ˆ๋‚ด๋“œ๋ฆฝ๋‹ˆ๋‹ค.

Release Notes Banner

์•ˆ๋…•ํ•˜์„ธ์š”, ํŒŒํŠธ๋„ˆ ์ •์‚ฐ ์ž๋™ํ™”ํŒ€์ž…๋‹ˆ๋‹ค.
ํŒŒํŠธ๋„ˆ์—๊ฒŒ ์ง€๊ธ‰ํ•  ๊ธˆ์•ก์„ ๊ณ„์‚ฐํ•  ๋•Œ, ์ •์‚ฐ๊ธˆ์•ก์„ ์–ด๋–ค ๊ธฐ์ค€์œผ๋กœ ํ•ด์„ํ• ์ง€ ์„ ํƒํ•  ์ˆ˜ ์žˆ๋Š” ๊ธฐ๋Šฅ์ด ์ƒˆ๋กญ๊ฒŒ ์ถ”๊ฐ€๋˜์—ˆ์Šต๋‹ˆ๋‹ค.
์ด๋ฒˆ ๊ฐœ์„ ์„ ํ†ตํ•ด ๊ณต๊ธ‰๊ฐ€์•ก ๊ธฐ์ค€ ๋˜๋Š” ํ•ฉ๊ณ„๊ธˆ์•ก ๊ธฐ์ค€ ์ค‘ ์„ ํƒํ•˜์—ฌ, ๋”์šฑ ์œ ์—ฐํ•˜๊ณ  ๋ช…ํ™•ํ•œ ์ง€๊ธ‰ ๊ธฐ์ค€์„ ์„ค์ •ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค.
๋˜ํ•œ, ์ผ๊ด„์ง€๊ธ‰ ์‹œ ํ†ต์žฅ ๋ฉ”๋ชจ(์ ์š”) ๊ธฐ๋Šฅ์ด ๋” ๋ˆˆ์— ์ž˜ ๋„๊ณ  ์‰ฝ๊ฒŒ ์„ค์ •๋˜๋„๋ก 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

ํฌํŠธ์› ์„œ๋น„์Šค ๋” ์•Œ์•„๋ณด๊ธฐ โ†’