@portone/mcp-server 0.14.0 → 0.15.0-alpha.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (257) hide show
  1. package/README.md +4 -2
  2. package/assets/docs/_components/ko/docs-for-llms.md +21 -0
  3. package/assets/docs/_components/ko/llms-txt-support.md +15 -0
  4. package/assets/docs/_components/ko/using-mcp-server.md +60 -0
  5. package/assets/docs/api/rest-v1/_components/v1auth.md +103 -0
  6. package/assets/docs/help/admin-console/analytics/content32.md +4 -4
  7. package/assets/docs/help/admin-console/payment-service/content29.md +223 -110
  8. package/assets/docs/help/admin-console/pg-settlement/content30.md +103 -208
  9. package/assets/docs/help/admin-console/pg-settlement-history/content35.md +167 -0
  10. package/assets/docs/help/admin-console/platform-settlement/partner_settlement_service_guide.md +268 -0
  11. package/assets/docs/help/api-sdk-2025-05-14.md +71 -0
  12. package/assets/docs/help/applepay.md +1 -1
  13. package/assets/docs/help/content100002.md +1 -1
  14. package/assets/docs/help/content100029.md +1 -1
  15. package/assets/docs/help/content100060.md +2 -2
  16. package/assets/docs/help/content200015.md +1 -1
  17. package/assets/docs/help/content200019.md +1 -1
  18. package/assets/docs/help/content200023.md +2 -2
  19. package/assets/docs/help/content200050.md +1 -1
  20. package/assets/docs/help/core-service/channel-setting/danal.md +6 -8
  21. package/assets/docs/help/core-service/channel-setting/eximbay.md +9 -3
  22. package/assets/docs/help/core-service/channel-setting/kcp_channel.md +80 -13
  23. package/assets/docs/help/core-service/channel-setting/naverpay.md +6 -8
  24. package/assets/docs/help/core-service/channel-setting/nice.md +49 -47
  25. package/assets/docs/help/core-service/channel-setting/payletter.md +91 -0
  26. package/assets/docs/help/core-service/channel-setting/paymentwall.md +4 -1
  27. package/assets/docs/help/core-service/how-to-use/additional-nice.md +19 -19
  28. package/assets/docs/help/core-service/how-to-use/cancel-reversal.md +2 -2
  29. package/assets/docs/help/core-service/how-to-use/content200009.md +2 -2
  30. package/assets/docs/help/core-service/how-to-use/danal-contract.md +2 -2
  31. package/assets/docs/help/core-service/how-to-use/daou-contract.md +2 -2
  32. package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +9 -9
  33. package/assets/docs/help/core-service/how-to-use/identity-verification-age-restriction.md +29 -0
  34. package/assets/docs/help/core-service/how-to-use/information-pg.md +4 -4
  35. package/assets/docs/help/core-service/how-to-use/ksnet-contract.md +1 -1
  36. package/assets/docs/help/core-service/how-to-use/nice-contract.md +15 -15
  37. package/assets/docs/help/core-service/how-to-use/open-immediately.md +1 -1
  38. package/assets/docs/help/core-service/how-to-use/point-service.md +7 -7
  39. package/assets/docs/help/core-service/how-to-use/settle-contract.md +2 -2
  40. package/assets/docs/help/core-service/how-to-use/shopify-available-list.md +4 -4
  41. package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +3 -3
  42. package/assets/docs/help/core-service/how-to-use/tosspayments-contract.md +4 -4
  43. package/assets/docs/help/core-service/payment-type/content200007.md +8 -7
  44. package/assets/docs/help/core-service/payment-type/content200036.md +17 -18
  45. package/assets/docs/help/core-service/payment-type/content200042.md +3 -3
  46. package/assets/docs/help/core-service/payment-type/content200052.md +2 -2
  47. package/assets/docs/help/core-service/payment-type/content200053.md +7 -3
  48. package/assets/docs/help/core-service/payment-type/hub-service-fee.md +19 -17
  49. package/assets/docs/help/core-service/payment-type/inicis-easypay-hub-fee.md +5 -6
  50. package/assets/docs/help/core-service/payment-type/inicis-international.md +10 -10
  51. package/assets/docs/help/core-service/payment-type/internationl-pg.md +7 -3
  52. package/assets/docs/help/core-service/payment-type/kcp-easypay-hub-apply.md +4 -5
  53. package/assets/docs/help/core-service/payment-type/kcp-international.md +2 -3
  54. package/assets/docs/help/core-service/payment-type/nice-easypay-hub-fee.md +8 -8
  55. package/assets/docs/help/core-service/payment-type/nice-international.md +14 -14
  56. package/assets/docs/help/core-service/payment-type/payletter-international.md +104 -0
  57. package/assets/docs/help/core-service/payment-type/schedule-requirement.md +2 -2
  58. package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md +6 -6
  59. package/assets/docs/help/faq/general-inquiry/confirm-process.md +16 -16
  60. package/assets/docs/help/faq/general-inquiry/identity-verification-suspended-ip.md +35 -0
  61. package/assets/docs/help/faq/general-inquiry/kcp-business-number-error.md +29 -0
  62. package/assets/docs/help/faq/general-inquiry/platform-contract-method.md +4 -5
  63. package/assets/docs/help/faq/general-inquiry/platform-contract-pg.md +2 -2
  64. package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
  65. package/assets/docs/help/faq/payment-faq/cash-receipt-guide.md +2 -2
  66. package/assets/docs/help/faq/payment-faq/kcp-cash-receipt.md +34 -0
  67. package/assets/docs/help/faq/payment-faq/payment-failure-danal-insufficient-funds.md +29 -0
  68. package/assets/docs/help/faq/payment-faq/payment-failure-kcp-insufficient-funds.md +35 -0
  69. package/assets/docs/help/faq/payment-faq/payment-failure-kiwoompay-insufficient-funds.md +25 -0
  70. package/assets/docs/help/faq/payment-faq/payment-failure-nice-insufficient-funds.md +28 -0
  71. package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
  72. package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +10 -10
  73. package/assets/docs/help/faq/payment-faq/wordpress-woocommerce-taxation.md +67 -0
  74. package/assets/docs/help/faq/platform-faq/platform_additional_fee_setting.md +28 -0
  75. package/assets/docs/help/faq/platform-faq/platform_api_docs.md +24 -0
  76. package/assets/docs/help/faq/platform-faq/platform_definition_partner.md +34 -0
  77. package/assets/docs/help/faq/platform-faq/platform_definition_payout_agency.md +23 -0
  78. package/assets/docs/help/faq/platform-faq/platform_definition_platform.md +17 -0
  79. package/assets/docs/help/faq/platform-faq/platform_definition_settlement.md +29 -0
  80. package/assets/docs/help/faq/platform-faq/platform_difference_settlement_payout.md +29 -0
  81. package/assets/docs/help/faq/platform-faq/platform_ecommerce_discount_policy.md +19 -0
  82. package/assets/docs/help/faq/platform-faq/platform_introduction.md +15 -0
  83. package/assets/docs/help/faq/platform-faq/platform_introduction_conditions.md +16 -0
  84. package/assets/docs/help/faq/platform-faq/platform_nocode_guide.md +5 -5
  85. package/assets/docs/help/faq/platform-faq/platform_nocode_hosting.md +20 -0
  86. package/assets/docs/help/faq/platform-faq/platform_nocode_use.md +28 -0
  87. package/assets/docs/help/faq/platform-faq/platform_partner_bulk_registration.md +31 -0
  88. package/assets/docs/help/faq/platform-faq/platform_partner_info_guide.md +49 -0
  89. package/assets/docs/help/faq/platform-faq/platform_partner_management_tags.md +14 -0
  90. package/assets/docs/help/faq/platform-faq/platform_partner_tax_type.md +18 -0
  91. package/assets/docs/help/faq/platform-faq/platform_partnerships.md +16 -0
  92. package/assets/docs/help/faq/platform-faq/platform_payment_formula_setting.md +20 -0
  93. package/assets/docs/help/faq/platform-faq/platform_paymentdetails_definition.md +11 -0
  94. package/assets/docs/help/faq/platform-faq/platform_paymentdetails_view_features.md +18 -0
  95. package/assets/docs/help/faq/platform-faq/platform_payoutagency_realtime_payment.md +22 -0
  96. package/assets/docs/help/faq/platform-faq/platform_payoutagency_safety_legality.md +22 -0
  97. package/assets/docs/help/faq/platform-faq/platform_payoutagency_scheduled_payment.md +18 -0
  98. package/assets/docs/help/faq/platform-faq/platform_pg_fee_handling.md +18 -0
  99. package/assets/docs/help/faq/platform-faq/platform_policymanagement_calculator.md +1 -1
  100. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_creation_guide.md +24 -0
  101. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_definition.md +19 -0
  102. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_service_compliance.md +28 -0
  103. package/assets/docs/help/faq/platform-faq/platform_settlement_auto_calculation_setting.md +39 -0
  104. package/assets/docs/help/faq/platform-faq/platform_settlement_cancellation_data.md +21 -0
  105. package/assets/docs/help/faq/platform-faq/platform_settlement_custom_attributes.md +18 -0
  106. package/assets/docs/help/faq/platform-faq/platform_settlement_custom_formula_request.md +20 -0
  107. package/assets/docs/help/faq/platform-faq/platform_settlement_cycle_setting.md +42 -0
  108. package/assets/docs/help/faq/platform-faq/platform_settlement_decimal_rounding.md +23 -0
  109. package/assets/docs/help/faq/platform-faq/platform_settlement_hold_date_setting.md +35 -0
  110. package/assets/docs/help/faq/platform-faq/platform_settlement_holidays.md +9 -0
  111. package/assets/docs/help/faq/platform-faq/platform_settlement_manual_registration.md +32 -0
  112. package/assets/docs/help/faq/platform-faq/platform_settlementdetails_view_features.md +26 -0
  113. package/assets/docs/help/faq/platform-faq/platform_settlmentandpayout_guide.md +4 -4
  114. package/assets/docs/help/faq/platform-faq/platform_supported_bank_codes.md +85 -0
  115. package/assets/docs/help/faq/platform-faq/platform_supported_currencies.md +33 -0
  116. package/assets/docs/help/faq/platform-faq/platform_tax_calculation.md +17 -0
  117. package/assets/docs/help/faq/platform-faq/platform_tax_setting_guide.md +1 -1
  118. package/assets/docs/help/faq/platform-faq/platform_tax_withholding_tax_definition.md +14 -0
  119. package/assets/docs/help/faq/platform-faq/platform_virtual_account_withdrawal.md +16 -0
  120. package/assets/docs/help/faq/platform-faq/platform_webhook_definition.md +24 -0
  121. package/assets/docs/help/faq/platform-faq/recommended_withdrawal.md +16 -0
  122. package/assets/docs/help/faq/platform-faq/system_test_environment.md +13 -0
  123. package/assets/docs/help/faq/platform-faq/taxinvoice_bulk_issuance.md +25 -0
  124. package/assets/docs/help/faq/platform-faq/taxinvoice_cancel.md +12 -0
  125. package/assets/docs/help/faq/platform-faq/taxinvoice_delayed.md +18 -0
  126. package/assets/docs/help/faq/platform-faq/taxinvoice_forward_issuance.md +23 -0
  127. package/assets/docs/help/faq/platform-faq/taxinvoice_guide_atoz.md +202 -0
  128. package/assets/docs/help/faq/platform-faq/taxinvoice_partner_peristalsis.md +60 -0
  129. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_buyer_process.md +52 -0
  130. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_definition.md +46 -0
  131. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_partner_signup.md +23 -0
  132. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_supplier_process.md +47 -0
  133. package/assets/docs/help/notice-payletter-2025-10-21.md +29 -0
  134. package/assets/docs/help/notice-payletter-2025-10-24.md +46 -0
  135. package/assets/docs/help/platform-2025-07-02.md +73 -0
  136. package/assets/docs/help/platform-2025-07-07.md +56 -0
  137. package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +2 -2
  138. package/assets/docs/help/procedure/payment-integration/test-integration.md +2 -2
  139. package/assets/docs/help/procedure/pg-application/content59.md +1 -1
  140. package/assets/docs/help/procedure/pg-application/start.md +1 -1
  141. package/assets/docs/help/procedure/recommendation/package.md +5 -5
  142. package/assets/docs/help/service/identity-verification/identity-verification.md +6 -6
  143. package/assets/docs/help/service/paymethod/paymethod.md +2 -2
  144. package/assets/docs/help/service/pg/pg-service-list.md +25 -13
  145. package/assets/docs/help/service/version/portone-version.md +1 -1
  146. package/assets/docs/opi/ko/console/guide/billing-payments.md +1 -1
  147. package/assets/docs/opi/ko/console/guide/reg.md +1 -1
  148. package/assets/docs/opi/ko/console/guide/smartrouting.md +0 -2
  149. package/assets/docs/opi/ko/console/pg.md +7 -7
  150. package/assets/docs/opi/ko/etc/recon.md +1 -1
  151. package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md +2 -2
  152. package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md +11 -4
  153. package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md +2 -2
  154. package/assets/docs/opi/ko/extra/identity-verification/v1/all/3.md +3 -3
  155. package/assets/docs/opi/ko/extra/identity-verification/v1/all/readme.md +1 -1
  156. package/assets/docs/opi/ko/extra/identity-verification/v1/credit-auth/4.md +3 -3
  157. package/assets/docs/opi/ko/extra/identity-verification/v1/phone/4.md +3 -3
  158. package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md +74 -0
  159. package/assets/docs/opi/ko/extra/plugins/wordpress/button.md +1 -1
  160. package/assets/docs/opi/ko/extra/plugins/wordpress/edd.md +1 -1
  161. package/assets/docs/opi/ko/extra/plugins/wordpress/woocommerce/subscription.md +1 -1
  162. package/assets/docs/opi/ko/extra/promotion/intro.md +1 -1
  163. package/assets/docs/opi/ko/extra/smart-routing/console-guide.md +1 -1
  164. package/assets/docs/opi/ko/extra/smart-routing/integration.md +2 -2
  165. package/assets/docs/opi/ko/extra/smart-routing/intro.md +9 -9
  166. package/assets/docs/opi/ko/integration/pg/v1/danal.md +5 -0
  167. package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +9 -0
  168. package/assets/docs/opi/ko/integration/pg/v1/daou/undefined.md +8 -0
  169. package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +0 -14
  170. package/assets/docs/opi/ko/integration/pg/v1/inicis.md +58 -0
  171. package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +12 -1
  172. package/assets/docs/opi/ko/integration/pg/v1/kicc.md +3 -1
  173. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +710 -0
  174. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +661 -0
  175. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +10 -71
  176. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +11 -11
  177. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/payment-caution.md +16 -16
  178. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +10 -8
  179. package/assets/docs/opi/ko/integration/pg/v1/nice.md +6 -6
  180. package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +86 -0
  181. package/assets/docs/opi/ko/integration/pg/v1/paypal.md +1 -1
  182. package/assets/docs/opi/ko/integration/pg/v1/readme.md +5 -3
  183. package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +80 -0
  184. package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +10 -9
  185. package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +10 -7
  186. package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +138 -22
  187. package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md +0 -1
  188. package/assets/docs/opi/ko/integration/pg/v2/inicis-v2.md +13 -1
  189. package/assets/docs/opi/ko/integration/pg/v2/kcp-v2.md +4 -2
  190. package/assets/docs/opi/ko/integration/pg/v2/naverpay.md +1 -1
  191. package/assets/docs/opi/ko/integration/pg/v2/nice-v2.md +40 -40
  192. package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md +9 -2
  193. package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +13 -12
  194. package/assets/docs/opi/ko/integration/pg/v2/readme.md +1 -1
  195. package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
  196. package/assets/docs/opi/ko/integration/pg/v2/welcome.md +8 -7
  197. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/hyphen.md +27 -0
  198. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/inicis.md +64 -0
  199. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/kcp-v2.md +70 -0
  200. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/paypal-v2.md +25 -0
  201. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/tosspayments.md +15 -0
  202. package/assets/docs/opi/ko/integration/ready/readme.md +26 -10
  203. package/assets/docs/opi/ko/integration/start/_components/sdk-installation.md +71 -0
  204. package/assets/docs/opi/ko/integration/start/v1/non-auth.md +2 -4
  205. package/assets/docs/opi/ko/integration/start/v2/billing/issue.md +1 -1
  206. package/assets/docs/opi/ko/integration/start/v2/checkout.md +4 -2
  207. package/assets/docs/opi/ko/integration/start/v2/readme.md +2 -2
  208. package/assets/docs/opi/ko/integration/using-ai-tools.md +33 -57
  209. package/assets/docs/opi/ko/integration/virtual-account/readme.md +9 -9
  210. package/assets/docs/opi/ko/integration/webhook/readme-v1.md +2 -4
  211. package/assets/docs/opi/ko/integration/webhook/readme-v2.md +1 -3
  212. package/assets/docs/opi/ko/quick-guide/payment.md +16 -16
  213. package/assets/docs/opi/ko/support/code-info/pg-1.md +1 -1
  214. package/assets/docs/opi/ko/support/code-info/pg-2.md +2 -2
  215. package/assets/docs/opi/ko/support/code-info/pg.md +2 -2
  216. package/assets/docs/opi/ko/support/contact.md +1 -13
  217. package/assets/docs/opi/ko/support/pg-terms.md +233 -0
  218. package/assets/docs/platform/ko/guides/dictionary.md +136 -16
  219. package/assets/docs/platform/ko/guides/process.md +1 -1
  220. package/assets/docs/platform/ko/guides/webhook.md +1 -1
  221. package/assets/docs/platform/ko/using-ai-tools.md +33 -57
  222. package/assets/docs/release-notes/api-sdk/2023-07-10.md +7 -7
  223. package/assets/docs/release-notes/api-sdk/2023-07-31.md +1 -1
  224. package/assets/docs/release-notes/api-sdk/2023-08-31.md +2 -2
  225. package/assets/docs/release-notes/api-sdk/2024-01-08.md +4 -4
  226. package/assets/docs/release-notes/api-sdk/2024-06-03.md +1 -1
  227. package/assets/docs/release-notes/api-sdk/2024-09-05.md +0 -1
  228. package/assets/docs/release-notes/api-sdk/2024-09-27.md +1 -1
  229. package/assets/docs/release-notes/console/2025-10-17.md +47 -0
  230. package/assets/docs/release-notes/platform/2025-03-17.md +1 -1
  231. package/assets/docs/release-notes/platform/2025-07-07.md +1 -1
  232. package/assets/docs/release-notes/platform/2025-07-23.md +85 -0
  233. package/assets/docs/release-notes/platform/2025-08-13.md +95 -0
  234. package/assets/docs/release-notes/platform/2025-08-21.md +53 -0
  235. package/assets/docs/release-notes/platform/2025-08-28.md +53 -0
  236. package/assets/docs/release-notes/platform/2025-10-02.md +152 -0
  237. package/assets/docs/schema/browser-sdk.yml +196 -69
  238. package/assets/docs/schema/v1.openapi.json +164 -217
  239. package/assets/docs/schema/v1.openapi.yml +148 -213
  240. package/assets/docs/schema/v2.openapi.json +18056 -11790
  241. package/assets/docs/schema/v2.openapi.yml +4801 -191
  242. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +3 -3
  243. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +3 -3
  244. package/assets/docs/sdk/ko/v2-sdk/_components/sdk-installation.md +71 -0
  245. package/assets/docs/sdk/ko/v2-server-sdk/jvm.md +12 -5
  246. package/assets/docs/sdk/ko/v2-server-sdk/python.md +12 -3
  247. package/assets/docs/v1-docs-full.md +2298 -1026
  248. package/assets/docs/v2-docs-full.md +1412 -362
  249. package/assets/docs/website-links.md +23 -13
  250. package/assets/instructions.md +4 -2
  251. package/manifest.json +1 -1
  252. package/package.json +17 -20
  253. package/server/index.js +135 -97
  254. package/assets/docs/help/admin-console/platform-settlement/content33-1.md +0 -201
  255. package/assets/docs/help/core-service/payment-type/schedule-logic-guide.md +0 -49
  256. package/assets/docs/help/faq/platform-faq/taxinvoice_guide.md +0 -107
  257. package/assets/docs/help/faq/platform-faq/taxinvoice_signupemail.md +0 -67
@@ -64,8 +64,9 @@
64
64
  ### V2 통합 가이드
65
65
 
66
66
  - [스마트 라우팅](https://developers.portone.io/opi/ko/console/guide/smartrouting): 포트원 스마트 라우팅을 사용하기 위한 그룹 설정을 관리할 수 있습니다. 관리자콘솔 내 스마트 라우팅 그룹 설정 방법을 안내합니다.
67
- - [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v2): 결제승인의 주체를 고객사 서버로 가져갈수 있는 서비스 입니다.
67
+ - [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v2): 결제 승인의 주체를 고객사 서버로 가져갈 있는 서비스입니다.
68
68
  - [본인인증 연동하기](https://developers.portone.io/opi/ko/extra/identity-verification/readme-v2): 포트원을 이용하여 간편하게 본인인증을 연동하는 방법을 확인합니다.
69
+ - [수동 승인](https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2): 고객사 서버에서 API를 호출하여 결제를 승인하는 연동 방식입니다.
69
70
  - [결제취소(환불) 연동하기](https://developers.portone.io/opi/ko/integration/cancel/v2/readme): 포트원 V2 결제취소 API를 이용한 결제취소 방법을 안내합니다.
70
71
  - [다날 본인인증](https://developers.portone.io/opi/ko/integration/pg/v2/danal-identity-verification): 다날 본인인증 연동 방법을 안내합니다.
71
72
  - [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v2/eximbay-v2): 엑심베이 결제 연동 방법을 안내합니다.
@@ -79,7 +80,7 @@
79
80
  - [한국결제네트웍스(KPN)](https://developers.portone.io/opi/ko/integration/pg/v2/kpn): 한국결제네트웍스(KPN) 결제 연동 방법을 안내합니다.
80
81
  - [KSNET](https://developers.portone.io/opi/ko/integration/pg/v2/ksnet): KSNET 결제 연동 방법을 안내합니다.
81
82
  - [네이버페이 (결제형)](https://developers.portone.io/opi/ko/integration/pg/v2/naverpay): 네이버페이 간편결제 연동 방법을 안내합니다.
82
- - [나이스페이먼츠](https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2): 나이스페이먼츠 결제 연동 방법을 안내합니다.
83
+ - [나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2): 나이스정보통신 결제 연동 방법을 안내합니다.
83
84
  - [페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v2/payletter-global): 페이레터 해외결제 연동 방법을 안내합니다.
84
85
  - [페이팔](https://developers.portone.io/opi/ko/integration/pg/v2/paypal-v2): 페이팔 결제 연동 방법을 안내합니다.
85
86
  - [결제대행사 선택하여 연동하기](https://developers.portone.io/opi/ko/integration/pg/v2/readme): 각 PG사별 결제 연동 방법을 확인할 수 있습니다.
@@ -111,19 +112,20 @@
111
112
  - [프로모션 결제 연동하기](https://developers.portone.io/opi/ko/extra/promotion/integration): 프로모션 할인금액을 적용하는 방법을 안내합니다.
112
113
  - [프로모션](https://developers.portone.io/opi/ko/extra/promotion/intro): 카드 즉시 할인을 쉽게 운영 및 관리할 수 있는 서비스입니다.
113
114
  - [프로모션 결제 취소하기](https://developers.portone.io/opi/ko/extra/promotion/refund): 프로모션을 적용하여 승인된 결제건들에 대하여 취소/환불하는 방법을 안내합니다.
114
- - [스마트 라우팅 - 콘솔 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
115
- - [스마트 라우팅 - 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
116
- - [스마트 라우팅](https://developers.portone.io/opi/ko/extra/smart-routing/intro): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
115
+ - [스마트 라우팅 - 콘솔 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
116
+ - [스마트 라우팅 - 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
117
+ - [스마트 라우팅](https://developers.portone.io/opi/ko/extra/smart-routing/intro): 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
117
118
  - [결제 연동 준비하기](https://developers.portone.io/opi/ko/integration/ready/readme): 포트원을 이용한 연동 개발이 처음이시라면 아래 안내 사항에 따라 진행하세요.
118
119
  - [AI 도구 활용하기](https://developers.portone.io/opi/ko/integration/using-ai-tools): AI 도구를 활용하여 쉽고 빠르게 포트원을 연동하세요. 연동 코드 작성은 물론, 24시간 언제나 관련 질의에 대한 답변을 받을 수 있습니다.
119
120
  - [가상계좌 입금통보 설정](https://developers.portone.io/opi/ko/integration/virtual-account/readme): 결제대행사별 입금통보 URL을 안내합니다.
120
121
  - [포트원 결제 연동 Doc](https://developers.portone.io/opi/ko/readme): 포트원 결제 연동 가이드입니다. 빠른 시간 안에 결제를 연동할 수 있게 도와드립니다.
121
122
  - [직접 문의하기](https://developers.portone.io/opi/ko/support/contact): 기술지원 문의를 위한 연락처 정보입니다.
123
+ - [용어 사전](https://developers.portone.io/opi/ko/support/pg-terms): 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
122
124
  - [TLS 지원 범위](https://developers.portone.io/opi/ko/support/tls-support): 포트원 v1 API의 TLS 지원 범위 및 설정 가이드를 확인할 수 있습니다.
123
125
 
124
126
  ### 파트너정산
125
127
 
126
- - [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary)
128
+ - [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary): 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
127
129
  - [서비스 프로세스](https://developers.portone.io/platform/ko/guides/process)
128
130
  - [세금계산서 웹훅 가이드](https://developers.portone.io/platform/ko/guides/webhook): 세금계산서 상태 변화 웹훅의 사용 방법과 설정 가이드입니다.
129
131
  - [파트너 정산 자동화 서비스 가이드](https://developers.portone.io/platform/ko/readme)
@@ -183,6 +185,7 @@
183
185
  - [관리자콘솔 2023-09-12](https://developers.portone.io/release-notes/console/2023-09-12)
184
186
  - [관리자콘솔 2023-12-27](https://developers.portone.io/release-notes/console/2023-12-27)
185
187
  - [관리자콘솔 2024-09-05](https://developers.portone.io/release-notes/console/2024-09-05)
188
+ - [관리자콘솔 2025-10-17](https://developers.portone.io/release-notes/console/2025-10-17)
186
189
  - [파트너 정산 자동화 2023-08-31](https://developers.portone.io/release-notes/platform/2023-08-31)
187
190
  - [파트너 정산 자동화 2023-11-08](https://developers.portone.io/release-notes/platform/2023-11-08)
188
191
  - [파트너 정산 자동화 2023-11-14](https://developers.portone.io/release-notes/platform/2023-11-14)
@@ -209,6 +212,11 @@
209
212
  - [파트너 정산 자동화 2025-05-14](https://developers.portone.io/release-notes/platform/2025-05-14)
210
213
  - [파트너 정산 자동화 2025-07-02](https://developers.portone.io/release-notes/platform/2025-07-02)
211
214
  - [파트너 정산 자동화 2025-07-07](https://developers.portone.io/release-notes/platform/2025-07-07)
215
+ - [파트너 정산 자동화 2025-07-23](https://developers.portone.io/release-notes/platform/2025-07-23)
216
+ - [파트너 정산 자동화 2025-08-13](https://developers.portone.io/release-notes/platform/2025-08-13)
217
+ - [파트너 정산 자동화 2025-08-21](https://developers.portone.io/release-notes/platform/2025-08-21)
218
+ - [파트너 정산 자동화 2025-08-28](https://developers.portone.io/release-notes/platform/2025-08-28)
219
+ - [파트너 정산 자동화 2025-10-02](https://developers.portone.io/release-notes/platform/2025-10-02)
212
220
 
213
221
  ### 블로그
214
222
 
@@ -234,8 +242,6 @@ targetVersions:
234
242
 
235
243
  스마트 라우팅 기능이 궁금하다면 [스마트 라우팅 기능 소개](https://developers.portone.io/opi/ko/extra/smart-routing/intro)를 확인해 보세요!
236
244
 
237
- 스마트 라우팅은 **V2 결제 서비스 이용시**에만 사용이 가능합니다.
238
-
239
245
  </div>
240
246
 
241
247
  ## 스마트 라우팅 그룹 생성하기
@@ -303,7 +309,7 @@ targetVersions:
303
309
 
304
310
  ---
305
311
  title: 컨펌 프로세스
306
- description: 결제승인의 주체를 고객사 서버로 가져갈수 있는 서비스 입니다.
312
+ description: 결제 승인의 주체를 고객사 서버로 가져갈 있는 서비스입니다.
307
313
  targetVersions:
308
314
  - v2
309
315
  versionVariants:
@@ -312,11 +318,18 @@ versionVariants:
312
318
 
313
319
  **해당 서비스는 결제 승인 직전에 고객사에서 결제 의사를 최종적으로 확인하는 서비스입니다.**
314
320
 
315
- (관련 이미지 첨부)
321
+ <div class="hint" data-style="info">
322
+
323
+ **수동 승인 기능 안내**
324
+
325
+ V2 신규 연동 시에는 컨펌 프로세스와 동일한 목적으로 사용할 수 있는 [수동 승인](https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2) 기능을 이용하시기를 권장합니다.
326
+ 수동 승인은 더 간편한 연동 방식을 제공하며, 채널 설정에서 간단히 켤 수 있습니다.
327
+
328
+ </div>
316
329
 
317
330
  ## 컨펌 프로세스란?
318
331
 
319
- - 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스 입니다.
332
+ - 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스입니다.
320
333
 
321
334
  - 기본적인 결제 플로우상 고객사에서 결제 요청 후 별도의 확인 없이 결제 승인되는 구조입니다.
322
335
  하지만 해당 서비스 이용 시 고객사가 최종적으로 결제 승인 요청의 주체가 될 수 있습니다.
@@ -365,7 +378,7 @@ versionVariants:
365
378
 
366
379
  **컨펌 프로세스 신청 방법**
367
380
 
368
- 기술지원 메일(<support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
381
+ 기술지원 메일(<tech.support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
369
382
 
370
383
  포트원 콘솔 로그인 후 \[결제연동] 페이지 상단에서 상점 아이디를 확인 하실 수 있습니다.
371
384
 
@@ -469,8 +482,8 @@ versionVariants:
469
482
  **본인인증 서비스**란 인증 절차를 거쳐 본인 여부와 입력한 정보의 정확성을 확인하여 주는 서비스입니다. 현재 지원하는 본인인증 서비스는 아래와 같습니다.
470
483
 
471
484
  - 다날 휴대폰 본인인증
472
- - KG이니시스 통합인증
473
485
  - KCP 휴대폰 본인인증
486
+ - KG이니시스 통합인증
474
487
 
475
488
  ## 휴대폰 본인인증
476
489
 
@@ -499,7 +512,7 @@ versionVariants:
499
512
  이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
500
513
  하는 방식으로 이루어집니다.
501
514
 
502
- > **이용가능 수단 : 네이버 / PASS / 페이코 / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
515
+ > **이용가능 수단 : 네이버 / PASS / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
503
516
 
504
517
  (이미지 첨부: 휴대폰 본인인증 화면 예시)
505
518
 
@@ -720,6 +733,84 @@ app.post("/identity-verifications", async (req, res) => {
720
733
  ```
721
734
 
722
735
 
736
+ # https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2
737
+
738
+ ---
739
+ title: 수동 승인
740
+ description: 고객사 서버에서 API를 호출하여 결제를 승인하는 연동 방식입니다.
741
+ targetVersions:
742
+ - v2
743
+ ---
744
+
745
+ 포트원을 통해 PG의 결제 UI를 표시하면, 구매자는 UI에서 정보 입력 및 인증을 진행합니다. 이 과정이 끝나고 UI가 닫히면 자동으로 결제 승인(또는 가상계좌 발급, 빌링키 발급)이 일어납니다.
746
+
747
+ 그러나 채널 설정에서 **수동 승인**을 켜면, 결제 UI가 완료되더라도 고객사 서버에서 포트원의 **수동 승인** API를 호출하지 않으면 결제 승인 등이 일어나지 않습니다.
748
+
749
+ <div class="hint" data-style="warning">
750
+
751
+ **수동 승인을 사용할 수 없는 PG**
752
+
753
+ 엑심베이, 페이레터 해외결제의 경우 수동 승인을 지원하지 않고, 채널 설정에서도 해당 항목이 보이지 않습니다.
754
+
755
+ 이는 근본적으로 위챗 결제와 같이 일부 해외 결제수단이 수동 승인을 지원하지 않기 때문입니다. 따라서 추후 포트원에 추가되는 PG가 이러한 결제수단을 지원한다면, 해당 PG에서는 수동 승인을 이용할 수 없을 가능성이 높습니다.
756
+
757
+ </div>
758
+
759
+ <div class="hint" data-style="info">
760
+
761
+ **컨펌 프로세스와의 비교**
762
+
763
+ 수동 승인은 컨펌 프로세스와 동일한 목적의 기능이며, V2 신규 연동에서는 더 간편한 수동 승인 이용을 권장합니다.
764
+
765
+ 컨펌 프로세스를 이용할 수 있는 PG의 목록도 수동 승인과 동일합니다.
766
+
767
+ </div>
768
+
769
+ ## 수동 승인이 유용한 경우
770
+
771
+ - 결제 승인 전 마지막으로 재고 확인이 필요할 때
772
+ - 수량이 한정된 선착순 판매일 때
773
+ - 결제 완료 상태를 웹훅으로 수신하기보다, 직접 API를 호출해서 결제를 완료시키는 것을 선호할 때
774
+ - 수동 승인 방식으로 타 결제사를 연동한 상태에서 포트원도 같은 구조로 연동하고 싶을 때
775
+
776
+ ## 자동 승인이 유용한 경우
777
+
778
+ - 수동 승인을 지원하지 않는 PG를 이용할 때
779
+ - 수동 승인을 지원하지 않는 PG를 추후 연동할 가능성이 높을 때 (특히, 위챗 등 다양한 해외 결제수단 연동을 고려하고 있을 때)
780
+ - 결제 완료 등 결제 상태를 웹훅으로 수신하는 데 불편함이 없을 때
781
+
782
+ ## 인증 결제 수동 승인 이용 방법
783
+
784
+ 채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
785
+
786
+ 수동 승인이 켜진 채널로 `PortOne.requestPayment`를 호출하면 응답에 `paymentToken` 필드가 포함됩니다.
787
+ (수동 승인을 켜지 않은 채널이면 `paymentToken` 필드는 포함되지 않습니다.)
788
+
789
+ 이렇게 UI 호출 응답으로 받은 `paymentToken`을 이용해 서버에서 [인증 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment?v=v2#post%20%2Fpayments%2F%7BpaymentId%7D%2Fconfirm) API를 호출하면 결제가 승인됩니다. (가상계좌 발급 건의 경우 수동 승인 API 호출 시에 가상계좌가 발급됩니다.)
790
+
791
+ ## 빌링키 발급 수동 승인 이용 방법
792
+
793
+ 채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
794
+
795
+ 수동 승인이 켜진 채널로 `PortOne.requestIssueBillingKey`나 `PortOne.requestIssueBillingKeyAndPay`를 호출하면 응답에 `billingIssueToken` 필드가 포함됩니다.
796
+ (수동 승인을 켜지 않은 채널이면 `billingIssueToken` 필드는 포함되지 않습니다.)
797
+
798
+ 이때 빌링키는 아직 발급된 상태가 아닙니다. 따라서 응답으로 전달되는 `billingKey` 값은 `NEEDS_CONFIRMATION`입니다. `requestIssueBillingKeyAndPay`를 사용한 경우에는 `txId` 값 또한 `NEEDS_CONFIRMATION`으로 전달됩니다.
799
+
800
+ 이렇게 UI 호출 응답으로 받은 `billingIssueToken`을 이용해 서버에서 포트원 API를 호출하면 빌링키가 발급됩니다. `requestIssueBillingKeyAndPay`의 경우 빌링키 발급과 함께 초회 결제도 일어납니다.
801
+
802
+ - `requestIssueBillingKey`의 경우 [빌링키 발급 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm) API를 호출합니다.
803
+ - `requestIssueBillingKeyAndPay`의 경우 [빌링키 발급 및 초회 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm-issue-and-pay) API를 호출합니다.
804
+
805
+ <div class="hint" data-style="info">
806
+
807
+ **수동 승인 API 호출 시점**
808
+
809
+ 수동 승인 API는 가능한 한 즉시 호출하는 것을 권장합니다. 타임아웃 시간은 PG별로 상이하지만, 오래 대기하면 승인이 실패할 수 있습니다.
810
+
811
+ </div>
812
+
813
+
723
814
  # https://developers.portone.io/opi/ko/integration/cancel/v2/readme
724
815
 
725
816
  ---
@@ -1248,19 +1339,13 @@ targetVersions:
1248
1339
 
1249
1340
  ## 가능한 결제수단
1250
1341
 
1251
- - **결제창 일반결제**
1252
-
1253
- 엑심베이의 경우 포트원의 결제수단 구분과 상관없이 여러 결제수단을 표시할 수 있습니다.
1254
- `payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
1255
-
1256
- - MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
1257
- - 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
1258
- - 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
1259
- - 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
1260
-
1261
- - **결제창 빌링키 발급 및 결제**
1342
+ 엑심베이의 경우 포트원의 결제수단 구분과 상관없이 MID에 설정된 여러 결제수단을 표시할 수 있습니다.
1343
+ `payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
1262
1344
 
1263
- 현재 신용카드 결제만 지원하며, `billingKeyAndPayMethod` 파라미터를 `CARD`로 설정해야 합니다.
1345
+ - MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
1346
+ - 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
1347
+ - 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
1348
+ - 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
1264
1349
 
1265
1350
  ## SDK 결제 요청하기
1266
1351
 
@@ -1385,6 +1470,35 @@ function requestPayment() {
1385
1470
 
1386
1471
  결제 완료 메일이 발송됩니다.
1387
1472
 
1473
+ - products?: object\[]
1474
+
1475
+ **구매 상품 정보**
1476
+
1477
+ - 해외카드 결제를 제외하고 필수 입력입니다.
1478
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
1479
+
1480
+ * id: string
1481
+
1482
+ **상품 ID**
1483
+
1484
+ * name: string
1485
+
1486
+ **상품명**
1487
+
1488
+ * amount: number
1489
+
1490
+ **상품 단위 가격**
1491
+
1492
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
1493
+
1494
+ * quantity: number
1495
+
1496
+ **상품 수량**
1497
+
1498
+ * link: string
1499
+
1500
+ **상품 판매 URL**
1501
+
1388
1502
  - bypass?: oneof object
1389
1503
 
1390
1504
  - eximbay\_v2?: object
@@ -1548,7 +1662,6 @@ function issueBillingKeyAndPay() {
1548
1662
  orderName: "PortOne Recurring Payment",
1549
1663
  totalAmount: 100, // 1 USD
1550
1664
  currency: "USD",
1551
- billingKeyAndPayMethod: "CARD",
1552
1665
  customer: {
1553
1666
  fullName: "PortOne",
1554
1667
  email: "test@example.com",
@@ -1601,12 +1714,6 @@ function issueBillingKeyAndPay() {
1601
1714
  - ISO 4217 통화 코드
1602
1715
  - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
1603
1716
 
1604
- - billingKeyAndPayMethod: string
1605
-
1606
- **빌링키 발급 및 결제 방법**
1607
-
1608
- - `CARD`: 신용카드 결제
1609
-
1610
1717
  - locale?: Locale
1611
1718
 
1612
1719
  **결제창 언어**
@@ -1658,12 +1765,55 @@ function issueBillingKeyAndPay() {
1658
1765
 
1659
1766
  결제 완료 메일이 발송됩니다.
1660
1767
 
1768
+ - products?: object\[]
1769
+
1770
+ **구매 상품 정보**
1771
+
1772
+ - 해외카드 결제를 제외하고 필수 입력입니다.
1773
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
1774
+
1775
+ * id: string
1776
+
1777
+ **상품 ID**
1778
+
1779
+ * name: string
1780
+
1781
+ **상품명**
1782
+
1783
+ * amount: number
1784
+
1785
+ **상품 단위 가격**
1786
+
1787
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
1788
+
1789
+ * quantity: number
1790
+
1791
+ **상품 수량**
1792
+
1793
+ * link: string
1794
+
1795
+ **상품 판매 URL**
1796
+
1661
1797
  - bypass?: oneof object
1662
1798
 
1663
1799
  - eximbay\_v2?: object
1664
1800
 
1665
1801
  **엑심베이 특수 파라미터**
1666
1802
 
1803
+ - payment?: object
1804
+
1805
+ - payment\_method?: string
1806
+
1807
+ **결제수단 단독 노출**
1808
+
1809
+ 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
1810
+
1811
+ - multi\_payment\_method?: string\[]
1812
+
1813
+ **결제수단 노출 목록**
1814
+
1815
+ 여러 결제수단을 노출합니다.
1816
+
1667
1817
  - merchant?: object
1668
1818
 
1669
1819
  - shop?: string
@@ -1861,6 +2011,35 @@ const response = await axios({
1861
2011
 
1862
2012
  **구매자 이메일**
1863
2013
 
2014
+ - products?: object\[]
2015
+
2016
+ **구매 상품 정보**
2017
+
2018
+ - 해외카드 결제를 제외하고 필수 입력입니다.
2019
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
2020
+
2021
+ * id: string
2022
+
2023
+ **상품 ID**
2024
+
2025
+ * name: string
2026
+
2027
+ **상품명**
2028
+
2029
+ * amount: number
2030
+
2031
+ **상품 단위 가격**
2032
+
2033
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
2034
+
2035
+ * quantity: number
2036
+
2037
+ **상품 수량**
2038
+
2039
+ * link: string
2040
+
2041
+ **상품 판매 URL**
2042
+
1864
2043
  - bypass?: oneof object
1865
2044
 
1866
2045
  - eximbayV2?: object
@@ -2071,6 +2250,35 @@ const response = await axios({
2071
2250
 
2072
2251
  **구매자 이메일**
2073
2252
 
2253
+ - products?: object\[]
2254
+
2255
+ **구매 상품 정보**
2256
+
2257
+ - 해외카드 결제를 제외하고 필수 입력입니다.
2258
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
2259
+
2260
+ * id: string
2261
+
2262
+ **상품 ID**
2263
+
2264
+ * name: string
2265
+
2266
+ **상품명**
2267
+
2268
+ * amount: number
2269
+
2270
+ **상품 단위 가격**
2271
+
2272
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
2273
+
2274
+ * quantity: number
2275
+
2276
+ **상품 수량**
2277
+
2278
+ * link: string
2279
+
2280
+ **상품 판매 URL**
2281
+
2074
2282
  - bypass?: oneof object
2075
2283
 
2076
2284
  - eximbayV2?: object
@@ -2176,9 +2384,10 @@ const response = await axios({
2176
2384
  ### 공통
2177
2385
 
2178
2386
  - `customer.name` 및 `customer.email`은 필수 입력 항목입니다.
2387
+ - 해외카드 결제를 제외하고 `products`를 필수로 입력해야 합니다. 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
2179
2388
  - `products` 입력 시 `link`를 필수로 입력해야 합니다.
2180
2389
 
2181
- ### SDK 결제 요청
2390
+ ### SDK 결제 / 빌링키 발급 및 결제 요청
2182
2391
 
2183
2392
  - 네이버페이 포인트로 결제할 경우에는 `bypass.eximbay_v2.tax` 내용을 모두 입력해야 합니다.
2184
2393
 
@@ -2186,8 +2395,6 @@ const response = await axios({
2186
2395
 
2187
2396
  - `bypass.eximbay_v2.payment_method`에 일본 편의점 결제를 지정할 경우 `customer.phoneNumber`을 필수로 입력해야 합니다.
2188
2397
 
2189
- - 간편결제 사용 시 `products`를 필수로 입력해야 합니다.
2190
-
2191
2398
  - 아래 결제수단의 경우 사용이 제한되므로 결제 연동 시 유의해 주시기 바랍니다.
2192
2399
  - 가상계좌(`P305`) : 호환성 이슈로 추후 지원 예정
2193
2400
  - Klarna(`P197`) : 엑심베이 정책에 따라 신규 결제 사용 불가
@@ -2880,7 +3087,6 @@ PortOne.requestIdentityVerification({
2880
3087
 
2881
3088
  <summary>인증 업체 코드 확인하기</summary>
2882
3089
 
2883
- - PAYCO(페이코)
2884
3090
  - PASS(패스 (통신사))
2885
3091
  - TOSS(토스)
2886
3092
  - KFTC(금융결제원)
@@ -3117,7 +3323,7 @@ function requestPayment() {
3117
3323
  "Ini_SSGPAY_MDN": "01012341234",
3118
3324
  "acceptmethod": ["SKIN(#C1272C)", "below1000", "ocb"],
3119
3325
  "P_CARD_OPTION": "selcode=14",
3120
- "P_NMANE": "포트원",
3326
+ "P_MNAME": "포트원",
3121
3327
  "P_RESERVED": ["below1000=Y", "noeasypay=Y"]
3122
3328
  }
3123
3329
  }
@@ -3246,6 +3452,18 @@ function requestPayment() {
3246
3452
 
3247
3453
  <details>
3248
3454
 
3455
+ <summary>계약 사항에 따라 결제 정보에서 카드 정보가 누락될 수 있습니다.</summary>
3456
+
3457
+ KG이니시스와의 계약에서 결제 결과에 카드번호를 전송하지 않도록 설정된 경우, 결제 조회 시 다음 카드 관련 필드들이 누락될 수 있습니다.
3458
+
3459
+ - `card.issuer`: 카드 발급사
3460
+ - `card.publisher`: 카드 발행사
3461
+ - `card.name`: 카드명
3462
+
3463
+ </details>
3464
+
3465
+ <details>
3466
+
3249
3467
  <summary>PC와 모바일에서 파라미터 필수 여부가 상이합니다.</summary>
3250
3468
 
3251
3469
  위의 주요 파라미터 설명에도 안내되어 있듯이, PC 결제와 모바일 결제에서 필수 여부가 상이한 파라미터가 존재합니다. 아래 필드들은 PC 결제에서는 필수이지만, 모바일 결제에서는 선택입니다.
@@ -4921,7 +5139,7 @@ description: NHN KCP 연동 방법을 안내합니다.
4921
5139
  targetVersions:
4922
5140
  - v2
4923
5141
  versionVariants:
4924
- v1: /opi/ko/integration/pg/v1/nhn-kcp
5142
+ v1: /opi/ko/integration/pg/v1/nhn-kcp/readme
4925
5143
  ---
4926
5144
 
4927
5145
  ## 채널 설정하기
@@ -5120,8 +5338,10 @@ function requestPayment() {
5120
5338
 
5121
5339
  - shop\_user\_id?: string
5122
5340
 
5123
- **기관에 따라 리스크 관리 조치를 위한 쇼핑몰 관리 ID**
5341
+ **리스크 관리 조치를 위한 고객사 회원 ID**
5124
5342
 
5343
+ - KCP에서 부정거래를 신속하게 탐지하기 위한 파라미터입니다.
5344
+ - 고객사에서 관리하는 구매자의 회원 ID를 입력합니다.
5125
5345
  - 상품권, 휴대폰 결제 시 필수로 입력해야 합니다.
5126
5346
 
5127
5347
  - site\_name?: string
@@ -8000,7 +8220,7 @@ versionVariants:
8000
8220
  - `easyPay.availableCards`
8001
8221
  - 네이버페이는 지원하지 않습니다.
8002
8222
 
8003
- ### 빌링키 발급 (`requestBillingKeyIssue`)
8223
+ ### 빌링키 발급 (`requestIssueBillingKey`)
8004
8224
 
8005
8225
  - `billingKeyMethod`
8006
8226
  - `EASY_PAY` 로 설정해야 합니다
@@ -8050,8 +8270,8 @@ versionVariants:
8050
8270
  # https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2
8051
8271
 
8052
8272
  ---
8053
- title: 나이스페이먼츠
8054
- description: 나이스페이먼츠 결제 연동 방법을 안내합니다.
8273
+ title: 나이스정보통신
8274
+ description: 나이스정보통신 결제 연동 방법을 안내합니다.
8055
8275
  targetVersions:
8056
8276
  - v2
8057
8277
  versionVariants:
@@ -8061,7 +8281,7 @@ versionVariants:
8061
8281
  ## 채널 설정하기
8062
8282
 
8063
8283
  - [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
8064
- V2 결제 모듈을 사용하시려면 나이스페이먼츠(신모듈)로 연동하셔야 합니다.
8284
+ V2 결제 모듈을 사용하시려면 나이스정보통신(신모듈)로 연동하셔야 합니다.
8065
8285
 
8066
8286
  ## 가능한 결제수단
8067
8287
 
@@ -8075,7 +8295,7 @@ versionVariants:
8075
8295
  - 간편 결제 : `EASY_PAY`
8076
8296
 
8077
8297
  - **결제창 빌링키 발급**
8078
- - `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
8298
+ - 결제창 빌링키 발급은 간편결제(네이버페이 / 카카오페이)만 지원하므로 `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
8079
8299
 
8080
8300
  - **API 수기(키인) 결제**
8081
8301
  - `method`파라미터를 `card`로 설정해야 합니다.
@@ -8086,9 +8306,9 @@ versionVariants:
8086
8306
  ## SDK 결제 요청하기
8087
8307
 
8088
8308
  결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다.
8089
- `channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여 나이스페이먼츠 채널 사용을 명시해주세요.
8309
+ `channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
8090
8310
 
8091
- 나이스페이먼츠 기준으로 작성한 예시 코드는 아래와 같습니다.
8311
+ 나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
8092
8312
 
8093
8313
  <div class="tabs-container">
8094
8314
 
@@ -8143,7 +8363,7 @@ function requestPayment() {
8143
8363
 
8144
8364
  - currency: string
8145
8365
 
8146
- 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 나이스페이먼츠의 경우 `KRW`와 `USD`를 지원합니다.
8366
+ 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 나이스정보통신의 경우 `KRW`와 `USD`를 지원합니다.
8147
8367
 
8148
8368
  - payMethod: string
8149
8369
 
@@ -8151,7 +8371,7 @@ function requestPayment() {
8151
8371
 
8152
8372
  - taxFreeAmount?: number
8153
8373
 
8154
- 면세금액으로 나이스페이먼츠와 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8374
+ 면세금액으로 나이스정보통신와 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8155
8375
 
8156
8376
  면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
8157
8377
 
@@ -8163,7 +8383,7 @@ function requestPayment() {
8163
8383
 
8164
8384
  - `card.installment.monthOption.fixedMonth`
8165
8385
 
8166
- 나이스페이먼츠는 **카드사 다이렉트 호출시 고정 할부 개월수를 필수로 입력**해야 합니다. 결제
8386
+ 나이스정보통신은 **카드사 다이렉트 호출시 고정 할부 개월수를 필수로 입력**해야 합니다. 결제
8167
8387
  금액이 할부 지원 금액 미만(대부분 50,000원이상 할부지원이나 카드사에 따라 상이함)인 경우 **할부
8168
8388
  개월수를 0(일시불)으로 전달**해야 합니다.
8169
8389
 
@@ -8177,15 +8397,15 @@ function requestPayment() {
8177
8397
 
8178
8398
  - `giftCertificate.certificateType`
8179
8399
 
8180
- 나이스페이먼츠는 컬쳐랜드만 지원하므로 상품권 결제시 항상 `CULTURELAND`로 지정해주어야 합니다.
8400
+ 나이스정보통신은 컬쳐랜드만 지원하므로 상품권 결제시 항상 `CULTURELAND`로 지정해주어야 합니다.
8181
8401
 
8182
8402
  - `bypass.nice_v2.MallUserID`
8183
8403
 
8184
- 나이스페이먼츠 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수로 입력해주어야 합니다.
8404
+ 나이스정보통신 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수로 입력해주어야 합니다.
8185
8405
 
8186
8406
  - `easyPay.availablePayMethods`
8187
8407
 
8188
- 나이스페이먼츠를 통한 간편결제 결제 요청 시 다른 간편결제 수단과 다르게 네이버페이, SSG페이, 토스페이의
8408
+ 나이스정보통신를 통한 간편결제 결제 요청 시 다른 간편결제 수단과 다르게 네이버페이, SSG페이, 토스페이의
8189
8409
  경우 어떤 방식으로 결제하느냐에 따라 availablePayMethods을 입력해야 합니다.
8190
8410
 
8191
8411
  - 네이버페이의 경우 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE` 로 입력해야
@@ -8200,9 +8420,9 @@ function requestPayment() {
8200
8420
  ## 결제창 빌링키 발급
8201
8421
 
8202
8422
  빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
8203
- `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 나이스페이먼츠 채널 사용을 명시해주세요.
8423
+ `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
8204
8424
 
8205
- 나이스페이먼츠 기준으로 작성한 예시 코드는 아래와 같습니다.
8425
+ 나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
8206
8426
 
8207
8427
  <div class="tabs-container">
8208
8428
 
@@ -8214,7 +8434,7 @@ function requestIssueBillingKey() {
8214
8434
  PortOne.requestIssueBillingKey({
8215
8435
  storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
8216
8436
  channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
8217
- billingKeyMethod: "EASY_PAY",
8437
+ billingKeyMethod: "EASY_PAY", // 간편결제만 지원합니다.
8218
8438
  issueId: "testIssueId",
8219
8439
  issueName: "testIssueName",
8220
8440
  customer: {
@@ -8251,21 +8471,21 @@ function requestIssueBillingKey() {
8251
8471
 
8252
8472
  **빌링키 발급수단**
8253
8473
 
8254
- 나이스페이먼츠는 결제창 방식으로 빌링키 발급 시 간편결제만을 지원하므로 `EASY_PAY`로 설정해야 합니다.
8474
+ 나이스정보통신은 결제창 방식으로 빌링키 발급 시 간편결제(네이버페이 / 카카오페이)만을 지원하므로 `EASY_PAY`로 설정해야 합니다.
8255
8475
 
8256
8476
  - issueId: string
8257
8477
 
8258
8478
  **빌링키 발급 건 고유 ID**
8259
8479
 
8260
8480
  - 고객사에서 채번하여 사용해야 합니다.
8261
- - 나이스페이먼츠의 경우 필수 입력해야 합니다.
8481
+ - 나이스정보통신의 경우 필수 입력해야 합니다.
8262
8482
  - 영문 대소문자와 숫자만 사용하여 40자 이내로 입력합니다.
8263
8483
 
8264
8484
  - issueName: string
8265
8485
 
8266
8486
  **빌링키 발급 시 결제창에 표시되는 제목**
8267
8487
 
8268
- - 나이스페이먼츠의 경우 필수 입력해야 합니다.
8488
+ - 나이스정보통신의 경우 필수 입력해야 합니다.
8269
8489
 
8270
8490
  - customer?: object
8271
8491
 
@@ -8384,7 +8604,7 @@ const issueResponse = await axios({
8384
8604
 
8385
8605
  - taxFree?: number
8386
8606
 
8387
- 면세 금액으로 나이스페이먼츠과 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8607
+ 면세 금액으로 나이스정보통신과 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8388
8608
  면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
8389
8609
 
8390
8610
  - currency: string
@@ -8582,7 +8802,7 @@ const response = await axios({
8582
8802
 
8583
8803
  결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
8584
8804
 
8585
- 나이스페이먼츠와 지정금액 혹은 복합과세 방식으로 계약한 경우 면세금액을 반드시 입력해야 합니다.
8805
+ 나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 면세금액을 반드시 입력해야 합니다.
8586
8806
  카드 빌링키의 경우 면세금액 미입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
8587
8807
  간편결제 빌링키의 경우 면세금액 미입력 시 오류가 발생합니다.
8588
8808
 
@@ -8592,13 +8812,13 @@ const response = await axios({
8592
8812
 
8593
8813
  결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
8594
8814
 
8595
- 나이스페이먼츠와 지정금액 혹은 복합과세 방식으로 계약한 경우 간편결제 빌링키 이용 시 부가세를 반드시 입력해야 합니다.
8815
+ 나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 간편결제 빌링키 이용 시 부가세를 반드시 입력해야 합니다.
8596
8816
 
8597
8817
  - currency: string
8598
8818
 
8599
8819
  **결제 통화**
8600
8820
 
8601
- 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)나이스페이먼츠의 경우 빌링키로 결제시 `KRW`만 지원합니다.
8821
+ 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)나이스정보통신의 경우 빌링키로 결제시 `KRW`만 지원합니다.
8602
8822
 
8603
8823
  - customer: object
8604
8824
 
@@ -8671,9 +8891,9 @@ const response = await axios({
8671
8891
 
8672
8892
  ## 연동 유의사항
8673
8893
 
8674
- ### 나이스페이먼츠와 사전 계약이 필요한 경우
8894
+ ### 나이스정보통신와 사전 계약이 필요한 경우
8675
8895
 
8676
- 아래 기능을 사용하시려면 나이스페이먼츠에 사전 신청 후 계약이 완료되어야 합니다.
8896
+ 아래 기능을 사용하시려면 나이스정보통신에 사전 신청 후 계약이 완료되어야 합니다.
8677
8897
  그렇지 않은 상태에서 해당 기능 이용시 PG창 호출에 실패하거나, 승인에 실패하거나,
8678
8898
  승인에 성공하더라도 의도한 바와는 다른 응답을 얻게 될 수 있으니 이 점 유의하시길 바랍니다.
8679
8899
 
@@ -8722,9 +8942,9 @@ const response = await axios({
8722
8942
  |비 다이렉트 호출 + 리스트 할부 개월수|`PC만 가능` |
8723
8943
 
8724
8944
  - 토스뱅크 카드의 경우 카드사 다이렉트 호출 불가능합니다.
8725
- - 나이스페이먼츠의 경우 토스뱅크 카드 다이렉트 호출이 지원되지 않습니다.
8945
+ - 나이스정보통신의 경우 토스뱅크 카드 다이렉트 호출이 지원되지 않습니다.
8726
8946
 
8727
- - 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다. -나이스페이먼츠의 경우 일반
8947
+ - 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다. -나이스정보통신의 경우 일반
8728
8948
  카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나 **모바일 환경**에서는
8729
8949
  **카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출
8730
8950
  코드 없이 할부 옵션을 전달하는 경우 무시됩니다.
@@ -8732,18 +8952,18 @@ const response = await axios({
8732
8952
  ### 계좌이체 일반결제 유의사항
8733
8953
 
8734
8954
  - 계좌이체 다이렉트 호출 시 은행 코드 지정이 불가능합니다.
8735
- - 나이스페이먼츠의 경우 계좌이체 다이렉트 호출을 하더라도 뱅크페이가 호출되오니 이 점 유의하시기 바랍니다.
8955
+ - 나이스정보통신의 경우 계좌이체 다이렉트 호출을 하더라도 뱅크페이가 호출되오니 이 점 유의하시기 바랍니다.
8736
8956
  - 다이렉트 호출을 원하시는 경우 은행코드 대신 bypass 파라미터인 `DirectShowOpt`를 설정하여 사용하시길 바랍니다.
8737
8957
 
8738
8958
  - 계좌이체 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
8739
- - 나이스페이먼츠 정책상 에스크로를 사용한 계좌이체 결제시에는 다이렉트 호출이 불가능합니다. 아래와
8959
+ - 나이스정보통신 정책상 에스크로를 사용한 계좌이체 결제시에는 다이렉트 호출이 불가능합니다. 아래와
8740
8960
  같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우 "나이스페이 V2 계좌이체
8741
8961
  에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 리턴되며, 결제창이 호출되지
8742
8962
  않으니 유의하시기 바랍니다.
8743
8963
 
8744
8964
  - 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 합니다.
8745
8965
  - 존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인 실패됩니다.
8746
- 또한 실제로 존재하는 이메일 도메인이더라도 나이스페이먼츠 정책상 유효하지 않다고 취급하는 이메일
8966
+ 또한 실제로 존재하는 이메일 도메인이더라도 나이스정보통신 정책상 유효하지 않다고 취급하는 이메일
8747
8967
  주소((예) <ex@portone.finance>)를 입력한 경우 정상 승인되지만 **이후 에스크로 API를 이용하여 배송
8748
8968
  정보 등록 시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
8749
8969
 
@@ -8751,8 +8971,8 @@ const response = await axios({
8751
8971
 
8752
8972
  ### 상품권 일반결제 유의사항
8753
8973
 
8754
- - 승인 완료시 나이스페이먼츠로부터 승인번호(`approvalNumber`)가 전달되지 않으니 이 점 유의하시기 바랍니다.
8755
- - 나이스페이먼츠는 상품권 결제시 별도의 승인 번호를 전달하지 않습니다. 따라서 결제 내역 조회시 승인 번호가 null로 리턴됩니다.
8974
+ - 승인 완료시 나이스정보통신로부터 승인번호(`approvalNumber`)가 전달되지 않으니 이 점 유의하시기 바랍니다.
8975
+ - 나이스정보통신은 상품권 결제시 별도의 승인 번호를 전달하지 않습니다. 따라서 결제 내역 조회시 승인 번호가 null로 리턴됩니다.
8756
8976
 
8757
8977
  ### 카카오페이 일반결제 유의사항
8758
8978
 
@@ -8832,9 +9052,9 @@ const response = await axios({
8832
9052
 
8833
9053
  - SSGPAY 계좌 결제 시 현금영수증 발급 정보를 확인할 수 없습니다.
8834
9054
  - SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도 승인
8835
- 완료(status: paid)시 나이스페이먼츠에서 현금영수증 발급 정보를 전달하지 않아 포트원 API로
9055
+ 완료(status: paid)시 나이스정보통신에서 현금영수증 발급 정보를 전달하지 않아 포트원 API로
8836
9056
  결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다. 단,
8837
- 나이스페이먼츠 어드민에서는 확인이 가능하오니 확인이 필요한 경우 나이스페이먼츠 어드민에서
9057
+ 나이스정보통신 어드민에서는 확인이 가능하오니 확인이 필요한 경우 나이스정보통신 어드민에서
8838
9058
  확인하시길 바랍니다.
8839
9059
 
8840
9060
  <details>
@@ -8873,7 +9093,7 @@ PortOne.requestPayment({
8873
9093
 
8874
9094
  ### API 지원 기능
8875
9095
 
8876
- 나이스페이먼츠는 API를 통해 아래 기능들을 지원합니다.
9096
+ 나이스정보통신은 API를 통해 아래 기능들을 지원합니다.
8877
9097
 
8878
9098
  - 카드 빌링키 발급
8879
9099
  - 카드 및 간편결제 빌링키 결제
@@ -8887,9 +9107,9 @@ PortOne.requestPayment({
8887
9107
  ### 가상계좌 발급 API 유의사항
8888
9108
 
8889
9109
  - 고정식 가상계좌 지원합니다.
8890
- - 나이스페이먼츠의 경우 API를 통한 고정식 가상계좌 사용을 지원합니다. 고정식 가상계좌를 사용하기
9110
+ - 나이스정보통신의 경우 API를 통한 고정식 가상계좌 사용을 지원합니다. 고정식 가상계좌를 사용하기
8891
9111
  위해서는 `virtualAccount.option.type`를 `FIXED`로 전달해야 합니다. 단, 고정식 가상계좌 및
8892
- 과오납체크를 사용하도록 나이스페이먼츠와 사전 협의가 필요합니다.
9112
+ 과오납체크를 사용하도록 나이스정보통신와 사전 협의가 필요합니다.
8893
9113
 
8894
9114
  ### 에스크로 API 유의사항
8895
9115
 
@@ -8899,23 +9119,23 @@ PortOne.requestPayment({
8899
9119
  - 배송지 주소인 `receiver.address` 파라미터가 필수입니다.
8900
9120
 
8901
9121
  - 이메일 전송 여부인 `sendEmail` 파라미터가 필수입니다.
8902
- - 나이스페이먼츠의 경우 다른 PG에서는 지원하지 않는 `sendEmail` 파라미터를 지원합니다.
9122
+ - 나이스정보통신의 경우 다른 PG에서는 지원하지 않는 `sendEmail` 파라미터를 지원합니다.
8903
9123
  - 에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부. (기본값: true | boolean type)
8904
9124
 
8905
9125
  - 배송 정보 수정 불가합니다.
8906
- - 나이스페이먼츠는 API로 에스크로 배송 정보 등록은 가능하지만 **수정은 불가능**합니다.
9126
+ - 나이스정보통신은 API로 에스크로 배송 정보 등록은 가능하지만 **수정은 불가능**합니다.
8907
9127
 
8908
9128
  ### 현금영수증 API 유의사항
8909
9129
 
8910
9130
  - 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능합니다.
8911
- - 나이스페이먼츠의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
9131
+ - 나이스정보통신의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
8912
9132
  현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한
8913
9133
  경우, 현금영수증 발급 API(`POST /cash-receipts`)를 사용한다고 하더라도 발급이 되지 않으니 참고
8914
9134
  부탁드립니다.
8915
9135
 
8916
9136
  - API로 현금영수증 발급 시, 현금영수증 카드 사용이 불가능합니다.
8917
9137
  - API로 현금영수증 발급(`POST /cash-receipts`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
8918
- 현금영수증 발행 식별 정보)를 전달해야 합니다. 단, 나이스페이먼츠의 경우 **발행 식별 정보 중
9138
+ 현금영수증 발행 식별 정보)를 전달해야 합니다. 단, 나이스정보통신의 경우 **발행 식별 정보 중
8919
9139
  현금영수증 카드 번호는 사용이 불가능**하오니 참고 부탁드립니다.
8920
9140
 
8921
9141
 
@@ -8946,9 +9166,16 @@ targetVersions:
8946
9166
  - 해외카드 비인증 : `PLCreditCard`
8947
9167
  - 해외카드 인증(3DS) : `PLCreditCardMpi`
8948
9168
  - 유니온페이 : `PLUnionPay_HC`
8949
- - 위챗페이 PC결제: `WeChatPayQRCodePayment`
9169
+ - 위챗페이 PC결제 : `WeChatPayQRCodePayment`
8950
9170
  - 위챗페이 모바일결제 : `WeChatPayH5Payment`
8951
9171
  - 알리페이 : `ICBAlipay`
9172
+ - 알리페이 HK (알리페이+) : `AlipayPlusAlipayHK`
9173
+ - BPI (알리페이+) : `AlipayPlusBPI`
9174
+ - Dana (알리페이+) : `AlipayPlusDana`
9175
+ - GCash (알리페이+) : `AlipayPlusGcash`
9176
+ - Rabbit LINE Pay (알리페이+) : `AlipayPlusRabbitLinePay`
9177
+ - Touch 'n Go (알리페이+) : `AlipayPlusTNG`
9178
+ - TrueMoney (알리페이+) : `AlipayPlusTrueMoney`
8952
9179
 
8953
9180
  ## SDK 결제 요청하기
8954
9181
 
@@ -8982,7 +9209,7 @@ targetVersions:
8982
9209
  - `paymentId` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
8983
9210
  - 페이레터의 경우 구매자 이메일을 필수로 받고있어,`customer.email`을 필수로 입력하셔야 합니다.
8984
9211
  - 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
8985
- - WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
9212
+ - WeChatPay, Alipay, Alipay+ 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
8986
9213
 
8987
9214
 
8988
9215
  # https://developers.portone.io/opi/ko/integration/pg/v2/paypal-v2
@@ -9278,33 +9505,34 @@ STC 기능을 사용하기 위해 다음 정보를 확인해 주세요.
9278
9505
  // 해당 파라미터들은 예시로 산업군에 따라 추가 또는 제외 가능한 파라미터들이 있습니다.
9279
9506
  _({
9280
9507
  additional_data: [
9508
+ // 상점의 구매자 계정 기준으로 정보 입력
9281
9509
  {
9282
- key: "sender_account_id", // 고객사 account ID(merchant-id)
9510
+ key: "sender_account_id", // 구매자 계정 ID
9283
9511
  value: "A12345N343",
9284
9512
  },
9285
9513
  {
9286
- key: "sender_first_name", // 고객사의 account에 등록된 구매자의 이름
9514
+ key: "sender_first_name", // 구매자 이름
9287
9515
  value: "John",
9288
9516
  },
9289
9517
  {
9290
- key: "sender_last_name", // 고객사의 account에 등록된 구매자의 이름
9518
+ key: "sender_last_name", // 구매자
9291
9519
  value: "Doe",
9292
9520
  },
9293
9521
  {
9294
- key: "sender_email", // 고객사의 account에 등록된 구매자의 이메일 주소
9522
+ key: "sender_email", // 구매자 이메일 주소
9295
9523
  value: "example@example.com",
9296
9524
  },
9297
9525
  {
9298
- key: "sender_phone", // 고객사의 account에 등록된 구매자의 연락처
9526
+ key: "sender_phone", // 구매자 휴대전화 번호
9299
9527
  value: "(02)16705176",
9300
9528
  },
9301
9529
  {
9302
- key: "sender_country_code", // 고객사의 account에 등록된 국가 코드
9303
- value: "KR", // ISO Alpha-2 형식 국가 코드
9530
+ key: "sender_country_code", // 구매자 국가 코드
9531
+ value: "KR", // ISO 3166-2 alpha-2 코드
9304
9532
  },
9305
9533
  {
9306
- key: "sender_create_date", // 고객사의 account에 등록된 국가 코드
9307
- value: "2023-10-10T23:59:59+09:00", // IOS8601 형식
9534
+ key: "sender_create_date", // 구매자 계정 생성 시각
9535
+ value: "2023-10-10T23:59:59+09:00", // RFC 3339 형식
9308
9536
  },
9309
9537
  ],
9310
9538
  });
@@ -10813,7 +11041,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10813
11041
 
10814
11042
  - 안드로이드
10815
11043
 
10816
- [**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
11044
+ [**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
10817
11045
 
10818
11046
  ```java title="코드 예시"
10819
11047
  MagnesResult magnesResult = MagnesSDK.getInstance()
@@ -10826,7 +11054,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10826
11054
 
10827
11055
  - iOS Switft
10828
11056
 
10829
- [**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
11057
+ [**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
10830
11058
 
10831
11059
  ```swift title="코드 예시"
10832
11060
  let magnesResult: MagnesResult =
@@ -10838,7 +11066,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10838
11066
 
10839
11067
  - iOS Objective-C
10840
11068
 
10841
- [**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(YOUR-PAYPAL-CLIENT-METADATA-ID)로는 주문번호(paymentId)를 전달해주시면 됩니다.
11069
+ [**iOS Objective-C SDK Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/ios-objective-c/) 가이드 문서에 따라 아래와 같이 collectAndSubmitWithPayPalClientMetadataId 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 첫번째 파라미터(YOUR-PAYPAL-CLIENT-METADATA-ID)로는 주문번호(paymentId)를 전달해주시면 됩니다.
10842
11070
 
10843
11071
  ```objc title="코드 예시"
10844
11072
  //PPRMOCMagnesSDK *magnesSDK = [PPRMOCMagnesSDK shared];
@@ -10916,7 +11144,7 @@ versionVariants:
10916
11144
  - 결제창/API 정기결제 : 카드
10917
11145
  - 간편결제 허브형 : 카카오페이 / 네이버페이 / 페이코 / LPay / 핀페이
10918
11146
 
10919
- - **나이스페이먼츠**
11147
+ - **나이스정보통신**
10920
11148
 
10921
11149
  - 연동 기능: 인증결제(결제창) / 비인증결제(API) / 정기결제(API) / 간편결제(결제창/다이렉트 호출)
10922
11150
 
@@ -11272,7 +11500,7 @@ function requestPayment() {
11272
11500
 
11273
11501
  ## SDK 빌링키 발급 요청하기
11274
11502
 
11275
- 빌링키 발급 요청 시에는 `requestBillingKeyIssue` 함수를 호출해야 합니다.
11503
+ 빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
11276
11504
  `channelKey`파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 스마트로 채널 사용을 명시해주세요.
11277
11505
 
11278
11506
  스마트로 기준으로 작성한 예시 코드는 아래와 같습니다.
@@ -13325,13 +13553,13 @@ function requestPayment() {
13325
13553
 
13326
13554
  **PC - 카드 결제 전용 파라미터**
13327
13555
 
13328
- |형식 |설명 |
13329
- |---------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
13330
- |SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d) |
13331
- |below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음 |
13332
- |paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어 |
13333
- |onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay`|
13334
- |SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3) |
13556
+ |형식 |설명 |
13557
+ |---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
13558
+ |SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d) |
13559
+ |below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음 |
13560
+ |paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어 |
13561
+ |onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay` <br /> - 네이버페이: `npay`|
13562
+ |SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3) |
13335
13563
 
13336
13564
  **PC - 휴대폰 소액 결제 전용 파라미터**
13337
13565
 
@@ -13502,6 +13730,7 @@ SDK를 통한 결제 요청 파라미터에는 부가세를 지정할 수 있는
13502
13730
  - lpay: `LPAY`
13503
13731
  - 토스페이: `TOSSPAY`
13504
13732
  - 페이코: `PAYCO`
13733
+ - 네이버페이: `NAVERPAY`
13505
13734
 
13506
13735
  </details>
13507
13736
 
@@ -14588,7 +14817,7 @@ versionVariants:
14588
14817
  브라우저에서 포트원 SDK를 호출하여 빌링키를 발급하고, 서버로 빌링키를 전달합니다.
14589
14818
 
14590
14819
  ```ts
14591
- const issueResponse = PortOne.requestIssueBillingKey({
14820
+ const issueResponse = await PortOne.requestIssueBillingKey({
14592
14821
  storeId: "store-9bf6076d-beef-4729-9521-ae66c14e0569",
14593
14822
  channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d",
14594
14823
  billingKeyMethod: "CARD",
@@ -14964,7 +15193,8 @@ async function requestPayment() {
14964
15193
  }
14965
15194
  ```
14966
15195
 
14967
- 결과값에 들어 있는 필드는 다음과 같습니다.
15196
+ 결과값에 들어 있는 주요 필드는 다음과 같습니다.
15197
+ 전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
14968
15198
 
14969
15199
  |필드명 |설명 |비고 |
14970
15200
  |---------|-------------------|----------------------------|
@@ -14987,7 +15217,8 @@ PortOne.requestPayment({
14987
15217
  });
14988
15218
  ```
14989
15219
 
14990
- 쿼리 문자열로 전달되는 내용은 다음과 같습니다.
15220
+ 쿼리 문자열로 전달되는 주요 필드는 다음과 같습니다.
15221
+ 전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
14991
15222
 
14992
15223
  |키 |설명 |비고 |
14993
15224
  |---------|-------------------|----------------------------|
@@ -15204,7 +15435,7 @@ V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https:/
15204
15435
 
15205
15436
  ### 기능 확장: 신속한 업데이트와 혁신
15206
15437
 
15207
- V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될 스마트라우팅은 V2 인프라를 이용 중인 고객사에게 우선하여 제공됩니다.
15438
+ V2는 최신 결제 기능을 가장 빠르게 제공합니다.
15208
15439
  최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다.
15209
15440
 
15210
15441
  ## 사용 가능한 PG사
@@ -15218,7 +15449,7 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될
15218
15449
  - **카카오페이**
15219
15450
  - **네이버페이**
15220
15451
  - **스마트로**
15221
- - **나이스페이먼츠**
15452
+ - **나이스정보통신**
15222
15453
  - **페이팔**
15223
15454
  - **KG이니시스**
15224
15455
  - **한국결제네트웍스(KPN)**
@@ -15257,8 +15488,6 @@ versionVariants:
15257
15488
  v1: /opi/ko/integration/webhook/readme-v1
15258
15489
  ---
15259
15490
 
15260
- (관련 이미지 첨부)
15261
-
15262
15491
  ## 웹훅(Webhook) 이란?
15263
15492
 
15264
15493
  특정 이벤트가 발생하였을 때 타 서비스나 응용프로그램으로 알림을 보내는 기능입니다.
@@ -15834,7 +16063,7 @@ Connection Timeout 및 Read Timeout 모두 30초 입니다.
15834
16063
 
15835
16064
  **웹훅 처리 전에 브라우저 결제 완료 처리가 진행되는 경우**
15836
16065
 
15837
- 기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
16066
+ 기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <tech.support@portone.io> 로 상점 아이디(storeId)를 기재하여 요청해 주시면 됩니다.
15838
16067
 
15839
16068
  </div>
15840
16069
 
@@ -16037,7 +16266,7 @@ ni @portone/browser-sdk
16037
16266
 
16038
16267
  <div class="hint" data-style="warning">
16039
16268
 
16040
- 나이스페이먼츠의 경우 최대 40바이트까지 입력할 수 있으며, 사용 가능한 특수문자는 아래와 같습니다.
16269
+ 나이스정보통신의 경우 최대 40바이트까지 입력할 수 있으며, 사용 가능한 특수문자는 아래와 같습니다.
16041
16270
 
16042
16271
  - 사용 가능: `_`
16043
16272
  - 사용 불가: `% & | $ - + = [ ]`
@@ -16141,7 +16370,7 @@ ni @portone/browser-sdk
16141
16370
 
16142
16371
  <div class="hint" data-style="warning">
16143
16372
 
16144
- 나이스페이먼츠는 `KRW`만을 지원합니다.
16373
+ 나이스정보통신은 `KRW`만을 지원합니다.
16145
16374
 
16146
16375
  </div>
16147
16376
 
@@ -16379,7 +16608,7 @@ ni @portone/browser-sdk
16379
16608
 
16380
16609
  <div class="hint" data-style="warning">
16381
16610
 
16382
- 나이스페이먼츠의 경우 카드사 단독 노출 시 `card.installment.monthOption.fixedMonth`를 필수로 지정해야 합니다.
16611
+ 나이스정보통신의 경우 카드사 단독 노출 시 `card.installment.monthOption.fixedMonth`를 필수로 지정해야 합니다.
16383
16612
  결제 금액이 할부 지원 금액 미만인 경우 할부 개월 수를 `0`으로 전달해야 합니다.
16384
16613
 
16385
16614
  </div>
@@ -16677,7 +16906,7 @@ ni @portone/browser-sdk
16677
16906
 
16678
16907
  <div class="hint" data-style="warning">
16679
16908
 
16680
- 나이스페이먼츠의 경우 카드사 포인트 사용 시 별도 계약이 필요합니다.
16909
+ 나이스정보통신의 경우 카드사 포인트 사용 시 별도 계약이 필요합니다.
16681
16910
 
16682
16911
  </div>
16683
16912
 
@@ -16900,7 +17129,7 @@ ni @portone/browser-sdk
16900
17129
 
16901
17130
  <div class="hint" data-style="warning">
16902
17131
 
16903
- 나이스페이먼츠의 경우 입금 만료기한을 필수로 입력해야 합니다.
17132
+ 나이스정보통신의 경우 입금 만료기한을 필수로 입력해야 합니다.
16904
17133
 
16905
17134
  </div>
16906
17135
 
@@ -17067,7 +17296,7 @@ ni @portone/browser-sdk
17067
17296
 
17068
17297
  <div class="hint" data-style="warning">
17069
17298
 
17070
- 나이스페이먼츠의 경우 상품권 유형을 필수로 지정해야 합니다.s
17299
+ 나이스정보통신의 경우 상품권 유형을 필수로 지정해야 합니다.s
17071
17300
 
17072
17301
  </div>
17073
17302
 
@@ -17263,7 +17492,7 @@ ni @portone/browser-sdk
17263
17492
 
17264
17493
  <div class="hint" data-style="warning">
17265
17494
 
17266
- 나이스페이먼츠의 경우 카카오페이, 네이버페이, 애플페이, LPAY 사용 시 상점분담 무이자를 사용하실 수 없습니다.
17495
+ 나이스정보통신의 경우 카카오페이, 네이버페이, 애플페이, LPAY 사용 시 상점분담 무이자를 사용하실 수 없습니다.
17267
17496
 
17268
17497
  </div>
17269
17498
 
@@ -17400,7 +17629,7 @@ ni @portone/browser-sdk
17400
17629
 
17401
17630
  <div class="hint" data-style="warning">
17402
17631
 
17403
- 나이스페이먼츠의 경우 할부 사용 시 별도 계약이 필요합니다.
17632
+ 나이스정보통신의 경우 할부 사용 시 별도 계약이 필요합니다.
17404
17633
 
17405
17634
  </div>
17406
17635
 
@@ -17523,7 +17752,7 @@ ni @portone/browser-sdk
17523
17752
 
17524
17753
  <div class="hint" data-style="warning">
17525
17754
 
17526
- 나이스페이먼츠의 경우 일부 간편결제 수단에 대해 `availablePayMethods`가 필수입니다.
17755
+ 나이스정보통신의 경우 일부 간편결제 수단에 대해 `availablePayMethods`가 필수입니다.
17527
17756
 
17528
17757
  - 네이버페이: 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE`를 입력합니다.
17529
17758
  - SSG페이: 계좌 결제를 노출하는 `TRANSFER`만 유효하며, 카드 혹은 머니 결제인 경우 `availablePayMethods`를 생략해야 합니다.
@@ -17559,7 +17788,7 @@ ni @portone/browser-sdk
17559
17788
 
17560
17789
  <div class="hint" data-style="warning">
17561
17790
 
17562
- 나이스페이먼츠와 계약 시 지정된 면세금액을 반드시 입력해야 합니다.
17791
+ 나이스정보통신와 계약 시 지정된 면세금액을 반드시 입력해야 합니다.
17563
17792
 
17564
17793
  </div>
17565
17794
 
@@ -17843,7 +18072,7 @@ ni @portone/browser-sdk
17843
18072
 
17844
18073
  <div class="hint" data-style="warning">
17845
18074
 
17846
- 나이스페이먼츠와 별도 계약이 필요합니다.
18075
+ 나이스정보통신와 별도 계약이 필요합니다.
17847
18076
 
17848
18077
  </div>
17849
18078
 
@@ -17868,7 +18097,7 @@ ni @portone/browser-sdk
17868
18097
 
17869
18098
  <div class="hint" data-style="warning">
17870
18099
 
17871
- 나이스페이먼츠와 별도 계약이 필요합니다.
18100
+ 나이스정보통신와 별도 계약이 필요합니다.
17872
18101
 
17873
18102
  </div>
17874
18103
 
@@ -17909,7 +18138,7 @@ ni @portone/browser-sdk
17909
18138
 
17910
18139
  <div class="hint" data-style="warning">
17911
18140
 
17912
- 나이스페이먼츠와 별도 계약이 필요합니다.
18141
+ 나이스정보통신와 별도 계약이 필요합니다.
17913
18142
 
17914
18143
  </div>
17915
18144
 
@@ -17921,7 +18150,7 @@ ni @portone/browser-sdk
17921
18150
 
17922
18151
  <div class="hint" data-style="warning">
17923
18152
 
17924
- 나이스페이먼츠와 별도 계약이 필요합니다.
18153
+ 나이스정보통신와 별도 계약이 필요합니다.
17925
18154
 
17926
18155
  </div>
17927
18156
 
@@ -17936,7 +18165,7 @@ ni @portone/browser-sdk
17936
18165
 
17937
18166
  <div class="hint" data-style="warning">
17938
18167
 
17939
- 나이스페이먼츠와 별도 계약이 필요합니다.
18168
+ 나이스정보통신와 별도 계약이 필요합니다.
17940
18169
 
17941
18170
  </div>
17942
18171
 
@@ -18627,7 +18856,7 @@ ni @portone/browser-sdk
18627
18856
 
18628
18857
  <div class="hint" data-style="warning">
18629
18858
 
18630
- 나이스페이먼츠의 경우 에스크로 사용 시 별도 계약이 필요합니다.
18859
+ 나이스정보통신의 경우 에스크로 사용 시 별도 계약이 필요합니다.
18631
18860
 
18632
18861
  </div>
18633
18862
 
@@ -20070,7 +20299,7 @@ targetVersions:
20070
20299
 
20071
20300
  - 결제대행사 필터는 하나의 결제대행사에 모든 `pg_provider`가 포함됩니다.
20072
20301
  - KG이니시스 : inicis, html5\_inicis, inicis\_v2
20073
- - 나이스페이먼츠 : nice, nice\_v2
20302
+ - 나이스정보통신 : nice, nice\_v2
20074
20303
  - 페이팔 : paypal, paypal\_v2
20075
20304
  - 스마트로 : smartro, smartro\_v2
20076
20305
  - 토스페이 : tosspay, tosspay\_v2
@@ -21340,7 +21569,7 @@ description: 결제대행사 및 결제수단을 선택하고 전자결제를
21340
21569
 
21341
21570
  - [V2 연동 매뉴얼 바로가기](https://developers.portone.io/opi/ko/integration/ready/readme?v=v2)
21342
21571
 
21343
- - 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <support@portone.io>**
21572
+ - 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <tech.support@portone.io>**
21344
21573
  또는 채널톡으로 문의 주시기 바랍니다.
21345
21574
 
21346
21575
 
@@ -21356,7 +21585,7 @@ description: >-
21356
21585
  ## PG 거래대사 유의사항
21357
21586
 
21358
21587
  - 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
21359
- - 지원 PG : **KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
21588
+ - 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
21360
21589
  - 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
21361
21590
  - 9/26 이후 지원 예정 PG사 : KPN, 하이픈, KSNET
21362
21591
 
@@ -22572,7 +22801,7 @@ targetVersions:
22572
22801
  ## 프로모션이란?
22573
22802
 
22574
22803
  고객사가 카드사와 계약하여 사용자에게 즉시 할인을 제공하는 **카드 즉시 할인 서비스**를 운영하고 관리할
22575
- 수 있는 서비스 입니다.
22804
+ 수 있는 서비스입니다.
22576
22805
 
22577
22806
  카드 즉시 할인 서비스를 이용시 필요한 **프로모션 관리 시스템**과 **프로모션 정산 대사 시스템** 을 제공합니다.
22578
22807
  포트원 콘솔에서 기간, 할인 조건, 예산 등 다양한 옵션의 프로모션을 설정할 수 있으며,
@@ -22918,7 +23147,7 @@ async function cancelPayment() {
22918
23147
 
22919
23148
  ---
22920
23149
  title: 스마트 라우팅 - 콘솔 가이드
22921
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
23150
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
22922
23151
  targetVersions:
22923
23152
  - v1
22924
23153
  - v2
@@ -22995,7 +23224,7 @@ targetVersions:
22995
23224
 
22996
23225
  ---
22997
23226
  title: 스마트 라우팅 - 연동하기
22998
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
23227
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
22999
23228
  targetVersions:
23000
23229
  - v1
23001
23230
  - v2
@@ -24308,7 +24537,7 @@ if (!issueResponse.ok)
24308
24537
  사용 가능한 빌링키가 없는 경우 그룹 내 채널 비율이 0으로 설정되어있더라도 해당 결제대행사로 결제가
24309
24538
  일어날 수 있습니다.
24310
24539
 
24311
- 예를 들어, 그룹 내에 나이스페이먼츠, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
24540
+ 예를 들어, 그룹 내에 나이스정보통신, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
24312
24541
  발급 시 3개의 결제대행사로부터 빌링키를 발급 받은 후 슈퍼 빌링키에 맵핑 됩니다.
24313
24542
  이후 그룹 설정을 토스페이먼츠 0%, 스마트로 100%로 변경한 경우 위에 발급한 슈퍼 빌링키로 결제 요청 시
24314
24543
  토스페이먼츠 빌링키만 사용이 가능하기 때문에 0%로 결제 비율이 설정되어있음에도 토스페이먼츠로 결제가
@@ -24323,7 +24552,7 @@ if (!issueResponse.ok)
24323
24552
 
24324
24553
  ---
24325
24554
  title: 스마트 라우팅
24326
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
24555
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
24327
24556
  targetVersions:
24328
24557
  - v1
24329
24558
  - v2
@@ -24354,8 +24583,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24354
24583
 
24355
24584
  ### 결제창(SDK) 인증결제
24356
24585
 
24357
- - **나이스페이먼츠(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24358
- - **(구) 나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24586
+ - **나이스정보통신(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24587
+ - **(구) 나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24359
24588
  - **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24360
24589
  - **KG 이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24361
24590
  - **토스페이먼츠(신모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
@@ -24374,7 +24603,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24374
24603
 
24375
24604
  ### API 수기(키인)결제
24376
24605
 
24377
- - **나이스페이먼츠(신모듈)** : 카드
24606
+ - **나이스정보통신(신모듈)** : 카드
24378
24607
  - **NHN KCP** : 카드
24379
24608
  - **KG 이니시스** : 카드
24380
24609
  - **토스페이먼츠(신모듈)** : 카드
@@ -24383,8 +24612,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24383
24612
 
24384
24613
  ### API 빌링키 발급 및 정기결제
24385
24614
 
24386
- - **나이스페이먼츠 (신모듈)** : 카드
24387
- - **(구) 나이스페이먼츠** : 카드
24615
+ - **나이스정보통신 (신모듈)** : 카드
24616
+ - **(구) 나이스정보통신** : 카드
24388
24617
  - **NHN KCP** : 카드
24389
24618
  - **KG이니시스** : 카드
24390
24619
  - **토스페이먼츠(신모듈)** : 카드
@@ -24399,7 +24628,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24399
24628
 
24400
24629
  ### 결제창(SDK) 인증결제
24401
24630
 
24402
- - **나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24631
+ - **나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24403
24632
  - **KG이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24404
24633
  - **토스페이먼츠** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
24405
24634
  - **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
@@ -24409,7 +24638,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24409
24638
 
24410
24639
  ### API 수기(키인)결제
24411
24640
 
24412
- - **나이스페이먼츠** : 카드 / 가상계좌
24641
+ - **나이스정보통신** : 카드 / 가상계좌
24413
24642
  - **KG이니시스** : 카드 / 가상계좌
24414
24643
  - **토스페이먼츠** : 카드 / 가상계좌
24415
24644
  - **한국결제네트웍스(KPN)** : 카드 / 가상계좌
@@ -24419,7 +24648,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24419
24648
 
24420
24649
  ### API 빌링키 발급 및 정기결제
24421
24650
 
24422
- - **나이스페이먼츠** : 카드
24651
+ - **나이스정보통신** : 카드
24423
24652
  - **KG이니시스** : 카드
24424
24653
  - **토스페이먼츠** : 카드
24425
24654
  - **한국결제네트웍스(KPN)** : 카드
@@ -24614,7 +24843,7 @@ targetVersions:
24614
24843
 
24615
24844
  <details>
24616
24845
 
24617
- <summary>나이스페이먼츠</summary>
24846
+ <summary>나이스정보통신</summary>
24618
24847
 
24619
24848
  <div class="hint" data-style="info">
24620
24849
 
@@ -24622,16 +24851,16 @@ targetVersions:
24622
24851
 
24623
24852
  </div>
24624
24853
 
24625
- 1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
24854
+ 1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
24626
24855
  2. \[가맹점정보]→\[KEY관리]를 클릭합니다.
24627
24856
  3. MID 및 Key 값을 확인할 수 있습니다.
24628
24857
 
24629
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 KEY 조회 화면)
24858
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 KEY 조회 화면)
24630
24859
 
24631
24860
  4. \[가맹점정보]→\[비밀번호관리]→\[거래취소비밀번호]를 클릭합니다.
24632
24861
  5. 비밀번호를 설정합니다. 비밀번호는 최대 10자리까지 가능합니다.
24633
24862
 
24634
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 거래취소비밀번호 설정 화면)
24863
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 거래취소비밀번호 설정 화면)
24635
24864
 
24636
24865
  6. 포트원 콘솔에서 채널 추가 시 \[MID], \[Key], \[결제취소 비밀번호]를 입력한 후 `저장`을 클릭합니다.
24637
24866
 
@@ -24950,7 +25179,17 @@ targetVersions:
24950
25179
 
24951
25180
  <div class="tabs-content" data-title="통합 본인인증">
24952
25181
 
24953
- 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와\[apikey]를 입력한`저장`을 클릭합니다.
25182
+ 1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속로그인을 합니다.
25183
+ 2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
25184
+ 3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
25185
+
25186
+ - 본인인증 서비스를 이용하는 고객사 서비스 도메인
25187
+ - iamport.co
25188
+ - iamport.kr
25189
+
25190
+ (이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
25191
+
25192
+ 4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
24954
25193
 
24955
25194
  </div>
24956
25195
 
@@ -25046,7 +25285,17 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
25046
25285
 
25047
25286
  <div class="tabs-content" data-title="통합 본인인증">
25048
25287
 
25049
- 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID] \[apikey]를 입력한 `저장`을 클릭합니다.
25288
+ 1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속로그인을 합니다.
25289
+ 2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
25290
+ 3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
25291
+
25292
+ - 본인인증 서비스를 이용하는 고객사 서비스 도메인
25293
+ - iamport.co
25294
+ - iamport.kr
25295
+
25296
+ (이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
25297
+
25298
+ 4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
25050
25299
 
25051
25300
  </div>
25052
25301
 
@@ -25476,8 +25725,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
25476
25725
 
25477
25726
  </details>
25478
25727
 
25479
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
25480
-
25481
25728
  <details>
25482
25729
 
25483
25730
  <summary>페이레터 해외결제</summary>
@@ -25487,8 +25734,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
25487
25734
 
25488
25735
  </details>
25489
25736
 
25490
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
25491
-
25492
25737
  ## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
25493
25738
 
25494
25739
  포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.
@@ -25568,78 +25813,54 @@ targetVersions:
25568
25813
  포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
25569
25814
  AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
25570
25815
 
25571
- ### 1. MCP 서버 등록하기
25572
-
25573
- 포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
25574
-
25575
- Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
25576
-
25577
- ```json
25578
- {
25579
- // ...
25580
-
25581
- "mcpServers": {
25582
- // ...
25583
-
25584
- "portone-mcp-server": {
25585
- "command": "uvx",
25586
- "args": ["portone-mcp-server@latest"]
25587
- }
25588
- }
25589
- }
25590
- ```
25591
-
25592
- <div class="hint" data-style="info">
25593
-
25594
- 사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
25595
-
25596
- </div>
25816
+ 이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
25817
+ 아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
25597
25818
 
25598
- 설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
25819
+ - 채널 목록 조회
25820
+ - 테스트 채널 추가
25821
+ - 하위 상점 조회
25822
+ - 결제 내역 조회
25599
25823
 
25600
- #### 포트원 기능 사용하기
25824
+ ### DXT를 이용한 설치
25601
25825
 
25602
- MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
25826
+ [DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
25603
25827
 
25604
- - 결제 내역 단건/다건 조회
25605
- - 본인인증 내역 단건/다건 조회
25828
+ 1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
25829
+ 2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
25830
+ 3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
25606
25831
 
25607
- 연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
25832
+ <div class="hint" data-style="warning">
25608
25833
 
25609
- ```json
25610
- {
25611
- // ...
25834
+ **Claude Desktop에서 DXT 파일 사용 시 주의사항**
25612
25835
 
25613
- "mcpServers": {
25614
- // ...
25836
+ 현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
25615
25837
 
25616
- "portone-mcp-server": {
25617
- "command": "uvx",
25618
- "args": ["portone-mcp-server@latest"],
25619
- // 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
25620
- "env": {
25621
- "API_SECRET": "<YOUR_PORTONE_API_SECRET>"
25622
- }
25623
- }
25624
- }
25625
- }
25626
- ```
25838
+ 이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
25627
25839
 
25628
- <div class="hint" data-style="warning">
25840
+ </div>
25629
25841
 
25630
- **API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
25842
+ ### MCP 서버 등록하기
25631
25843
 
25632
- 내부의 인가된 인원만이 MCP 서버를 사용할 수 있도록 통제해야 합니다.
25844
+ 1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
25633
25845
 
25634
- </div>
25846
+ 2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
25635
25847
 
25636
- <div class="hint" data-style="warning">
25848
+ ```jsonc
25849
+ "mcpServers": {
25637
25850
 
25638
- **MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
25851
+ // 기존 설정
25639
25852
 
25640
- 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
25853
+ "portone-mcp-server": {
25854
+ "command": "npx",
25855
+ "args": [
25856
+ "-y",
25857
+ "@portone/mcp-server@latest"
25858
+ ]
25859
+ }
25860
+ }
25861
+ ```
25641
25862
 
25642
- </div>
25863
+ 3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
25643
25864
 
25644
25865
  <div class="hint" data-style="warning">
25645
25866
 
@@ -25650,7 +25871,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
25650
25871
 
25651
25872
  </div>
25652
25873
 
25653
- ### 2. MCP 서버 활용하기
25874
+ ### MCP 서버 활용하기
25654
25875
 
25655
25876
  사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
25656
25877
 
@@ -25720,8 +25941,8 @@ targetVersions:
25720
25941
  |키움페이 |daou |<ul><li>발행 통지 URL: [https://service.iamport.kr/daou\_payments/result](http://service.iamport.kr/daou_payments/result)</li> <li>결과 통지 URL: [https://service.iamport.kr/daou\_payments/notice\_vbank](http://service.iamport.kr/daou_payments/notice_vbank)</li></ul>|
25721
25942
  |토스페이먼츠(신모듈) |tosspayments |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments) |
25722
25943
  |스마트로(신모듈) |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) |
25723
- |나이스페이먼츠(구모듈)|nice |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank) |
25724
- |나이스페이먼츠(신모듈)|nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) |
25944
+ |나이스정보통신(구모듈)|nice |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank) |
25945
+ |나이스정보통신(신모듈)|nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) |
25725
25946
  |웰컴페이먼츠 |welcome |[https://tx-gateway-service.prod.iamport.co/welcome](http://tx-gateway-service.prod.iamport.co/welcome) |
25726
25947
 
25727
25948
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -25732,7 +25953,7 @@ targetVersions:
25732
25953
  |----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-|
25733
25954
  |토스페이먼츠 |tosspayments |[https://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments](http://tx-gateway-service.prod.iamport.co/virtual-account/webhook-event/tosspayments)| |
25734
25955
  |스마트로 |smartro\_v2 |입금 통보, 환불이체 URL 동일: [https://tx-gateway-service.prod.iamport.co/smartro-v2](http://tx-gateway-service.prod.iamport.co/smartro-v2) | |
25735
- |나이스페이먼츠 |nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) | |
25956
+ |나이스정보통신 |nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) | |
25736
25957
  |KG이니시스 |inicis\_v2 |[https://tx-gateway-service.prod.iamport.co/inicis-v2](http://tx-gateway-service.prod.iamport.co/inicis-v2) | |
25737
25958
  |한국결제네트웍스|kpn |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](http://tx-gateway-service.prod.iamport.co/kpn/virtual-account) | |
25738
25959
  |NHN KCP |kcp\_v2 |[https://tx-gateway-service.prod.iamport.co/kcp-v2](http://tx-gateway-service.prod.iamport.co/kcp-v2) | |
@@ -25773,9 +25994,9 @@ targetVersions:
25773
25994
 
25774
25995
  <details>
25775
25996
 
25776
- <summary>나이스페이먼츠(구모듈) 설정 방법</summary>
25997
+ <summary>나이스정보통신(구모듈) 설정 방법</summary>
25777
25998
 
25778
- 1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
25999
+ 1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
25779
26000
  2. \[가맹점정보]→\[기본정보]를 클릭합니다.
25780
26001
  3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://service.iamport.kr/nice_payments/notice_vbank` 로 설정해주세요.
25781
26002
  4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
@@ -25785,7 +26006,7 @@ targetVersions:
25785
26006
  - 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
25786
26007
  - 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
25787
26008
 
25788
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면)
26009
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면)
25789
26010
 
25790
26011
  </details>
25791
26012
 
@@ -25878,9 +26099,9 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
25878
26099
 
25879
26100
  <details>
25880
26101
 
25881
- <summary>나이스페이먼츠(신모듈) 설정 방법</summary>
26102
+ <summary>나이스정보통신(신모듈) 설정 방법</summary>
25882
26103
 
25883
- 1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
26104
+ 1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
25884
26105
  2. \[가맹점정보]→\[기본정보]를 클릭합니다.
25885
26106
  3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://tx-gateway-service.prod.iamport.co/nicepay-v2` 로 설정해주세요.
25886
26107
  4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
@@ -25890,7 +26111,7 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
25890
26111
  - 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
25891
26112
  - 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
25892
26113
 
25893
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면 )
26114
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면 )
25894
26115
 
25895
26116
  </details>
25896
26117
 
@@ -26176,86 +26397,311 @@ targetVersions:
26176
26397
 
26177
26398
  포트원 결제 연동 및 운영 과정에서 기술적인 어려움을 겪고 있다면, 아래 메일로 문의하세요.
26178
26399
 
26179
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
26400
+ - <tech.support@portone.io>
26180
26401
 
26181
- - V1: <support@portone.io>
26182
- - V2: <tech.support@portone.io>
26183
26402
 
26184
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
26403
+ # https://developers.portone.io/opi/ko/support/pg-terms
26185
26404
 
26186
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
26405
+ ---
26406
+ title: 용어 사전
26407
+ description: 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
26408
+ targetVersions:
26409
+ - v1
26410
+ - v2
26411
+ ---
26187
26412
 
26188
- - V2: <tech.support@portone.io>
26189
- - V1: <support@portone.io>
26413
+ ## 결제 대행 관련
26190
26414
 
26191
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
26415
+ ### PG (Payment Gateway)
26192
26416
 
26417
+ PG는 온라인 결제에서 결제 정보를 송수신하고 정산을 매개하는 서비스입니다. 온라인 결제를 받기 위해서는 PG사와의 계약과 연동이 필요합니다. 법적으로는 전자금융업상 전자지급결제대행업에 해당합니다.
26193
26418
 
26194
- # https://developers.portone.io/opi/ko/support/tls-support
26419
+ PG에 따라 신용카드, 계좌이체, 가상계좌, 휴대폰 결제 등 다양한 결제 수단을 이용할 수 있으며, "결제의 관문"이라는 이름처럼 알맞은 시스템으로 결제 정보를 전달합니다.
26195
26420
 
26196
- ---
26197
- title: TLS 지원 범위
26198
- description: 포트원 v1 API의 TLS 지원 범위 및 설정 가이드를 확인할 수 있습니다.
26199
- ---
26421
+ ### 포트원 원 페이먼트 인프라 (OPI)
26200
26422
 
26201
- 2024년 9월 1일부터 포트원을 이용하는 고객님들의 개인정보결제정보를 더욱 안전하게 보호하기 위해
26202
- v1 API 서버(api.iamport.kr)의 TLS 버전 및 Cipher Suite 지원 범위가 변경됩니다.
26423
+ 다양한 PG의 파편화된 인터페이스를 통일하여 현대적인 연동 경험을 제공하는 **결제 오케스트레이션 서비스**입니다. 이를 통해 PG를 쉽게 연동 추가/변경하고, 다중 PG 시스템을 운영할 수 있습니다.
26203
26424
 
26204
- ## 변경사항 요약
26425
+ <div class="hint" data-style="info">
26205
26426
 
26206
- - HTTP 평문 통신에 대한 지원이 중단됩니다.
26207
- - TLS 1.0, 1.1 버전에 대한 지원이 중단됩니다.
26208
- - 보안성이 떨어지는 일부 Legacy Cipher Suite 들에 대한 지원이 중단됩니다.
26427
+ OPI 서비스는 결제 정보를 송수신하지만 자금 이동에는 관여하지 않습니다.
26209
26428
 
26210
- <table class="table-tls-support">
26429
+ </div>
26211
26430
 
26212
- <thead>
26431
+ ### PG 상점 아이디 (MID)
26213
26432
 
26214
- <tr>
26433
+ PG에서 상점에 부여하는 고유 식별자입니다. PG와의 계약을 통해 발급되며, 결제 수단, 과세 여부, 수수료 등 여러 설정이 MID 단위로 관리됩니다. PG 정책에 따라서는 이용 서비스 및 세부 설정별로 여러 개의 MID를 발급하기도 합니다.
26215
26434
 
26216
- <th>Protocol</th>
26217
- <th>Cipher Suite</th>
26218
- <th>2024-09-01 전</th>
26219
- <th>2024-09-01 이후</th>
26435
+ 포트원을 이용할 때에는 채널을 추가할 때 MID를 입력합니다.
26220
26436
 
26221
- </tr>
26437
+ <div class="hint" data-style="info">
26222
26438
 
26223
- </thead>
26439
+ **PG사별 상점 아이디 명칭**
26224
26440
 
26225
- <tbody>
26441
+ - KG이니시스: 상점 아이디(MID)
26442
+ - 카카오페이: 고객사 코드(CID)
26443
+ - 네이버페이: 파트너 ID (하위 식별자로 체인 ID 존재)
26444
+ - 토스페이먼츠: 상점 아이디(MID)
26445
+ - NHN KCP: 사이트 코드
26226
26446
 
26227
- <tr>
26447
+ </div>
26228
26448
 
26229
- <td>HTTP</td>
26230
- <td>
26449
+ ### 포트원 상점 아이디 (storeId)
26231
26450
 
26232
- <i>N/A</i>
26451
+ 포트원 관리자 콘솔에서 확인할 수 있는 상점 식별자입니다. 연동 시 `storeId`라는 이름으로 많은 API에 등장합니다.
26233
26452
 
26234
- </td>
26235
- <td rowspan="3" class="supported">O</td>
26236
- <td rowspan="3" class="unsupported">X</td>
26453
+ 포트원 V1에서는 고객사 식별코드라는 별도 값을 이용합니다.
26237
26454
 
26238
- </tr>
26455
+ ## 결제 방식 관련 용어
26239
26456
 
26240
- <tr>
26457
+ ### 간편결제사
26241
26458
 
26242
- <td>TLSv1.0</td>
26243
- <td>
26459
+ 네이버페이, 카카오페이, 토스페이, 페이코와 같이 신용카드나 계좌번호 등의 결제 정보를 등록해 비밀번호 입력, 지문 인식만으로 결제할 수 있는 서비스를 제공하는 사업자입니다.
26244
26460
 
26245
- <i>(omitted)</i>
26461
+ ### PG 제휴 간편결제
26246
26462
 
26247
- </td>
26463
+ 간편결제사와 직접 계약을 맺지 않고 일반 PG사와의 계약만으로 간편결제사의 서비스 이용이 가능한 서비스입니다. 구매자가 보기에는 동일한 간편결제사의 결제창이 호출됩니다.
26248
26464
 
26249
- </tr>
26465
+ <div class="hint" data-style="warning">
26250
26466
 
26251
- <tr>
26467
+ **PG 제휴 간편결제 주의사항**
26252
26468
 
26253
- <td>TLSv1.1</td>
26254
- <td>
26469
+ PG 제휴로 간편결제를 이용할 경우 간편결제 포인트 적립이 안 되는 등 일부 기능을 사용할 수 없는 경우가 있습니다.
26255
26470
 
26256
- <i>(omitted)</i>
26471
+ </div>
26257
26472
 
26258
- </td>
26473
+ ### 인증결제
26474
+
26475
+ 신용카드, 간편결제, 계좌이체, 휴대폰 결제 등에서 결제 정보가 본인임을 확인하는 과정을 거친 이후 결제되는 방식을 총칭합니다. 쇼핑몰 등에서 이용되는 일회성 결제로 가장 일반적인 결제 방식입니다.
26476
+
26477
+ ### 키인결제
26478
+
26479
+ 카드 번호 등 결제 정보를 구매자로부터 직접 입력받아 API 호출을 통해 결제를 일으키는 비인증결제 방식입니다.
26480
+
26481
+ ### 빌링결제
26482
+
26483
+ 구매자에게 최초 1회 결제 정보를 입력받아 빌링키를 발급함으로써, 이후에 고객사에서 임의 시점에 결제를 반복하여 일으키는 결제 방식입니다. 결제를 일으킬 때에는 별도로 사용자 인증이 필요 없으므로 비인증결제에 속합니다. 정기결제 등을 구현하기 위해 사용합니다.
26484
+
26485
+ <div class="hint" data-style="warning">
26486
+
26487
+ **빌링키 사용 제한**
26488
+
26489
+ 빌링키는 해당 빌링키를 발급한 PG에서만 사용 가능합니다. 또, 빌링키를 다른 포트원 상점 또는 다른 PG MID로 이관하려면 별도 요청이 필요합니다.
26490
+
26491
+ </div>
26492
+
26493
+ ## 거래 식별 관련 용어
26494
+
26495
+ ### 결제 ID (paymentId, 고객사 주문번호)
26496
+
26497
+ 결제를 요청할 때 고객사가 채번한 고유 번호입니다. V1에서는 `merchant_uid`라는 이름을 사용합니다.
26498
+
26499
+ ### PG 거래번호 (TID)
26500
+
26501
+ PG사가 채번한 거래 번호입니다. PG사에 따라 취소 건에도 별도의 거래 번호를 부여할 수 있습니다.
26502
+
26503
+ ### 카드 승인번호
26504
+
26505
+ 승인 성공 시 카드사가 부여한 8자리 숫자로, 매입을 진행하거나 취소를 할 때 필요합니다. 당일에 한 카드사에 유니크하나 몇몇 카드사는 당일에 중복되는 경우도 있습니다.
26506
+
26507
+ ## 카드 결제
26508
+
26509
+ 신용/체크/선불카드를 통한 결제는 인증, 승인, 매입의 과정을 거칩니다.
26510
+
26511
+ ### 인증 (Authentication)
26512
+
26513
+ 인증결제에서, 카드 소유주가 본인임을 확인하는 과정입니다. 웹에서 비밀번호를 입력하거나 앱에서 지문 인식을 하는 등 카드사마다 방식이 다릅니다.
26514
+
26515
+ ### 승인 (Authorization)
26516
+
26517
+ 승인 거래가 생성되고, 카드 한도를 차감합니다. 실제로 대금이 이동하지는 않습니다.
26518
+
26519
+ 포트원에서는 인증이 완료되면 자동으로 승인을 진행합니다. 또는, V2에서 수동 승인 기능을 이용하면 인증 후 승인 요청을 별도로 할 수 있습니다.
26520
+
26521
+ ### 매입 (Capture)
26522
+
26523
+ 매입은 승인된 카드 거래의 대금을 청구하는 일을 말합니다. 일반적으로 PG가 매일 정해진 시간에 승인 건들을 모아 자동으로 매입합니다.
26524
+
26525
+ 결제 승인 시점과 상품 공급 시점이 크게 다른 상점에서는 자동 매입을 끄고 PG에 건별로 매입을 요청하는 수동 매입을 이용할 수 있습니다. 매입이 오랫동안 일어나지 않으면 자동으로 승인이 취소됩니다. 포트원에서는 아직 수동 매입을 지원하지 않습니다.
26526
+
26527
+ 카드 결제를 취소할 경우 원리상 매입 전 취소와 매입 후 취소가 구분되고, 매입 후 취소는 보통 3\~4 영업일이 소요됩니다.
26528
+
26529
+ ## 카드 관련 용어
26530
+
26531
+ ### 카드사 유형
26532
+
26533
+ 신용, 체크카드와 관련된 개념으로 발급사, 매입사, 네트워크(브랜드)가 있습니다.
26534
+
26535
+ - **발급사**: 카드를 발급한 회사
26536
+ - **매입사**: 상점과 계약하여 카드 거래 매입을 담당하는 회사
26537
+ - **네트워크**: 매입사와 발급사 사이를 중개하는 인프라 (비자, 마스터카드, JCB, 아메리칸 익스프레스, 다이너스 클럽, 디스커버, 유니온페이 등)
26538
+
26539
+ 국내는 카드에 따라 매입사가 하나로 정해져 있기 때문에 PG가 각 매입사와 계약을 맺습니다.
26540
+
26541
+ <div class="hint" data-style="info">
26542
+
26543
+ **예시: 카카오뱅크 카드**
26544
+
26545
+ - 발급사: 카카오뱅크
26546
+ - 매입사: 국민카드
26547
+ - 네트워크: 없음 (해외 사용 시 비자, 마스터카드 등 선택)
26548
+
26549
+ </div>
26550
+
26551
+ ### PLCC (Private Label Credit Card)
26552
+
26553
+ 상업자표시 신용카드로, 카드명에 특정 브랜드를 표기한 것을 말합니다. 제휴 업체와 함께 카드 상품을 공동으로 기획하여 비용과 수익을 분담하며, 제휴사의 충성도 높은 고객을 확보할 수 있는 장점이 있습니다.
26554
+
26555
+ **PLCC 예시:**
26556
+
26557
+ - 스타벅스 현대카드
26558
+ - 배민 현대카드
26559
+ - 11번가 신한카드
26560
+
26561
+ ### 제휴카드
26562
+
26563
+ 카드사가 특정 기업 혹은 단체와 협약을 맺어 발급하는 카드입니다. 카드사는 제휴사 카드 상품을 출시하고 마케팅 비용이나 카드 수익 등을 모두 관리하며, 반면 제휴사는 카드 모집만 담당합니다.
26564
+
26565
+ ## 기타 결제 관련 용어
26566
+
26567
+ ### 가상계좌
26568
+
26569
+ 은행이 고객사에 발급한 입금 전용 계좌로, 고객사는 납부자와 가상계좌 번호를 일대일로 매핑하여 발급합니다. 보통 가상계좌는 입금 시 바로 삭제되며 해당 계좌번호는 재활용되어 다른 납부자에게 발급될 수 있습니다.
26570
+
26571
+ ### 고정식 가상계좌
26572
+
26573
+ 전기요금 고지서처럼 납부자가 하나의 입금 계좌번호를 부여받아 지속적으로 입금하고자 할 때 이용하는 가상계좌입니다.
26574
+
26575
+ ### 에스크로
26576
+
26577
+ 구매자의 구매 확인 의사인 구매결정을 통보받은 후 판매자에게 결제 대금을 지급하는 안전한 결제 서비스입니다. 2006년 4월 1일부터 에스크로 의무화 시행에 따라 가상계좌, 계좌이체와 같은 모든 현금 거래에는 의무적으로 적용해야 합니다.
26578
+
26579
+ ## 취소
26580
+
26581
+ 결제 완료 이후에 API나 콘솔을 통해 결제를 취소할 수 있습니다. 결제 금액의 일부만 취소하는 것도 가능합니다.
26582
+
26583
+ 가상계좌 환불이나 휴대폰 익월 환불의 경우 환불받을 계좌를 입력해야 합니다.
26584
+
26585
+ 환불 가능 기한이 지난 등의 이유로 PG를 통한 취소가 불가능한 경우에는 고객사에서 직접 구매자에게 자체 환불 처리해야 합니다.
26586
+
26587
+ ### 카드
26588
+
26589
+ 매입 전 취소의 경우 즉시 환불됩니다. 매입 후 취소는 일반적으로 3\~4 영업일이 소요됩니다.
26590
+
26591
+ ### 계좌이체
26592
+
26593
+ 즉시 환불됩니다.
26594
+
26595
+ ### 가상계좌
26596
+
26597
+ 환불받을 계좌를 입력해야 환불이 가능합니다. 일반적으로 2 영업일이 소요됩니다.
26598
+
26599
+ ### 휴대폰
26600
+
26601
+ 결제가 일어난 해당 월에만 취소가 가능합니다. 실제 지불 전이므로 즉시 취소됩니다. 일부 PG에서는 익월 환불이라 하여 해당 월이 지난 뒤에도 계좌로 환불하는 기능을 제공합니다.
26602
+
26603
+ ## 세금 관련 용어
26604
+
26605
+ ### 부가가치세
26606
+
26607
+ 일반적으로 매출 발생시 10%의 부가가치세를 국가에 납부해야 합니다. 또한, PG 서비스 수수료에도 10%의 부가가치세가 발생합니다. 수수료에 대한 부가가치세는 매입 세액에 속합니다.
26608
+
26609
+ <div class="hint" data-style="info">
26610
+
26611
+ **정산 수수료 계산 예시**
26612
+
26613
+ 1,000원의 결제에 대해 3%의 수수료를 적용한다면:
26614
+
26615
+ - 수수료: 30원
26616
+ - 수수료 부가세: 3원 (수수료의 10%)
26617
+ - 정산 금액: 967원
26618
+
26619
+ </div>
26620
+
26621
+ ### 면세
26622
+
26623
+ 세금을 부과하지 않는 소득을 의미합니다. 저소득층의 세금 부담 경감 또는 기타 정책적 목적으로 일부 재화나 용역의 공급에 대해 부가가치세를 면제하는 것을 말합니다. 대표적으로 기초생활필수품, 문화 관련 재화, 용역 등이 있습니다.
26624
+
26625
+ ### 영세율
26626
+
26627
+ 일정한 재화 또는 용역의 공급에 대해 0의 세율을 적용하는 제도로, 수출업자, 기타 외화 획득 사업자 등이 영세사업자로 적용됩니다.
26628
+
26629
+ ## 할인 관련 용어
26630
+
26631
+ ### 즉시할인
26632
+
26633
+ 상품의 가격에 즉시 할인 금액을 적용하여 할인된 금액을 결제하는 방식입니다.
26634
+
26635
+ ### 청구할인
26636
+
26637
+ 본래의 상품 가격을 결제했다가 조건 충족 시 결제 대금의 할인된 금액이 반영되는 방식입니다. 청구할인은 할인 여부를 챙겨봐야 하기 때문에 즉시할인이 납부자에게 더 선호됩니다.
26638
+
26639
+
26640
+ # https://developers.portone.io/opi/ko/support/tls-support
26641
+
26642
+ ---
26643
+ title: TLS 지원 범위
26644
+ description: 포트원 v1 API의 TLS 지원 범위 및 설정 가이드를 확인할 수 있습니다.
26645
+ ---
26646
+
26647
+ 2024년 9월 1일부터 포트원을 이용하는 고객님들의 개인정보 및 결제정보를 더욱 안전하게 보호하기 위해
26648
+ v1 API 서버(api.iamport.kr)의 TLS 버전 및 Cipher Suite 지원 범위가 변경됩니다.
26649
+
26650
+ ## 변경사항 요약
26651
+
26652
+ - HTTP 평문 통신에 대한 지원이 중단됩니다.
26653
+ - TLS 1.0, 1.1 버전에 대한 지원이 중단됩니다.
26654
+ - 보안성이 떨어지는 일부 Legacy Cipher Suite 들에 대한 지원이 중단됩니다.
26655
+
26656
+ <table class="table-tls-support">
26657
+
26658
+ <thead>
26659
+
26660
+ <tr>
26661
+
26662
+ <th>Protocol</th>
26663
+ <th>Cipher Suite</th>
26664
+ <th>2024-09-01 전</th>
26665
+ <th>2024-09-01 이후</th>
26666
+
26667
+ </tr>
26668
+
26669
+ </thead>
26670
+
26671
+ <tbody>
26672
+
26673
+ <tr>
26674
+
26675
+ <td>HTTP</td>
26676
+ <td>
26677
+
26678
+ <i>N/A</i>
26679
+
26680
+ </td>
26681
+ <td rowspan="3" class="supported">O</td>
26682
+ <td rowspan="3" class="unsupported">X</td>
26683
+
26684
+ </tr>
26685
+
26686
+ <tr>
26687
+
26688
+ <td>TLSv1.0</td>
26689
+ <td>
26690
+
26691
+ <i>(omitted)</i>
26692
+
26693
+ </td>
26694
+
26695
+ </tr>
26696
+
26697
+ <tr>
26698
+
26699
+ <td>TLSv1.1</td>
26700
+ <td>
26701
+
26702
+ <i>(omitted)</i>
26703
+
26704
+ </td>
26259
26705
 
26260
26706
  </tr>
26261
26707
 
@@ -26756,24 +27202,144 @@ SDK를 지원하지 않는 플랫폼을 포함하여 다양한 플랫폼에서
26756
27202
 
26757
27203
  ---
26758
27204
  title: 용어 사전
26759
- description: ''
27205
+ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
27206
+ ---
27207
+
27208
+
27209
+
27210
+ ## **서비스 용어**
27211
+
27212
+ ### 정산금 계산 자동화
27213
+
27214
+ 파트너에게 정산할 금액을 자동 계산하고 관리하는 대표 서비스입니다.
27215
+ 파트너를 등록하여 파트너 정보를 관리하고, 플랫폼 정책에 맞는 각종 계약을 등록할 수 있으며, 선택한 파트너와 계약을 기반으로 자동 정산금 계산을 지원합니다.
27216
+
27217
+ ### 지급대행 서비스
27218
+
27219
+ 전자금융거래법을 준수하기 위해 PG 정산금의 수취 및 이체를 대행하는 서비스로
27220
+ 안전하고 편리한 지급대행 서비스를 지원합니다. 포트원 지급대행은 일반 PG사와 다르게 즉시(바로)지급과 자유로운 예약지급 설정으로 보다 유연한 관리가 가능합니다.
27221
+
27222
+ ### 전자세금계산서 서비스
27223
+
27224
+ 역발행과 정발행을 지원하는 전자세금계산서 서비스입니다.
27225
+ 세금계산서 발행 뿐만 아니라 히스토리 관리, 일괄(대량) 발행을 지원합니다.
27226
+
27227
+ <div class="hint" data-style="info">
27228
+
27229
+ 파트너 정산 자동화 솔루션 안에서 3가지의 서비스를 제공하고 있습니다.
27230
+
27231
+ </div>
27232
+
27233
+ ---
27234
+
27235
+ ## **공통 용어**
27236
+
27237
+ ### 고객사 / 파트너
27238
+
27239
+ 고객사는 포트원의 결제서비스를 이용하고 있는 포트원의 고객을 의미합니다.
27240
+
27241
+ 파트너는 고객사가 결제사정산 이후 하위정산을 받을 고객사의 파트너사 (하위셀러) 입니다.
27242
+
27243
+ ### 사업자 휴폐업 조회
27244
+
27245
+ 파트너의 사업자등록번호 유효성과 영업 상태를 확인하는 서비스입니다. 사업자 휴폐업 조회를 사전에 진행하여 비즈니스의 안전성과 신뢰성을 확보할 수 있습니다. 또한 미리 휴폐업을 조회하지 못해 생기는 리소스 낭비를 줄일 수 있습니다.
27246
+
27247
+ ### 영업일
27248
+
27249
+ 은행이 영업을 하는 날로, 휴일이 아닌 날입니다.
27250
+
27251
+ <div class="hint" data-style="success">
27252
+
27253
+ 예를 들어, 10일(금), 11일(토), 12(일), 13(월)이라고 할 때, 11, 12, 13일의 전 영업일은 10일이고, 10, 11, 12일의 후 영업일은 13일입니다.
27254
+
27255
+ </div>
27256
+
26760
27257
  ---
26761
27258
 
26762
- | 용어 | 설명 | 비고 |
26763
- |:--------:|:--------------------------------------------------------------------------------------------:|:-------------------------------------------------------------------------------------------------------------------:|
26764
- | 콘솔 | 포트원의 거래내역을 확인하고 파트너와 정산을 등록하고 내역을 확인 할 수 있는 솔루션입니다. | [관리자콘솔 바로가기](https://admin.portone.io) |
26765
- | 고객사 | 포트원의 결제서비스를 이용하고 있는 포트원의 고객입니다. | |
26766
- | 파트너 | 고객사가 결제사정산 이후 하위정산을 받을 고객사의 파트너사 입니다. | |
26767
- |결제사정산| 포트원의 결제 이후 결제대행사(PG) 또는 간편결제사로부터 고객사가 받는 정산 | |
26768
- |파트너정산| 결제사정산 이후에 고객사가 파트너에게 내려주는 정산 | |
26769
- | 계약 | 고객사와 파트너 사이에 정산이 이루어지기 위한 조건(중개수수료, 주기 등) | |
26770
- | 영업일 | 은행이 영업을 하는 날로, 휴일이 아닌 날 |10일(금), 11일(토), 12(일), 13(월)이라고 할 때, 11,12,13일의 전영업일은 10일이고, 10,11,12일의 후영업일은 13일입니다.|
26771
- | 달력일 | 휴일과 상관없는 단순일 | |
26772
- | 수수료 | 절차 및 중개 등 때 수수하는 금전 | |
26773
- | 부가세 |상품(재화)의 거래나 서비스(용역)의 제공과정에서 얻어지는 부가가치(이윤)에 대하여 과세하는 세금| 일반과세자는 10%의 세율이 적용함으로, 수수료가 3천원 일 경우, 부가세는 300원으로 계산 |
26774
- |할인분담금| 할인금액에 대해 고객사와 파트너가 나누어 부담하는 금액 | |
26775
- | 정률 | 수수료를 계산하는 방식으로 백분율을 곱하는 방식 | 3만원에 대해 3%의 수수료로 계약 했을 시, 수수료는 900원 |
26776
- | 정액 | 수수료를 계산하는 방식으로 고정된 금액 또는 건수에 곱하는 방식 | 판매 건당 1천원 |
27259
+ ## **정산금 계산 자동화 용어**
27260
+
27261
+ ### 계약
27262
+
27263
+ 고객사와 파트너 사이에 정산이 이루어지기 위한 조건입니다. 계약은 파트너 정산 자동화의 정산 정책 관리 페이지에서 등록할 수 있습니다. 계약 등록을 통해 플랫폼 중개 수수료를 설정하거나 부가세 분담 주체, 정산 주기 등을 설정할 수 있으며, 각 플랫폼사의 정책에 맞게 커스터마이징이 가능합니다.
27264
+
27265
+ ### 수수료
27266
+
27267
+ 절차 중개 등을 지원할 수수하는 금전입니다.
27268
+ 플랫폼사에서는 중개수수료와 추가수수료 등을 수취합니다. **중개수수료**는 플랫폼이 거래 중개 서비스에 대해 부과하는 수수료이고, **추가수수료**는 PG사 수수료, 마케팅 채널 수수료 등 특정 서비스에 대해 부과하는 수수료입니다.
27269
+
27270
+ ### 원천 징수세
27271
+
27272
+ 소득자(개인 파트너)가 자신의 세금을 직접 납부하지 않고, 원천징수 대상소득을 지급하는 원천징수 의무자(플랫폼사)가 그 금액을 미리 떼어서 대신 납부하는 세금입니다. 원천 징수세는 계약 등록에서 미리 설정할 수 있습니다.
27273
+
27274
+ ---
27275
+
27276
+ ## **지급대행 서비스 용어**
27277
+
27278
+ ### 결제사 정산
27279
+
27280
+ 포트원의 결제 이후 결제대행사(PG) 또는 간편결제사로부터 고객사가 받는 정산입니다.
27281
+
27282
+ ### 파트너 정산
27283
+
27284
+ 결제사 정산 이후에 고객사가 파트너에게 내려주는 정산입니다.
27285
+
27286
+ ### 일괄지급
27287
+
27288
+ 여러 파트너에게 동시에 정산금을 지급하는 기능으로, 한 번의 실행으로 대량 송금이 가능합니다. 정산일을 설정하고 정산할 건을 선택하여 일괄지급할 수 있습니다.
27289
+
27290
+ ### 즉시지급(바로지급)과 예약지급
27291
+
27292
+ **즉시지급**은 지급 요청 즉시 실시간으로 송금이 실행되는 지급 방식입니다.
27293
+ **예약지급**은 미래의 특정 시점에 지급이 실행되도록 예약하는 지급 방식입니다. 예약지급은 주말과 공휴일도 포함시켜 달력일로 예약할 수 있습니다.
27294
+
27295
+ <div class="hint" data-style="warning">
27296
+
27297
+ 단, 은행 점검 시간에는 지급 및 예약이 불가합니다.
27298
+
27299
+ </div>
27300
+
27301
+ ---
27302
+
27303
+ ## **세금계산서 서비스 용어**
27304
+
27305
+ ### 세금계산서 역발행
27306
+
27307
+ 세금계산서 발행 주체인 공급자(파트너)가 아니라, 공급받는자(플랫폼)가 공급자 대신 세금계산서를 작성하여 공급자에게 발행을 요청하는 기능입니다.
27308
+
27309
+ 플랫폼사가 직접 파트너에게 지급할 정산대금 정보를 작성하고, 해당 내용을 바탕으로 공급자는 이메일을 통해 검토만 하고 승인할 수 있는 구조이기 때문에 파트너와의 소통을 줄일 수 있습니다.
27310
+
27311
+ ### 발행 취소
27312
+
27313
+ 세금계산서를 국세청으로 전송하기 전까지 발행을 취소할 수 있는 기능으로, '발행 요청' 상태의 세금계산서 우측에 있는 '발행 취소' 버튼을 눌러 취소할 수 있습니다.
27314
+
27315
+ <div class="hint" data-style="warning">
27316
+
27317
+ 세금계산서 내역 관리의 **삭제** 버튼은 발행 취소와 다른 기능으로 세금계산서의 상태가 실패, 거절, 취소 등의 최종 상태일 경우에만 적용됩니다.
27318
+
27319
+ </div>
27320
+
27321
+ ### 수정 발행
27322
+
27323
+ 세금계산서가 국세청으로 전송되면 (전송 완료 상태) 수정 발행으로 취소 및 수정이 가능합니다. 단, 수정 발행 시 사유 확인이 필요합니다.
27324
+
27325
+ ### 재전송
27326
+
27327
+ 역발행 세금계산서의 승인을 요청하는 메일을 파트너에게 다시 전송하는 기능입니다.
27328
+
27329
+ ### 지연 발행
27330
+
27331
+ 세금계산서 지연 발행 상태는 재화 또는 용역을 공급한 날이 속한 달의 다음 달 10일까지 세금계산서를 발급하지 않고, 그 기간을 넘겨 발행하면 지연 발행에 해당합니다.
27332
+
27333
+ 예를 들어, 9월 16일에 재화나 용역을 제공했다면, 다음 달인 10월 10일까지 세금계산서를 발행해야 합니다. 이 기한을 넘겨 발행하면 지연 발행에 해당합니다.
27334
+
27335
+ <div class="hint" data-style="info">
27336
+
27337
+ 지연 발행 시에는 가산세가 부과됩니다.
27338
+
27339
+ - 공급자는 지연 발행 가산세로 공급가액의 1%를 부담하게 됩니다.
27340
+ - 공급받는자는 지연 수취 가산세로 공급가액의 0.5%가 부과됩니다.
27341
+
27342
+ </div>
26777
27343
 
26778
27344
 
26779
27345
  # https://developers.portone.io/platform/ko/guides/process
@@ -26787,7 +27353,7 @@ description: ''
26787
27353
 
26788
27354
  <div class="hint" data-style="etc">
26789
27355
 
26790
- 📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스 입니다.**
27356
+ 📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스입니다.**
26791
27357
 
26792
27358
  </div>
26793
27359
 
@@ -26958,7 +27524,7 @@ app.post("/webhook/taxinvoice", (req, res) => {
26958
27524
  ### 설정 요청 절차
26959
27525
 
26960
27526
  1. 웹훅 수신 URL을 준비해주세요.
26961
- 2. 기술지원 이메일(<support.b2b@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
27527
+ 2. 기술지원 이메일(<tech.support@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
26962
27528
  3. 테스트 모드 설정이 완료되었다는 회신을 받으면 테스트 모드에서 웹훅 정상 작동 여부를 확인해주세요
26963
27529
  4. 운영 환경에도 적용을 요청하신 뒤 운영 환경에서 웹훅 정상 작동 여부를 확인해주세요.
26964
27530
 
@@ -29207,78 +29773,54 @@ targetVersions:
29207
29773
  포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
29208
29774
  AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
29209
29775
 
29210
- ### 1. MCP 서버 등록하기
29776
+ 이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
29777
+ 아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
29211
29778
 
29212
- 포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
29779
+ - 채널 목록 조회
29780
+ - 테스트 채널 추가
29781
+ - 하위 상점 조회
29782
+ - 결제 내역 조회
29213
29783
 
29214
- Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
29784
+ ### DXT를 이용한 설치
29215
29785
 
29216
- ```json
29217
- {
29218
- // ...
29786
+ [DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
29219
29787
 
29220
- "mcpServers": {
29221
- // ...
29788
+ 1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
29789
+ 2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
29790
+ 3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
29222
29791
 
29223
- "portone-mcp-server": {
29224
- "command": "uvx",
29225
- "args": ["portone-mcp-server@latest"]
29226
- }
29227
- }
29228
- }
29229
- ```
29230
-
29231
- <div class="hint" data-style="info">
29232
-
29233
- 사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
29234
-
29235
- </div>
29236
-
29237
- 설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
29238
-
29239
- #### 포트원 기능 사용하기
29240
-
29241
- MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
29242
-
29243
- - 결제 내역 단건/다건 조회
29244
- - 본인인증 내역 단건/다건 조회
29245
-
29246
- 연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
29792
+ <div class="hint" data-style="warning">
29247
29793
 
29248
- ```json
29249
- {
29250
- // ...
29794
+ **Claude Desktop에서 DXT 파일 사용 시 주의사항**
29251
29795
 
29252
- "mcpServers": {
29253
- // ...
29796
+ 현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
29254
29797
 
29255
- "portone-mcp-server": {
29256
- "command": "uvx",
29257
- "args": ["portone-mcp-server@latest"],
29258
- // 아래 env 블록을 추가하여 API 시크릿을 설정합니다.
29259
- "env": {
29260
- "API_SECRET": "<YOUR_PORTONE_API_SECRET>"
29261
- }
29262
- }
29263
- }
29264
- }
29265
- ```
29798
+ 이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
29266
29799
 
29267
- <div class="hint" data-style="warning">
29800
+ </div>
29268
29801
 
29269
- **API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
29802
+ ### MCP 서버 등록하기
29270
29803
 
29271
- 내부의 인가된 인원만이 MCP 서버를 사용할 수 있도록 통제해야 합니다.
29804
+ 1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
29272
29805
 
29273
- </div>
29806
+ 2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
29274
29807
 
29275
- <div class="hint" data-style="warning">
29808
+ ```jsonc
29809
+ "mcpServers": {
29276
29810
 
29277
- **MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
29811
+ // 기존 설정
29278
29812
 
29279
- 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
29813
+ "portone-mcp-server": {
29814
+ "command": "npx",
29815
+ "args": [
29816
+ "-y",
29817
+ "@portone/mcp-server@latest"
29818
+ ]
29819
+ }
29820
+ }
29821
+ ```
29280
29822
 
29281
- </div>
29823
+ 3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
29282
29824
 
29283
29825
  <div class="hint" data-style="warning">
29284
29826
 
@@ -29289,7 +29831,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
29289
29831
 
29290
29832
  </div>
29291
29833
 
29292
- ### 2. MCP 서버 활용하기
29834
+ ### MCP 서버 활용하기
29293
29835
 
29294
29836
  사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
29295
29837
 
@@ -29534,13 +30076,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
29534
30076
 
29535
30077
  ## 주요 업데이트 사항
29536
30078
 
29537
- ### **결제 모듈 V1**✔️ 나이스페이먼츠의 새로운 결제창을 이용할 수 있습니다
30079
+ ### **결제 모듈 V1**✔️ 나이스정보통신의 새로운 결제창을 이용할 수 있습니다
29538
30080
 
29539
- 포트원을 통해 나이스페이먼츠의 새로운 결제창(이하 ‘(신) 나이스페이먼츠’)을 이용할 수 있습니다. 이번
30081
+ 포트원을 통해 나이스정보통신의 새로운 결제창(이하 ‘(신) 나이스정보통신’)을 이용할 수 있습니다. 이번
29540
30082
  업데이트를 통해 기존 모듈보다 확장된 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트
29541
30083
  호출을 지원합니다.
29542
30084
 
29543
- (신) 나이스페이먼츠에서 이용 가능한 간편결제는 다음과 같습니다.
30085
+ (신) 나이스정보통신에서 이용 가능한 간편결제는 다음과 같습니다.
29544
30086
 
29545
30087
  - 카카오페이
29546
30088
  - 네이버페이
@@ -29553,13 +30095,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
29553
30095
 
29554
30096
  이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 회수, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
29555
30097
 
29556
- (신) 나이스페이먼츠 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
30098
+ (신) 나이스정보통신 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
29557
30099
 
29558
- [→ (신)나이스페이먼츠 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
30100
+ [→ (신)나이스정보통신 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
29559
30101
 
29560
- [→ (신)나이스페이먼츠 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
30102
+ [→ (신)나이스정보통신 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
29561
30103
 
29562
- 기존에 나이스페이먼츠를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
30104
+ 기존에 나이스정보통신를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
29563
30105
  이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이
29564
30106
  안내드리겠습니다.
29565
30107
 
@@ -29614,7 +30156,7 @@ KCP 인증결제창에서 할인쿠폰 적용 여부를 컨트롤 할수 있는
29614
30156
  할인쿠폰기능을 사용하기 위해서는 KCP와 협의가 먼저 선행되어야 하는점 유의하세요
29615
30157
 
29616
30158
  본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
29617
- [→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
30159
+ [→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
29618
30160
 
29619
30161
 
29620
30162
  # https://developers.portone.io/release-notes/api-sdk/2023-08-31
@@ -29637,7 +30179,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
29637
30179
  선택할수 있도록 하였습니다.
29638
30180
 
29639
30181
  본 기능 설정을 위한 자세한 내용은 SDK 가이드 문서를 확인 해주세요
29640
- [→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/docs/ko/pg/payment-gateway/nhn-kcp#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
30182
+ [→ KCP SDK 연동가이드 확인하기](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme#4-%EA%B8%B0%ED%83%80-%ED%8C%8C%EB%9D%BC%EB%AF%B8%ED%84%B0)
29641
30183
 
29642
30184
  ### **결제 모듈 V1**✔️ 결제 URL 생성 API 지원 PG사 확대
29643
30185
 
@@ -29647,7 +30189,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
29647
30189
  - (신)스마트로
29648
30190
  - KSNET
29649
30191
  - (신)페이팔 일반결제/정기결제
29650
- - (신)나이스페이먼츠
30192
+ - (신)나이스정보통신
29651
30193
 
29652
30194
 
29653
30195
  # https://developers.portone.io/release-notes/api-sdk/2023-12-15
@@ -29675,11 +30217,11 @@ writtenAt: 2024-01-08T00:00:00.000Z
29675
30217
 
29676
30218
  ## 주요 업데이트 사항
29677
30219
 
29678
- ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스페이먼츠 결제를 지원합니다.
30220
+ ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스정보통신 결제를 지원합니다.
29679
30221
 
29680
- 이제 포트원 V2를 통해 나이스페이먼츠 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
30222
+ 이제 포트원 V2를 통해 나이스정보통신 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
29681
30223
 
29682
- 나이스페이먼츠에서 지원하는 결제수단 아래와 같습니다.
30224
+ 나이스정보통신에서 지원하는 결제수단 아래와 같습니다.
29683
30225
 
29684
30226
  - 카드
29685
30227
 
@@ -29703,7 +30245,7 @@ writtenAt: 2024-01-08T00:00:00.000Z
29703
30245
 
29704
30246
  이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
29705
30247
 
29706
- 나이스페이먼츠 연동에 대해 자세히 알고 싶다면 [→ 나이스페이먼츠 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.
30248
+ 나이스정보통신 연동에 대해 자세히 알고 싶다면 [→ 나이스정보통신 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.
29707
30249
 
29708
30250
 
29709
30251
  # https://developers.portone.io/release-notes/api-sdk/2024-01-11
@@ -30083,7 +30625,7 @@ writtenAt: 2024-06-03T00:00:00.000Z
30083
30625
 
30084
30626
  **지원 결제대행사**
30085
30627
 
30086
- - 나이스페이먼츠
30628
+ - 나이스정보통신
30087
30629
  - KG이니시스
30088
30630
  - 토스페이먼츠
30089
30631
  - 스마트로
@@ -30291,7 +30833,6 @@ writtenAt: 2024-09-05T00:00:00.000Z
30291
30833
  - 토스
30292
30834
  - 카카오
30293
30835
  - 네이버
30294
- - 페이코
30295
30836
  - 금융결제원
30296
30837
  - KB국민은행
30297
30838
  - 신한은행
@@ -30328,7 +30869,7 @@ PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는
30328
30869
 
30329
30870
  ### **PG 거래대사**✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
30330
30871
 
30331
- 기존에 12개 PG사 (KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
30872
+ 기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
30332
30873
  토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN, 하이픈까지 확장하여
30333
30874
  총 15개 PG사 데이터에 한하여 제공됩니다.
30334
30875
 
@@ -30782,6 +31323,57 @@ writtenAt: 2024-09-05T00:00:00.000Z
30782
31323
  - 좌측 메뉴 영역 상단의 \[계정 정보]를 클릭한 후 \[로그아웃]을 클릭해 주세요.
30783
31324
 
30784
31325
 
31326
+ # https://developers.portone.io/release-notes/console/2025-10-17
31327
+
31328
+ ---
31329
+ releasedAt: 2025-10-17T00:00:00.000Z
31330
+ writtenAt: 2025-10-17T00:00:00.000Z
31331
+ ---
31332
+
31333
+ ## 콘솔 일부 설정 업데이트 안내
31334
+
31335
+ 안녕하세요, 포트원 입니다.
31336
+
31337
+ 더욱 쾌적하고 편리한 서비스 이용을 위해, 콘솔 내의 일부 디자인 시스템이 변경되어 안내해 드립니다.
31338
+
31339
+ ---
31340
+
31341
+ ## 관리자 콘솔
31342
+
31343
+ ### 표설정 기능 업데이트
31344
+
31345
+ 기존에는 콘솔에서 확인할 수 있는 다양한 표 내부 컬럼의 순서를 변경할 수 없었습니다. 하지만 이번 업데이트를 통해 표설정 기능을 추가하여 드래그 방식으로 손쉽게 내부 컬럼의 순서를 변경하고, 유지할 수 있습니다. 표설정 기능을 활용하여 더 중요한 정보들을 앞으로 가져오는 등의 편리한 커스터마이징이 가능합니다.
31346
+
31347
+ 파트너 정산 서비스 뿐만 아니라 포트원 전자결제를 함께 이용중이라면, 전자결제 서비스의 표 설정 또한 브라우저에 저장될 수 있습니다.
31348
+
31349
+ (이미지 첨부: 표 순서 변경 기능)
31350
+
31351
+ ## 파트너 정산
31352
+
31353
+ ### 보관함 설정 업데이트
31354
+
31355
+ 기존 정산 정책 관리 및 파트너 관리 페이지에서 보관함 보기 토글을 이용하여 보관함을 조회한 후, 페이지를 새로고침하면 보관함이 아닌 일반 정책 목록이 조회되는 현상이 발생했습니다. 업데이트 후에는 보관함 보기 상태로 새로고침을 해도 해당 상태가 풀리지 않고 유지되어 사용 편의성이 높아집니다.
31356
+
31357
+ ### 파트너 관리 UI 업데이트
31358
+
31359
+ 기존 파트너 관리 페이지의 계약 일괄 변경 페이지에서는 변경할 신규 계약과 정산 시작일 기준 적용 시점만을 선택해야 했고, 계약 아이디로만 계약을 관리했기 때문에 실제 계약 정보 확인 없이 작업을 진행해야 하는 불편함이 있었습니다.
31360
+
31361
+ 이제부터는 계약 이름으로 변경할 계약 정보를 직접 검색 및 조회할 수 있게 됩니다. 계약을 선택하면 중개 수수료율, 정산 보류일, 정산 주기와 같은 주요 정산 정보를 즉시 확인할 수 있어 더 정확한 계약 변경이 가능해집니다. 아울러, 정산 시작일 기준 적용 시점을 선택할 때 사용되는 달력 UI도 직관적으로 변경되어 적용 시점 설정이 더욱 쉬워졌습니다.
31362
+
31363
+ (이미지 첨부: 파트너 관리 UI 업데이트)
31364
+
31365
+ ### 콘솔 표 설정 업데이트
31366
+
31367
+ 정산 상세 조회, 정산 내역 관리, 일괄 지급 내역 관리, 지급 내역 관리, 이체 내역 관리, 일괄 이체 내역 관리, 세금계산서 작성 목록, 세금계산서 내역 관리, 일괄 세금계산서 내역 관리 페이지의 표 설정이 일괄 변경됩니다. 이제 해당 페이지들에서 표(테이블)의 필터 값을 설정한 후 페이지를 새로고침하더라도, 설정했던 필터 값이 초기화되지 않고 그대로 유지됩니다. 따라서 반복적으로 필터를 재설정할 필요 없이 더 빠르고 효율적으로 데이터를 조회할 수 있습니다.
31368
+
31369
+ ---
31370
+
31371
+ 작성일자: **2025년 10월 17일**
31372
+
31373
+ - 일반 문의: <cs@portone.io> / 채널톡
31374
+ - 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
31375
+
31376
+
30785
31377
  # https://developers.portone.io/release-notes/platform/2023-08-31
30786
31378
 
30787
31379
  ---
@@ -31990,7 +32582,7 @@ writtenAt: 2025-03-17T00:00:00.000Z
31990
32582
  - 기존 파트너정산자동화 제품을 이용하고 계신 고객이더라도, 세금계산서 역발행 기능 사용을 위해서는 별도 문의가 필요합니다.
31991
32583
 
31992
32584
  - 세금계산서 상태변화 웹훅 및 사업자번호 기업정보조회 API 연동이 필요하신 고객사는
31993
- [📩 support.b2b@portone.io](mailto:support.b2b@portone.io)로 문의해 주세요.
32585
+ [📩 tech.support@portone.io](mailto:tech.support@portone.io)로 문의해 주세요.
31994
32586
 
31995
32587
  포트원의 전체 업데이트 소식은 [개발자센터 릴리즈노트](https://developers.portone.io/release-notes) 페이지에서 확인할 수 있습니다.
31996
32588
 
@@ -32431,7 +33023,465 @@ writtenAt: 2025-07-07T00:00:00.000Z
32431
33023
 
32432
33024
  일반 문의 <cs@portone.io> / 채널톡
32433
33025
 
32434
- 기술지원 문의 <support@portone.io> / 파트너스 슬랙 채널
33026
+ 기술지원 문의 <tech.support@portone.io> / 파트너스 슬랙 채널
33027
+
33028
+
33029
+ # https://developers.portone.io/release-notes/platform/2025-07-23
33030
+
33031
+ ---
33032
+ releasedAt: 2025-07-23T00:00:00.000Z
33033
+ writtenAt: 2025-07-23T00:00:00.000Z
33034
+ ---
33035
+
33036
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
33037
+
33038
+ 2025년 7월 23일 업데이트 사항을 확인해 보세요.
33039
+
33040
+ |**업데이트 항목** |**변경 전** |**변경 후** |
33041
+ |:---------------------------------------|:---------------------------------------------------------|:-------------------------------------------------------|
33042
+ |**세금계산서 API 출시** |세금계산서 기능을 콘솔에서만 이용 |**API 제공으로 시스템 연동 및 자동화 가능** |
33043
+ |**세금계산서 정발행 기능 (API) 추가** |역발행만 가능 |**정발행 및 역발행 모두 지원 (API)** |
33044
+ |**정산 정책 관리 사용성 개선** |정책 수정사항 확인 불가 |**정책 수정 히스토리 조회 가능** |
33045
+ |**정산 상세 조회 내 필터 개선** |수기 정산 건 조회 어려움<br />새로고침 시 필터 조건 초기화|**정산일 기준으로 조회<br />새로고침 시 필터 조건 유지**|
33046
+ |**파트너 정산 자동화 제품 UI 색상 변경**|오렌지 컬러 |**블루 컬러** |
33047
+
33048
+ ## API 출시 안내
33049
+
33050
+ ## 세금계산서 API 출시
33051
+
33052
+ 이제 파트너정산 세금계산서 기능을 **콘솔이 아닌 API**로도 이용하실 수 있습니다.
33053
+
33054
+ API를 활용하면 각 기업의 자체 서비스, 백오피스, 외부 시스템과의 연동을 통해 세금계산서 발행, 조회, 관리 등 다양한 업무를 **완전 자동화**할 수 있어, 반복적인 수기 업무의 부담을 크게 줄이고 효율적인 업무 처리가 가능합니다.
33055
+
33056
+ ## 세금계산서 정발행 기능 (API) 추가
33057
+
33058
+ 기존에는 ‘역발행’만 지원하였으나, 이번 업데이트로 **‘정발행’** 기능이 API에도 포함되었습니다.
33059
+
33060
+ 기업간 거래 상황에 따라 어떤 발행 방식이든, 이제는 포트원 하나로 발행 및 관리가 모두 가능해집니다.
33061
+ 정발행 기능의 콘솔 지원도 2025년 3분기 내 업데이트 예정이니 많은 기대 부탁드립니다.
33062
+
33063
+ **기술 변경 사항 안내**
33064
+ 신규 세금계산서 API 카테고리 및 상세 문서가 [**개발자센터**](https://developers.portone.io/api/rest-v2/b2b.taxInvoice?v=v2) 에 추가되었습니다.
33065
+ 기존 콘솔 UI 기반의 역발행 외에, 정발행 기능이 API로 제공됩니다.
33066
+ 연동 개발 시 개발자센터의 세금계산서 관련 문서를 참고해주시기 바랍니다.
33067
+
33068
+ ---
33069
+
33070
+ ## 파트너 정산 자동화 제품 개선 안내
33071
+
33072
+ ### 정산 정책 관리 사용성 개선
33073
+
33074
+ 정산 정책 관리 페이지의 사용성이 개선되었습니다.
33075
+
33076
+ - 페이지 사용성 개선
33077
+
33078
+ 계약 등록 및 상세 조회, 할인 분담 정책 등록 및 상세 조회, 추가 수수료 정책 등록 및 상세 조회 등 정산 정책 관리 내의 다양한 페이지의 사용성이 개선되었습니다.
33079
+
33080
+ - 계약 내용 수정 이력 조회 기능 추가
33081
+
33082
+ 계약 관리 페이지에서 계약 내용 수정 시, 수정 사항을 확인할 수 있는 히스토리 조회 기능이 추가되었습니다.\
33083
+ 이제 계약 상세 페이지에서 변경 이력을 확인할 수 있어 더 효율적이고 투명한 계약 관리가 가능합니다.
33084
+
33085
+ (관련 이미지 첨부)
33086
+
33087
+ ### 정산 상세 조회 내 필터 개선
33088
+
33089
+ 정산 상세 조회 페이지에서 더욱 편리하게 정산 내역을 확인하실 수 있도록 필터 기능이 개선되었습니다.
33090
+
33091
+ - 기본 조회 기준 변경
33092
+
33093
+ 정산 건 조회 시 기본 조회 기준이 기존 '정산 기준일'에서 '정산일'로 변경되었습니다.
33094
+ 정산 시작일이 설정되지 않은 수기 정산 건도 쉽게 조회할 수 있습니다.
33095
+
33096
+ - 기본 조회 기간 확대
33097
+ 기존 30일 → 90일로 확대되어 더 넓은 범위의 데이터를 한 번에 확인하실 수 있습니다.
33098
+
33099
+ - 필터 조건 유지 및 버그 수정
33100
+
33101
+ 정산 건을 검색할 때 미리 지정한 필터값이 해제되던 버그가 수정되었으며,
33102
+ 이제 페이지를 새로 고침 시에도 이전에 설정한 필터 조건이 그대로 유지됩니다.
33103
+
33104
+ (관련 이미지 첨부)
33105
+
33106
+ ### 파트너 정산 자동화 제품 사용자 인터페이스 색상 변경
33107
+
33108
+ 파트너 정산 자동화 제품의 전반적인 사용자 인터페이스 색상이 기존 오렌지에서 블루로 변경되었습니다.
33109
+
33110
+ ---
33111
+
33112
+ 작성일자: **2025년 07월 23일**
33113
+
33114
+ - 일반 문의: <cs@portone.io> / 채널톡
33115
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
33116
+
33117
+
33118
+ # https://developers.portone.io/release-notes/platform/2025-08-13
33119
+
33120
+ ---
33121
+ releasedAt: 2025-08-13T00:00:00.000Z
33122
+ writtenAt: 2025-08-13T00:00:00.000Z
33123
+ ---
33124
+
33125
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
33126
+
33127
+ 2025년 8월 13일 업데이트 사항을 확인해 보세요.
33128
+
33129
+ ---
33130
+
33131
+ ## 정산 내역서 발송 기능 업데이트
33132
+
33133
+ 이제, 파트너 정산 콘솔에서 생성된 정산 내역을 기반으로, 파트너에게 정산 내역서를 보낼 수 있습니다.
33134
+
33135
+ 일괄지급 내역 상세 및 지급 내역 관리 페이지에서 원하는 정산 내역을 단건, 혹은 다건으로 선택하여 한 번에 정산내역서 이메일을 발송할 수 있습니다.
33136
+
33137
+ **발신자/수신자 설정**: 발신자 이메일 설정은 필수이며, 도메인 인증을 통해 도메인을 활용한 발신이 가능합니다. 인증 완료된 도메인이 없는 경우, 기본 메일 <no-reply@portone.io>로 정산내역서를 발송할 수 있습니다.
33138
+
33139
+ 수신자 이메일은 등록해 둔 파트너의 담당자 이메일로 지정되고, 담당자 이메일을 수정하는 것으로 수신자 이메일을 수정할 수 있습니다. 모든 설정을 완료하고, '정산내역서 발송' 버튼을 클릭하면 선택된 지급 내역의 파트너 전체에게 이메일이 차례대로 발송됩니다.
33140
+
33141
+ (관련 이미지 첨부)
33142
+
33143
+ ---
33144
+
33145
+ ## 정산 내역서 템플릿 생성 및 수정
33146
+
33147
+ 정산 내역서 템플릿을 자유롭게 생성하고, 수정할 수 있습니다.
33148
+
33149
+ 정산내역서 템플릿 관리 페이지에서 템플릿을 다양하게 만들어 관리할 수 있습니다. 지급 내역 생성 여부와 관계없이 템플릿을 생성할 수 있으며, 템플릿 목록 조회, 신규 생성 및 수정, 보관, 복원이 가능합니다. 템플릿 구성 항목의 포함 여부(on/off)를 관리할 수 있고, 구성 항목은 다음과 같습니다.
33150
+
33151
+ (관련 이미지 첨부)
33152
+
33153
+ **발신자 정보**
33154
+
33155
+ - 우리 회사 상호
33156
+
33157
+ **수신자(파트너) 정보**
33158
+
33159
+ - 파트너 이름 및 법인명
33160
+ - 파트너 유형
33161
+ - 과세, 소득 유형
33162
+ - 예금주명
33163
+ - 은행정보 (계좌번호 및 은행명)
33164
+
33165
+ **정산 기본 정보**
33166
+
33167
+ - 정산 기간
33168
+
33169
+ **정산 금액 정보**
33170
+
33171
+ - 지급 금액 (필수값)
33172
+ - 원천징수세액 (소득세, 지방 소득세)
33173
+ - 정산 금액
33174
+ - 확정 공급가액
33175
+ - 확정 부가세액
33176
+ - 정산 면세액
33177
+ - 확정 면세액
33178
+
33179
+ ---
33180
+
33181
+ ## 지급 내역에서 정산 내역서의 상태를 확인
33182
+
33183
+ 지급 내역 페이지에서 정산 내역서 상태 컬럼이 추가되어 발송 상태를 확인할 수 있습니다.
33184
+
33185
+ 지급 내역 페이지에 `정산내역서 상태`, `정산내역서 ID`, `정산내역서 발송 일시` 컬럼이 추가됩니다. 정산 내역서의 상태는 정산내역서가 아직 생성 및 발송되지 않은 상태인 **미발송**, 이메일이 수신자에게 성공적으로 전달된 **발송 완료**, 이메일 발송을 시도했으나, 주소 오류 등의 이유로 실패한 상태인 **발송 실패** 총 3개의 상태가 존재합니다.
33186
+
33187
+ (관련 이미지 첨부)
33188
+
33189
+ ---
33190
+
33191
+ ## API 변경 안내
33192
+
33193
+ 지급내역 `PlatformPayout` 에 정산내역서 요약 정보가 추가되었고, 지급내역 다건 조회 시 정산내역서 정보를 기준으로 필터링할 수 있습니다.
33194
+
33195
+ **지급 내역** `PlatformPayout` **필드 추가**
33196
+
33197
+ 신규 필드: `settlementStatement`: `PlatformPayoutSettlementStatementSummary`
33198
+
33199
+ - `id` – 정산내역서 아이디
33200
+ - `status` – 정산내역서 상태
33201
+ - `issuedAt` – 정산내역서 발송 일시
33202
+
33203
+ **지급 내역 필터** `PlatformPayoutFilterInput` **옵션 추가**
33204
+
33205
+ - `settlementStatementStatuses`: 정산내역서 상태
33206
+ - `criteria.settlementStatementIssuedTimestampRange`: 정산내역서 발송 일시 범위
33207
+ - `criteria.settlementStatementId`: 정산내역서 아이디
33208
+
33209
+ ---
33210
+
33211
+ 작성일자: **2025년 08월 13일**
33212
+
33213
+ - 일반 문의: <cs@portone.io> / 채널톡
33214
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
33215
+
33216
+
33217
+ # https://developers.portone.io/release-notes/platform/2025-08-21
33218
+
33219
+ ---
33220
+ releasedAt: 2025-08-21T00:00:00.000Z
33221
+ writtenAt: 2025-08-21T00:00:00.000Z
33222
+ ---
33223
+
33224
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
33225
+
33226
+ 2025년 8월 21일 업데이트 사항을 확인해 보세요.
33227
+
33228
+ ---
33229
+
33230
+ ## 세금계산서 정발행 기능 출시
33231
+
33232
+ 고객에게 발행하는 정발행 세금계산서를 발행하고 관리할 수 있습니다.
33233
+
33234
+ 이제, 역발행 뿐 아니라 정발행 기능을 콘솔에서 사용할 수 있습니다. 단건 발행 및 일괄 발행으로 정발행 세금계산서를 발행할 수 있게 되어 정산뿐만 아니라 모든 거래에 대한 세금계산서 커버가 가능해집니다.
33235
+
33236
+ 기존 역발행과 다르게 정발행은 파트너 등록 및 <strong>국세청 연동 없이</strong> 이용할 수 있으며, 파트너 등록을 하지 않더라도 정발행시 입력한 공급받는 자(거래처) 정보를 다시 불러와 사용할 수 있습니다.
33237
+
33238
+ (관련 이미지 첨부)
33239
+
33240
+ ---
33241
+
33242
+ ## 엑셀, CSV 일괄 정/역발행
33243
+
33244
+ 기존 일괄 세금계산서 발행은 CSV 파일만 지원되었지만, 이번 업데이트를 통해 엑셀 파일 업로드도 가능해집니다. 제공되는 엑셀 및 CSV 파일 양식을 다운로드 받아 일괄적으로 세금계산서를 작성하여 업로드할 수 있습니다. 기존 역발행과 동일하게 미리보기 후 임시 저장하거나 즉시 발행할 수 있습니다.
33245
+
33246
+ (관련 이미지 첨부)
33247
+
33248
+ ---
33249
+
33250
+ ## 세금계산서 내역 관리
33251
+
33252
+ 기존 역발행 건과 정발행 건의 자연스러운 통합을 위해 세금계산서 내역 관리 페이지에 발행 유형 필터가 추가됩니다. 세금계산서 내역 테이블 내 사업자 정보 컬럼이 기존 공급자 정보에서 거래처(공급자/공급받는자) 정보로 변경되어 역발행의 경우 공급자, 정발행의 경우 공급받는자 정보가 표기됩니다.
33253
+
33254
+ 일괄 세금계산서 내역 관리 페이지에서 발행 대기 상태와 발행 실패 상태가 추가됩니다. 발행 대기 상태는 일괄 세금계산서 발행 처리 중 상태를 의미하며 발행 실패 상태는 시스템 처리 실패를 의미합니다. 또한 정발행과 역발행을 구분하는 발행 유형 정보 및 필터가 추가됩니다.
33255
+
33256
+ (관련 이미지 첨부)
33257
+
33258
+ ---
33259
+
33260
+ ## 세금계산서 안내 메일 발송
33261
+
33262
+ 공급받는 자에게 이메일이 발송됩니다.
33263
+
33264
+ 세금계산서를 발행하는 시점에 공급받는자 (고객) 에게 팝빌 (포트원과 연동된 세금계산서 서비스) 로부터 이메일이 발송됩니다. 공급자는 발행 주체이므로, 별도의 알림 이메일은 발송되지 않습니다.
33265
+
33266
+ ---
33267
+
33268
+ 작성일자: **2025년 08월 21일**
33269
+
33270
+ - 일반 문의: <cs@portone.io> / 채널톡
33271
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
33272
+
33273
+
33274
+ # https://developers.portone.io/release-notes/platform/2025-08-28
33275
+
33276
+ ---
33277
+ releasedAt: 2025-08-28T00:00:00.000Z
33278
+ writtenAt: 2025-08-28T00:00:00.000Z
33279
+ ---
33280
+
33281
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
33282
+
33283
+ 2025년 8월 28일 업데이트 사항을 확인해 보세요.
33284
+
33285
+ ---
33286
+
33287
+ ## 2단계 인증수단
33288
+
33289
+ ### 2단계 인증수단이란?
33290
+
33291
+ 관리자 계정 접근 및 이체 실행 시, 공동 인증서 외에 다른 방식의 인증 절차를 요구하여 보안을 유지하는 방식입니다. 포트원은 2단계 인증 수단으로 Google Authenticator (Google OTP) 를 사용합니다. 파트너 정산을 이용하시는 고객님의 빠르고 편리한 이체를 돕기 위해 관리자 콘솔에서 2단계 인증 수단을 이용할 수 있습니다.
33292
+
33293
+ ---
33294
+
33295
+ ## 이체 시 2단계 인증수단 업데이트
33296
+
33297
+ ### 공동인증서 없이 2단계 인증수단 (OTP) 을 이용하여 쉽게 이체하세요.
33298
+
33299
+ 이제, 공동인증서 없이 콘솔에서 2단계 인증수단을 이용하여 손쉽게 이체를 진행할 수 있습니다. 설정의 내 정보 관리탭에서 2차인증을 눌러 Google Authenticator 를 등록하여 2단계 인증 수단으로 설정할 수 있습니다. 등록이 완료되면 송금대행 일괄이체 실행 페이지의 최종 단계에서 전자서명 대신 2단계 인증번호를 입력할 수 있는 다이얼로그가 노출됩니다.
33300
+
33301
+ (이미지 첨부: 2단계 인증번호 입력 화면)
33302
+
33303
+ ---
33304
+
33305
+ ## 보안 관련 사항
33306
+
33307
+ ### 2단계 인증수단 신청 방식
33308
+
33309
+ 공동인증서 대신 2단계 인증수단 등록을 위해서는 포트원 세일즈/CS 팀으로 요청하셔야하며, <bd@portone.io> 를 통해 요청하실 수 있습니다. 요청이 완료되었더라도, 2단계 인증 설정이 완료된 Admin 계정의 유저만 사용이 가능합니다.
33310
+
33311
+ 또한, 강력한 보안 조치를 위해 포트원 관리자 콘솔 세션 접근 시 인증을 진행하였더라도, 이체 시에 2단계 인증 수단을 통한 재인증이 요구됩니다.
33312
+
33313
+ ---
33314
+
33315
+ ## 가상계좌 과출금 방지 기능 업데이트
33316
+
33317
+ ### 권장 출금 금액보다 많은 금액을 인출할 때 과출금 방지 경고를 받습니다.
33318
+
33319
+ 실시간으로 안전한 출금을 지원하고, 과출금 리스크를 방지하기 위해 과출금 방지 기능이 업데이트 되었습니다. 권장 출금 금액 (계좌 잔액 - 예상 지급 금액) 을 자동 계산하여, 권장 출금 금액보다 많은 금액을 출금하려고 할 때 과출금 방지 경고를 받을 수 있습니다. 예상 지급 금액은 정산내역과 지급내역을 통해 계산되며, 가상계좌 출금 페이지에서 예상 지급 금액 정보를 바로 확인할 수 있습니다.
33320
+
33321
+ (이미지 첨부: 과출금 방지 화면)
33322
+
33323
+ ---
33324
+
33325
+ 작성일자: **2025년 08월 28일**
33326
+
33327
+ - 일반 문의: <cs@portone.io> / 채널톡
33328
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
33329
+
33330
+
33331
+ # https://developers.portone.io/release-notes/platform/2025-10-02
33332
+
33333
+ ---
33334
+ releasedAt: 2025-10-02T00:00:00.000Z
33335
+ writtenAt: 2025-10-02T00:00:00.000Z
33336
+ ---
33337
+
33338
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
33339
+
33340
+ 파트너 정산 자동화 제품의 테스트 환경 확장에 따른 API 변경 사항을 안내드립니다.
33341
+
33342
+ ---
33343
+
33344
+ ## \[파트너 정산 자동화] 테스트 환경 분리 및 API 변경 사전 안내
33345
+
33346
+ 이번 업데이트로 운영 환경과 테스트 환경이 완전히 분리되어, 설정·정산 정책·내역서 템플릿 등을 독립적으로 관리하실 수 있습니다.
33347
+
33348
+ ## 주요 변경 사항
33349
+
33350
+ - 신규 쿼리 파라미터: test: Boolean (선택값)
33351
+
33352
+ - 적용 대상: 모든 파트너 정산 REST API
33353
+
33354
+ - 적용 예정 일자: 2025년 11월 중 (정확한 일자는 추후 별도 안내 예정)
33355
+
33356
+ - 기본값: false
33357
+
33358
+ - 연동 환경 별 설정
33359
+ - 라이브: 하위호환성이 보장되어 영향이 없습니다.
33360
+ - 테스트: test=true 쿼리 파라미터 추가 설정이 필요합니다.
33361
+
33362
+ (이미지 첨부: as is - to be)
33363
+
33364
+ 이번 변경으로 라이브/테스트 환경이 완전히 분리되어 더욱 자유로운 테스트가 가능해집니다.\
33365
+ _기존 데이터는 테스트 및 라이브 환경에 복제되어 기존 그대로 활용하실 수 있습니다._
33366
+
33367
+ ---
33368
+
33369
+ ## 개선 사항
33370
+
33371
+ ### 1. 정산 정책 및 수식 테스트 환경 분리
33372
+
33373
+ 기존에는 정산 정책 및 정산 수식을 변경할 때 별도의 테스트 환경이 없어 운영에 영향을 줄 우려가 있었습니다.\
33374
+ 이번 개선으로 라이브 환경과 완전히 분리된 테스트 환경을 제공하여, 정산 정책 및 수식을 실제 운영에 영향 없이 안전하게 테스트할 수 있습니다.
33375
+
33376
+ ### 2. 파트너 데이터 환경 분리
33377
+
33378
+ 테스트를 위해 등록한 파트너가 라이브 데이터에 그대로 남아 실제 파트너와 함께 조회되는 불편함이 있었습니다.\
33379
+ 테스트용 파트너는 테스트 환경에 별도로 등록하여, 실제 파트너 데이터와 분리하여 관리할 수 있습니다.
33380
+
33381
+ ### 3. 국세청 연동 환경 분리
33382
+
33383
+ 국세청 연동 시 라이브와 테스트 환경에 동시에 연동되어 불필요한 연동 안내 메일을 중복으로 받는 문제가 있었습니다.\
33384
+ 환경별로 독립적인 국세청 연동이 가능해져 필요한 환경에서만 선택적으로 연동할 수 있습니다.
33385
+
33386
+ ---
33387
+
33388
+ ## 세부 변경 사항
33389
+
33390
+ ### 1. 기존 요청 본문에서 테스트 환경 구분이 가능한 API
33391
+
33392
+ 요청 본문(body)의 `isForTest` 파라미터로 환경을 지정하던 방식은 deprecated 되었습니다.\
33393
+ 쿼리 파라미터 `test`로 대체 해 주시기 바랍니다. deprecated 필드는 2026년 이후 별도 공지와 함께 지원이 중단될 예정입니다.
33394
+
33395
+ ```http
33396
+ #Query Parameter가 우선 적용
33397
+ POST /platform/transfers/order?test=true
33398
+ {
33399
+ "isForTest": false, // 무시됨, Query Parameter의 true가 적용
33400
+ ...
33401
+ }
33402
+
33403
+ #Query Parameter 가 없으면 Request Body 값 사용
33404
+ POST /platform/transfers/order
33405
+ {
33406
+ "isForTest": true, // 이 값이 적용
33407
+ ...
33408
+ }
33409
+ ```
33410
+
33411
+ 우선순위는 아래와 같습니다.
33412
+
33413
+ 1. Query Parameter 의미 `test` (최우선)
33414
+ 2. Request Body 의 `isForTest` (Query Parameter 없을 때)
33415
+ 3. 기본값 `false` (둘 다 없을 때)
33416
+
33417
+ 영향 받는 API는 다음과 같습니다.
33418
+
33419
+ - 정산 상세 내역 다운로드 `GET /platform/transfer-summaries/sheet-file`
33420
+ - 정산건 다건 조회 `GET /platform/transfer-summaries`
33421
+ - 수기 정산건 생성 `POST /platform/transfers/manual`
33422
+ - 주문 정산건 생성 `POST /platform/transfers/order`
33423
+ - 주문 취소 정산건 생성 `POST /platform/transfers/order-cancel`
33424
+ - 정산 내역 다건 조회 `GET /platform/partner-settlements`
33425
+ - 지급 내역 다건 조회 `GET /platform/payouts`
33426
+ - 일괄 지급 내역 다건 조회 `GET /platform/bulk-payouts`
33427
+ - 이체 내역 다건 조회 `GET /platform/account-transfers`
33428
+ - 일괄 이체 내역 다건 조회 `GET /platform/bulk-account-transfers`
33429
+
33430
+ ### 2. 테스트 환경 지정이 필요한 API
33431
+
33432
+ 테스트 환경 지정을 위해 쿼리 파라미터 `test`가 추가되었습니다.\
33433
+ 해당 파라미터는 선택 값이며 기본값은 `false`입니다.
33434
+
33435
+ ```http
33436
+ #라이브 환경 데이터만 조회 (기본값)
33437
+ GET /platform/transfers/{id}
33438
+
33439
+ #테스트 환경 데이터만 조회
33440
+ GET /platform/transfers/{id}?test=true
33441
+ ```
33442
+
33443
+ 영향 받는 API는 다음과 같습니다.
33444
+
33445
+ - 정산건 조회 `GET /platform/transfers/{id}`
33446
+ - 정산건 삭제 `DELETE /platform/transfers/{id}`
33447
+ - 추가 수수료 정책 다건 조회 `GET /platform/additional-fee-policies`
33448
+ - 추가 수수료 정책 생성 `POST /platform/additional-fee-policies`
33449
+ - 추가 수수료 정책 조회 `GET /platform/additional-fee-policies/{id}`
33450
+ - 추가 수수료 정책 수정 `PATCH /platform/additional-fee-policies/{id}`
33451
+ - 추가 수수료 정책 보관 `POST /platform/additional-fee-policies/{id}/archive`
33452
+ - 추가 수수료 정책 복원 `POST /platform/additional-fee-policies/{id}/recover`
33453
+ - 계약 다건 조회 `GET /platform/contracts`
33454
+ - 계약 생성 `POST /platform/contracts`
33455
+ - 계약 조회 `GET /platform/contracts/{id}`
33456
+ - 계약 수정 `PATCH /platform/contracts/{id}`
33457
+ - 계약 보관 `POST /platform/contracts/{id}/archive`
33458
+ - 계약 복원 `POST /platform/contracts/{id}/recover`
33459
+ - 할인 분담 정책 다건 조회 `GET /platform/discount-share-policies`
33460
+ - 할인 분담 정책 생성 `POST /platform/discount-share-policies`
33461
+ - 할인 분담 정책 조회 `GET /platform/discount-share-policies/{id}`
33462
+ - 할인 분담 정책 수정 `PATCH /platform/discount-share-policies/{id}`
33463
+ - 할인 분담 정책 보관 `POST /platform/discount-share-policies/{id}/archive`
33464
+ - 할인 분담 정책 복원 `POST /platform/discount-share-policies/{id}/recover`
33465
+ - 파트너 다건 조회 `GET /platform/partners`
33466
+ - 파트너 생성 `POST /platform/partners`
33467
+ - 파트너 다건 생성 `POST /platform/partners/batch`
33468
+ - 파트너 일괄 국세청 연동 `POST /platform/partners/member-company-connect`
33469
+ - 파트너 국세청 연동 `POST /platform/partners/member-company-connect/{id}`
33470
+ - 파트너 일괄 국세청 연동 해제 `POST /platform/partners/member-company-disconnect`
33471
+ - 파트너 국세청 연동 해제 `POST /platform/partners/member-company-disconnect/{id}`
33472
+ - 파트너 조회 `GET /platform/partners/{id}`
33473
+ - 파트너 수정 `PATCH /platform/partners/{id}`
33474
+ - 파트너 보관 `POST /platform/partners/{id}/archive`
33475
+ - 파트너 복원 `POST /platform/partners/{id}/recover`
33476
+ - 예금주 조회 `GET /platform/bank-accounts/{bank}/{accountNumber}/holder`
33477
+ - 사업자 조회 `GET /platform/companies/{businessRegistrationNumber}/state`
33478
+
33479
+ ---
33480
+
33481
+ 작성일자: **2025년 10월 02일**
33482
+
33483
+ - 일반 문의: <cs@portone.io> / 채널톡
33484
+ - 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
32435
33485
 
32436
33486
 
32437
33487
  # https://developers.portone.io/blog/posts/2024-02/v2-oom