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

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 (268) 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/help/admin-console/analytics/content32.md +4 -4
  6. package/assets/docs/help/admin-console/payment-service/content29.md +223 -110
  7. package/assets/docs/help/admin-console/pg-settlement/content30.md +103 -208
  8. package/assets/docs/help/admin-console/pg-settlement-history/content35.md +167 -0
  9. package/assets/docs/help/admin-console/platform-settlement/partner_settlement_service_guide.md +268 -0
  10. package/assets/docs/help/api-sdk-2025-05-14.md +71 -0
  11. package/assets/docs/help/applepay.md +1 -1
  12. package/assets/docs/help/content100002.md +1 -1
  13. package/assets/docs/help/content100029.md +1 -1
  14. package/assets/docs/help/content100060.md +2 -2
  15. package/assets/docs/help/content200015.md +1 -1
  16. package/assets/docs/help/content200019.md +1 -1
  17. package/assets/docs/help/content200023.md +2 -2
  18. package/assets/docs/help/content200050.md +1 -1
  19. package/assets/docs/help/content61.md +0 -2
  20. package/assets/docs/help/core-service/channel-setting/danal.md +6 -8
  21. package/assets/docs/help/core-service/channel-setting/eximbay.md +224 -17
  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/eximbay-contract.md +1 -1
  33. package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +9 -9
  34. package/assets/docs/help/core-service/how-to-use/identity-verification-age-restriction.md +29 -0
  35. package/assets/docs/help/core-service/how-to-use/information-pg.md +4 -10
  36. package/assets/docs/help/core-service/how-to-use/kakao-contract.md +2 -2
  37. package/assets/docs/help/core-service/how-to-use/ksnet-contract.md +1 -1
  38. package/assets/docs/help/core-service/how-to-use/nice-contract.md +15 -15
  39. package/assets/docs/help/core-service/how-to-use/open-immediately.md +1 -1
  40. package/assets/docs/help/core-service/how-to-use/point-service.md +7 -7
  41. package/assets/docs/help/core-service/how-to-use/settle-contract.md +2 -2
  42. package/assets/docs/help/core-service/how-to-use/shopify-available-list.md +4 -4
  43. package/assets/docs/help/core-service/how-to-use/shopify-guide.md +1 -1
  44. package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +3 -3
  45. package/assets/docs/help/core-service/how-to-use/tosspayments-contract.md +4 -4
  46. package/assets/docs/help/core-service/payment-type/content200007.md +8 -7
  47. package/assets/docs/help/core-service/payment-type/content200036.md +17 -18
  48. package/assets/docs/help/core-service/payment-type/content200042.md +3 -3
  49. package/assets/docs/help/core-service/payment-type/content200052.md +2 -2
  50. package/assets/docs/help/core-service/payment-type/content200053.md +7 -3
  51. package/assets/docs/help/core-service/payment-type/hub-service-fee.md +19 -17
  52. package/assets/docs/help/core-service/payment-type/inicis-easypay-hub-fee.md +5 -6
  53. package/assets/docs/help/core-service/payment-type/inicis-international.md +10 -10
  54. package/assets/docs/help/core-service/payment-type/internationl-pg.md +7 -3
  55. package/assets/docs/help/core-service/payment-type/kcp-easypay-hub-apply.md +4 -5
  56. package/assets/docs/help/core-service/payment-type/kcp-international.md +2 -3
  57. package/assets/docs/help/core-service/payment-type/nice-easypay-hub-fee.md +8 -8
  58. package/assets/docs/help/core-service/payment-type/nice-international.md +14 -14
  59. package/assets/docs/help/core-service/payment-type/payletter-international.md +105 -0
  60. package/assets/docs/help/core-service/payment-type/paypal-payment-status.md +3 -3
  61. package/assets/docs/help/core-service/payment-type/schedule-requirement.md +2 -2
  62. package/assets/docs/help/faq/console-faq/change-console-url.md +2 -0
  63. package/assets/docs/help/faq/general-inquiry/confirm-process.md +16 -16
  64. package/assets/docs/help/faq/general-inquiry/identity-verification-suspended-ip.md +35 -0
  65. package/assets/docs/help/faq/general-inquiry/kcp-business-number-error.md +29 -0
  66. package/assets/docs/help/faq/general-inquiry/platform-contract-method.md +4 -5
  67. package/assets/docs/help/faq/general-inquiry/platform-contract-pg.md +2 -2
  68. package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
  69. package/assets/docs/help/faq/payment-faq/cash-receipt-guide.md +2 -2
  70. package/assets/docs/help/faq/payment-faq/kcp-cash-receipt.md +34 -0
  71. package/assets/docs/help/faq/payment-faq/payment-failure-danal-insufficient-funds.md +29 -0
  72. package/assets/docs/help/faq/payment-faq/payment-failure-kcp-insufficient-funds.md +35 -0
  73. package/assets/docs/help/faq/payment-faq/payment-failure-kiwoompay-insufficient-funds.md +25 -0
  74. package/assets/docs/help/faq/payment-faq/payment-failure-nice-insufficient-funds.md +28 -0
  75. package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
  76. package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +10 -10
  77. package/assets/docs/help/faq/payment-faq/wordpress-woocommerce-taxation.md +67 -0
  78. package/assets/docs/help/faq/platform-faq/platform_additional_fee_setting.md +28 -0
  79. package/assets/docs/help/faq/platform-faq/platform_api_docs.md +24 -0
  80. package/assets/docs/help/faq/platform-faq/platform_definition_partner.md +34 -0
  81. package/assets/docs/help/faq/platform-faq/platform_definition_payout_agency.md +23 -0
  82. package/assets/docs/help/faq/platform-faq/platform_definition_platform.md +17 -0
  83. package/assets/docs/help/faq/platform-faq/platform_definition_settlement.md +29 -0
  84. package/assets/docs/help/faq/platform-faq/platform_difference_settlement_payout.md +29 -0
  85. package/assets/docs/help/faq/platform-faq/platform_ecommerce_discount_policy.md +19 -0
  86. package/assets/docs/help/faq/platform-faq/platform_introduction.md +15 -0
  87. package/assets/docs/help/faq/platform-faq/platform_introduction_conditions.md +16 -0
  88. package/assets/docs/help/faq/platform-faq/platform_nocode_guide.md +5 -5
  89. package/assets/docs/help/faq/platform-faq/platform_nocode_hosting.md +20 -0
  90. package/assets/docs/help/faq/platform-faq/platform_nocode_use.md +28 -0
  91. package/assets/docs/help/faq/platform-faq/platform_partner_bulk_registration.md +31 -0
  92. package/assets/docs/help/faq/platform-faq/platform_partner_info_guide.md +49 -0
  93. package/assets/docs/help/faq/platform-faq/platform_partner_management_tags.md +14 -0
  94. package/assets/docs/help/faq/platform-faq/platform_partner_tax_type.md +18 -0
  95. package/assets/docs/help/faq/platform-faq/platform_partnerships.md +16 -0
  96. package/assets/docs/help/faq/platform-faq/platform_payment_formula_setting.md +20 -0
  97. package/assets/docs/help/faq/platform-faq/platform_paymentdetails_definition.md +11 -0
  98. package/assets/docs/help/faq/platform-faq/platform_paymentdetails_view_features.md +18 -0
  99. package/assets/docs/help/faq/platform-faq/platform_payoutagency_realtime_payment.md +22 -0
  100. package/assets/docs/help/faq/platform-faq/platform_payoutagency_safety_legality.md +22 -0
  101. package/assets/docs/help/faq/platform-faq/platform_payoutagency_scheduled_payment.md +18 -0
  102. package/assets/docs/help/faq/platform-faq/platform_pg_fee_handling.md +18 -0
  103. package/assets/docs/help/faq/platform-faq/platform_policymanagement_calculator.md +1 -1
  104. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_creation_guide.md +24 -0
  105. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_definition.md +19 -0
  106. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_service_compliance.md +28 -0
  107. package/assets/docs/help/faq/platform-faq/platform_settlement_auto_calculation_setting.md +39 -0
  108. package/assets/docs/help/faq/platform-faq/platform_settlement_cancellation_data.md +21 -0
  109. package/assets/docs/help/faq/platform-faq/platform_settlement_custom_attributes.md +18 -0
  110. package/assets/docs/help/faq/platform-faq/platform_settlement_custom_formula_request.md +20 -0
  111. package/assets/docs/help/faq/platform-faq/platform_settlement_cycle_setting.md +42 -0
  112. package/assets/docs/help/faq/platform-faq/platform_settlement_decimal_rounding.md +23 -0
  113. package/assets/docs/help/faq/platform-faq/platform_settlement_hold_date_setting.md +35 -0
  114. package/assets/docs/help/faq/platform-faq/platform_settlement_holidays.md +9 -0
  115. package/assets/docs/help/faq/platform-faq/platform_settlement_manual_registration.md +32 -0
  116. package/assets/docs/help/faq/platform-faq/platform_settlementdetails_view_features.md +26 -0
  117. package/assets/docs/help/faq/platform-faq/platform_settlmentandpayout_guide.md +4 -4
  118. package/assets/docs/help/faq/platform-faq/platform_supported_bank_codes.md +85 -0
  119. package/assets/docs/help/faq/platform-faq/platform_supported_currencies.md +33 -0
  120. package/assets/docs/help/faq/platform-faq/platform_tax_calculation.md +17 -0
  121. package/assets/docs/help/faq/platform-faq/platform_tax_setting_guide.md +1 -1
  122. package/assets/docs/help/faq/platform-faq/platform_tax_withholding_tax_definition.md +14 -0
  123. package/assets/docs/help/faq/platform-faq/platform_virtual_account_withdrawal.md +16 -0
  124. package/assets/docs/help/faq/platform-faq/platform_webhook_definition.md +24 -0
  125. package/assets/docs/help/faq/platform-faq/recommended_withdrawal.md +16 -0
  126. package/assets/docs/help/faq/platform-faq/system_test_environment.md +13 -0
  127. package/assets/docs/help/faq/platform-faq/taxinvoice_bulk_issuance.md +25 -0
  128. package/assets/docs/help/faq/platform-faq/taxinvoice_cancel.md +12 -0
  129. package/assets/docs/help/faq/platform-faq/taxinvoice_delayed.md +18 -0
  130. package/assets/docs/help/faq/platform-faq/taxinvoice_forward_issuance.md +23 -0
  131. package/assets/docs/help/faq/platform-faq/taxinvoice_guide_atoz.md +202 -0
  132. package/assets/docs/help/faq/platform-faq/taxinvoice_partner_peristalsis.md +60 -0
  133. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_buyer_process.md +52 -0
  134. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_definition.md +46 -0
  135. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_partner_signup.md +23 -0
  136. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_supplier_process.md +47 -0
  137. package/assets/docs/help/notice-payletter-2025-10-21.md +29 -0
  138. package/assets/docs/help/notice-payletter-2025-10-24.md +46 -0
  139. package/assets/docs/help/notice-v1-api-2025-11-24.md +78 -0
  140. package/assets/docs/help/notice-v1-api-2025-11-25.md +59 -0
  141. package/assets/docs/help/platform-2025-07-02.md +73 -0
  142. package/assets/docs/help/platform-2025-07-07.md +56 -0
  143. package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +2 -2
  144. package/assets/docs/help/pricing/portone/portone-pricing.md +1 -1
  145. package/assets/docs/help/procedure/payment-integration/test-integration.md +2 -2
  146. package/assets/docs/help/procedure/pg-application/content59.md +1 -1
  147. package/assets/docs/help/procedure/pg-application/start.md +1 -1
  148. package/assets/docs/help/procedure/recommendation/package.md +14 -8
  149. package/assets/docs/help/service/identity-verification/identity-verification.md +6 -6
  150. package/assets/docs/help/service/paymethod/paymethod.md +2 -2
  151. package/assets/docs/help/service/pg/pg-service-list.md +25 -13
  152. package/assets/docs/help/service/version/portone-version.md +1 -1
  153. package/assets/docs/opi/ko/console/guide/billing-payments.md +1 -1
  154. package/assets/docs/opi/ko/console/guide/reg.md +1 -1
  155. package/assets/docs/opi/ko/console/guide/smartrouting.md +0 -2
  156. package/assets/docs/opi/ko/console/pg.md +7 -7
  157. package/assets/docs/opi/ko/etc/recon.md +2 -2
  158. package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md +2 -2
  159. package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md +11 -4
  160. package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md +2 -2
  161. package/assets/docs/opi/ko/extra/identity-verification/v1/all/3.md +3 -3
  162. package/assets/docs/opi/ko/extra/identity-verification/v1/all/readme.md +1 -1
  163. package/assets/docs/opi/ko/extra/identity-verification/v1/credit-auth/4.md +3 -3
  164. package/assets/docs/opi/ko/extra/identity-verification/v1/phone/4.md +3 -3
  165. package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md +74 -0
  166. package/assets/docs/opi/ko/extra/plugins/wordpress/button.md +1 -1
  167. package/assets/docs/opi/ko/extra/plugins/wordpress/edd.md +1 -1
  168. package/assets/docs/opi/ko/extra/plugins/wordpress/woocommerce/subscription.md +1 -1
  169. package/assets/docs/opi/ko/extra/promotion/intro.md +1 -1
  170. package/assets/docs/opi/ko/extra/smart-routing/console-guide.md +1 -1
  171. package/assets/docs/opi/ko/extra/smart-routing/integration.md +2 -2
  172. package/assets/docs/opi/ko/extra/smart-routing/intro.md +9 -10
  173. package/assets/docs/opi/ko/integration/pg/v1/danal.md +6 -1
  174. package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +10 -1
  175. package/assets/docs/opi/ko/integration/pg/v1/daou/undefined.md +8 -0
  176. package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +0 -14
  177. package/assets/docs/opi/ko/integration/pg/v1/inicis.md +60 -2
  178. package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +12 -1
  179. package/assets/docs/opi/ko/integration/pg/v1/kicc.md +3 -1
  180. package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +1 -1
  181. package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +1 -1
  182. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +710 -0
  183. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +661 -0
  184. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +0 -34
  185. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +11 -11
  186. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/payment-caution.md +16 -16
  187. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +10 -8
  188. package/assets/docs/opi/ko/integration/pg/v1/nice.md +7 -7
  189. package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +91 -0
  190. package/assets/docs/opi/ko/integration/pg/v1/paypal.md +1 -1
  191. package/assets/docs/opi/ko/integration/pg/v1/readme.md +5 -5
  192. package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +3 -3
  193. package/assets/docs/opi/ko/integration/pg/v1/rt/warning.md +2 -2
  194. package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +81 -1
  195. package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/caution.md +1 -1
  196. package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +10 -9
  197. package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +1 -1
  198. package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +10 -7
  199. package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +140 -22
  200. package/assets/docs/opi/ko/integration/pg/v2/hyphen.md +1 -1
  201. package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md +0 -1
  202. package/assets/docs/opi/ko/integration/pg/v2/inicis-v2.md +13 -1
  203. package/assets/docs/opi/ko/integration/pg/v2/kcp-v2.md +4 -2
  204. package/assets/docs/opi/ko/integration/pg/v2/naverpay.md +1 -1
  205. package/assets/docs/opi/ko/integration/pg/v2/nice-v2.md +40 -40
  206. package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md +17 -3
  207. package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +14 -13
  208. package/assets/docs/opi/ko/integration/pg/v2/readme.md +1 -9
  209. package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
  210. package/assets/docs/opi/ko/integration/pg/v2/tosspayments.md +1 -1
  211. package/assets/docs/opi/ko/integration/pg/v2/welcome.md +8 -7
  212. package/assets/docs/opi/ko/integration/ready/readme.md +44 -42
  213. package/assets/docs/opi/ko/integration/start/v1/non-auth.md +2 -4
  214. package/assets/docs/opi/ko/integration/start/v2/billing/issue.md +1 -1
  215. package/assets/docs/opi/ko/integration/start/v2/checkout.md +4 -2
  216. package/assets/docs/opi/ko/integration/start/v2/readme.md +2 -3
  217. package/assets/docs/opi/ko/integration/using-ai-tools.md +33 -57
  218. package/assets/docs/opi/ko/integration/virtual-account/readme.md +9 -9
  219. package/assets/docs/opi/ko/integration/webhook/readme-v1.md +2 -4
  220. package/assets/docs/opi/ko/integration/webhook/readme-v2.md +3 -5
  221. package/assets/docs/opi/ko/quick-guide/payment.md +25 -77
  222. package/assets/docs/opi/ko/support/code-info/pg-1.md +1 -1
  223. package/assets/docs/opi/ko/support/code-info/pg-2.md +2 -2
  224. package/assets/docs/opi/ko/support/code-info/pg.md +2 -2
  225. package/assets/docs/opi/ko/support/contact.md +1 -13
  226. package/assets/docs/opi/ko/support/pg-terms.md +233 -0
  227. package/assets/docs/platform/ko/guides/dictionary.md +136 -16
  228. package/assets/docs/platform/ko/guides/process.md +1 -1
  229. package/assets/docs/platform/ko/guides/webhook.md +1 -1
  230. package/assets/docs/platform/ko/using-ai-tools.md +33 -57
  231. package/assets/docs/release-notes/api-sdk/2023-07-10.md +7 -7
  232. package/assets/docs/release-notes/api-sdk/2023-07-31.md +1 -1
  233. package/assets/docs/release-notes/api-sdk/2023-08-31.md +2 -2
  234. package/assets/docs/release-notes/api-sdk/2024-01-08.md +4 -4
  235. package/assets/docs/release-notes/api-sdk/2024-06-03.md +1 -1
  236. package/assets/docs/release-notes/api-sdk/2024-09-05.md +0 -1
  237. package/assets/docs/release-notes/api-sdk/2024-09-27.md +4 -4
  238. package/assets/docs/release-notes/console/2025-10-17.md +47 -0
  239. package/assets/docs/release-notes/platform/2025-03-17.md +1 -1
  240. package/assets/docs/release-notes/platform/2025-07-07.md +1 -1
  241. package/assets/docs/release-notes/platform/2025-07-23.md +85 -0
  242. package/assets/docs/release-notes/platform/2025-08-13.md +95 -0
  243. package/assets/docs/release-notes/platform/2025-08-21.md +53 -0
  244. package/assets/docs/release-notes/platform/2025-08-28.md +53 -0
  245. package/assets/docs/release-notes/platform/2025-10-02.md +152 -0
  246. package/assets/docs/schema/browser-sdk.schema.json +510 -0
  247. package/assets/docs/schema/browser-sdk.yml +196 -69
  248. package/assets/docs/schema/v1.openapi.json +845 -887
  249. package/assets/docs/schema/v1.openapi.yml +1062 -1737
  250. package/assets/docs/schema/v2.openapi.json +9177 -2044
  251. package/assets/docs/schema/v2.openapi.yml +7499 -1479
  252. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +3 -3
  253. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +3 -3
  254. package/assets/docs/sdk/ko/v2-mobile-sdk/android.md +1 -1
  255. package/assets/docs/sdk/ko/v2-server-sdk/jvm.md +12 -5
  256. package/assets/docs/sdk/ko/v2-server-sdk/python.md +12 -3
  257. package/assets/docs/v1-docs-full.md +2395 -1336
  258. package/assets/docs/v2-docs-full.md +1422 -649
  259. package/assets/docs/website-links.md +23 -15
  260. package/assets/instructions.md +4 -2
  261. package/manifest.json +1 -1
  262. package/package.json +17 -20
  263. package/server/index.js +135 -97
  264. package/assets/docs/help/admin-console/platform-settlement/content33-1.md +0 -201
  265. package/assets/docs/help/core-service/payment-type/schedule-logic-guide.md +0 -49
  266. package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md +0 -42
  267. package/assets/docs/help/faq/platform-faq/taxinvoice_guide.md +0 -107
  268. package/assets/docs/help/faq/platform-faq/taxinvoice_signupemail.md +0 -67
@@ -64,12 +64,12 @@
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): 엑심베이 결제 연동 방법을 안내합니다.
72
- - [하이픈](https://developers.portone.io/opi/ko/integration/pg/v2/hyphen): 하이픈 결제 연동 방법을 안내합니다.
73
73
  - [KG이니시스 일본결제](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-jp): KG이니시스 일본결제 연동 방법을 안내합니다.
74
74
  - [KG이니시스 통합인증](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-unified-identity-verification): KG이니시스 통합인증 연동 방법을 안내합니다.
75
75
  - [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v2/inicis-v2): KG이니시스 결제 연동 방법을 안내합니다.
@@ -79,7 +79,7 @@
79
79
  - [한국결제네트웍스(KPN)](https://developers.portone.io/opi/ko/integration/pg/v2/kpn): 한국결제네트웍스(KPN) 결제 연동 방법을 안내합니다.
80
80
  - [KSNET](https://developers.portone.io/opi/ko/integration/pg/v2/ksnet): KSNET 결제 연동 방법을 안내합니다.
81
81
  - [네이버페이 (결제형)](https://developers.portone.io/opi/ko/integration/pg/v2/naverpay): 네이버페이 간편결제 연동 방법을 안내합니다.
82
- - [나이스페이먼츠](https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2): 나이스페이먼츠 결제 연동 방법을 안내합니다.
82
+ - [나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2): 나이스정보통신 결제 연동 방법을 안내합니다.
83
83
  - [페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v2/payletter-global): 페이레터 해외결제 연동 방법을 안내합니다.
84
84
  - [페이팔](https://developers.portone.io/opi/ko/integration/pg/v2/paypal-v2): 페이팔 결제 연동 방법을 안내합니다.
85
85
  - [결제대행사 선택하여 연동하기](https://developers.portone.io/opi/ko/integration/pg/v2/readme): 각 PG사별 결제 연동 방법을 확인할 수 있습니다.
@@ -111,19 +111,20 @@
111
111
  - [프로모션 결제 연동하기](https://developers.portone.io/opi/ko/extra/promotion/integration): 프로모션 할인금액을 적용하는 방법을 안내합니다.
112
112
  - [프로모션](https://developers.portone.io/opi/ko/extra/promotion/intro): 카드 즉시 할인을 쉽게 운영 및 관리할 수 있는 서비스입니다.
113
113
  - [프로모션 결제 취소하기](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 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
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 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
117
117
  - [결제 연동 준비하기](https://developers.portone.io/opi/ko/integration/ready/readme): 포트원을 이용한 연동 개발이 처음이시라면 아래 안내 사항에 따라 진행하세요.
118
118
  - [AI 도구 활용하기](https://developers.portone.io/opi/ko/integration/using-ai-tools): AI 도구를 활용하여 쉽고 빠르게 포트원을 연동하세요. 연동 코드 작성은 물론, 24시간 언제나 관련 질의에 대한 답변을 받을 수 있습니다.
119
119
  - [가상계좌 입금통보 설정](https://developers.portone.io/opi/ko/integration/virtual-account/readme): 결제대행사별 입금통보 URL을 안내합니다.
120
120
  - [포트원 결제 연동 Doc](https://developers.portone.io/opi/ko/readme): 포트원 결제 연동 가이드입니다. 빠른 시간 안에 결제를 연동할 수 있게 도와드립니다.
121
121
  - [직접 문의하기](https://developers.portone.io/opi/ko/support/contact): 기술지원 문의를 위한 연락처 정보입니다.
122
+ - [용어 사전](https://developers.portone.io/opi/ko/support/pg-terms): 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
122
123
  - [TLS 지원 범위](https://developers.portone.io/opi/ko/support/tls-support): 포트원 v1 API의 TLS 지원 범위 및 설정 가이드를 확인할 수 있습니다.
123
124
 
124
125
  ### 파트너정산
125
126
 
126
- - [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary)
127
+ - [용어 사전](https://developers.portone.io/platform/ko/guides/dictionary): 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
127
128
  - [서비스 프로세스](https://developers.portone.io/platform/ko/guides/process)
128
129
  - [세금계산서 웹훅 가이드](https://developers.portone.io/platform/ko/guides/webhook): 세금계산서 상태 변화 웹훅의 사용 방법과 설정 가이드입니다.
129
130
  - [파트너 정산 자동화 서비스 가이드](https://developers.portone.io/platform/ko/readme)
@@ -183,6 +184,7 @@
183
184
  - [관리자콘솔 2023-09-12](https://developers.portone.io/release-notes/console/2023-09-12)
184
185
  - [관리자콘솔 2023-12-27](https://developers.portone.io/release-notes/console/2023-12-27)
185
186
  - [관리자콘솔 2024-09-05](https://developers.portone.io/release-notes/console/2024-09-05)
187
+ - [관리자콘솔 2025-10-17](https://developers.portone.io/release-notes/console/2025-10-17)
186
188
  - [파트너 정산 자동화 2023-08-31](https://developers.portone.io/release-notes/platform/2023-08-31)
187
189
  - [파트너 정산 자동화 2023-11-08](https://developers.portone.io/release-notes/platform/2023-11-08)
188
190
  - [파트너 정산 자동화 2023-11-14](https://developers.portone.io/release-notes/platform/2023-11-14)
@@ -209,6 +211,11 @@
209
211
  - [파트너 정산 자동화 2025-05-14](https://developers.portone.io/release-notes/platform/2025-05-14)
210
212
  - [파트너 정산 자동화 2025-07-02](https://developers.portone.io/release-notes/platform/2025-07-02)
211
213
  - [파트너 정산 자동화 2025-07-07](https://developers.portone.io/release-notes/platform/2025-07-07)
214
+ - [파트너 정산 자동화 2025-07-23](https://developers.portone.io/release-notes/platform/2025-07-23)
215
+ - [파트너 정산 자동화 2025-08-13](https://developers.portone.io/release-notes/platform/2025-08-13)
216
+ - [파트너 정산 자동화 2025-08-21](https://developers.portone.io/release-notes/platform/2025-08-21)
217
+ - [파트너 정산 자동화 2025-08-28](https://developers.portone.io/release-notes/platform/2025-08-28)
218
+ - [파트너 정산 자동화 2025-10-02](https://developers.portone.io/release-notes/platform/2025-10-02)
212
219
 
213
220
  ### 블로그
214
221
 
@@ -234,8 +241,6 @@ targetVersions:
234
241
 
235
242
  스마트 라우팅 기능이 궁금하다면 [스마트 라우팅 기능 소개](https://developers.portone.io/opi/ko/extra/smart-routing/intro)를 확인해 보세요!
236
243
 
237
- 스마트 라우팅은 **V2 결제 서비스 이용시**에만 사용이 가능합니다.
238
-
239
244
  </div>
240
245
 
241
246
  ## 스마트 라우팅 그룹 생성하기
@@ -303,7 +308,7 @@ targetVersions:
303
308
 
304
309
  ---
305
310
  title: 컨펌 프로세스
306
- description: 결제승인의 주체를 고객사 서버로 가져갈수 있는 서비스 입니다.
311
+ description: 결제 승인의 주체를 고객사 서버로 가져갈 있는 서비스입니다.
307
312
  targetVersions:
308
313
  - v2
309
314
  versionVariants:
@@ -312,11 +317,18 @@ versionVariants:
312
317
 
313
318
  **해당 서비스는 결제 승인 직전에 고객사에서 결제 의사를 최종적으로 확인하는 서비스입니다.**
314
319
 
315
- (관련 이미지 첨부)
320
+ <div class="hint" data-style="info">
321
+
322
+ **수동 승인 기능 안내**
323
+
324
+ V2 신규 연동 시에는 컨펌 프로세스와 동일한 목적으로 사용할 수 있는 [수동 승인](https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2) 기능을 이용하시기를 권장합니다.
325
+ 수동 승인은 더 간편한 연동 방식을 제공하며, 채널 설정에서 간단히 켤 수 있습니다.
326
+
327
+ </div>
316
328
 
317
329
  ## 컨펌 프로세스란?
318
330
 
319
- - 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스 입니다.
331
+ - 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스입니다.
320
332
 
321
333
  - 기본적인 결제 플로우상 고객사에서 결제 요청 후 별도의 확인 없이 결제 승인되는 구조입니다.
322
334
  하지만 해당 서비스 이용 시 고객사가 최종적으로 결제 승인 요청의 주체가 될 수 있습니다.
@@ -365,7 +377,7 @@ versionVariants:
365
377
 
366
378
  **컨펌 프로세스 신청 방법**
367
379
 
368
- 기술지원 메일(<support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
380
+ 기술지원 메일(<tech.support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
369
381
 
370
382
  포트원 콘솔 로그인 후 \[결제연동] 페이지 상단에서 상점 아이디를 확인 하실 수 있습니다.
371
383
 
@@ -469,8 +481,8 @@ versionVariants:
469
481
  **본인인증 서비스**란 인증 절차를 거쳐 본인 여부와 입력한 정보의 정확성을 확인하여 주는 서비스입니다. 현재 지원하는 본인인증 서비스는 아래와 같습니다.
470
482
 
471
483
  - 다날 휴대폰 본인인증
472
- - KG이니시스 통합인증
473
484
  - KCP 휴대폰 본인인증
485
+ - KG이니시스 통합인증
474
486
 
475
487
  ## 휴대폰 본인인증
476
488
 
@@ -499,7 +511,7 @@ versionVariants:
499
511
  이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
500
512
  하는 방식으로 이루어집니다.
501
513
 
502
- > **이용가능 수단 : 네이버 / PASS / 페이코 / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
514
+ > **이용가능 수단 : 네이버 / PASS / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
503
515
 
504
516
  (이미지 첨부: 휴대폰 본인인증 화면 예시)
505
517
 
@@ -720,6 +732,84 @@ app.post("/identity-verifications", async (req, res) => {
720
732
  ```
721
733
 
722
734
 
735
+ # https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2
736
+
737
+ ---
738
+ title: 수동 승인
739
+ description: 고객사 서버에서 API를 호출하여 결제를 승인하는 연동 방식입니다.
740
+ targetVersions:
741
+ - v2
742
+ ---
743
+
744
+ 포트원을 통해 PG의 결제 UI를 표시하면, 구매자는 UI에서 정보 입력 및 인증을 진행합니다. 이 과정이 끝나고 UI가 닫히면 자동으로 결제 승인(또는 가상계좌 발급, 빌링키 발급)이 일어납니다.
745
+
746
+ 그러나 채널 설정에서 **수동 승인**을 켜면, 결제 UI가 완료되더라도 고객사 서버에서 포트원의 **수동 승인** API를 호출하지 않으면 결제 승인 등이 일어나지 않습니다.
747
+
748
+ <div class="hint" data-style="warning">
749
+
750
+ **수동 승인을 사용할 수 없는 PG**
751
+
752
+ 엑심베이, 페이레터 해외결제의 경우 수동 승인을 지원하지 않고, 채널 설정에서도 해당 항목이 보이지 않습니다.
753
+
754
+ 이는 근본적으로 위챗 결제와 같이 일부 해외 결제수단이 수동 승인을 지원하지 않기 때문입니다. 따라서 추후 포트원에 추가되는 PG가 이러한 결제수단을 지원한다면, 해당 PG에서는 수동 승인을 이용할 수 없을 가능성이 높습니다.
755
+
756
+ </div>
757
+
758
+ <div class="hint" data-style="info">
759
+
760
+ **컨펌 프로세스와의 비교**
761
+
762
+ 수동 승인은 컨펌 프로세스와 동일한 목적의 기능이며, V2 신규 연동에서는 더 간편한 수동 승인 이용을 권장합니다.
763
+
764
+ 컨펌 프로세스를 이용할 수 있는 PG의 목록도 수동 승인과 동일합니다.
765
+
766
+ </div>
767
+
768
+ ## 수동 승인이 유용한 경우
769
+
770
+ - 결제 승인 전 마지막으로 재고 확인이 필요할 때
771
+ - 수량이 한정된 선착순 판매일 때
772
+ - 결제 완료 상태를 웹훅으로 수신하기보다, 직접 API를 호출해서 결제를 완료시키는 것을 선호할 때
773
+ - 수동 승인 방식으로 타 결제사를 연동한 상태에서 포트원도 같은 구조로 연동하고 싶을 때
774
+
775
+ ## 자동 승인이 유용한 경우
776
+
777
+ - 수동 승인을 지원하지 않는 PG를 이용할 때
778
+ - 수동 승인을 지원하지 않는 PG를 추후 연동할 가능성이 높을 때 (특히, 위챗 등 다양한 해외 결제수단 연동을 고려하고 있을 때)
779
+ - 결제 완료 등 결제 상태를 웹훅으로 수신하는 데 불편함이 없을 때
780
+
781
+ ## 인증 결제 수동 승인 이용 방법
782
+
783
+ 채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
784
+
785
+ 수동 승인이 켜진 채널로 `PortOne.requestPayment`를 호출하면 응답에 `paymentToken` 필드가 포함됩니다.
786
+ (수동 승인을 켜지 않은 채널이면 `paymentToken` 필드는 포함되지 않습니다.)
787
+
788
+ 이렇게 UI 호출 응답으로 받은 `paymentToken`을 이용해 서버에서 [인증 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment?v=v2#post%20%2Fpayments%2F%7BpaymentId%7D%2Fconfirm) API를 호출하면 결제가 승인됩니다. (가상계좌 발급 건의 경우 수동 승인 API 호출 시에 가상계좌가 발급됩니다.)
789
+
790
+ ## 빌링키 발급 수동 승인 이용 방법
791
+
792
+ 채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
793
+
794
+ 수동 승인이 켜진 채널로 `PortOne.requestIssueBillingKey`나 `PortOne.requestIssueBillingKeyAndPay`를 호출하면 응답에 `billingIssueToken` 필드가 포함됩니다.
795
+ (수동 승인을 켜지 않은 채널이면 `billingIssueToken` 필드는 포함되지 않습니다.)
796
+
797
+ 이때 빌링키는 아직 발급된 상태가 아닙니다. 따라서 응답으로 전달되는 `billingKey` 값은 `NEEDS_CONFIRMATION`입니다. `requestIssueBillingKeyAndPay`를 사용한 경우에는 `txId` 값 또한 `NEEDS_CONFIRMATION`으로 전달됩니다.
798
+
799
+ 이렇게 UI 호출 응답으로 받은 `billingIssueToken`을 이용해 서버에서 포트원 API를 호출하면 빌링키가 발급됩니다. `requestIssueBillingKeyAndPay`의 경우 빌링키 발급과 함께 초회 결제도 일어납니다.
800
+
801
+ - `requestIssueBillingKey`의 경우 [빌링키 발급 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm) API를 호출합니다.
802
+ - `requestIssueBillingKeyAndPay`의 경우 [빌링키 발급 및 초회 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm-issue-and-pay) API를 호출합니다.
803
+
804
+ <div class="hint" data-style="info">
805
+
806
+ **수동 승인 API 호출 시점**
807
+
808
+ 수동 승인 API는 가능한 한 즉시 호출하는 것을 권장합니다. 타임아웃 시간은 PG별로 상이하지만, 오래 대기하면 승인이 실패할 수 있습니다.
809
+
810
+ </div>
811
+
812
+
723
813
  # https://developers.portone.io/opi/ko/integration/cancel/v2/readme
724
814
 
725
815
  ---
@@ -1248,19 +1338,13 @@ targetVersions:
1248
1338
 
1249
1339
  ## 가능한 결제수단
1250
1340
 
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)에서 확인 후 입력해야 합니다.
1341
+ 엑심베이의 경우 포트원의 결제수단 구분과 상관없이 MID에 설정된 여러 결제수단을 표시할 수 있습니다.
1342
+ `payMethod`를 생략하고, 특정 결제수단만을 노출할 경우 `bypass.eximbay_v2`를 사용해야 합니다.
1260
1343
 
1261
- - **결제창 빌링키 발급 결제**
1262
-
1263
- 현재 신용카드 결제만 지원하며, `billingKeyAndPayMethod` 파라미터를 `CARD`로 설정해야 합니다.
1344
+ - MID에 설정된 기본 결제수단을 전부 표시하려면 `bypass.eximbay_v2.payment`를 생략해야 합니다.
1345
+ - 특정 결제수단을 단독으로 표시하려면 `bypass.eximbay_v2.payment.payment_method`를 설정합니다.
1346
+ - 일부 결제수단만을 표시하려면 `bypass.eximbay_v2.payment.multi_payment_method`에 결제수단 목록을 전달합니다.
1347
+ - 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
1264
1348
 
1265
1349
  ## SDK 결제 요청하기
1266
1350
 
@@ -1385,6 +1469,35 @@ function requestPayment() {
1385
1469
 
1386
1470
  결제 완료 메일이 발송됩니다.
1387
1471
 
1472
+ - products?: object\[]
1473
+
1474
+ **구매 상품 정보**
1475
+
1476
+ - 해외카드 결제를 제외하고 필수 입력입니다.
1477
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
1478
+
1479
+ * id: string
1480
+
1481
+ **상품 ID**
1482
+
1483
+ * name: string
1484
+
1485
+ **상품명**
1486
+
1487
+ * amount: number
1488
+
1489
+ **상품 단위 가격**
1490
+
1491
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
1492
+
1493
+ * quantity: number
1494
+
1495
+ **상품 수량**
1496
+
1497
+ * link: string
1498
+
1499
+ **상품 판매 URL**
1500
+
1388
1501
  - bypass?: oneof object
1389
1502
 
1390
1503
  - eximbay\_v2?: object
@@ -1548,7 +1661,6 @@ function issueBillingKeyAndPay() {
1548
1661
  orderName: "PortOne Recurring Payment",
1549
1662
  totalAmount: 100, // 1 USD
1550
1663
  currency: "USD",
1551
- billingKeyAndPayMethod: "CARD",
1552
1664
  customer: {
1553
1665
  fullName: "PortOne",
1554
1666
  email: "test@example.com",
@@ -1601,12 +1713,6 @@ function issueBillingKeyAndPay() {
1601
1713
  - ISO 4217 통화 코드
1602
1714
  - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
1603
1715
 
1604
- - billingKeyAndPayMethod: string
1605
-
1606
- **빌링키 발급 및 결제 방법**
1607
-
1608
- - `CARD`: 신용카드 결제
1609
-
1610
1716
  - locale?: Locale
1611
1717
 
1612
1718
  **결제창 언어**
@@ -1658,12 +1764,55 @@ function issueBillingKeyAndPay() {
1658
1764
 
1659
1765
  결제 완료 메일이 발송됩니다.
1660
1766
 
1767
+ - products?: object\[]
1768
+
1769
+ **구매 상품 정보**
1770
+
1771
+ - 해외카드 결제를 제외하고 필수 입력입니다.
1772
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
1773
+
1774
+ * id: string
1775
+
1776
+ **상품 ID**
1777
+
1778
+ * name: string
1779
+
1780
+ **상품명**
1781
+
1782
+ * amount: number
1783
+
1784
+ **상품 단위 가격**
1785
+
1786
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
1787
+
1788
+ * quantity: number
1789
+
1790
+ **상품 수량**
1791
+
1792
+ * link: string
1793
+
1794
+ **상품 판매 URL**
1795
+
1661
1796
  - bypass?: oneof object
1662
1797
 
1663
1798
  - eximbay\_v2?: object
1664
1799
 
1665
1800
  **엑심베이 특수 파라미터**
1666
1801
 
1802
+ - payment?: object
1803
+
1804
+ - payment\_method?: string
1805
+
1806
+ **결제수단 단독 노출**
1807
+
1808
+ 엑심베이의 결제수단 코드는 포트원 코드와 상이하므로, [EXIMBAY Docs](https://developer.eximbay.com/eximbay/api_sdk/code-organization.html#paymentCode)에서 확인 후 입력해야 합니다.
1809
+
1810
+ - multi\_payment\_method?: string\[]
1811
+
1812
+ **결제수단 노출 목록**
1813
+
1814
+ 여러 결제수단을 노출합니다.
1815
+
1667
1816
  - merchant?: object
1668
1817
 
1669
1818
  - shop?: string
@@ -1861,6 +2010,35 @@ const response = await axios({
1861
2010
 
1862
2011
  **구매자 이메일**
1863
2012
 
2013
+ - products?: object\[]
2014
+
2015
+ **구매 상품 정보**
2016
+
2017
+ - 해외카드 결제를 제외하고 필수 입력입니다.
2018
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
2019
+
2020
+ * id: string
2021
+
2022
+ **상품 ID**
2023
+
2024
+ * name: string
2025
+
2026
+ **상품명**
2027
+
2028
+ * amount: number
2029
+
2030
+ **상품 단위 가격**
2031
+
2032
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
2033
+
2034
+ * quantity: number
2035
+
2036
+ **상품 수량**
2037
+
2038
+ * link: string
2039
+
2040
+ **상품 판매 URL**
2041
+
1864
2042
  - bypass?: oneof object
1865
2043
 
1866
2044
  - eximbayV2?: object
@@ -2071,6 +2249,35 @@ const response = await axios({
2071
2249
 
2072
2250
  **구매자 이메일**
2073
2251
 
2252
+ - products?: object\[]
2253
+
2254
+ **구매 상품 정보**
2255
+
2256
+ - 해외카드 결제를 제외하고 필수 입력입니다.
2257
+ - 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
2258
+
2259
+ * id: string
2260
+
2261
+ **상품 ID**
2262
+
2263
+ * name: string
2264
+
2265
+ **상품명**
2266
+
2267
+ * amount: number
2268
+
2269
+ **상품 단위 가격**
2270
+
2271
+ 결제 금액과 동일하게 scale factor가 적용된 값을 입력합니다.
2272
+
2273
+ * quantity: number
2274
+
2275
+ **상품 수량**
2276
+
2277
+ * link: string
2278
+
2279
+ **상품 판매 URL**
2280
+
2074
2281
  - bypass?: oneof object
2075
2282
 
2076
2283
  - eximbayV2?: object
@@ -2176,9 +2383,10 @@ const response = await axios({
2176
2383
  ### 공통
2177
2384
 
2178
2385
  - `customer.name` 및 `customer.email`은 필수 입력 항목입니다.
2386
+ - 해외카드 결제를 제외하고 `products`를 필수로 입력해야 합니다. 해외카드의 경우에도 위험 거래 관리가 필요한 경우 요구될 수 있습니다.
2179
2387
  - `products` 입력 시 `link`를 필수로 입력해야 합니다.
2180
2388
 
2181
- ### SDK 결제 요청
2389
+ ### SDK 결제 / 빌링키 발급 및 결제 요청
2182
2390
 
2183
2391
  - 네이버페이 포인트로 결제할 경우에는 `bypass.eximbay_v2.tax` 내용을 모두 입력해야 합니다.
2184
2392
 
@@ -2186,222 +2394,13 @@ const response = await axios({
2186
2394
 
2187
2395
  - `bypass.eximbay_v2.payment_method`에 일본 편의점 결제를 지정할 경우 `customer.phoneNumber`을 필수로 입력해야 합니다.
2188
2396
 
2189
- - 간편결제 사용 시 `products`를 필수로 입력해야 합니다.
2190
-
2191
2397
  - 아래 결제수단의 경우 사용이 제한되므로 결제 연동 시 유의해 주시기 바랍니다.
2192
2398
  - 가상계좌(`P305`) : 호환성 이슈로 추후 지원 예정
2193
2399
  - Klarna(`P197`) : 엑심베이 정책에 따라 신규 결제 사용 불가
2194
2400
 
2195
2401
  - 모바일 앱 내에서 결제를 연동할 경우 `appScheme` 파라미터를 설정하고 `bypass.eximbay_v2.settings.call_from_app` 파라미터를 "Y"로 설정해야 합니다.
2196
2402
 
2197
-
2198
- # https://developers.portone.io/opi/ko/integration/pg/v2/hyphen
2199
-
2200
- ---
2201
- title: 하이픈
2202
- description: 하이픈 결제 연동 방법을 안내합니다.
2203
- targetVersions:
2204
- - v2
2205
- versionVariants:
2206
- v1: /opi/ko/integration/pg/v1/hyphen
2207
- ---
2208
-
2209
- ## 채널 설정하기
2210
-
2211
- - [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다.
2212
-
2213
- ## 가능한 결제 수단
2214
-
2215
- - 간편 결제
2216
-
2217
- 하이픈은 계좌 간편 결제를 전용으로 지원하는 PG사로, 등록한 계좌를 이용한 결제만 가능하며 다른 결제 수단은 지원하지 않습니다.
2218
-
2219
- 따라서 `payMethod` 파라미터를 아래와 같이 설정해야 합니다.
2220
-
2221
- - 간편결제 : `EASY_PAY`
2222
-
2223
- ### 계좌 간편 결제란?
2224
-
2225
- 고객이 PG사에서 제공하는 결제 페이지에서 본인 명의의 계좌를 등록하고, 상품 구매 시 비밀번호 인증 등을 통해 등록된 계좌에서 출금하여 결제하는 서비스를 의미합니다.
2226
-
2227
- ### 계좌 간편 결제의 장점
2228
-
2229
- 계좌 간편 결제는 아래와 같은 장점을 제공합니다.
2230
-
2231
- 1. **우수한 사용성**
2232
-
2233
- 보안 프로그램이나 추가 앱 설치 과정이 필요하지 않습니다.
2234
- 또한 복잡한 계좌 입력이나 인증 과정 없이 최초 한 번만 계좌를 등록하고 이후에는 비밀번호를 통해 간편하게 인증할 수 있습니다.
2235
-
2236
- 2. **낮은 수수료**
2237
-
2238
- 바로 계좌 결제는 오픈 뱅킹 기반의 계좌 이체 서비스로, 신용카드 결제에 비해 낮은 수수료로 해당 서비스를 이용할 수 있습니다.
2239
-
2240
- 3. **빠른 정산 주기**
2241
-
2242
- 하이픈의 계좌 간편 결제 서비스는 통상 D+2일 주기로 정산을 해드리고 있습니다. 빠른 정산을 통해 현금 흐름을 효율적으로 관리할 수 있습니다.
2243
-
2244
- ## SDK 결제 요청하기
2245
-
2246
- 결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다.
2247
- `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 하이픈 채널 사용을 명시해주세요.
2248
-
2249
- 하이픈 기준으로 작성한 예시 코드는 아래와 같습니다.
2250
-
2251
- <div class="tabs-container">
2252
-
2253
- <div class="tabs-content" data-title="SDK 결제 요청">
2254
-
2255
- ```javascript
2256
- import * as PortOne from "@portone/browser-sdk/v2";
2257
- function requestPayment() {
2258
- PortOne.requestPayment({
2259
- storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
2260
- channelKey: "channel-key-9987cb87-6458-4888-b94e-68d9a2da896d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
2261
- paymentId: `payment${crypto.randomUUID()}`,
2262
- orderName: "나이키 와플 트레이너 2 SD",
2263
- totalAmount: 1000,
2264
- currency: "CURRENCY_KRW",
2265
- payMethod: "EASY_PAY",
2266
- storeDetails: {
2267
- businessName: "상호명",
2268
- },
2269
- customer: {
2270
- fullName: "포트원",
2271
- phoneNumber: "010-0000-1234",
2272
- email: "test@portone.io",
2273
- },
2274
- });
2275
- }
2276
- ```
2277
-
2278
- </div>
2279
-
2280
- </div>
2281
-
2282
- ### 주요 파라미터
2283
-
2284
- - storeId: string
2285
-
2286
- **상점 아이디**
2287
-
2288
- 포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
2289
-
2290
- - paymentId: string
2291
-
2292
- **고객사 주문 고유 번호**
2293
-
2294
- 고객사에서 채번하는 주문 고유 번호로 매번 고유하게 채번되어야 합니다. 이미 승인 완료된 `paymentId`로 결제를 시도하는 경우 에러가 발생합니다.
2295
-
2296
- - orderName: string
2297
-
2298
- **주문명**
2299
-
2300
- 주문명으로 고객사에서 자유롭게 입력합니다.
2301
-
2302
- - channelKey: string
2303
-
2304
- **채널 키**
2305
-
2306
- 포트원 콘솔 내 \[연동 관리] > \[연동 정보] > \[채널 관리] 화면에서 채널 추가 시 생성되는 값입니다. 결제 호출 시 채널을 지정할 때 사용됩니다.
2307
-
2308
- - totalAmount: number
2309
-
2310
- **결제 금액**
2311
-
2312
- 결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
2313
-
2314
- - currency: string
2315
-
2316
- **결제 통화**
2317
-
2318
- 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다.
2319
-
2320
- - payMethod: string
2321
-
2322
- **결제수단 구분코드**
2323
-
2324
- 결제 호출 시 결제수단을 지정할 때 사용됩니다. 하이픈의 경우 해당 값은 `EASY_PAY`로 고정해주세요.
2325
-
2326
- - customer?: object
2327
-
2328
- **고객 정보**
2329
-
2330
- - fullName?: string
2331
-
2332
- **구매자 전체 이름**
2333
-
2334
- - 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
2335
-
2336
- - firstName?: string
2337
-
2338
- **구매자 이름**
2339
-
2340
- - 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
2341
-
2342
- - lastName?: string
2343
-
2344
- **구매자 성**
2345
-
2346
- - 하이픈의 경우 fullName 혹은 (firstName + lastName)을 필수로 입력해야 합니다.
2347
-
2348
- - storeDetails?: object
2349
-
2350
- **상점 정보**
2351
-
2352
- - businessName?: string
2353
-
2354
- **상호명**
2355
-
2356
- - 결제창에 표시될 상호명입니다. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
2357
-
2358
- - bypass?: oneof object
2359
-
2360
- **PG사 결제창 호출 시 PG사로 그대로 bypass할 파라미터들의 모음**
2361
-
2362
- - hyphen?: object
2363
-
2364
- **하이픈에서 제공하는 파라미터 모음**
2365
-
2366
- - designCd?: string
2367
-
2368
- **결제창 디자인 색상 코드**
2369
-
2370
- - `#`으로 시작하는 여섯자리 Hex 값을 입력합니다. (ex. `#C1272C`)
2371
-
2372
- #### 예시 코드
2373
-
2374
- ```json title="bypass 예시 코드"
2375
- {
2376
- "bypass": {
2377
- "hyphen": {
2378
- "designCd": "#C1272C"
2379
- }
2380
- }
2381
- }
2382
- ```
2383
-
2384
- ### 유의사항
2385
-
2386
- <details>
2387
-
2388
- <summary>`paymentId` 허용 문자 및 길이 제한</summary>
2389
-
2390
- `paymentId` 에는 영문, 숫자, `_`(underscore) 만으로 이루어진 문자열만 입력할 수 있습니다.
2391
-
2392
- 여기에 포함되지 않는 한글이나 `♤`, `♡`, `♧` 등의 특수 문자는 허용되지 않습니다.
2393
-
2394
- 또한 `paymentId`의 최대 길이는 50자이므로, 해당 길이를 넘지 않는 값으로 결제를 요청해주세요.
2395
-
2396
- </details>
2397
-
2398
- <details>
2399
-
2400
- <summary>`orderName` 길이 제한</summary>
2401
-
2402
- `orderName`의 최대 길이는 100byte 입니다. (UTF-8 인코딩 기준)
2403
-
2404
- </details>
2403
+ - 엑심베이의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.
2405
2404
 
2406
2405
 
2407
2406
  # https://developers.portone.io/opi/ko/integration/pg/v2/inicis-jp
@@ -2880,7 +2879,6 @@ PortOne.requestIdentityVerification({
2880
2879
 
2881
2880
  <summary>인증 업체 코드 확인하기</summary>
2882
2881
 
2883
- - PAYCO(페이코)
2884
2882
  - PASS(패스 (통신사))
2885
2883
  - TOSS(토스)
2886
2884
  - KFTC(금융결제원)
@@ -3117,7 +3115,7 @@ function requestPayment() {
3117
3115
  "Ini_SSGPAY_MDN": "01012341234",
3118
3116
  "acceptmethod": ["SKIN(#C1272C)", "below1000", "ocb"],
3119
3117
  "P_CARD_OPTION": "selcode=14",
3120
- "P_NMANE": "포트원",
3118
+ "P_MNAME": "포트원",
3121
3119
  "P_RESERVED": ["below1000=Y", "noeasypay=Y"]
3122
3120
  }
3123
3121
  }
@@ -3246,6 +3244,18 @@ function requestPayment() {
3246
3244
 
3247
3245
  <details>
3248
3246
 
3247
+ <summary>계약 사항에 따라 결제 정보에서 카드 정보가 누락될 수 있습니다.</summary>
3248
+
3249
+ KG이니시스와의 계약에서 결제 결과에 카드번호를 전송하지 않도록 설정된 경우, 결제 조회 시 다음 카드 관련 필드들이 누락될 수 있습니다.
3250
+
3251
+ - `card.issuer`: 카드 발급사
3252
+ - `card.publisher`: 카드 발행사
3253
+ - `card.name`: 카드명
3254
+
3255
+ </details>
3256
+
3257
+ <details>
3258
+
3249
3259
  <summary>PC와 모바일에서 파라미터 필수 여부가 상이합니다.</summary>
3250
3260
 
3251
3261
  위의 주요 파라미터 설명에도 안내되어 있듯이, PC 결제와 모바일 결제에서 필수 여부가 상이한 파라미터가 존재합니다. 아래 필드들은 PC 결제에서는 필수이지만, 모바일 결제에서는 선택입니다.
@@ -4921,7 +4931,7 @@ description: NHN KCP 연동 방법을 안내합니다.
4921
4931
  targetVersions:
4922
4932
  - v2
4923
4933
  versionVariants:
4924
- v1: /opi/ko/integration/pg/v1/nhn-kcp
4934
+ v1: /opi/ko/integration/pg/v1/nhn-kcp/readme
4925
4935
  ---
4926
4936
 
4927
4937
  ## 채널 설정하기
@@ -5120,8 +5130,10 @@ function requestPayment() {
5120
5130
 
5121
5131
  - shop\_user\_id?: string
5122
5132
 
5123
- **기관에 따라 리스크 관리 조치를 위한 쇼핑몰 관리 ID**
5133
+ **리스크 관리 조치를 위한 고객사 회원 ID**
5124
5134
 
5135
+ - KCP에서 부정거래를 신속하게 탐지하기 위한 파라미터입니다.
5136
+ - 고객사에서 관리하는 구매자의 회원 ID를 입력합니다.
5125
5137
  - 상품권, 휴대폰 결제 시 필수로 입력해야 합니다.
5126
5138
 
5127
5139
  - site\_name?: string
@@ -8000,7 +8012,7 @@ versionVariants:
8000
8012
  - `easyPay.availableCards`
8001
8013
  - 네이버페이는 지원하지 않습니다.
8002
8014
 
8003
- ### 빌링키 발급 (`requestBillingKeyIssue`)
8015
+ ### 빌링키 발급 (`requestIssueBillingKey`)
8004
8016
 
8005
8017
  - `billingKeyMethod`
8006
8018
  - `EASY_PAY` 로 설정해야 합니다
@@ -8050,8 +8062,8 @@ versionVariants:
8050
8062
  # https://developers.portone.io/opi/ko/integration/pg/v2/nice-v2
8051
8063
 
8052
8064
  ---
8053
- title: 나이스페이먼츠
8054
- description: 나이스페이먼츠 결제 연동 방법을 안내합니다.
8065
+ title: 나이스정보통신
8066
+ description: 나이스정보통신 결제 연동 방법을 안내합니다.
8055
8067
  targetVersions:
8056
8068
  - v2
8057
8069
  versionVariants:
@@ -8061,7 +8073,7 @@ versionVariants:
8061
8073
  ## 채널 설정하기
8062
8074
 
8063
8075
  - [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
8064
- V2 결제 모듈을 사용하시려면 나이스페이먼츠(신모듈)로 연동하셔야 합니다.
8076
+ V2 결제 모듈을 사용하시려면 나이스정보통신(신모듈)로 연동하셔야 합니다.
8065
8077
 
8066
8078
  ## 가능한 결제수단
8067
8079
 
@@ -8075,7 +8087,7 @@ versionVariants:
8075
8087
  - 간편 결제 : `EASY_PAY`
8076
8088
 
8077
8089
  - **결제창 빌링키 발급**
8078
- - `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
8090
+ - 결제창 빌링키 발급은 간편결제(네이버페이 / 카카오페이)만 지원하므로 `billingKeyMethod` 파라미터를 `EASY_PAY`로 설정해야 합니다.
8079
8091
 
8080
8092
  - **API 수기(키인) 결제**
8081
8093
  - `method`파라미터를 `card`로 설정해야 합니다.
@@ -8086,9 +8098,9 @@ versionVariants:
8086
8098
  ## SDK 결제 요청하기
8087
8099
 
8088
8100
  결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다.
8089
- `channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여 나이스페이먼츠 채널 사용을 명시해주세요.
8101
+ `channelKey`파라미터에 결제 채널 연동 시 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
8090
8102
 
8091
- 나이스페이먼츠 기준으로 작성한 예시 코드는 아래와 같습니다.
8103
+ 나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
8092
8104
 
8093
8105
  <div class="tabs-container">
8094
8106
 
@@ -8143,7 +8155,7 @@ function requestPayment() {
8143
8155
 
8144
8156
  - currency: string
8145
8157
 
8146
- 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 나이스페이먼츠의 경우 `KRW`와 `USD`를 지원합니다.
8158
+ 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. 나이스정보통신의 경우 `KRW`와 `USD`를 지원합니다.
8147
8159
 
8148
8160
  - payMethod: string
8149
8161
 
@@ -8151,7 +8163,7 @@ function requestPayment() {
8151
8163
 
8152
8164
  - taxFreeAmount?: number
8153
8165
 
8154
- 면세금액으로 나이스페이먼츠와 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8166
+ 면세금액으로 나이스정보통신와 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8155
8167
 
8156
8168
  면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
8157
8169
 
@@ -8163,7 +8175,7 @@ function requestPayment() {
8163
8175
 
8164
8176
  - `card.installment.monthOption.fixedMonth`
8165
8177
 
8166
- 나이스페이먼츠는 **카드사 다이렉트 호출시 고정 할부 개월수를 필수로 입력**해야 합니다. 결제
8178
+ 나이스정보통신은 **카드사 다이렉트 호출시 고정 할부 개월수를 필수로 입력**해야 합니다. 결제
8167
8179
  금액이 할부 지원 금액 미만(대부분 50,000원이상 할부지원이나 카드사에 따라 상이함)인 경우 **할부
8168
8180
  개월수를 0(일시불)으로 전달**해야 합니다.
8169
8181
 
@@ -8177,15 +8189,15 @@ function requestPayment() {
8177
8189
 
8178
8190
  - `giftCertificate.certificateType`
8179
8191
 
8180
- 나이스페이먼츠는 컬쳐랜드만 지원하므로 상품권 결제시 항상 `CULTURELAND`로 지정해주어야 합니다.
8192
+ 나이스정보통신은 컬쳐랜드만 지원하므로 상품권 결제시 항상 `CULTURELAND`로 지정해주어야 합니다.
8181
8193
 
8182
8194
  - `bypass.nice_v2.MallUserID`
8183
8195
 
8184
- 나이스페이먼츠 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수로 입력해주어야 합니다.
8196
+ 나이스정보통신 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수로 입력해주어야 합니다.
8185
8197
 
8186
8198
  - `easyPay.availablePayMethods`
8187
8199
 
8188
- 나이스페이먼츠를 통한 간편결제 결제 요청 시 다른 간편결제 수단과 다르게 네이버페이, SSG페이, 토스페이의
8200
+ 나이스정보통신를 통한 간편결제 결제 요청 시 다른 간편결제 수단과 다르게 네이버페이, SSG페이, 토스페이의
8189
8201
  경우 어떤 방식으로 결제하느냐에 따라 availablePayMethods을 입력해야 합니다.
8190
8202
 
8191
8203
  - 네이버페이의 경우 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE` 로 입력해야
@@ -8200,9 +8212,9 @@ function requestPayment() {
8200
8212
  ## 결제창 빌링키 발급
8201
8213
 
8202
8214
  빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
8203
- `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 나이스페이먼츠 채널 사용을 명시해주세요.
8215
+ `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 나이스정보통신 채널 사용을 명시해주세요.
8204
8216
 
8205
- 나이스페이먼츠 기준으로 작성한 예시 코드는 아래와 같습니다.
8217
+ 나이스정보통신 기준으로 작성한 예시 코드는 아래와 같습니다.
8206
8218
 
8207
8219
  <div class="tabs-container">
8208
8220
 
@@ -8214,7 +8226,7 @@ function requestIssueBillingKey() {
8214
8226
  PortOne.requestIssueBillingKey({
8215
8227
  storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
8216
8228
  channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
8217
- billingKeyMethod: "EASY_PAY",
8229
+ billingKeyMethod: "EASY_PAY", // 간편결제만 지원합니다.
8218
8230
  issueId: "testIssueId",
8219
8231
  issueName: "testIssueName",
8220
8232
  customer: {
@@ -8251,21 +8263,21 @@ function requestIssueBillingKey() {
8251
8263
 
8252
8264
  **빌링키 발급수단**
8253
8265
 
8254
- 나이스페이먼츠는 결제창 방식으로 빌링키 발급 시 간편결제만을 지원하므로 `EASY_PAY`로 설정해야 합니다.
8266
+ 나이스정보통신은 결제창 방식으로 빌링키 발급 시 간편결제(네이버페이 / 카카오페이)만을 지원하므로 `EASY_PAY`로 설정해야 합니다.
8255
8267
 
8256
8268
  - issueId: string
8257
8269
 
8258
8270
  **빌링키 발급 건 고유 ID**
8259
8271
 
8260
8272
  - 고객사에서 채번하여 사용해야 합니다.
8261
- - 나이스페이먼츠의 경우 필수 입력해야 합니다.
8273
+ - 나이스정보통신의 경우 필수 입력해야 합니다.
8262
8274
  - 영문 대소문자와 숫자만 사용하여 40자 이내로 입력합니다.
8263
8275
 
8264
8276
  - issueName: string
8265
8277
 
8266
8278
  **빌링키 발급 시 결제창에 표시되는 제목**
8267
8279
 
8268
- - 나이스페이먼츠의 경우 필수 입력해야 합니다.
8280
+ - 나이스정보통신의 경우 필수 입력해야 합니다.
8269
8281
 
8270
8282
  - customer?: object
8271
8283
 
@@ -8384,7 +8396,7 @@ const issueResponse = await axios({
8384
8396
 
8385
8397
  - taxFree?: number
8386
8398
 
8387
- 면세 금액으로 나이스페이먼츠과 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8399
+ 면세 금액으로 나이스정보통신과 상점아이디 계약시 지정금액 혹은 복합과세 방식으로 계약한 경우 면세 처리를 위해 면세금액을 반드시 입력해야 합니다.
8388
8400
  면세금액 미 입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
8389
8401
 
8390
8402
  - currency: string
@@ -8582,7 +8594,7 @@ const response = await axios({
8582
8594
 
8583
8595
  결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
8584
8596
 
8585
- 나이스페이먼츠와 지정금액 혹은 복합과세 방식으로 계약한 경우 면세금액을 반드시 입력해야 합니다.
8597
+ 나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 면세금액을 반드시 입력해야 합니다.
8586
8598
  카드 빌링키의 경우 면세금액 미입력 시 면세금액은 0원으로 자동 처리되며, 결제 요청 금액은 모두 과세 처리 되오니 이 점 유의하시기 바랍니다.
8587
8599
  간편결제 빌링키의 경우 면세금액 미입력 시 오류가 발생합니다.
8588
8600
 
@@ -8592,13 +8604,13 @@ const response = await axios({
8592
8604
 
8593
8605
  결제 금액으로 결제를 원하는 통화(currency)별 scale factor(소수점 몇번째 자리까지 유효한지)를 고려한 number 형식만 허용됩니다.
8594
8606
 
8595
- 나이스페이먼츠와 지정금액 혹은 복합과세 방식으로 계약한 경우 간편결제 빌링키 이용 시 부가세를 반드시 입력해야 합니다.
8607
+ 나이스정보통신와 지정금액 혹은 복합과세 방식으로 계약한 경우 간편결제 빌링키 이용 시 부가세를 반드시 입력해야 합니다.
8596
8608
 
8597
8609
  - currency: string
8598
8610
 
8599
8611
  **결제 통화**
8600
8612
 
8601
- 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)나이스페이먼츠의 경우 빌링키로 결제시 `KRW`만 지원합니다.
8613
+ 결제통화로 원화 결제 시 `KRW`로 입력해야 합니다. (신)나이스정보통신의 경우 빌링키로 결제시 `KRW`만 지원합니다.
8602
8614
 
8603
8615
  - customer: object
8604
8616
 
@@ -8671,9 +8683,9 @@ const response = await axios({
8671
8683
 
8672
8684
  ## 연동 유의사항
8673
8685
 
8674
- ### 나이스페이먼츠와 사전 계약이 필요한 경우
8686
+ ### 나이스정보통신와 사전 계약이 필요한 경우
8675
8687
 
8676
- 아래 기능을 사용하시려면 나이스페이먼츠에 사전 신청 후 계약이 완료되어야 합니다.
8688
+ 아래 기능을 사용하시려면 나이스정보통신에 사전 신청 후 계약이 완료되어야 합니다.
8677
8689
  그렇지 않은 상태에서 해당 기능 이용시 PG창 호출에 실패하거나, 승인에 실패하거나,
8678
8690
  승인에 성공하더라도 의도한 바와는 다른 응답을 얻게 될 수 있으니 이 점 유의하시길 바랍니다.
8679
8691
 
@@ -8722,9 +8734,9 @@ const response = await axios({
8722
8734
  |비 다이렉트 호출 + 리스트 할부 개월수|`PC만 가능` |
8723
8735
 
8724
8736
  - 토스뱅크 카드의 경우 카드사 다이렉트 호출 불가능합니다.
8725
- - 나이스페이먼츠의 경우 토스뱅크 카드 다이렉트 호출이 지원되지 않습니다.
8737
+ - 나이스정보통신의 경우 토스뱅크 카드 다이렉트 호출이 지원되지 않습니다.
8726
8738
 
8727
- - 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다. -나이스페이먼츠의 경우 일반
8739
+ - 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정이 가능합니다. -나이스정보통신의 경우 일반
8728
8740
  카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나 **모바일 환경**에서는
8729
8741
  **카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출
8730
8742
  코드 없이 할부 옵션을 전달하는 경우 무시됩니다.
@@ -8732,18 +8744,18 @@ const response = await axios({
8732
8744
  ### 계좌이체 일반결제 유의사항
8733
8745
 
8734
8746
  - 계좌이체 다이렉트 호출 시 은행 코드 지정이 불가능합니다.
8735
- - 나이스페이먼츠의 경우 계좌이체 다이렉트 호출을 하더라도 뱅크페이가 호출되오니 이 점 유의하시기 바랍니다.
8747
+ - 나이스정보통신의 경우 계좌이체 다이렉트 호출을 하더라도 뱅크페이가 호출되오니 이 점 유의하시기 바랍니다.
8736
8748
  - 다이렉트 호출을 원하시는 경우 은행코드 대신 bypass 파라미터인 `DirectShowOpt`를 설정하여 사용하시길 바랍니다.
8737
8749
 
8738
8750
  - 계좌이체 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
8739
- - 나이스페이먼츠 정책상 에스크로를 사용한 계좌이체 결제시에는 다이렉트 호출이 불가능합니다. 아래와
8751
+ - 나이스정보통신 정책상 에스크로를 사용한 계좌이체 결제시에는 다이렉트 호출이 불가능합니다. 아래와
8740
8752
  같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우 "나이스페이 V2 계좌이체
8741
8753
  에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 리턴되며, 결제창이 호출되지
8742
8754
  않으니 유의하시기 바랍니다.
8743
8755
 
8744
8756
  - 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 합니다.
8745
8757
  - 존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인 실패됩니다.
8746
- 또한 실제로 존재하는 이메일 도메인이더라도 나이스페이먼츠 정책상 유효하지 않다고 취급하는 이메일
8758
+ 또한 실제로 존재하는 이메일 도메인이더라도 나이스정보통신 정책상 유효하지 않다고 취급하는 이메일
8747
8759
  주소((예) <ex@portone.finance>)를 입력한 경우 정상 승인되지만 **이후 에스크로 API를 이용하여 배송
8748
8760
  정보 등록 시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
8749
8761
 
@@ -8751,8 +8763,8 @@ const response = await axios({
8751
8763
 
8752
8764
  ### 상품권 일반결제 유의사항
8753
8765
 
8754
- - 승인 완료시 나이스페이먼츠로부터 승인번호(`approvalNumber`)가 전달되지 않으니 이 점 유의하시기 바랍니다.
8755
- - 나이스페이먼츠는 상품권 결제시 별도의 승인 번호를 전달하지 않습니다. 따라서 결제 내역 조회시 승인 번호가 null로 리턴됩니다.
8766
+ - 승인 완료시 나이스정보통신로부터 승인번호(`approvalNumber`)가 전달되지 않으니 이 점 유의하시기 바랍니다.
8767
+ - 나이스정보통신은 상품권 결제시 별도의 승인 번호를 전달하지 않습니다. 따라서 결제 내역 조회시 승인 번호가 null로 리턴됩니다.
8756
8768
 
8757
8769
  ### 카카오페이 일반결제 유의사항
8758
8770
 
@@ -8832,9 +8844,9 @@ const response = await axios({
8832
8844
 
8833
8845
  - SSGPAY 계좌 결제 시 현금영수증 발급 정보를 확인할 수 없습니다.
8834
8846
  - SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도 승인
8835
- 완료(status: paid)시 나이스페이먼츠에서 현금영수증 발급 정보를 전달하지 않아 포트원 API로
8847
+ 완료(status: paid)시 나이스정보통신에서 현금영수증 발급 정보를 전달하지 않아 포트원 API로
8836
8848
  결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다. 단,
8837
- 나이스페이먼츠 어드민에서는 확인이 가능하오니 확인이 필요한 경우 나이스페이먼츠 어드민에서
8849
+ 나이스정보통신 어드민에서는 확인이 가능하오니 확인이 필요한 경우 나이스정보통신 어드민에서
8838
8850
  확인하시길 바랍니다.
8839
8851
 
8840
8852
  <details>
@@ -8873,7 +8885,7 @@ PortOne.requestPayment({
8873
8885
 
8874
8886
  ### API 지원 기능
8875
8887
 
8876
- 나이스페이먼츠는 API를 통해 아래 기능들을 지원합니다.
8888
+ 나이스정보통신은 API를 통해 아래 기능들을 지원합니다.
8877
8889
 
8878
8890
  - 카드 빌링키 발급
8879
8891
  - 카드 및 간편결제 빌링키 결제
@@ -8887,9 +8899,9 @@ PortOne.requestPayment({
8887
8899
  ### 가상계좌 발급 API 유의사항
8888
8900
 
8889
8901
  - 고정식 가상계좌 지원합니다.
8890
- - 나이스페이먼츠의 경우 API를 통한 고정식 가상계좌 사용을 지원합니다. 고정식 가상계좌를 사용하기
8902
+ - 나이스정보통신의 경우 API를 통한 고정식 가상계좌 사용을 지원합니다. 고정식 가상계좌를 사용하기
8891
8903
  위해서는 `virtualAccount.option.type`를 `FIXED`로 전달해야 합니다. 단, 고정식 가상계좌 및
8892
- 과오납체크를 사용하도록 나이스페이먼츠와 사전 협의가 필요합니다.
8904
+ 과오납체크를 사용하도록 나이스정보통신와 사전 협의가 필요합니다.
8893
8905
 
8894
8906
  ### 에스크로 API 유의사항
8895
8907
 
@@ -8899,23 +8911,23 @@ PortOne.requestPayment({
8899
8911
  - 배송지 주소인 `receiver.address` 파라미터가 필수입니다.
8900
8912
 
8901
8913
  - 이메일 전송 여부인 `sendEmail` 파라미터가 필수입니다.
8902
- - 나이스페이먼츠의 경우 다른 PG에서는 지원하지 않는 `sendEmail` 파라미터를 지원합니다.
8914
+ - 나이스정보통신의 경우 다른 PG에서는 지원하지 않는 `sendEmail` 파라미터를 지원합니다.
8903
8915
  - 에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부. (기본값: true | boolean type)
8904
8916
 
8905
8917
  - 배송 정보 수정 불가합니다.
8906
- - 나이스페이먼츠는 API로 에스크로 배송 정보 등록은 가능하지만 **수정은 불가능**합니다.
8918
+ - 나이스정보통신은 API로 에스크로 배송 정보 등록은 가능하지만 **수정은 불가능**합니다.
8907
8919
 
8908
8920
  ### 현금영수증 API 유의사항
8909
8921
 
8910
8922
  - 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능합니다.
8911
- - 나이스페이먼츠의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
8923
+ - 나이스정보통신의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
8912
8924
  현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한
8913
8925
  경우, 현금영수증 발급 API(`POST /cash-receipts`)를 사용한다고 하더라도 발급이 되지 않으니 참고
8914
8926
  부탁드립니다.
8915
8927
 
8916
8928
  - API로 현금영수증 발급 시, 현금영수증 카드 사용이 불가능합니다.
8917
8929
  - API로 현금영수증 발급(`POST /cash-receipts`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
8918
- 현금영수증 발행 식별 정보)를 전달해야 합니다. 단, 나이스페이먼츠의 경우 **발행 식별 정보 중
8930
+ 현금영수증 발행 식별 정보)를 전달해야 합니다. 단, 나이스정보통신의 경우 **발행 식별 정보 중
8919
8931
  현금영수증 카드 번호는 사용이 불가능**하오니 참고 부탁드립니다.
8920
8932
 
8921
8933
 
@@ -8946,9 +8958,16 @@ targetVersions:
8946
8958
  - 해외카드 비인증 : `PLCreditCard`
8947
8959
  - 해외카드 인증(3DS) : `PLCreditCardMpi`
8948
8960
  - 유니온페이 : `PLUnionPay_HC`
8949
- - 위챗페이 PC결제: `WeChatPayQRCodePayment`
8961
+ - 위챗페이 PC결제 : `WeChatPayQRCodePayment`
8950
8962
  - 위챗페이 모바일결제 : `WeChatPayH5Payment`
8951
8963
  - 알리페이 : `ICBAlipay`
8964
+ - 알리페이 HK (알리페이+) : `AlipayPlusAlipayHK`
8965
+ - BPI (알리페이+) : `AlipayPlusBPI`
8966
+ - Dana (알리페이+) : `AlipayPlusDana`
8967
+ - GCash (알리페이+) : `AlipayPlusGcash`
8968
+ - Rabbit LINE Pay (알리페이+) : `AlipayPlusRabbitLinePay`
8969
+ - Touch 'n Go (알리페이+) : `AlipayPlusTNG`
8970
+ - TrueMoney (알리페이+) : `AlipayPlusTrueMoney`
8952
8971
 
8953
8972
  ## SDK 결제 요청하기
8954
8973
 
@@ -8977,12 +8996,19 @@ targetVersions:
8977
8996
  빌링키 발급 및 결제 요청 시에는 [requestIssueBillingKeyAndPay](https://developers.portone.io/sdk/ko/v2-sdk/billing-key-and-pay-request?v=v2) 함수를 호출해야 합니다.
8978
8997
  `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 페이레터 해외결제 채널 사용을 명시해주세요.
8979
8998
 
8999
+ ## 결제수단별 승인 가능 통화
9000
+
9001
+ - 카드: `KRW`, `USD`, `JPY`
9002
+ - Alipay: `USD`, `CNY`
9003
+ - Alipay+: `USD`
9004
+ - WeChatPay: `KRW`, `USD`, `CNY`
9005
+
8980
9006
  ## 유의사항
8981
9007
 
8982
9008
  - `paymentId` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
8983
9009
  - 페이레터의 경우 구매자 이메일을 필수로 받고있어,`customer.email`을 필수로 입력하셔야 합니다.
8984
- - 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
8985
- - WeChatPay, Alipay 결제 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
9010
+ - WeChatPay, Alipay, Alipay+ 결제 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
9011
+ - 페이레터의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.
8986
9012
 
8987
9013
 
8988
9014
  # https://developers.portone.io/opi/ko/integration/pg/v2/paypal-v2
@@ -9278,33 +9304,34 @@ STC 기능을 사용하기 위해 다음 정보를 확인해 주세요.
9278
9304
  // 해당 파라미터들은 예시로 산업군에 따라 추가 또는 제외 가능한 파라미터들이 있습니다.
9279
9305
  _({
9280
9306
  additional_data: [
9307
+ // 상점의 구매자 계정 기준으로 정보 입력
9281
9308
  {
9282
- key: "sender_account_id", // 고객사 account ID(merchant-id)
9309
+ key: "sender_account_id", // 구매자 계정 ID
9283
9310
  value: "A12345N343",
9284
9311
  },
9285
9312
  {
9286
- key: "sender_first_name", // 고객사의 account에 등록된 구매자의 이름
9313
+ key: "sender_first_name", // 구매자 이름
9287
9314
  value: "John",
9288
9315
  },
9289
9316
  {
9290
- key: "sender_last_name", // 고객사의 account에 등록된 구매자의 이름
9317
+ key: "sender_last_name", // 구매자
9291
9318
  value: "Doe",
9292
9319
  },
9293
9320
  {
9294
- key: "sender_email", // 고객사의 account에 등록된 구매자의 이메일 주소
9321
+ key: "sender_email", // 구매자 이메일 주소
9295
9322
  value: "example@example.com",
9296
9323
  },
9297
9324
  {
9298
- key: "sender_phone", // 고객사의 account에 등록된 구매자의 연락처
9325
+ key: "sender_phone", // 구매자 휴대전화 번호
9299
9326
  value: "(02)16705176",
9300
9327
  },
9301
9328
  {
9302
- key: "sender_country_code", // 고객사의 account에 등록된 국가 코드
9303
- value: "KR", // ISO Alpha-2 형식 국가 코드
9329
+ key: "sender_country_code", // 구매자 국가 코드
9330
+ value: "KR", // ISO 3166-2 alpha-2 코드
9304
9331
  },
9305
9332
  {
9306
- key: "sender_create_date", // 고객사의 account에 등록된 국가 코드
9307
- value: "2023-10-10T23:59:59+09:00", // IOS8601 형식
9333
+ key: "sender_create_date", // 구매자 계정 생성 시각
9334
+ value: "2023-10-10T23:59:59+09:00", // RFC 3339 형식
9308
9335
  },
9309
9336
  ],
9310
9337
  });
@@ -10748,7 +10775,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10748
10775
  페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
10749
10776
  일반적으로 페이팔 창에서 진행되는 결제나 빌링키 발급은 페이팔이 구매자 접속 정보를 직접 확인하여 이상 거래를 판단합니다.
10750
10777
 
10751
- 하지만 발급된 빌링키로 브라우저에서 재결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
10778
+ 하지만 발급된 빌링키로 브라우저에서 결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
10752
10779
  따라서 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달해야 합니다.
10753
10780
  때문에 브라우저에서 발급된 빌링키를 이용하여 결제를 호출하는 경우 **고객사 클라이언트 페이지에 페이팔 Fraudnet 스크립트/Magnes SDK를 반드시 추가해야** 합니다.
10754
10781
 
@@ -10813,7 +10840,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10813
10840
 
10814
10841
  - 안드로이드
10815
10842
 
10816
- [**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
10843
+ [**Android Integration of Magnes**](http://developer.paypal.com/limited-release/magnes/integrate/android/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야 합니다. 이때 두 번째 파라미터(`paypalClientMetaDataId`)로는 주문번호(`paymentId`)를 전달해야 합니다.
10817
10844
 
10818
10845
  ```java title="코드 예시"
10819
10846
  MagnesResult magnesResult = MagnesSDK.getInstance()
@@ -10826,7 +10853,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10826
10853
 
10827
10854
  - iOS Switft
10828
10855
 
10829
- [**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메소드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
10856
+ [**iOS Swift SDK Integration**](http://developer.paypal.com/limited-release/magnes/integrate/ios-swift/) 가이드 문서에 따라 아래와 같이 collectAndSubmit 메서드 호출을 통해 페이팔로 디바이스 정보를 보내야합니다. 이때 첫번째 파라미터(withPayPalClientMetadataId)로는 주문번호(paymentId)를 전달해야 합니다.
10830
10857
 
10831
10858
  ```swift title="코드 예시"
10832
10859
  let magnesResult: MagnesResult =
@@ -10838,7 +10865,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
10838
10865
 
10839
10866
  - iOS Objective-C
10840
10867
 
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)를 전달해주시면 됩니다.
10868
+ [**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
10869
 
10843
10870
  ```objc title="코드 예시"
10844
10871
  //PPRMOCMagnesSDK *magnesSDK = [PPRMOCMagnesSDK shared];
@@ -10916,7 +10943,7 @@ versionVariants:
10916
10943
  - 결제창/API 정기결제 : 카드
10917
10944
  - 간편결제 허브형 : 카카오페이 / 네이버페이 / 페이코 / LPay / 핀페이
10918
10945
 
10919
- - **나이스페이먼츠**
10946
+ - **나이스정보통신**
10920
10947
 
10921
10948
  - 연동 기능: 인증결제(결제창) / 비인증결제(API) / 정기결제(API) / 간편결제(결제창/다이렉트 호출)
10922
10949
 
@@ -11005,14 +11032,6 @@ versionVariants:
11005
11032
 
11006
11033
  - 간편결제 : 토스페이
11007
11034
 
11008
- - **하이픈**
11009
-
11010
- - 연동 기능 : 간편결제(결제창)
11011
-
11012
- - 결제 수단
11013
-
11014
- - 간편결제 : 바로계좌결제
11015
-
11016
11035
  #### 해외결제
11017
11036
 
11018
11037
  - **페이팔**
@@ -11272,7 +11291,7 @@ function requestPayment() {
11272
11291
 
11273
11292
  ## SDK 빌링키 발급 요청하기
11274
11293
 
11275
- 빌링키 발급 요청 시에는 `requestBillingKeyIssue` 함수를 호출해야 합니다.
11294
+ 빌링키 발급 요청 시에는 `requestIssueBillingKey` 함수를 호출해야 합니다.
11276
11295
  `channelKey`파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 스마트로 채널 사용을 명시해주세요.
11277
11296
 
11278
11297
  스마트로 기준으로 작성한 예시 코드는 아래와 같습니다.
@@ -12767,7 +12786,7 @@ async function schedulePayment() {
12767
12786
  - 상품권 결제 요청 시, 사용하고자 하는 상품권 종류에 따라 아래 목록을 참고하여 `giftCertificateType` 파라미터를 입력해야 합니다.
12768
12787
  - 도서문화상품권 : `BOOKNLIFE`
12769
12788
  - 스마트문상 ((구)게임문화상품권) : `SMART_MUNSANG`
12770
- - 문화상품권 : `CULTURELAND`
12789
+ - 컬쳐랜드 문화상품권 : `CULTURELAND`
12771
12790
 
12772
12791
  - `paymentId`
12773
12792
  - 토스페이먼츠를 사용하는 경우 영문 대소문자, 숫자, 특수문자(-,\_)만 허용되며, 6자 이상 64자 이하만 가능합니다.
@@ -13325,13 +13344,13 @@ function requestPayment() {
13325
13344
 
13326
13345
  **PC - 카드 결제 전용 파라미터**
13327
13346
 
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) |
13347
+ |형식 |설명 |
13348
+ |---------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
13349
+ |SKIN(색상코드) |결제 창의 배경 색상 <br /> - 기본값 : #c1272c <br /> - 예시: SKIN(#fc6b2d) |
13350
+ |below1000 |1,000원 미만 결제 허용 여부 <br /> - 기본값: 허용하지 않음 |
13351
+ |paypopup |안심클릭을 팝업 형태로 렌더링 시킬지 여부 <br /> - 기본값: 레이어 |
13352
+ |onlyeasypaycode(간편 결제 리스트)|카드 결제창 내 렌더링 될 간편 결제 리스트 <br /> 예) 카카오페이, 엘페이, 페이코만 렌더링 → ”kakaopay:lpay:payco” 전달 <br /> - 카카오페이: `kakaopay` <br /> - 엘페이: `lpay` <br /> - 페이코: `payco` <br /> - 토스페이: `tosspay` <br /> - 네이버페이: `npay`|
13353
+ |SLIMQUOTA(슬림 할부 설정) |부분 무이자 설정. 슬림 할부 <br /> - 형식) SLIMQUOTA(코드-개월:개월^코드-개월:개월 <br /> - 예시) SLIMQUOTA(11-2:3^34-2:3) |
13335
13354
 
13336
13355
  **PC - 휴대폰 소액 결제 전용 파라미터**
13337
13356
 
@@ -13502,6 +13521,7 @@ SDK를 통한 결제 요청 파라미터에는 부가세를 지정할 수 있는
13502
13521
  - lpay: `LPAY`
13503
13522
  - 토스페이: `TOSSPAY`
13504
13523
  - 페이코: `PAYCO`
13524
+ - 네이버페이: `NAVERPAY`
13505
13525
 
13506
13526
  </details>
13507
13527
 
@@ -14588,7 +14608,7 @@ versionVariants:
14588
14608
  브라우저에서 포트원 SDK를 호출하여 빌링키를 발급하고, 서버로 빌링키를 전달합니다.
14589
14609
 
14590
14610
  ```ts
14591
- const issueResponse = PortOne.requestIssueBillingKey({
14611
+ const issueResponse = await PortOne.requestIssueBillingKey({
14592
14612
  storeId: "store-9bf6076d-beef-4729-9521-ae66c14e0569",
14593
14613
  channelKey: "channel-key-3b37819a-1c72-4deb-a245-8c810af5403d",
14594
14614
  billingKeyMethod: "CARD",
@@ -14964,7 +14984,8 @@ async function requestPayment() {
14964
14984
  }
14965
14985
  ```
14966
14986
 
14967
- 결과값에 들어 있는 필드는 다음과 같습니다.
14987
+ 결과값에 들어 있는 주요 필드는 다음과 같습니다.
14988
+ 전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
14968
14989
 
14969
14990
  |필드명 |설명 |비고 |
14970
14991
  |---------|-------------------|----------------------------|
@@ -14987,7 +15008,8 @@ PortOne.requestPayment({
14987
15008
  });
14988
15009
  ```
14989
15010
 
14990
- 쿼리 문자열로 전달되는 내용은 다음과 같습니다.
15011
+ 쿼리 문자열로 전달되는 주요 필드는 다음과 같습니다.
15012
+ 전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
14991
15013
 
14992
15014
  |키 |설명 |비고 |
14993
15015
  |---------|-------------------|----------------------------|
@@ -15204,7 +15226,7 @@ V2는 모든 데이터를 수집하고 기록합니다. [Event Sourcing](https:/
15204
15226
 
15205
15227
  ### 기능 확장: 신속한 업데이트와 혁신
15206
15228
 
15207
- V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될 스마트라우팅은 V2 인프라를 이용 중인 고객사에게 우선하여 제공됩니다.
15229
+ V2는 최신 결제 기능을 가장 빠르게 제공합니다.
15208
15230
  최신 기능을 통해 결제 프로세스를 혁신하고, 고객의 결제 경험을 향상시킬 수 있습니다.
15209
15231
 
15210
15232
  ## 사용 가능한 PG사
@@ -15218,13 +15240,12 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다. 곧 출시될
15218
15240
  - **카카오페이**
15219
15241
  - **네이버페이**
15220
15242
  - **스마트로**
15221
- - **나이스페이먼츠**
15243
+ - **나이스정보통신**
15222
15244
  - **페이팔**
15223
15245
  - **KG이니시스**
15224
15246
  - **한국결제네트웍스(KPN)**
15225
15247
  - **NHN KCP**
15226
15248
  - **토스페이**
15227
- - **하이픈 바로계좌결제**
15228
15249
 
15229
15250
  ### 본인인증
15230
15251
 
@@ -15257,8 +15278,6 @@ versionVariants:
15257
15278
  v1: /opi/ko/integration/webhook/readme-v1
15258
15279
  ---
15259
15280
 
15260
- (관련 이미지 첨부)
15261
-
15262
15281
  ## 웹훅(Webhook) 이란?
15263
15282
 
15264
15283
  특정 이벤트가 발생하였을 때 타 서비스나 응용프로그램으로 알림을 보내는 기능입니다.
@@ -15298,7 +15317,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
15298
15317
  - `Transaction.PartialCancelled`: **결제가 부분 취소**되었을 때
15299
15318
  - `Transaction.Cancelled`: **결제가 완전 취소**되었을 때
15300
15319
  - `Transaction.Failed`: **결제(예약 결제 포함)가 실패**했을 때
15301
- - `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (해외 결제시 발생 가능)
15320
+ - `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
15302
15321
  - `Transaction.CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
15303
15322
  - `Transaction.DisputeCreated`: **분쟁이 발생**되었을 때
15304
15323
  - `Transaction.DisputeResolved`: **분쟁이 해소**되었을 때
@@ -15379,7 +15398,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
15379
15398
  - `PartialCancelled`: **결제가 부분 취소**되었을 때
15380
15399
  - `Cancelled`: **결제가 완전 취소**되었을 때
15381
15400
  - `Failed`: **결제(예약 결제 포함)가 실패**했을 때
15382
- - `PayPending`: **결제 승인 대기** 상태가 되었을 때 (해외 결제시 발생 가능)
15401
+ - `PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
15383
15402
  - `CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
15384
15403
 
15385
15404
  웹훅 payload 예시:
@@ -15834,7 +15853,7 @@ Connection Timeout 및 Read Timeout 모두 30초 입니다.
15834
15853
 
15835
15854
  **웹훅 처리 전에 브라우저 결제 완료 처리가 진행되는 경우**
15836
15855
 
15837
- 기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <support@portone.io> 로 고객사 식별코드를 기재하여 요청해 주시면 됩니다.
15856
+ 기본적으로 포트원 서버는 웹훅을 호출한 뒤 고객사 응답을 기다리지 않고 브라우저에 302 redirect 응답을 보내기 때문에 결과 도달에 대한 순서를 보장하지 않습니다. 다만 고객사 요청이 있을 경우 webhook 호출 이후에 브라우저에 302 redirect 또는 callback 응답을 보내어 순서를 보장해 드리고 있습니다. 웹훅 우선순위 요청은 <tech.support@portone.io> 로 상점 아이디(storeId)를 기재하여 요청해 주시면 됩니다.
15838
15857
 
15839
15858
  </div>
15840
15859
 
@@ -16017,16 +16036,6 @@ ni @portone/browser-sdk
16017
16036
 
16018
16037
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'inicis' END -->
16019
16038
 
16020
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
16021
-
16022
- <div class="hint" data-style="warning">
16023
-
16024
- 하이픈의 경우 영문 대소문자, 숫자, `_`만 허용되며, 50자 이하로 입력합니다.
16025
-
16026
- </div>
16027
-
16028
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
16029
-
16030
16039
  - orderName: string
16031
16040
 
16032
16041
  **주문명**
@@ -16037,7 +16046,7 @@ ni @portone/browser-sdk
16037
16046
 
16038
16047
  <div class="hint" data-style="warning">
16039
16048
 
16040
- 나이스페이먼츠의 경우 최대 40바이트까지 입력할 수 있으며, 사용 가능한 특수문자는 아래와 같습니다.
16049
+ 나이스정보통신의 경우 최대 40바이트까지 입력할 수 있으며, 사용 가능한 특수문자는 아래와 같습니다.
16041
16050
 
16042
16051
  - 사용 가능: `_`
16043
16052
  - 사용 불가: `% & | $ - + = [ ]`
@@ -16098,16 +16107,6 @@ ni @portone/browser-sdk
16098
16107
 
16099
16108
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'naver' END -->
16100
16109
 
16101
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
16102
-
16103
- <div class="hint" data-style="warning">
16104
-
16105
- 하이픈의 경우 최대 1000바이트까지 입력할 수 있습니다.
16106
-
16107
- </div>
16108
-
16109
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
16110
-
16111
16110
  - totalAmount: number
16112
16111
 
16113
16112
  **결제 금액**
@@ -16141,7 +16140,7 @@ ni @portone/browser-sdk
16141
16140
 
16142
16141
  <div class="hint" data-style="warning">
16143
16142
 
16144
- 나이스페이먼츠는 `KRW`만을 지원합니다.
16143
+ 나이스정보통신은 `KRW`만을 지원합니다.
16145
16144
 
16146
16145
  </div>
16147
16146
 
@@ -16337,11 +16336,11 @@ ni @portone/browser-sdk
16337
16336
 
16338
16337
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' END -->
16339
16338
 
16340
- <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) START -->
16339
+ <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'].includes(name) START -->
16341
16340
 
16342
16341
  - 간편결제: `EASY_PAY`
16343
16342
 
16344
- <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) END -->
16343
+ <!-- CONDITIONAL CONTENT pgName=(name) => ['kakao', 'naver', 'tosspay'].includes(name) END -->
16345
16344
 
16346
16345
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'eximbay' START -->
16347
16346
 
@@ -16379,7 +16378,7 @@ ni @portone/browser-sdk
16379
16378
 
16380
16379
  <div class="hint" data-style="warning">
16381
16380
 
16382
- 나이스페이먼츠의 경우 카드사 단독 노출 시 `card.installment.monthOption.fixedMonth`를 필수로 지정해야 합니다.
16381
+ 나이스정보통신의 경우 카드사 단독 노출 시 `card.installment.monthOption.fixedMonth`를 필수로 지정해야 합니다.
16383
16382
  결제 금액이 할부 지원 금액 미만인 경우 할부 개월 수를 `0`으로 전달해야 합니다.
16384
16383
 
16385
16384
  </div>
@@ -16677,7 +16676,7 @@ ni @portone/browser-sdk
16677
16676
 
16678
16677
  <div class="hint" data-style="warning">
16679
16678
 
16680
- 나이스페이먼츠의 경우 카드사 포인트 사용 시 별도 계약이 필요합니다.
16679
+ 나이스정보통신의 경우 카드사 포인트 사용 시 별도 계약이 필요합니다.
16681
16680
 
16682
16681
  </div>
16683
16682
 
@@ -16900,7 +16899,7 @@ ni @portone/browser-sdk
16900
16899
 
16901
16900
  <div class="hint" data-style="warning">
16902
16901
 
16903
- 나이스페이먼츠의 경우 입금 만료기한을 필수로 입력해야 합니다.
16902
+ 나이스정보통신의 경우 입금 만료기한을 필수로 입력해야 합니다.
16904
16903
 
16905
16904
  </div>
16906
16905
 
@@ -17067,7 +17066,7 @@ ni @portone/browser-sdk
17067
17066
 
17068
17067
  <div class="hint" data-style="warning">
17069
17068
 
17070
- 나이스페이먼츠의 경우 상품권 유형을 필수로 지정해야 합니다.s
17069
+ 나이스정보통신의 경우 상품권 유형을 필수로 지정해야 합니다.s
17071
17070
 
17072
17071
  </div>
17073
17072
 
@@ -17091,19 +17090,19 @@ ni @portone/browser-sdk
17091
17090
 
17092
17091
  - `BOOKNLIFE` (도서문화상품권)
17093
17092
  - `SMART_MUNSANG` (스마트문상, (구)게임문화상품권)
17094
- - `CULTURELAND` (문화상품권)
17093
+ - `CULTURELAND` (컬쳐랜드 문화상품권)
17095
17094
 
17096
17095
  <!-- CONDITIONAL CONTENT pgName=(name) => ['toss', 'inicis'].includes(name) END -->
17097
17096
 
17098
17097
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "nice" START -->
17099
17098
 
17100
- - `CULTURELAND` (문화상품권)
17099
+ - `CULTURELAND` (컬쳐랜드 문화상품권)
17101
17100
 
17102
17101
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "nice" END -->
17103
17102
 
17104
17103
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' START -->
17105
17104
 
17106
- - `CULTURELAND` (문화상품권)
17105
+ - `CULTURELAND` (컬쳐랜드 문화상품권)
17107
17106
  - `BOOKNLIFE` (도서문화상품권)
17108
17107
 
17109
17108
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'kcp' END -->
@@ -17120,7 +17119,7 @@ ni @portone/browser-sdk
17120
17119
 
17121
17120
  `payMethod`가 `EASY_PAY`인 경우 간편결제와 관련한 추가 정보를 입력할 수 있습니다.
17122
17121
 
17123
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) START -->
17122
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'].includes(name) START -->
17124
17123
 
17125
17124
  - easyPayProvider?: string
17126
17125
 
@@ -17251,7 +17250,7 @@ ni @portone/browser-sdk
17251
17250
 
17252
17251
  </details>
17253
17252
 
17254
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay', 'hyphen'].includes(name) END -->
17253
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kakao', 'naver', 'tosspay'].includes(name) END -->
17255
17254
 
17256
17255
  <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'ksnet'].includes(name) START -->
17257
17256
 
@@ -17263,7 +17262,7 @@ ni @portone/browser-sdk
17263
17262
 
17264
17263
  <div class="hint" data-style="warning">
17265
17264
 
17266
- 나이스페이먼츠의 경우 카카오페이, 네이버페이, 애플페이, LPAY 사용 시 상점분담 무이자를 사용하실 수 없습니다.
17265
+ 나이스정보통신의 경우 카카오페이, 네이버페이, 애플페이, LPAY 사용 시 상점분담 무이자를 사용하실 수 없습니다.
17267
17266
 
17268
17267
  </div>
17269
17268
 
@@ -17279,7 +17278,7 @@ ni @portone/browser-sdk
17279
17278
 
17280
17279
  <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis'].includes(name) END -->
17281
17280
 
17282
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay', 'hyphen'].includes(name) START -->
17281
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'].includes(name) START -->
17283
17282
 
17284
17283
  - availableCards?: string\[]
17285
17284
 
@@ -17388,7 +17387,7 @@ ni @portone/browser-sdk
17388
17387
 
17389
17388
  </details>
17390
17389
 
17391
- <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay', 'hyphen'].includes(name) END -->
17390
+ <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'inicis', 'naver', 'tosspay'].includes(name) END -->
17392
17391
 
17393
17392
  <!-- CONDITIONAL CONTENT pgName=(name) => !['kpn', 'naverpay'].includes(name) START -->
17394
17393
 
@@ -17400,7 +17399,7 @@ ni @portone/browser-sdk
17400
17399
 
17401
17400
  <div class="hint" data-style="warning">
17402
17401
 
17403
- 나이스페이먼츠의 경우 할부 사용 시 별도 계약이 필요합니다.
17402
+ 나이스정보통신의 경우 할부 사용 시 별도 계약이 필요합니다.
17404
17403
 
17405
17404
  </div>
17406
17405
 
@@ -17523,7 +17522,7 @@ ni @portone/browser-sdk
17523
17522
 
17524
17523
  <div class="hint" data-style="warning">
17525
17524
 
17526
- 나이스페이먼츠의 경우 일부 간편결제 수단에 대해 `availablePayMethods`가 필수입니다.
17525
+ 나이스정보통신의 경우 일부 간편결제 수단에 대해 `availablePayMethods`가 필수입니다.
17527
17526
 
17528
17527
  - 네이버페이: 카드 결제인 경우 `CARD`, 포인트 혹은 머니 결제인 경우 `CHARGE`를 입력합니다.
17529
17528
  - SSG페이: 계좌 결제를 노출하는 `TRANSFER`만 유효하며, 카드 혹은 머니 결제인 경우 `availablePayMethods`를 생략해야 합니다.
@@ -17559,7 +17558,7 @@ ni @portone/browser-sdk
17559
17558
 
17560
17559
  <div class="hint" data-style="warning">
17561
17560
 
17562
- 나이스페이먼츠와 계약 시 지정된 면세금액을 반드시 입력해야 합니다.
17561
+ 나이스정보통신와 계약 시 지정된 면세금액을 반드시 입력해야 합니다.
17563
17562
 
17564
17563
  </div>
17565
17564
 
@@ -17672,16 +17671,6 @@ ni @portone/browser-sdk
17672
17671
 
17673
17672
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'naver' END -->
17674
17673
 
17675
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
17676
-
17677
- <div class="hint" data-style="warning">
17678
-
17679
- 하이픈의 경우 구매자 이름을 필수로 입력해야 합니다.
17680
-
17681
- </div>
17682
-
17683
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
17684
-
17685
17674
  <!-- CONDITIONAL CONTENT pgName=(name) => name === 'eximbay' START -->
17686
17675
 
17687
17676
  <div class="hint" data-style="warning">
@@ -17843,7 +17832,7 @@ ni @portone/browser-sdk
17843
17832
 
17844
17833
  <div class="hint" data-style="warning">
17845
17834
 
17846
- 나이스페이먼츠와 별도 계약이 필요합니다.
17835
+ 나이스정보통신와 별도 계약이 필요합니다.
17847
17836
 
17848
17837
  </div>
17849
17838
 
@@ -17868,7 +17857,7 @@ ni @portone/browser-sdk
17868
17857
 
17869
17858
  <div class="hint" data-style="warning">
17870
17859
 
17871
- 나이스페이먼츠와 별도 계약이 필요합니다.
17860
+ 나이스정보통신와 별도 계약이 필요합니다.
17872
17861
 
17873
17862
  </div>
17874
17863
 
@@ -17909,7 +17898,7 @@ ni @portone/browser-sdk
17909
17898
 
17910
17899
  <div class="hint" data-style="warning">
17911
17900
 
17912
- 나이스페이먼츠와 별도 계약이 필요합니다.
17901
+ 나이스정보통신와 별도 계약이 필요합니다.
17913
17902
 
17914
17903
  </div>
17915
17904
 
@@ -17921,7 +17910,7 @@ ni @portone/browser-sdk
17921
17910
 
17922
17911
  <div class="hint" data-style="warning">
17923
17912
 
17924
- 나이스페이먼츠와 별도 계약이 필요합니다.
17913
+ 나이스정보통신와 별도 계약이 필요합니다.
17925
17914
 
17926
17915
  </div>
17927
17916
 
@@ -17936,7 +17925,7 @@ ni @portone/browser-sdk
17936
17925
 
17937
17926
  <div class="hint" data-style="warning">
17938
17927
 
17939
- 나이스페이먼츠와 별도 계약이 필요합니다.
17928
+ 나이스정보통신와 별도 계약이 필요합니다.
17940
17929
 
17941
17930
  </div>
17942
17931
 
@@ -18214,18 +18203,6 @@ ni @portone/browser-sdk
18214
18203
 
18215
18204
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "tosspay" END -->
18216
18205
 
18217
- <!-- CONDITIONAL CONTENT pgName=(name) => name === "hyphen" START -->
18218
-
18219
- - hyphen?: object
18220
-
18221
- - designCd?: string
18222
-
18223
- **결제창 디자인 코드**
18224
-
18225
- `#`으로 시작하는 여섯 자리 16진수 코드입니다.
18226
-
18227
- <!-- CONDITIONAL CONTENT pgName=(name) => name === "hyphen" END -->
18228
-
18229
18206
  <!-- CONDITIONAL CONTENT pgName=(name) => name === "eximbay" START -->
18230
18207
 
18231
18208
  - eximbay?: object
@@ -18577,16 +18554,6 @@ ni @portone/browser-sdk
18577
18554
 
18578
18555
  **상점 사업자명**
18579
18556
 
18580
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' START -->
18581
-
18582
- <div class="hint" data-style="warning">
18583
-
18584
- 하이픈의 경우 미입력 시 대표상점명으로 설정됩니다.
18585
-
18586
- </div>
18587
-
18588
- <!-- CONDITIONAL CONTENT pgName=(name) => name === 'hyphen' END -->
18589
-
18590
18557
  - businessRegistrationNumber?: string
18591
18558
 
18592
18559
  **상점 사업자 번호**
@@ -18627,7 +18594,7 @@ ni @portone/browser-sdk
18627
18594
 
18628
18595
  <div class="hint" data-style="warning">
18629
18596
 
18630
- 나이스페이먼츠의 경우 에스크로 사용 시 별도 계약이 필요합니다.
18597
+ 나이스정보통신의 경우 에스크로 사용 시 별도 계약이 필요합니다.
18631
18598
 
18632
18599
  </div>
18633
18600
 
@@ -20070,7 +20037,7 @@ targetVersions:
20070
20037
 
20071
20038
  - 결제대행사 필터는 하나의 결제대행사에 모든 `pg_provider`가 포함됩니다.
20072
20039
  - KG이니시스 : inicis, html5\_inicis, inicis\_v2
20073
- - 나이스페이먼츠 : nice, nice\_v2
20040
+ - 나이스정보통신 : nice, nice\_v2
20074
20041
  - 페이팔 : paypal, paypal\_v2
20075
20042
  - 스마트로 : smartro, smartro\_v2
20076
20043
  - 토스페이 : tosspay, tosspay\_v2
@@ -21340,7 +21307,7 @@ description: 결제대행사 및 결제수단을 선택하고 전자결제를
21340
21307
 
21341
21308
  - [V2 연동 매뉴얼 바로가기](https://developers.portone.io/opi/ko/integration/ready/readme?v=v2)
21342
21309
 
21343
- - 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <support@portone.io>**
21310
+ - 연동과 관련하여 궁금하신 사항은 **포트원 기술지원 이메일 <tech.support@portone.io>**
21344
21311
  또는 채널톡으로 문의 주시기 바랍니다.
21345
21312
 
21346
21313
 
@@ -21356,9 +21323,9 @@ description: >-
21356
21323
  ## PG 거래대사 유의사항
21357
21324
 
21358
21325
  - 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
21359
- - 지원 PG : **KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
21326
+ - 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
21360
21327
  - 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
21361
- - 9/26 이후 지원 예정 PG사 : KPN, 하이픈, KSNET
21328
+ - 9/26 이후 지원 예정 PG사 : KPN, KSNET
21362
21329
 
21363
21330
  - 고객사 주문번호를 정확하게 확인하기 위해서는 **실제 사용하시는 주문번호의 연동**이 필요합니다.
21364
21331
 
@@ -22572,7 +22539,7 @@ targetVersions:
22572
22539
  ## 프로모션이란?
22573
22540
 
22574
22541
  고객사가 카드사와 계약하여 사용자에게 즉시 할인을 제공하는 **카드 즉시 할인 서비스**를 운영하고 관리할
22575
- 수 있는 서비스 입니다.
22542
+ 수 있는 서비스입니다.
22576
22543
 
22577
22544
  카드 즉시 할인 서비스를 이용시 필요한 **프로모션 관리 시스템**과 **프로모션 정산 대사 시스템** 을 제공합니다.
22578
22545
  포트원 콘솔에서 기간, 할인 조건, 예산 등 다양한 옵션의 프로모션을 설정할 수 있으며,
@@ -22918,7 +22885,7 @@ async function cancelPayment() {
22918
22885
 
22919
22886
  ---
22920
22887
  title: 스마트 라우팅 - 콘솔 가이드
22921
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
22888
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
22922
22889
  targetVersions:
22923
22890
  - v1
22924
22891
  - v2
@@ -22995,7 +22962,7 @@ targetVersions:
22995
22962
 
22996
22963
  ---
22997
22964
  title: 스마트 라우팅 - 연동하기
22998
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
22965
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
22999
22966
  targetVersions:
23000
22967
  - v1
23001
22968
  - v2
@@ -24308,7 +24275,7 @@ if (!issueResponse.ok)
24308
24275
  사용 가능한 빌링키가 없는 경우 그룹 내 채널 비율이 0으로 설정되어있더라도 해당 결제대행사로 결제가
24309
24276
  일어날 수 있습니다.
24310
24277
 
24311
- 예를 들어, 그룹 내에 나이스페이먼츠, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
24278
+ 예를 들어, 그룹 내에 나이스정보통신, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
24312
24279
  발급 시 3개의 결제대행사로부터 빌링키를 발급 받은 후 슈퍼 빌링키에 맵핑 됩니다.
24313
24280
  이후 그룹 설정을 토스페이먼츠 0%, 스마트로 100%로 변경한 경우 위에 발급한 슈퍼 빌링키로 결제 요청 시
24314
24281
  토스페이먼츠 빌링키만 사용이 가능하기 때문에 0%로 결제 비율이 설정되어있음에도 토스페이먼츠로 결제가
@@ -24323,7 +24290,7 @@ if (!issueResponse.ok)
24323
24290
 
24324
24291
  ---
24325
24292
  title: 스마트 라우팅
24326
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
24293
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
24327
24294
  targetVersions:
24328
24295
  - v1
24329
24296
  - v2
@@ -24354,8 +24321,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24354
24321
 
24355
24322
  ### 결제창(SDK) 인증결제
24356
24323
 
24357
- - **나이스페이먼츠(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24358
- - **(구) 나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24324
+ - **나이스정보통신(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24325
+ - **(구) 나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24359
24326
  - **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24360
24327
  - **KG 이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24361
24328
  - **토스페이먼츠(신모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
@@ -24370,11 +24337,10 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24370
24337
  - **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24371
24338
  - **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24372
24339
  - **엑심베이** : 카드
24373
- - **하이픈** : 실시간 계좌이체
24374
24340
 
24375
24341
  ### API 수기(키인)결제
24376
24342
 
24377
- - **나이스페이먼츠(신모듈)** : 카드
24343
+ - **나이스정보통신(신모듈)** : 카드
24378
24344
  - **NHN KCP** : 카드
24379
24345
  - **KG 이니시스** : 카드
24380
24346
  - **토스페이먼츠(신모듈)** : 카드
@@ -24383,8 +24349,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24383
24349
 
24384
24350
  ### API 빌링키 발급 및 정기결제
24385
24351
 
24386
- - **나이스페이먼츠 (신모듈)** : 카드
24387
- - **(구) 나이스페이먼츠** : 카드
24352
+ - **나이스정보통신 (신모듈)** : 카드
24353
+ - **(구) 나이스정보통신** : 카드
24388
24354
  - **NHN KCP** : 카드
24389
24355
  - **KG이니시스** : 카드
24390
24356
  - **토스페이먼츠(신모듈)** : 카드
@@ -24399,7 +24365,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24399
24365
 
24400
24366
  ### 결제창(SDK) 인증결제
24401
24367
 
24402
- - **나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24368
+ - **나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24403
24369
  - **KG이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
24404
24370
  - **토스페이먼츠** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
24405
24371
  - **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
@@ -24409,7 +24375,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24409
24375
 
24410
24376
  ### API 수기(키인)결제
24411
24377
 
24412
- - **나이스페이먼츠** : 카드 / 가상계좌
24378
+ - **나이스정보통신** : 카드 / 가상계좌
24413
24379
  - **KG이니시스** : 카드 / 가상계좌
24414
24380
  - **토스페이먼츠** : 카드 / 가상계좌
24415
24381
  - **한국결제네트웍스(KPN)** : 카드 / 가상계좌
@@ -24419,7 +24385,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
24419
24385
 
24420
24386
  ### API 빌링키 발급 및 정기결제
24421
24387
 
24422
- - **나이스페이먼츠** : 카드
24388
+ - **나이스정보통신** : 카드
24423
24389
  - **KG이니시스** : 카드
24424
24390
  - **토스페이먼츠** : 카드
24425
24391
  - **한국결제네트웍스(KPN)** : 카드
@@ -24614,7 +24580,7 @@ targetVersions:
24614
24580
 
24615
24581
  <details>
24616
24582
 
24617
- <summary>나이스페이먼츠</summary>
24583
+ <summary>나이스정보통신</summary>
24618
24584
 
24619
24585
  <div class="hint" data-style="info">
24620
24586
 
@@ -24622,16 +24588,16 @@ targetVersions:
24622
24588
 
24623
24589
  </div>
24624
24590
 
24625
- 1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
24591
+ 1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
24626
24592
  2. \[가맹점정보]→\[KEY관리]를 클릭합니다.
24627
24593
  3. MID 및 Key 값을 확인할 수 있습니다.
24628
24594
 
24629
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 KEY 조회 화면)
24595
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 KEY 조회 화면)
24630
24596
 
24631
24597
  4. \[가맹점정보]→\[비밀번호관리]→\[거래취소비밀번호]를 클릭합니다.
24632
24598
  5. 비밀번호를 설정합니다. 비밀번호는 최대 10자리까지 가능합니다.
24633
24599
 
24634
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 거래취소비밀번호 설정 화면)
24600
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 거래취소비밀번호 설정 화면)
24635
24601
 
24636
24602
  6. 포트원 콘솔에서 채널 추가 시 \[MID], \[Key], \[결제취소 비밀번호]를 입력한 후 `저장`을 클릭합니다.
24637
24603
 
@@ -24950,7 +24916,17 @@ targetVersions:
24950
24916
 
24951
24917
  <div class="tabs-content" data-title="통합 본인인증">
24952
24918
 
24953
- 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와\[apikey]를 입력한`저장`을 클릭합니다.
24919
+ 1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속로그인을 합니다.
24920
+ 2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
24921
+ 3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
24922
+
24923
+ - 본인인증 서비스를 이용하는 고객사 서비스 도메인
24924
+ - iamport.co
24925
+ - iamport.kr
24926
+
24927
+ (이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
24928
+
24929
+ 4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
24954
24930
 
24955
24931
  </div>
24956
24932
 
@@ -25046,7 +25022,17 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
25046
25022
 
25047
25023
  <div class="tabs-content" data-title="통합 본인인증">
25048
25024
 
25049
- 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID] \[apikey]를 입력한 `저장`을 클릭합니다.
25025
+ 1. [KG이니시스 가맹점관리자](https://iniweb.inicis.com/security/login.do) 접속로그인을 합니다.
25026
+ 2. \[상점정보]→\[계약정보]→\[KEY 정보]를 클릭합니다.
25027
+ 3. \[부가서비스 연동 Key 정보]→\[통합인증 서비스] 항목에서 \[도메인 등록] 버튼을 클릭 후 아래 3개의 도메인을 등록합니다.
25028
+
25029
+ - 본인인증 서비스를 이용하는 고객사 서비스 도메인
25030
+ - iamport.co
25031
+ - iamport.kr
25032
+
25033
+ (이미지 첨부: KG이니시스 가맹점관리자 내 도메인 등록화면)
25034
+
25035
+ 4. 포트원 콘솔에서 채널 추가 시 계약 완료 후 KG이니시스로부터 전달받은 \[MID]와 \[apikey]를 입력한 후 `저장`을 클릭합니다.
25050
25036
 
25051
25037
  </div>
25052
25038
 
@@ -25302,38 +25288,6 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
25302
25288
 
25303
25289
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
25304
25290
 
25305
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
25306
-
25307
- <details>
25308
-
25309
- <summary>하이픈</summary>
25310
-
25311
- 1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
25312
- 로그인을 합니다.
25313
-
25314
- (이미지 첨부: HYPHEN 백오피스 로그인 화면)
25315
-
25316
- 2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
25317
-
25318
- 3. 상점명을 클릭합니다.
25319
-
25320
- (이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
25321
-
25322
- 4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
25323
-
25324
- (이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
25325
-
25326
- 5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
25327
-
25328
- (이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
25329
-
25330
- 6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
25331
- 입력한 후 \[저장]을 클릭합니다.
25332
-
25333
- </details>
25334
-
25335
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
25336
-
25337
25291
  #### 해외 결제대행사
25338
25292
 
25339
25293
  <details>
@@ -25371,6 +25325,24 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
25371
25325
 
25372
25326
  3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
25373
25327
 
25328
+ #### 핑백(Pingback) URL 설정하기
25329
+
25330
+ 페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
25331
+
25332
+ 1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
25333
+
25334
+ (이미지 첨부: 페이먼트월 My Projects 메뉴)
25335
+
25336
+ 2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
25337
+
25338
+ (이미지 첨부: 페이먼트월 프로젝트 setting 탭)
25339
+
25340
+ 3. \[Pingback type]을 `URL`로 선택합니다.
25341
+ 4. \[Pingback URL]에 `https://service.iamport.kr/paymentwall/webhook`를 입력합니다.
25342
+ 5. \[Pingback signature version]을 `3`으로 설정합니다.
25343
+
25344
+ (이미지 첨부: 페이먼트월 Pingback 설정 화면)
25345
+
25374
25346
  </details>
25375
25347
 
25376
25348
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -25476,8 +25448,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
25476
25448
 
25477
25449
  </details>
25478
25450
 
25479
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
25480
-
25481
25451
  <details>
25482
25452
 
25483
25453
  <summary>페이레터 해외결제</summary>
@@ -25487,8 +25457,6 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
25487
25457
 
25488
25458
  </details>
25489
25459
 
25490
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
25491
-
25492
25460
  ## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
25493
25461
 
25494
25462
  포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.
@@ -25561,85 +25529,61 @@ targetVersions:
25561
25529
  - v2
25562
25530
  ---
25563
25531
 
25564
- ## 포트원 MCP (Model Context Protocol) 서버
25565
-
25566
- 포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)
25567
-
25568
- 포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
25569
- AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
25570
-
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
- ```
25532
+ ## 포트원 MCP (Model Context Protocol) 서버
25591
25533
 
25592
- <div class="hint" data-style="info">
25534
+ 포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)
25593
25535
 
25594
- 사용 환경에 [uv](https://docs.astral.sh/uv/getting-started/installation/)가 설치되어 있어야 합니다.
25536
+ 포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
25537
+ AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
25595
25538
 
25596
- </div>
25539
+ 이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
25540
+ 아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
25597
25541
 
25598
- 설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
25542
+ - 채널 목록 조회
25543
+ - 테스트 채널 추가
25544
+ - 하위 상점 조회
25545
+ - 결제 내역 조회
25599
25546
 
25600
- #### 포트원 기능 사용하기
25547
+ ### DXT를 이용한 설치
25601
25548
 
25602
- MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
25549
+ [DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
25603
25550
 
25604
- - 결제 내역 단건/다건 조회
25605
- - 본인인증 내역 단건/다건 조회
25551
+ 1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
25552
+ 2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
25553
+ 3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
25606
25554
 
25607
- 연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
25555
+ <div class="hint" data-style="warning">
25608
25556
 
25609
- ```json
25610
- {
25611
- // ...
25557
+ **Claude Desktop에서 DXT 파일 사용 시 주의사항**
25612
25558
 
25613
- "mcpServers": {
25614
- // ...
25559
+ 현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 수 있습니다.
25615
25560
 
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
- ```
25561
+ 이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
25627
25562
 
25628
- <div class="hint" data-style="warning">
25563
+ </div>
25629
25564
 
25630
- **API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
25565
+ ### MCP 서버 등록하기
25631
25566
 
25632
- 내부의 인가된 인원만이 MCP 서버를 사용할 수 있도록 통제해야 합니다.
25567
+ 1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
25633
25568
 
25634
- </div>
25569
+ 2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
25635
25570
 
25636
- <div class="hint" data-style="warning">
25571
+ ```jsonc
25572
+ "mcpServers": {
25637
25573
 
25638
- **MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
25574
+ // 기존 설정
25639
25575
 
25640
- 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
25576
+ "portone-mcp-server": {
25577
+ "command": "npx",
25578
+ "args": [
25579
+ "-y",
25580
+ "@portone/mcp-server@latest"
25581
+ ]
25582
+ }
25583
+ }
25584
+ ```
25641
25585
 
25642
- </div>
25586
+ 3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
25643
25587
 
25644
25588
  <div class="hint" data-style="warning">
25645
25589
 
@@ -25650,7 +25594,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
25650
25594
 
25651
25595
  </div>
25652
25596
 
25653
- ### 2. MCP 서버 활용하기
25597
+ ### MCP 서버 활용하기
25654
25598
 
25655
25599
  사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
25656
25600
 
@@ -25720,8 +25664,8 @@ targetVersions:
25720
25664
  |키움페이 |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
25665
  |토스페이먼츠(신모듈) |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
25666
  |스마트로(신모듈) |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) |
25667
+ |나이스정보통신(구모듈)|nice |[https://service.iamport.kr/nice\_payments/notice\_vbank](http://service.iamport.kr/nice_payments/notice_vbank) |
25668
+ |나이스정보통신(신모듈)|nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) |
25725
25669
  |웰컴페이먼츠 |welcome |[https://tx-gateway-service.prod.iamport.co/welcome](http://tx-gateway-service.prod.iamport.co/welcome) |
25726
25670
 
25727
25671
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -25732,7 +25676,7 @@ targetVersions:
25732
25676
  |----------------|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------|-|
25733
25677
  |토스페이먼츠 |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
25678
  |스마트로 |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) | |
25679
+ |나이스정보통신 |nice\_v2 |[https://tx-gateway-service.prod.iamport.co/nicepay-v2](http://tx-gateway-service.prod.iamport.co/nicepay-v2) | |
25736
25680
  |KG이니시스 |inicis\_v2 |[https://tx-gateway-service.prod.iamport.co/inicis-v2](http://tx-gateway-service.prod.iamport.co/inicis-v2) | |
25737
25681
  |한국결제네트웍스|kpn |[https://tx-gateway-service.prod.iamport.co/kpn/virtual-account](http://tx-gateway-service.prod.iamport.co/kpn/virtual-account) | |
25738
25682
  |NHN KCP |kcp\_v2 |[https://tx-gateway-service.prod.iamport.co/kcp-v2](http://tx-gateway-service.prod.iamport.co/kcp-v2) | |
@@ -25773,9 +25717,9 @@ targetVersions:
25773
25717
 
25774
25718
  <details>
25775
25719
 
25776
- <summary>나이스페이먼츠(구모듈) 설정 방법</summary>
25720
+ <summary>나이스정보통신(구모듈) 설정 방법</summary>
25777
25721
 
25778
- 1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
25722
+ 1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
25779
25723
  2. \[가맹점정보]→\[기본정보]를 클릭합니다.
25780
25724
  3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://service.iamport.kr/nice_payments/notice_vbank` 로 설정해주세요.
25781
25725
  4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
@@ -25785,7 +25729,7 @@ targetVersions:
25785
25729
  - 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
25786
25730
  - 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
25787
25731
 
25788
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면)
25732
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면)
25789
25733
 
25790
25734
  </details>
25791
25735
 
@@ -25878,9 +25822,9 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
25878
25822
 
25879
25823
  <details>
25880
25824
 
25881
- <summary>나이스페이먼츠(신모듈) 설정 방법</summary>
25825
+ <summary>나이스정보통신(신모듈) 설정 방법</summary>
25882
25826
 
25883
- 1. [나이스페이먼츠 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
25827
+ 1. [나이스정보통신 가맹점 관리자](http://npg.nicepay.co.kr/merchant/mkeyMngForm.do) 접속 후 로그인을 합니다.
25884
25828
  2. \[가맹점정보]→\[기본정보]를 클릭합니다.
25885
25829
  3. \[결제데이터통보] 항목에서 **가상계좌**의 \[URL/IP]를 `https://tx-gateway-service.prod.iamport.co/nicepay-v2` 로 설정해주세요.
25886
25830
  4. \[재전송 간격]은 1분, \[재전송 횟수]는 3회로 설정해주세요.
@@ -25890,7 +25834,7 @@ KSNET은 포트원을 통해 발급된 MID에 대해 자동으로 입금통보 U
25890
25834
  - 재전송 간격: 최소 1분 \~ 최대 10분까지만 입력 가능합니다.
25891
25835
  - 재전송 횟수: 최소 1회 \~ 최대 10회까지 재전송 가능합니다.(전송 실패 건에 대해 자동 재전송)
25892
25836
 
25893
- (이미지 첨부: 나이스페이먼츠 가맹점 관리자 내 입금통보 URL 설정 화면 )
25837
+ (이미지 첨부: 나이스정보통신 가맹점 관리자 내 입금통보 URL 설정 화면 )
25894
25838
 
25895
25839
  </details>
25896
25840
 
@@ -26176,19 +26120,244 @@ targetVersions:
26176
26120
 
26177
26121
  포트원 결제 연동 및 운영 과정에서 기술적인 어려움을 겪고 있다면, 아래 메일로 문의하세요.
26178
26122
 
26179
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
26123
+ - <tech.support@portone.io>
26180
26124
 
26181
- - V1: <support@portone.io>
26182
- - V2: <tech.support@portone.io>
26183
26125
 
26184
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
26126
+ # https://developers.portone.io/opi/ko/support/pg-terms
26185
26127
 
26186
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
26128
+ ---
26129
+ title: 용어 사전
26130
+ description: 온라인 결제 시스템에서 자주 사용되는 용어들을 설명합니다.
26131
+ targetVersions:
26132
+ - v1
26133
+ - v2
26134
+ ---
26187
26135
 
26188
- - V2: <tech.support@portone.io>
26189
- - V1: <support@portone.io>
26136
+ ## 결제 대행 관련
26190
26137
 
26191
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
26138
+ ### PG (Payment Gateway)
26139
+
26140
+ PG는 온라인 결제에서 결제 정보를 송수신하고 정산을 매개하는 서비스입니다. 온라인 결제를 받기 위해서는 PG사와의 계약과 연동이 필요합니다. 법적으로는 전자금융업상 전자지급결제대행업에 해당합니다.
26141
+
26142
+ PG에 따라 신용카드, 계좌이체, 가상계좌, 휴대폰 결제 등 다양한 결제 수단을 이용할 수 있으며, "결제의 관문"이라는 이름처럼 알맞은 시스템으로 결제 정보를 전달합니다.
26143
+
26144
+ ### 포트원 원 페이먼트 인프라 (OPI)
26145
+
26146
+ 다양한 PG의 파편화된 인터페이스를 통일하여 현대적인 연동 경험을 제공하는 **결제 오케스트레이션 서비스**입니다. 이를 통해 PG를 쉽게 연동 및 추가/변경하고, 다중 PG 시스템을 운영할 수 있습니다.
26147
+
26148
+ <div class="hint" data-style="info">
26149
+
26150
+ OPI 서비스는 결제 정보를 송수신하지만 자금 이동에는 관여하지 않습니다.
26151
+
26152
+ </div>
26153
+
26154
+ ### PG 상점 아이디 (MID)
26155
+
26156
+ PG에서 상점에 부여하는 고유 식별자입니다. PG와의 계약을 통해 발급되며, 결제 수단, 과세 여부, 수수료 등 여러 설정이 MID 단위로 관리됩니다. PG 정책에 따라서는 이용 서비스 및 세부 설정별로 여러 개의 MID를 발급하기도 합니다.
26157
+
26158
+ 포트원을 이용할 때에는 채널을 추가할 때 MID를 입력합니다.
26159
+
26160
+ <div class="hint" data-style="info">
26161
+
26162
+ **PG사별 상점 아이디 명칭**
26163
+
26164
+ - KG이니시스: 상점 아이디(MID)
26165
+ - 카카오페이: 고객사 코드(CID)
26166
+ - 네이버페이: 파트너 ID (하위 식별자로 체인 ID 존재)
26167
+ - 토스페이먼츠: 상점 아이디(MID)
26168
+ - NHN KCP: 사이트 코드
26169
+
26170
+ </div>
26171
+
26172
+ ### 포트원 상점 아이디 (storeId)
26173
+
26174
+ 포트원 관리자 콘솔에서 확인할 수 있는 상점 식별자입니다. 연동 시 `storeId`라는 이름으로 많은 API에 등장합니다.
26175
+
26176
+ 포트원 V1에서는 고객사 식별코드라는 별도 값을 이용합니다.
26177
+
26178
+ ## 결제 방식 관련 용어
26179
+
26180
+ ### 간편결제사
26181
+
26182
+ 네이버페이, 카카오페이, 토스페이, 페이코와 같이 신용카드나 계좌번호 등의 결제 정보를 등록해 비밀번호 입력, 지문 인식만으로 결제할 수 있는 서비스를 제공하는 사업자입니다.
26183
+
26184
+ ### PG 제휴 간편결제
26185
+
26186
+ 간편결제사와 직접 계약을 맺지 않고 일반 PG사와의 계약만으로 간편결제사의 서비스 이용이 가능한 서비스입니다. 구매자가 보기에는 동일한 간편결제사의 결제창이 호출됩니다.
26187
+
26188
+ <div class="hint" data-style="warning">
26189
+
26190
+ **PG 제휴 간편결제 주의사항**
26191
+
26192
+ PG 제휴로 간편결제를 이용할 경우 간편결제 포인트 적립이 안 되는 등 일부 기능을 사용할 수 없는 경우가 있습니다.
26193
+
26194
+ </div>
26195
+
26196
+ ### 인증결제
26197
+
26198
+ 신용카드, 간편결제, 계좌이체, 휴대폰 결제 등에서 결제 정보가 본인임을 확인하는 과정을 거친 이후 결제되는 방식을 총칭합니다. 쇼핑몰 등에서 이용되는 일회성 결제로 가장 일반적인 결제 방식입니다.
26199
+
26200
+ ### 키인결제
26201
+
26202
+ 카드 번호 등 결제 정보를 구매자로부터 직접 입력받아 API 호출을 통해 결제를 일으키는 비인증결제 방식입니다.
26203
+
26204
+ ### 빌링결제
26205
+
26206
+ 구매자에게 최초 1회 결제 정보를 입력받아 빌링키를 발급함으로써, 이후에 고객사에서 임의 시점에 결제를 반복하여 일으키는 결제 방식입니다. 결제를 일으킬 때에는 별도로 사용자 인증이 필요 없으므로 비인증결제에 속합니다. 정기결제 등을 구현하기 위해 사용합니다.
26207
+
26208
+ <div class="hint" data-style="warning">
26209
+
26210
+ **빌링키 사용 제한**
26211
+
26212
+ 빌링키는 해당 빌링키를 발급한 PG에서만 사용 가능합니다. 또, 빌링키를 다른 포트원 상점 또는 다른 PG MID로 이관하려면 별도 요청이 필요합니다.
26213
+
26214
+ </div>
26215
+
26216
+ ## 거래 식별 관련 용어
26217
+
26218
+ ### 결제 ID (paymentId, 고객사 주문번호)
26219
+
26220
+ 결제를 요청할 때 고객사가 채번한 고유 번호입니다. V1에서는 `merchant_uid`라는 이름을 사용합니다.
26221
+
26222
+ ### PG 거래번호 (TID)
26223
+
26224
+ PG사가 채번한 거래 번호입니다. PG사에 따라 취소 건에도 별도의 거래 번호를 부여할 수 있습니다.
26225
+
26226
+ ### 카드 승인번호
26227
+
26228
+ 승인 성공 시 카드사가 부여한 8자리 숫자로, 매입을 진행하거나 취소를 할 때 필요합니다. 당일에 한 카드사에 유니크하나 몇몇 카드사는 당일에 중복되는 경우도 있습니다.
26229
+
26230
+ ## 카드 결제
26231
+
26232
+ 신용/체크/선불카드를 통한 결제는 인증, 승인, 매입의 과정을 거칩니다.
26233
+
26234
+ ### 인증 (Authentication)
26235
+
26236
+ 인증결제에서, 카드 소유주가 본인임을 확인하는 과정입니다. 웹에서 비밀번호를 입력하거나 앱에서 지문 인식을 하는 등 카드사마다 방식이 다릅니다.
26237
+
26238
+ ### 승인 (Authorization)
26239
+
26240
+ 승인 거래가 생성되고, 카드 한도를 차감합니다. 실제로 대금이 이동하지는 않습니다.
26241
+
26242
+ 포트원에서는 인증이 완료되면 자동으로 승인을 진행합니다. 또는, V2에서 수동 승인 기능을 이용하면 인증 후 승인 요청을 별도로 할 수 있습니다.
26243
+
26244
+ ### 매입 (Capture)
26245
+
26246
+ 매입은 승인된 카드 거래의 대금을 청구하는 일을 말합니다. 일반적으로 PG가 매일 정해진 시간에 승인 건들을 모아 자동으로 매입합니다.
26247
+
26248
+ 결제 승인 시점과 상품 공급 시점이 크게 다른 상점에서는 자동 매입을 끄고 PG에 건별로 매입을 요청하는 수동 매입을 이용할 수 있습니다. 매입이 오랫동안 일어나지 않으면 자동으로 승인이 취소됩니다. 포트원에서는 아직 수동 매입을 지원하지 않습니다.
26249
+
26250
+ 카드 결제를 취소할 경우 원리상 매입 전 취소와 매입 후 취소가 구분되고, 매입 후 취소는 보통 3\~4 영업일이 소요됩니다.
26251
+
26252
+ ## 카드 관련 용어
26253
+
26254
+ ### 카드사 유형
26255
+
26256
+ 신용, 체크카드와 관련된 개념으로 발급사, 매입사, 네트워크(브랜드)가 있습니다.
26257
+
26258
+ - **발급사**: 카드를 발급한 회사
26259
+ - **매입사**: 상점과 계약하여 카드 거래 매입을 담당하는 회사
26260
+ - **네트워크**: 매입사와 발급사 사이를 중개하는 인프라 (비자, 마스터카드, JCB, 아메리칸 익스프레스, 다이너스 클럽, 디스커버, 유니온페이 등)
26261
+
26262
+ 국내는 카드에 따라 매입사가 하나로 정해져 있기 때문에 PG가 각 매입사와 계약을 맺습니다.
26263
+
26264
+ <div class="hint" data-style="info">
26265
+
26266
+ **예시: 카카오뱅크 카드**
26267
+
26268
+ - 발급사: 카카오뱅크
26269
+ - 매입사: 국민카드
26270
+ - 네트워크: 없음 (해외 사용 시 비자, 마스터카드 등 선택)
26271
+
26272
+ </div>
26273
+
26274
+ ### PLCC (Private Label Credit Card)
26275
+
26276
+ 상업자표시 신용카드로, 카드명에 특정 브랜드를 표기한 것을 말합니다. 제휴 업체와 함께 카드 상품을 공동으로 기획하여 비용과 수익을 분담하며, 제휴사의 충성도 높은 고객을 확보할 수 있는 장점이 있습니다.
26277
+
26278
+ **PLCC 예시:**
26279
+
26280
+ - 스타벅스 현대카드
26281
+ - 배민 현대카드
26282
+ - 11번가 신한카드
26283
+
26284
+ ### 제휴카드
26285
+
26286
+ 카드사가 특정 기업 혹은 단체와 협약을 맺어 발급하는 카드입니다. 카드사는 제휴사 카드 상품을 출시하고 마케팅 비용이나 카드 수익 등을 모두 관리하며, 반면 제휴사는 카드 모집만 담당합니다.
26287
+
26288
+ ## 기타 결제 관련 용어
26289
+
26290
+ ### 가상계좌
26291
+
26292
+ 은행이 고객사에 발급한 입금 전용 계좌로, 고객사는 납부자와 가상계좌 번호를 일대일로 매핑하여 발급합니다. 보통 가상계좌는 입금 시 바로 삭제되며 해당 계좌번호는 재활용되어 다른 납부자에게 발급될 수 있습니다.
26293
+
26294
+ ### 고정식 가상계좌
26295
+
26296
+ 전기요금 고지서처럼 납부자가 하나의 입금 계좌번호를 부여받아 지속적으로 입금하고자 할 때 이용하는 가상계좌입니다.
26297
+
26298
+ ### 에스크로
26299
+
26300
+ 구매자의 구매 확인 의사인 구매결정을 통보받은 후 판매자에게 결제 대금을 지급하는 안전한 결제 서비스입니다. 2006년 4월 1일부터 에스크로 의무화 시행에 따라 가상계좌, 계좌이체와 같은 모든 현금 거래에는 의무적으로 적용해야 합니다.
26301
+
26302
+ ## 취소
26303
+
26304
+ 결제 완료 이후에 API나 콘솔을 통해 결제를 취소할 수 있습니다. 결제 금액의 일부만 취소하는 것도 가능합니다.
26305
+
26306
+ 가상계좌 환불이나 휴대폰 익월 환불의 경우 환불받을 계좌를 입력해야 합니다.
26307
+
26308
+ 환불 가능 기한이 지난 등의 이유로 PG를 통한 취소가 불가능한 경우에는 고객사에서 직접 구매자에게 자체 환불 처리해야 합니다.
26309
+
26310
+ ### 카드
26311
+
26312
+ 매입 전 취소의 경우 즉시 환불됩니다. 매입 후 취소는 일반적으로 3\~4 영업일이 소요됩니다.
26313
+
26314
+ ### 계좌이체
26315
+
26316
+ 즉시 환불됩니다.
26317
+
26318
+ ### 가상계좌
26319
+
26320
+ 환불받을 계좌를 입력해야 환불이 가능합니다. 일반적으로 2 영업일이 소요됩니다.
26321
+
26322
+ ### 휴대폰
26323
+
26324
+ 결제가 일어난 해당 월에만 취소가 가능합니다. 실제 지불 전이므로 즉시 취소됩니다. 일부 PG에서는 익월 환불이라 하여 해당 월이 지난 뒤에도 계좌로 환불하는 기능을 제공합니다.
26325
+
26326
+ ## 세금 관련 용어
26327
+
26328
+ ### 부가가치세
26329
+
26330
+ 일반적으로 매출 발생시 10%의 부가가치세를 국가에 납부해야 합니다. 또한, PG 서비스 수수료에도 10%의 부가가치세가 발생합니다. 수수료에 대한 부가가치세는 매입 세액에 속합니다.
26331
+
26332
+ <div class="hint" data-style="info">
26333
+
26334
+ **정산 수수료 계산 예시**
26335
+
26336
+ 1,000원의 결제에 대해 3%의 수수료를 적용한다면:
26337
+
26338
+ - 수수료: 30원
26339
+ - 수수료 부가세: 3원 (수수료의 10%)
26340
+ - 정산 금액: 967원
26341
+
26342
+ </div>
26343
+
26344
+ ### 면세
26345
+
26346
+ 세금을 부과하지 않는 소득을 의미합니다. 저소득층의 세금 부담 경감 또는 기타 정책적 목적으로 일부 재화나 용역의 공급에 대해 부가가치세를 면제하는 것을 말합니다. 대표적으로 기초생활필수품, 문화 관련 재화, 용역 등이 있습니다.
26347
+
26348
+ ### 영세율
26349
+
26350
+ 일정한 재화 또는 용역의 공급에 대해 0의 세율을 적용하는 제도로, 수출업자, 기타 외화 획득 사업자 등이 영세사업자로 적용됩니다.
26351
+
26352
+ ## 할인 관련 용어
26353
+
26354
+ ### 즉시할인
26355
+
26356
+ 상품의 가격에 즉시 할인 금액을 적용하여 할인된 금액을 결제하는 방식입니다.
26357
+
26358
+ ### 청구할인
26359
+
26360
+ 본래의 상품 가격을 결제했다가 조건 충족 시 결제 대금의 할인된 금액이 반영되는 방식입니다. 청구할인은 할인 여부를 챙겨봐야 하기 때문에 즉시할인이 납부자에게 더 선호됩니다.
26192
26361
 
26193
26362
 
26194
26363
  # https://developers.portone.io/opi/ko/support/tls-support
@@ -26756,24 +26925,144 @@ SDK를 지원하지 않는 플랫폼을 포함하여 다양한 플랫폼에서
26756
26925
 
26757
26926
  ---
26758
26927
  title: 용어 사전
26759
- description: ''
26928
+ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용어를 설명합니다.
26929
+ ---
26930
+
26931
+
26932
+
26933
+ ## **서비스 용어**
26934
+
26935
+ ### 정산금 계산 자동화
26936
+
26937
+ 파트너에게 정산할 금액을 자동 계산하고 관리하는 대표 서비스입니다.
26938
+ 파트너를 등록하여 파트너 정보를 관리하고, 플랫폼 정책에 맞는 각종 계약을 등록할 수 있으며, 선택한 파트너와 계약을 기반으로 자동 정산금 계산을 지원합니다.
26939
+
26940
+ ### 지급대행 서비스
26941
+
26942
+ 전자금융거래법을 준수하기 위해 PG 정산금의 수취 및 이체를 대행하는 서비스로
26943
+ 안전하고 편리한 지급대행 서비스를 지원합니다. 포트원 지급대행은 일반 PG사와 다르게 즉시(바로)지급과 자유로운 예약지급 설정으로 보다 유연한 관리가 가능합니다.
26944
+
26945
+ ### 전자세금계산서 서비스
26946
+
26947
+ 역발행과 정발행을 지원하는 전자세금계산서 서비스입니다.
26948
+ 세금계산서 발행 뿐만 아니라 히스토리 관리, 일괄(대량) 발행을 지원합니다.
26949
+
26950
+ <div class="hint" data-style="info">
26951
+
26952
+ 파트너 정산 자동화 솔루션 안에서 3가지의 서비스를 제공하고 있습니다.
26953
+
26954
+ </div>
26955
+
26956
+ ---
26957
+
26958
+ ## **공통 용어**
26959
+
26960
+ ### 고객사 / 파트너
26961
+
26962
+ 고객사는 포트원의 결제서비스를 이용하고 있는 포트원의 고객을 의미합니다.
26963
+
26964
+ 파트너는 고객사가 결제사정산 이후 하위정산을 받을 고객사의 파트너사 (하위셀러) 입니다.
26965
+
26966
+ ### 사업자 휴폐업 조회
26967
+
26968
+ 파트너의 사업자등록번호 유효성과 영업 상태를 확인하는 서비스입니다. 사업자 휴폐업 조회를 사전에 진행하여 비즈니스의 안전성과 신뢰성을 확보할 수 있습니다. 또한 미리 휴폐업을 조회하지 못해 생기는 리소스 낭비를 줄일 수 있습니다.
26969
+
26970
+ ### 영업일
26971
+
26972
+ 은행이 영업을 하는 날로, 휴일이 아닌 날입니다.
26973
+
26974
+ <div class="hint" data-style="success">
26975
+
26976
+ 예를 들어, 10일(금), 11일(토), 12(일), 13(월)이라고 할 때, 11, 12, 13일의 전 영업일은 10일이고, 10, 11, 12일의 후 영업일은 13일입니다.
26977
+
26978
+ </div>
26979
+
26980
+ ---
26981
+
26982
+ ## **정산금 계산 자동화 용어**
26983
+
26984
+ ### 계약
26985
+
26986
+ 고객사와 파트너 사이에 정산이 이루어지기 위한 조건입니다. 계약은 파트너 정산 자동화의 정산 정책 관리 페이지에서 등록할 수 있습니다. 계약 등록을 통해 플랫폼 중개 수수료를 설정하거나 부가세 분담 주체, 정산 주기 등을 설정할 수 있으며, 각 플랫폼사의 정책에 맞게 커스터마이징이 가능합니다.
26987
+
26988
+ ### 수수료
26989
+
26990
+ 절차 및 중개 등을 지원할 때 수수하는 금전입니다.
26991
+ 플랫폼사에서는 중개수수료와 추가수수료 등을 수취합니다. **중개수수료**는 플랫폼이 거래 중개 서비스에 대해 부과하는 수수료이고, **추가수수료**는 PG사 수수료, 마케팅 채널 수수료 등 특정 서비스에 대해 부과하는 수수료입니다.
26992
+
26993
+ ### 원천 징수세
26994
+
26995
+ 소득자(개인 파트너)가 자신의 세금을 직접 납부하지 않고, 원천징수 대상소득을 지급하는 원천징수 의무자(플랫폼사)가 그 금액을 미리 떼어서 대신 납부하는 세금입니다. 원천 징수세는 계약 등록에서 미리 설정할 수 있습니다.
26996
+
26997
+ ---
26998
+
26999
+ ## **지급대행 서비스 용어**
27000
+
27001
+ ### 결제사 정산
27002
+
27003
+ 포트원의 결제 이후 결제대행사(PG) 또는 간편결제사로부터 고객사가 받는 정산입니다.
27004
+
27005
+ ### 파트너 정산
27006
+
27007
+ 결제사 정산 이후에 고객사가 파트너에게 내려주는 정산입니다.
27008
+
27009
+ ### 일괄지급
27010
+
27011
+ 여러 파트너에게 동시에 정산금을 지급하는 기능으로, 한 번의 실행으로 대량 송금이 가능합니다. 정산일을 설정하고 정산할 건을 선택하여 일괄지급할 수 있습니다.
27012
+
27013
+ ### 즉시지급(바로지급)과 예약지급
27014
+
27015
+ **즉시지급**은 지급 요청 즉시 실시간으로 송금이 실행되는 지급 방식입니다.
27016
+ **예약지급**은 미래의 특정 시점에 지급이 실행되도록 예약하는 지급 방식입니다. 예약지급은 주말과 공휴일도 포함시켜 달력일로 예약할 수 있습니다.
27017
+
27018
+ <div class="hint" data-style="warning">
27019
+
27020
+ 단, 은행 점검 시간에는 지급 및 예약이 불가합니다.
27021
+
27022
+ </div>
27023
+
26760
27024
  ---
26761
27025
 
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천원 |
27026
+ ## **세금계산서 서비스 용어**
27027
+
27028
+ ### 세금계산서 역발행
27029
+
27030
+ 세금계산서 발행 주체인 공급자(파트너)가 아니라, 공급받는자(플랫폼)가 공급자 대신 세금계산서를 작성하여 공급자에게 발행을 요청하는 기능입니다.
27031
+
27032
+ 플랫폼사가 직접 파트너에게 지급할 정산대금 정보를 작성하고, 해당 내용을 바탕으로 공급자는 이메일을 통해 검토만 하고 승인할 수 있는 구조이기 때문에 파트너와의 소통을 줄일 수 있습니다.
27033
+
27034
+ ### 발행 취소
27035
+
27036
+ 세금계산서를 국세청으로 전송하기 전까지 발행을 취소할 수 있는 기능으로, '발행 요청' 상태의 세금계산서 우측에 있는 '발행 취소' 버튼을 눌러 취소할 수 있습니다.
27037
+
27038
+ <div class="hint" data-style="warning">
27039
+
27040
+ 세금계산서 내역 관리의 **삭제** 버튼은 발행 취소와 다른 기능으로 세금계산서의 상태가 실패, 거절, 취소 등의 최종 상태일 경우에만 적용됩니다.
27041
+
27042
+ </div>
27043
+
27044
+ ### 수정 발행
27045
+
27046
+ 세금계산서가 국세청으로 전송되면 (전송 완료 상태) 수정 발행으로 취소 및 수정이 가능합니다. 단, 수정 발행 시 사유 확인이 필요합니다.
27047
+
27048
+ ### 재전송
27049
+
27050
+ 역발행 세금계산서의 승인을 요청하는 메일을 파트너에게 다시 전송하는 기능입니다.
27051
+
27052
+ ### 지연 발행
27053
+
27054
+ 세금계산서 지연 발행 상태는 재화 또는 용역을 공급한 날이 속한 달의 다음 달 10일까지 세금계산서를 발급하지 않고, 그 기간을 넘겨 발행하면 지연 발행에 해당합니다.
27055
+
27056
+ 예를 들어, 9월 16일에 재화나 용역을 제공했다면, 다음 달인 10월 10일까지 세금계산서를 발행해야 합니다. 이 기한을 넘겨 발행하면 지연 발행에 해당합니다.
27057
+
27058
+ <div class="hint" data-style="info">
27059
+
27060
+ 지연 발행 시에는 가산세가 부과됩니다.
27061
+
27062
+ - 공급자는 지연 발행 가산세로 공급가액의 1%를 부담하게 됩니다.
27063
+ - 공급받는자는 지연 수취 가산세로 공급가액의 0.5%가 부과됩니다.
27064
+
27065
+ </div>
26777
27066
 
26778
27067
 
26779
27068
  # https://developers.portone.io/platform/ko/guides/process
@@ -26787,7 +27076,7 @@ description: ''
26787
27076
 
26788
27077
  <div class="hint" data-style="etc">
26789
27078
 
26790
- 📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스 입니다.**
27079
+ 📘 **파트너정산은 간단한 API연동과 관리자 콘솔 등록을 통해 파트너정산을 자동화 하는 서비스입니다.**
26791
27080
 
26792
27081
  </div>
26793
27082
 
@@ -26958,7 +27247,7 @@ app.post("/webhook/taxinvoice", (req, res) => {
26958
27247
  ### 설정 요청 절차
26959
27248
 
26960
27249
  1. 웹훅 수신 URL을 준비해주세요.
26961
- 2. 기술지원 이메일(<support.b2b@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
27250
+ 2. 기술지원 이메일(<tech.support@portone.io>)로 웹훅 URL(운영 환경, 테스트 환경 별도 적용 가능)을 전달해주세요.
26962
27251
  3. 테스트 모드 설정이 완료되었다는 회신을 받으면 테스트 모드에서 웹훅 정상 작동 여부를 확인해주세요
26963
27252
  4. 운영 환경에도 적용을 요청하신 뒤 운영 환경에서 웹훅 정상 작동 여부를 확인해주세요.
26964
27253
 
@@ -29207,78 +29496,54 @@ targetVersions:
29207
29496
  포트원 MCP 서버는 개발자센터 문서 내용을 AI에게 제공하여,
29208
29497
  AI가 보다 정확하고 구체적인 정보를 바탕으로 사용자의 연동 및 질의를 돕도록 합니다.
29209
29498
 
29210
- ### 1. MCP 서버 등록하기
29211
-
29212
- 포트원 MCP 서버를 사용하기 위해서는 먼저 사용하는 AI 도구에 서버를 등록해야 합니다.
29213
-
29214
- Cursor, Windsurf, Claude Code, Claude for Desktop 등 다양한 AI 도구의 설정 파일에서 아래 내용을 추가하여 MCP 서버를 등록할 수 있습니다.
29215
-
29216
- ```json
29217
- {
29218
- // ...
29219
-
29220
- "mcpServers": {
29221
- // ...
29222
-
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/)가 설치되어 있어야 합니다.
29499
+ 이외에도 포트원 콘솔에서 제공하는 기능 중 일부를 수행할 수 있습니다.
29500
+ 아래 기능을 AI에게 요청하면 MCP 서버가 브라우저를 열어 포트원 콘솔 로그인을 요청하며, 로그인 후 기능이 수행됩니다.
29234
29501
 
29235
- </div>
29236
-
29237
- 설정 파일 수정이 완료된 후 AI 도구를 재시작하면 MCP 서버가 적용됩니다.
29238
-
29239
- #### 포트원 기능 사용하기
29240
-
29241
- MCP 서버에 포트원 기능을 연동하면, AI가 아래와 같은 작업을 수행할 수 있습니다.
29502
+ - 채널 목록 조회
29503
+ - 테스트 채널 추가
29504
+ - 하위 상점 조회
29505
+ - 결제 내역 조회
29242
29506
 
29243
- - 결제 내역 단건/다건 조회
29244
- - 본인인증 내역 단건/다건 조회
29245
-
29246
- 연동을 활성화하려면, MCP 설정 파일의 env 블록에 포트원 관리자 콘솔에서 발급받은 API\_SECRET을 추가합니다.
29247
-
29248
- ```json
29249
- {
29250
- // ...
29507
+ ### DXT를 이용한 설치
29251
29508
 
29252
- "mcpServers": {
29253
- // ...
29509
+ [DXT (Desktop Extensions)](https://github.com/anthropics/dxt)를 이용해 MCP 서버를 원클릭으로 설치할 수 있습니다.
29254
29510
 
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
- ```
29511
+ 1. [GitHub Releases](https://github.com/portone-io/mcp-server/releases)에서 최신 `portone-mcp-server.dxt` 파일을 다운로드합니다.
29512
+ 2. 지원하는 AI 도구(Claude Desktop 등)에서 다운로드한 `.dxt` 파일을 드래그 앤 드롭하거나 열기를 통해 설치합니다.
29513
+ 3. 설치 후 도구를 재시작하여 MCP 서버가 정상적으로 등록되었는지 확인합니다.
29266
29514
 
29267
29515
  <div class="hint" data-style="warning">
29268
29516
 
29269
- **API 시크릿은 MCP 서버에서 제공하는 기능 외에도 포트원 REST API의 모든 권한을 가집니다.**
29517
+ **Claude Desktop에서 DXT 파일 사용 주의사항**
29270
29518
 
29271
- 내부의 인가된 인원만이 MCP 서버를 사용할 있도록 통제해야 합니다.
29519
+ 현재 [알려진 이슈](https://github.com/anthropics/dxt/issues/45)로 인해 Claude Desktop에서 DXT 설치 후 MCP 서버가 정상적으로 작동하지 않을 있습니다.
29520
+
29521
+ 이 경우 Node.js 22.6.0 이상을 설치하고 Claude Desktop 설정에서 **"MCP용 내장 Node.js 사용"** 옵션을 비활성화한 후 재시작하면 정상적으로 작동합니다.
29272
29522
 
29273
29523
  </div>
29274
29524
 
29275
- <div class="hint" data-style="warning">
29525
+ ### MCP 서버 등록하기
29276
29526
 
29277
- **MCP 서버는 포트원의 공개된 API 기능만을 사용하며, 인증을 위해 사용자가 제공한 API 시크릿을 활용합니다.**
29527
+ 1. Node.js 22.6.0 이상이 설치되어 있어야 합니다.
29278
29528
 
29279
- 인증 과정은 전적으로 MCP 서버 내부에서 일어나므로, 언어 모델의 문제로 인해 비인가 사용자에게 기밀 정보가 유출되지는 않습니다.
29529
+ 2. 사용하는 AI 도구의 MCP 설정에서 아래 내용을 추가합니다. (Cursor, Windsurf, Claude Desktop, etc...)
29280
29530
 
29281
- </div>
29531
+ ```jsonc
29532
+ "mcpServers": {
29533
+
29534
+ // 기존 설정
29535
+
29536
+ "portone-mcp-server": {
29537
+ "command": "npx",
29538
+ "args": [
29539
+ "-y",
29540
+ "@portone/mcp-server@latest"
29541
+ ]
29542
+ }
29543
+ }
29544
+ ```
29545
+
29546
+ 3. 도구를 재시작해 portone-mcp-server 및 해당 서버가 제공하는 도구들이 잘 등록되었는지 확인합니다.
29282
29547
 
29283
29548
  <div class="hint" data-style="warning">
29284
29549
 
@@ -29289,7 +29554,7 @@ MCP 서버는 API 응답에 포함된 개인정보가 외부로 전달되지 않
29289
29554
 
29290
29555
  </div>
29291
29556
 
29292
- ### 2. MCP 서버 활용하기
29557
+ ### MCP 서버 활용하기
29293
29558
 
29294
29559
  사용 중인 AI 도구에 포트원 MCP 서버가 적용되었다면, 아래 예시들과 같이 질의하여 사용할 수 있습니다.
29295
29560
 
@@ -29534,13 +29799,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
29534
29799
 
29535
29800
  ## 주요 업데이트 사항
29536
29801
 
29537
- ### **결제 모듈 V1**✔️ 나이스페이먼츠의 새로운 결제창을 이용할 수 있습니다
29802
+ ### **결제 모듈 V1**✔️ 나이스정보통신의 새로운 결제창을 이용할 수 있습니다
29538
29803
 
29539
- 포트원을 통해 나이스페이먼츠의 새로운 결제창(이하 ‘(신) 나이스페이먼츠’)을 이용할 수 있습니다. 이번
29804
+ 포트원을 통해 나이스정보통신의 새로운 결제창(이하 ‘(신) 나이스정보통신’)을 이용할 수 있습니다. 이번
29540
29805
  업데이트를 통해 기존 모듈보다 확장된 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트
29541
29806
  호출을 지원합니다.
29542
29807
 
29543
- (신) 나이스페이먼츠에서 이용 가능한 간편결제는 다음과 같습니다.
29808
+ (신) 나이스정보통신에서 이용 가능한 간편결제는 다음과 같습니다.
29544
29809
 
29545
29810
  - 카카오페이
29546
29811
  - 네이버페이
@@ -29553,13 +29818,13 @@ writtenAt: 2023-07-12T00:00:00.000Z
29553
29818
 
29554
29819
  이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 회수, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
29555
29820
 
29556
- (신) 나이스페이먼츠 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
29821
+ (신) 나이스정보통신 이용시 고려해야 하는 조건들이 있으니 다음 문서를 참고하시기 바랍니다.
29557
29822
 
29558
- [→ (신)나이스페이먼츠 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
29823
+ [→ (신)나이스정보통신 일반결제 연동 유의사항](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/payment-caution)
29559
29824
 
29560
- [→ (신)나이스페이먼츠 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
29825
+ [→ (신)나이스정보통신 비인증결제 연동 유의사항(빌링키 발급 및 API 연동)](https://developers.portone.io/docs/ko/pg/payment-gateway/nice-v2/billing-api-caution)
29561
29826
 
29562
- 기존에 나이스페이먼츠를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
29827
+ 기존에 나이스정보통신를 이용 중이라면 간편결제사와 별도의 계약없이 간단한 신청만으로 간편결제를
29563
29828
  이용할 수 있습니다. 하단의 일반 문의 채널을 통해 관련 문의를 남겨주시면 포트원 고객지원팀이
29564
29829
  안내드리겠습니다.
29565
29830
 
@@ -29614,7 +29879,7 @@ KCP 인증결제창에서 할인쿠폰 적용 여부를 컨트롤 할수 있는
29614
29879
  할인쿠폰기능을 사용하기 위해서는 KCP와 협의가 먼저 선행되어야 하는점 유의하세요
29615
29880
 
29616
29881
  본 기능 설정을 위한 자세한 내용은 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)
29882
+ [→ 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
29883
 
29619
29884
 
29620
29885
  # https://developers.portone.io/release-notes/api-sdk/2023-08-31
@@ -29637,7 +29902,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
29637
29902
  선택할수 있도록 하였습니다.
29638
29903
 
29639
29904
  본 기능 설정을 위한 자세한 내용은 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)
29905
+ [→ 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
29906
 
29642
29907
  ### **결제 모듈 V1**✔️ 결제 URL 생성 API 지원 PG사 확대
29643
29908
 
@@ -29647,7 +29912,7 @@ NHN KCP결제창을 통한 빌링키 발급시 파라미터를 통해 빌링키
29647
29912
  - (신)스마트로
29648
29913
  - KSNET
29649
29914
  - (신)페이팔 일반결제/정기결제
29650
- - (신)나이스페이먼츠
29915
+ - (신)나이스정보통신
29651
29916
 
29652
29917
 
29653
29918
  # https://developers.portone.io/release-notes/api-sdk/2023-12-15
@@ -29675,11 +29940,11 @@ writtenAt: 2024-01-08T00:00:00.000Z
29675
29940
 
29676
29941
  ## 주요 업데이트 사항
29677
29942
 
29678
- ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스페이먼츠 결제를 지원합니다.
29943
+ ### **결제 모듈 V2**✔️ 포트원 V2 신모듈에서 나이스정보통신 결제를 지원합니다.
29679
29944
 
29680
- 이제 포트원 V2를 통해 나이스페이먼츠 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
29945
+ 이제 포트원 V2를 통해 나이스정보통신 일반결제/정기결제가 가능합니다. 이번 업데이트를 통해 다양한 결제수단을 제공하며, 모든 간편결제에 대해 허브형과 다이렉트 호출을 지원합니다.
29681
29946
 
29682
- 나이스페이먼츠에서 지원하는 결제수단 아래와 같습니다.
29947
+ 나이스정보통신에서 지원하는 결제수단 아래와 같습니다.
29683
29948
 
29684
29949
  - 카드
29685
29950
 
@@ -29703,7 +29968,7 @@ writtenAt: 2024-01-08T00:00:00.000Z
29703
29968
 
29704
29969
  이 외에도 SDK/API 빌링키 발급, 에스크로, API 가상계좌 발급 및 말소, 면세 및 부가세 금액 지정(영세율 포함), 상점분담무이자 등의 기능을 지원합니다.
29705
29970
 
29706
- 나이스페이먼츠 연동에 대해 자세히 알고 싶다면 [→ 나이스페이먼츠 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.
29971
+ 나이스정보통신 연동에 대해 자세히 알고 싶다면 [→ 나이스정보통신 연동가이드](https://developers.portone.io/docs/ko/v2-payment/pg/nice-v2?v=v2) 에서 확인하실 수 있습니다.
29707
29972
 
29708
29973
 
29709
29974
  # https://developers.portone.io/release-notes/api-sdk/2024-01-11
@@ -30083,7 +30348,7 @@ writtenAt: 2024-06-03T00:00:00.000Z
30083
30348
 
30084
30349
  **지원 결제대행사**
30085
30350
 
30086
- - 나이스페이먼츠
30351
+ - 나이스정보통신
30087
30352
  - KG이니시스
30088
30353
  - 토스페이먼츠
30089
30354
  - 스마트로
@@ -30291,7 +30556,6 @@ writtenAt: 2024-09-05T00:00:00.000Z
30291
30556
  - 토스
30292
30557
  - 카카오
30293
30558
  - 네이버
30294
- - 페이코
30295
30559
  - 금융결제원
30296
30560
  - KB국민은행
30297
30561
  - 신한은행
@@ -30326,11 +30590,11 @@ writtenAt: 2024-09-30T00:00:00.000Z
30326
30590
  PG 거래대사 내의 **거래 정산 내역** 메뉴에서 정산일 또는 거래일을 기준으로,
30327
30591
  **거래 건별 조회** 메뉴에서는 정산일을 기준으로 최대 3개월 분량의 데이터를 엑셀로 다운로드할 수 있습니다.
30328
30592
 
30329
- ### **PG 거래대사**✔️ KSNET, KPN, 하이픈에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
30593
+ ### **PG 거래대사**✔️ KSNET, KPN에서 발생한 거래 건도 PG 거래대사에서 데이터 확인이 가능해집니다.
30330
30594
 
30331
- 기존에 12개 PG사 (KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
30332
- 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN, 하이픈까지 확장하여
30333
- 15개 PG사 데이터에 한하여 제공됩니다.
30595
+ 기존에 12개 PG사 (KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠,
30596
+ 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜) 에서만 지원하던 **PG 거래대사**가 KSNET, KPN까지 확장하여
30597
+ 14개 PG사 데이터에 한하여 제공됩니다.
30334
30598
 
30335
30599
  (참고 : PG 거래대사 메뉴의 경우 클로즈 베타로 운영되고 있으며,
30336
30600
  사용을 원하시는 고객께서는 [PG거래대사 베타서비스 신청 바로가기](https://forms.gle/cZAqJLGqovC1STrS8)에서 신청해 주시길 바랍니다.)
@@ -30782,6 +31046,57 @@ writtenAt: 2024-09-05T00:00:00.000Z
30782
31046
  - 좌측 메뉴 영역 상단의 \[계정 정보]를 클릭한 후 \[로그아웃]을 클릭해 주세요.
30783
31047
 
30784
31048
 
31049
+ # https://developers.portone.io/release-notes/console/2025-10-17
31050
+
31051
+ ---
31052
+ releasedAt: 2025-10-17T00:00:00.000Z
31053
+ writtenAt: 2025-10-17T00:00:00.000Z
31054
+ ---
31055
+
31056
+ ## 콘솔 일부 설정 업데이트 안내
31057
+
31058
+ 안녕하세요, 포트원 입니다.
31059
+
31060
+ 더욱 쾌적하고 편리한 서비스 이용을 위해, 콘솔 내의 일부 디자인 시스템이 변경되어 안내해 드립니다.
31061
+
31062
+ ---
31063
+
31064
+ ## 관리자 콘솔
31065
+
31066
+ ### 표설정 기능 업데이트
31067
+
31068
+ 기존에는 콘솔에서 확인할 수 있는 다양한 표 내부 컬럼의 순서를 변경할 수 없었습니다. 하지만 이번 업데이트를 통해 표설정 기능을 추가하여 드래그 방식으로 손쉽게 내부 컬럼의 순서를 변경하고, 유지할 수 있습니다. 표설정 기능을 활용하여 더 중요한 정보들을 앞으로 가져오는 등의 편리한 커스터마이징이 가능합니다.
31069
+
31070
+ 파트너 정산 서비스 뿐만 아니라 포트원 전자결제를 함께 이용중이라면, 전자결제 서비스의 표 설정 또한 브라우저에 저장될 수 있습니다.
31071
+
31072
+ (이미지 첨부: 표 순서 변경 기능)
31073
+
31074
+ ## 파트너 정산
31075
+
31076
+ ### 보관함 설정 업데이트
31077
+
31078
+ 기존 정산 정책 관리 및 파트너 관리 페이지에서 보관함 보기 토글을 이용하여 보관함을 조회한 후, 페이지를 새로고침하면 보관함이 아닌 일반 정책 목록이 조회되는 현상이 발생했습니다. 업데이트 후에는 보관함 보기 상태로 새로고침을 해도 해당 상태가 풀리지 않고 유지되어 사용 편의성이 높아집니다.
31079
+
31080
+ ### 파트너 관리 UI 업데이트
31081
+
31082
+ 기존 파트너 관리 페이지의 계약 일괄 변경 페이지에서는 변경할 신규 계약과 정산 시작일 기준 적용 시점만을 선택해야 했고, 계약 아이디로만 계약을 관리했기 때문에 실제 계약 정보 확인 없이 작업을 진행해야 하는 불편함이 있었습니다.
31083
+
31084
+ 이제부터는 계약 이름으로 변경할 계약 정보를 직접 검색 및 조회할 수 있게 됩니다. 계약을 선택하면 중개 수수료율, 정산 보류일, 정산 주기와 같은 주요 정산 정보를 즉시 확인할 수 있어 더 정확한 계약 변경이 가능해집니다. 아울러, 정산 시작일 기준 적용 시점을 선택할 때 사용되는 달력 UI도 직관적으로 변경되어 적용 시점 설정이 더욱 쉬워졌습니다.
31085
+
31086
+ (이미지 첨부: 파트너 관리 UI 업데이트)
31087
+
31088
+ ### 콘솔 표 설정 업데이트
31089
+
31090
+ 정산 상세 조회, 정산 내역 관리, 일괄 지급 내역 관리, 지급 내역 관리, 이체 내역 관리, 일괄 이체 내역 관리, 세금계산서 작성 목록, 세금계산서 내역 관리, 일괄 세금계산서 내역 관리 페이지의 표 설정이 일괄 변경됩니다. 이제 해당 페이지들에서 표(테이블)의 필터 값을 설정한 후 페이지를 새로고침하더라도, 설정했던 필터 값이 초기화되지 않고 그대로 유지됩니다. 따라서 반복적으로 필터를 재설정할 필요 없이 더 빠르고 효율적으로 데이터를 조회할 수 있습니다.
31091
+
31092
+ ---
31093
+
31094
+ 작성일자: **2025년 10월 17일**
31095
+
31096
+ - 일반 문의: <cs@portone.io> / 채널톡
31097
+ - 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
31098
+
31099
+
30785
31100
  # https://developers.portone.io/release-notes/platform/2023-08-31
30786
31101
 
30787
31102
  ---
@@ -31990,7 +32305,7 @@ writtenAt: 2025-03-17T00:00:00.000Z
31990
32305
  - 기존 파트너정산자동화 제품을 이용하고 계신 고객이더라도, 세금계산서 역발행 기능 사용을 위해서는 별도 문의가 필요합니다.
31991
32306
 
31992
32307
  - 세금계산서 상태변화 웹훅 및 사업자번호 기업정보조회 API 연동이 필요하신 고객사는
31993
- [📩 support.b2b@portone.io](mailto:support.b2b@portone.io)로 문의해 주세요.
32308
+ [📩 tech.support@portone.io](mailto:tech.support@portone.io)로 문의해 주세요.
31994
32309
 
31995
32310
  포트원의 전체 업데이트 소식은 [개발자센터 릴리즈노트](https://developers.portone.io/release-notes) 페이지에서 확인할 수 있습니다.
31996
32311
 
@@ -32431,7 +32746,465 @@ writtenAt: 2025-07-07T00:00:00.000Z
32431
32746
 
32432
32747
  일반 문의 <cs@portone.io> / 채널톡
32433
32748
 
32434
- 기술지원 문의 <support@portone.io> / 파트너스 슬랙 채널
32749
+ 기술지원 문의 <tech.support@portone.io> / 파트너스 슬랙 채널
32750
+
32751
+
32752
+ # https://developers.portone.io/release-notes/platform/2025-07-23
32753
+
32754
+ ---
32755
+ releasedAt: 2025-07-23T00:00:00.000Z
32756
+ writtenAt: 2025-07-23T00:00:00.000Z
32757
+ ---
32758
+
32759
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
32760
+
32761
+ 2025년 7월 23일 업데이트 사항을 확인해 보세요.
32762
+
32763
+ |**업데이트 항목** |**변경 전** |**변경 후** |
32764
+ |:---------------------------------------|:---------------------------------------------------------|:-------------------------------------------------------|
32765
+ |**세금계산서 API 출시** |세금계산서 기능을 콘솔에서만 이용 |**API 제공으로 시스템 연동 및 자동화 가능** |
32766
+ |**세금계산서 정발행 기능 (API) 추가** |역발행만 가능 |**정발행 및 역발행 모두 지원 (API)** |
32767
+ |**정산 정책 관리 사용성 개선** |정책 수정사항 확인 불가 |**정책 수정 히스토리 조회 가능** |
32768
+ |**정산 상세 조회 내 필터 개선** |수기 정산 건 조회 어려움<br />새로고침 시 필터 조건 초기화|**정산일 기준으로 조회<br />새로고침 시 필터 조건 유지**|
32769
+ |**파트너 정산 자동화 제품 UI 색상 변경**|오렌지 컬러 |**블루 컬러** |
32770
+
32771
+ ## API 출시 안내
32772
+
32773
+ ## 세금계산서 API 출시
32774
+
32775
+ 이제 파트너정산 세금계산서 기능을 **콘솔이 아닌 API**로도 이용하실 수 있습니다.
32776
+
32777
+ API를 활용하면 각 기업의 자체 서비스, 백오피스, 외부 시스템과의 연동을 통해 세금계산서 발행, 조회, 관리 등 다양한 업무를 **완전 자동화**할 수 있어, 반복적인 수기 업무의 부담을 크게 줄이고 효율적인 업무 처리가 가능합니다.
32778
+
32779
+ ## 세금계산서 정발행 기능 (API) 추가
32780
+
32781
+ 기존에는 ‘역발행’만 지원하였으나, 이번 업데이트로 **‘정발행’** 기능이 API에도 포함되었습니다.
32782
+
32783
+ 기업간 거래 상황에 따라 어떤 발행 방식이든, 이제는 포트원 하나로 발행 및 관리가 모두 가능해집니다.
32784
+ 정발행 기능의 콘솔 지원도 2025년 3분기 내 업데이트 예정이니 많은 기대 부탁드립니다.
32785
+
32786
+ **기술 변경 사항 안내**
32787
+ 신규 세금계산서 API 카테고리 및 상세 문서가 [**개발자센터**](https://developers.portone.io/api/rest-v2/b2b.taxInvoice?v=v2) 에 추가되었습니다.
32788
+ 기존 콘솔 UI 기반의 역발행 외에, 정발행 기능이 API로 제공됩니다.
32789
+ 연동 개발 시 개발자센터의 세금계산서 관련 문서를 참고해주시기 바랍니다.
32790
+
32791
+ ---
32792
+
32793
+ ## 파트너 정산 자동화 제품 개선 안내
32794
+
32795
+ ### 정산 정책 관리 사용성 개선
32796
+
32797
+ 정산 정책 관리 페이지의 사용성이 개선되었습니다.
32798
+
32799
+ - 페이지 사용성 개선
32800
+
32801
+ 계약 등록 및 상세 조회, 할인 분담 정책 등록 및 상세 조회, 추가 수수료 정책 등록 및 상세 조회 등 정산 정책 관리 내의 다양한 페이지의 사용성이 개선되었습니다.
32802
+
32803
+ - 계약 내용 수정 이력 조회 기능 추가
32804
+
32805
+ 계약 관리 페이지에서 계약 내용 수정 시, 수정 사항을 확인할 수 있는 히스토리 조회 기능이 추가되었습니다.\
32806
+ 이제 계약 상세 페이지에서 변경 이력을 확인할 수 있어 더 효율적이고 투명한 계약 관리가 가능합니다.
32807
+
32808
+ (관련 이미지 첨부)
32809
+
32810
+ ### 정산 상세 조회 내 필터 개선
32811
+
32812
+ 정산 상세 조회 페이지에서 더욱 편리하게 정산 내역을 확인하실 수 있도록 필터 기능이 개선되었습니다.
32813
+
32814
+ - 기본 조회 기준 변경
32815
+
32816
+ 정산 건 조회 시 기본 조회 기준이 기존 '정산 기준일'에서 '정산일'로 변경되었습니다.
32817
+ 정산 시작일이 설정되지 않은 수기 정산 건도 쉽게 조회할 수 있습니다.
32818
+
32819
+ - 기본 조회 기간 확대
32820
+ 기존 30일 → 90일로 확대되어 더 넓은 범위의 데이터를 한 번에 확인하실 수 있습니다.
32821
+
32822
+ - 필터 조건 유지 및 버그 수정
32823
+
32824
+ 정산 건을 검색할 때 미리 지정한 필터값이 해제되던 버그가 수정되었으며,
32825
+ 이제 페이지를 새로 고침 시에도 이전에 설정한 필터 조건이 그대로 유지됩니다.
32826
+
32827
+ (관련 이미지 첨부)
32828
+
32829
+ ### 파트너 정산 자동화 제품 사용자 인터페이스 색상 변경
32830
+
32831
+ 파트너 정산 자동화 제품의 전반적인 사용자 인터페이스 색상이 기존 오렌지에서 블루로 변경되었습니다.
32832
+
32833
+ ---
32834
+
32835
+ 작성일자: **2025년 07월 23일**
32836
+
32837
+ - 일반 문의: <cs@portone.io> / 채널톡
32838
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
32839
+
32840
+
32841
+ # https://developers.portone.io/release-notes/platform/2025-08-13
32842
+
32843
+ ---
32844
+ releasedAt: 2025-08-13T00:00:00.000Z
32845
+ writtenAt: 2025-08-13T00:00:00.000Z
32846
+ ---
32847
+
32848
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
32849
+
32850
+ 2025년 8월 13일 업데이트 사항을 확인해 보세요.
32851
+
32852
+ ---
32853
+
32854
+ ## 정산 내역서 발송 기능 업데이트
32855
+
32856
+ 이제, 파트너 정산 콘솔에서 생성된 정산 내역을 기반으로, 파트너에게 정산 내역서를 보낼 수 있습니다.
32857
+
32858
+ 일괄지급 내역 상세 및 지급 내역 관리 페이지에서 원하는 정산 내역을 단건, 혹은 다건으로 선택하여 한 번에 정산내역서 이메일을 발송할 수 있습니다.
32859
+
32860
+ **발신자/수신자 설정**: 발신자 이메일 설정은 필수이며, 도메인 인증을 통해 도메인을 활용한 발신이 가능합니다. 인증 완료된 도메인이 없는 경우, 기본 메일 <no-reply@portone.io>로 정산내역서를 발송할 수 있습니다.
32861
+
32862
+ 수신자 이메일은 등록해 둔 파트너의 담당자 이메일로 지정되고, 담당자 이메일을 수정하는 것으로 수신자 이메일을 수정할 수 있습니다. 모든 설정을 완료하고, '정산내역서 발송' 버튼을 클릭하면 선택된 지급 내역의 파트너 전체에게 이메일이 차례대로 발송됩니다.
32863
+
32864
+ (관련 이미지 첨부)
32865
+
32866
+ ---
32867
+
32868
+ ## 정산 내역서 템플릿 생성 및 수정
32869
+
32870
+ 정산 내역서 템플릿을 자유롭게 생성하고, 수정할 수 있습니다.
32871
+
32872
+ 정산내역서 템플릿 관리 페이지에서 템플릿을 다양하게 만들어 관리할 수 있습니다. 지급 내역 생성 여부와 관계없이 템플릿을 생성할 수 있으며, 템플릿 목록 조회, 신규 생성 및 수정, 보관, 복원이 가능합니다. 템플릿 구성 항목의 포함 여부(on/off)를 관리할 수 있고, 구성 항목은 다음과 같습니다.
32873
+
32874
+ (관련 이미지 첨부)
32875
+
32876
+ **발신자 정보**
32877
+
32878
+ - 우리 회사 상호
32879
+
32880
+ **수신자(파트너) 정보**
32881
+
32882
+ - 파트너 이름 및 법인명
32883
+ - 파트너 유형
32884
+ - 과세, 소득 유형
32885
+ - 예금주명
32886
+ - 은행정보 (계좌번호 및 은행명)
32887
+
32888
+ **정산 기본 정보**
32889
+
32890
+ - 정산 기간
32891
+
32892
+ **정산 금액 정보**
32893
+
32894
+ - 지급 금액 (필수값)
32895
+ - 원천징수세액 (소득세, 지방 소득세)
32896
+ - 정산 금액
32897
+ - 확정 공급가액
32898
+ - 확정 부가세액
32899
+ - 정산 면세액
32900
+ - 확정 면세액
32901
+
32902
+ ---
32903
+
32904
+ ## 지급 내역에서 정산 내역서의 상태를 확인
32905
+
32906
+ 지급 내역 페이지에서 정산 내역서 상태 컬럼이 추가되어 발송 상태를 확인할 수 있습니다.
32907
+
32908
+ 지급 내역 페이지에 `정산내역서 상태`, `정산내역서 ID`, `정산내역서 발송 일시` 컬럼이 추가됩니다. 정산 내역서의 상태는 정산내역서가 아직 생성 및 발송되지 않은 상태인 **미발송**, 이메일이 수신자에게 성공적으로 전달된 **발송 완료**, 이메일 발송을 시도했으나, 주소 오류 등의 이유로 실패한 상태인 **발송 실패** 총 3개의 상태가 존재합니다.
32909
+
32910
+ (관련 이미지 첨부)
32911
+
32912
+ ---
32913
+
32914
+ ## API 변경 안내
32915
+
32916
+ 지급내역 `PlatformPayout` 에 정산내역서 요약 정보가 추가되었고, 지급내역 다건 조회 시 정산내역서 정보를 기준으로 필터링할 수 있습니다.
32917
+
32918
+ **지급 내역** `PlatformPayout` **필드 추가**
32919
+
32920
+ 신규 필드: `settlementStatement`: `PlatformPayoutSettlementStatementSummary`
32921
+
32922
+ - `id` – 정산내역서 아이디
32923
+ - `status` – 정산내역서 상태
32924
+ - `issuedAt` – 정산내역서 발송 일시
32925
+
32926
+ **지급 내역 필터** `PlatformPayoutFilterInput` **옵션 추가**
32927
+
32928
+ - `settlementStatementStatuses`: 정산내역서 상태
32929
+ - `criteria.settlementStatementIssuedTimestampRange`: 정산내역서 발송 일시 범위
32930
+ - `criteria.settlementStatementId`: 정산내역서 아이디
32931
+
32932
+ ---
32933
+
32934
+ 작성일자: **2025년 08월 13일**
32935
+
32936
+ - 일반 문의: <cs@portone.io> / 채널톡
32937
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
32938
+
32939
+
32940
+ # https://developers.portone.io/release-notes/platform/2025-08-21
32941
+
32942
+ ---
32943
+ releasedAt: 2025-08-21T00:00:00.000Z
32944
+ writtenAt: 2025-08-21T00:00:00.000Z
32945
+ ---
32946
+
32947
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
32948
+
32949
+ 2025년 8월 21일 업데이트 사항을 확인해 보세요.
32950
+
32951
+ ---
32952
+
32953
+ ## 세금계산서 정발행 기능 출시
32954
+
32955
+ 고객에게 발행하는 정발행 세금계산서를 발행하고 관리할 수 있습니다.
32956
+
32957
+ 이제, 역발행 뿐 아니라 정발행 기능을 콘솔에서 사용할 수 있습니다. 단건 발행 및 일괄 발행으로 정발행 세금계산서를 발행할 수 있게 되어 정산뿐만 아니라 모든 거래에 대한 세금계산서 커버가 가능해집니다.
32958
+
32959
+ 기존 역발행과 다르게 정발행은 파트너 등록 및 <strong>국세청 연동 없이</strong> 이용할 수 있으며, 파트너 등록을 하지 않더라도 정발행시 입력한 공급받는 자(거래처) 정보를 다시 불러와 사용할 수 있습니다.
32960
+
32961
+ (관련 이미지 첨부)
32962
+
32963
+ ---
32964
+
32965
+ ## 엑셀, CSV 일괄 정/역발행
32966
+
32967
+ 기존 일괄 세금계산서 발행은 CSV 파일만 지원되었지만, 이번 업데이트를 통해 엑셀 파일 업로드도 가능해집니다. 제공되는 엑셀 및 CSV 파일 양식을 다운로드 받아 일괄적으로 세금계산서를 작성하여 업로드할 수 있습니다. 기존 역발행과 동일하게 미리보기 후 임시 저장하거나 즉시 발행할 수 있습니다.
32968
+
32969
+ (관련 이미지 첨부)
32970
+
32971
+ ---
32972
+
32973
+ ## 세금계산서 내역 관리
32974
+
32975
+ 기존 역발행 건과 정발행 건의 자연스러운 통합을 위해 세금계산서 내역 관리 페이지에 발행 유형 필터가 추가됩니다. 세금계산서 내역 테이블 내 사업자 정보 컬럼이 기존 공급자 정보에서 거래처(공급자/공급받는자) 정보로 변경되어 역발행의 경우 공급자, 정발행의 경우 공급받는자 정보가 표기됩니다.
32976
+
32977
+ 일괄 세금계산서 내역 관리 페이지에서 발행 대기 상태와 발행 실패 상태가 추가됩니다. 발행 대기 상태는 일괄 세금계산서 발행 처리 중 상태를 의미하며 발행 실패 상태는 시스템 처리 실패를 의미합니다. 또한 정발행과 역발행을 구분하는 발행 유형 정보 및 필터가 추가됩니다.
32978
+
32979
+ (관련 이미지 첨부)
32980
+
32981
+ ---
32982
+
32983
+ ## 세금계산서 안내 메일 발송
32984
+
32985
+ 공급받는 자에게 이메일이 발송됩니다.
32986
+
32987
+ 세금계산서를 발행하는 시점에 공급받는자 (고객) 에게 팝빌 (포트원과 연동된 세금계산서 서비스) 로부터 이메일이 발송됩니다. 공급자는 발행 주체이므로, 별도의 알림 이메일은 발송되지 않습니다.
32988
+
32989
+ ---
32990
+
32991
+ 작성일자: **2025년 08월 21일**
32992
+
32993
+ - 일반 문의: <cs@portone.io> / 채널톡
32994
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
32995
+
32996
+
32997
+ # https://developers.portone.io/release-notes/platform/2025-08-28
32998
+
32999
+ ---
33000
+ releasedAt: 2025-08-28T00:00:00.000Z
33001
+ writtenAt: 2025-08-28T00:00:00.000Z
33002
+ ---
33003
+
33004
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
33005
+
33006
+ 2025년 8월 28일 업데이트 사항을 확인해 보세요.
33007
+
33008
+ ---
33009
+
33010
+ ## 2단계 인증수단
33011
+
33012
+ ### 2단계 인증수단이란?
33013
+
33014
+ 관리자 계정 접근 및 이체 실행 시, 공동 인증서 외에 다른 방식의 인증 절차를 요구하여 보안을 유지하는 방식입니다. 포트원은 2단계 인증 수단으로 Google Authenticator (Google OTP) 를 사용합니다. 파트너 정산을 이용하시는 고객님의 빠르고 편리한 이체를 돕기 위해 관리자 콘솔에서 2단계 인증 수단을 이용할 수 있습니다.
33015
+
33016
+ ---
33017
+
33018
+ ## 이체 시 2단계 인증수단 업데이트
33019
+
33020
+ ### 공동인증서 없이 2단계 인증수단 (OTP) 을 이용하여 쉽게 이체하세요.
33021
+
33022
+ 이제, 공동인증서 없이 콘솔에서 2단계 인증수단을 이용하여 손쉽게 이체를 진행할 수 있습니다. 설정의 내 정보 관리탭에서 2차인증을 눌러 Google Authenticator 를 등록하여 2단계 인증 수단으로 설정할 수 있습니다. 등록이 완료되면 송금대행 일괄이체 실행 페이지의 최종 단계에서 전자서명 대신 2단계 인증번호를 입력할 수 있는 다이얼로그가 노출됩니다.
33023
+
33024
+ (이미지 첨부: 2단계 인증번호 입력 화면)
33025
+
33026
+ ---
33027
+
33028
+ ## 보안 관련 사항
33029
+
33030
+ ### 2단계 인증수단 신청 방식
33031
+
33032
+ 공동인증서 대신 2단계 인증수단 등록을 위해서는 포트원 세일즈/CS 팀으로 요청하셔야하며, <bd@portone.io> 를 통해 요청하실 수 있습니다. 요청이 완료되었더라도, 2단계 인증 설정이 완료된 Admin 계정의 유저만 사용이 가능합니다.
33033
+
33034
+ 또한, 강력한 보안 조치를 위해 포트원 관리자 콘솔 세션 접근 시 인증을 진행하였더라도, 이체 시에 2단계 인증 수단을 통한 재인증이 요구됩니다.
33035
+
33036
+ ---
33037
+
33038
+ ## 가상계좌 과출금 방지 기능 업데이트
33039
+
33040
+ ### 권장 출금 금액보다 많은 금액을 인출할 때 과출금 방지 경고를 받습니다.
33041
+
33042
+ 실시간으로 안전한 출금을 지원하고, 과출금 리스크를 방지하기 위해 과출금 방지 기능이 업데이트 되었습니다. 권장 출금 금액 (계좌 잔액 - 예상 지급 금액) 을 자동 계산하여, 권장 출금 금액보다 많은 금액을 출금하려고 할 때 과출금 방지 경고를 받을 수 있습니다. 예상 지급 금액은 정산내역과 지급내역을 통해 계산되며, 가상계좌 출금 페이지에서 예상 지급 금액 정보를 바로 확인할 수 있습니다.
33043
+
33044
+ (이미지 첨부: 과출금 방지 화면)
33045
+
33046
+ ---
33047
+
33048
+ 작성일자: **2025년 08월 28일**
33049
+
33050
+ - 일반 문의: <cs@portone.io> / 채널톡
33051
+ - 기술지원 문의: <tech.support@portone.io> / 파트너스 슬랙 채널
33052
+
33053
+
33054
+ # https://developers.portone.io/release-notes/platform/2025-10-02
33055
+
33056
+ ---
33057
+ releasedAt: 2025-10-02T00:00:00.000Z
33058
+ writtenAt: 2025-10-02T00:00:00.000Z
33059
+ ---
33060
+
33061
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
33062
+
33063
+ 파트너 정산 자동화 제품의 테스트 환경 확장에 따른 API 변경 사항을 안내드립니다.
33064
+
33065
+ ---
33066
+
33067
+ ## \[파트너 정산 자동화] 테스트 환경 분리 및 API 변경 사전 안내
33068
+
33069
+ 이번 업데이트로 운영 환경과 테스트 환경이 완전히 분리되어, 설정·정산 정책·내역서 템플릿 등을 독립적으로 관리하실 수 있습니다.
33070
+
33071
+ ## 주요 변경 사항
33072
+
33073
+ - 신규 쿼리 파라미터: test: Boolean (선택값)
33074
+
33075
+ - 적용 대상: 모든 파트너 정산 REST API
33076
+
33077
+ - 적용 예정 일자: 2025년 11월 중 (정확한 일자는 추후 별도 안내 예정)
33078
+
33079
+ - 기본값: false
33080
+
33081
+ - 연동 환경 별 설정
33082
+ - 라이브: 하위호환성이 보장되어 영향이 없습니다.
33083
+ - 테스트: test=true 쿼리 파라미터 추가 설정이 필요합니다.
33084
+
33085
+ (이미지 첨부: as is - to be)
33086
+
33087
+ 이번 변경으로 라이브/테스트 환경이 완전히 분리되어 더욱 자유로운 테스트가 가능해집니다.\
33088
+ _기존 데이터는 테스트 및 라이브 환경에 복제되어 기존 그대로 활용하실 수 있습니다._
33089
+
33090
+ ---
33091
+
33092
+ ## 개선 사항
33093
+
33094
+ ### 1. 정산 정책 및 수식 테스트 환경 분리
33095
+
33096
+ 기존에는 정산 정책 및 정산 수식을 변경할 때 별도의 테스트 환경이 없어 운영에 영향을 줄 우려가 있었습니다.\
33097
+ 이번 개선으로 라이브 환경과 완전히 분리된 테스트 환경을 제공하여, 정산 정책 및 수식을 실제 운영에 영향 없이 안전하게 테스트할 수 있습니다.
33098
+
33099
+ ### 2. 파트너 데이터 환경 분리
33100
+
33101
+ 테스트를 위해 등록한 파트너가 라이브 데이터에 그대로 남아 실제 파트너와 함께 조회되는 불편함이 있었습니다.\
33102
+ 테스트용 파트너는 테스트 환경에 별도로 등록하여, 실제 파트너 데이터와 분리하여 관리할 수 있습니다.
33103
+
33104
+ ### 3. 국세청 연동 환경 분리
33105
+
33106
+ 국세청 연동 시 라이브와 테스트 환경에 동시에 연동되어 불필요한 연동 안내 메일을 중복으로 받는 문제가 있었습니다.\
33107
+ 환경별로 독립적인 국세청 연동이 가능해져 필요한 환경에서만 선택적으로 연동할 수 있습니다.
33108
+
33109
+ ---
33110
+
33111
+ ## 세부 변경 사항
33112
+
33113
+ ### 1. 기존 요청 본문에서 테스트 환경 구분이 가능한 API
33114
+
33115
+ 요청 본문(body)의 `isForTest` 파라미터로 환경을 지정하던 방식은 deprecated 되었습니다.\
33116
+ 쿼리 파라미터 `test`로 대체 해 주시기 바랍니다. deprecated 필드는 2026년 이후 별도 공지와 함께 지원이 중단될 예정입니다.
33117
+
33118
+ ```http
33119
+ #Query Parameter가 우선 적용
33120
+ POST /platform/transfers/order?test=true
33121
+ {
33122
+ "isForTest": false, // 무시됨, Query Parameter의 true가 적용
33123
+ ...
33124
+ }
33125
+
33126
+ #Query Parameter 가 없으면 Request Body 값 사용
33127
+ POST /platform/transfers/order
33128
+ {
33129
+ "isForTest": true, // 이 값이 적용
33130
+ ...
33131
+ }
33132
+ ```
33133
+
33134
+ 우선순위는 아래와 같습니다.
33135
+
33136
+ 1. Query Parameter 의미 `test` (최우선)
33137
+ 2. Request Body 의 `isForTest` (Query Parameter 없을 때)
33138
+ 3. 기본값 `false` (둘 다 없을 때)
33139
+
33140
+ 영향 받는 API는 다음과 같습니다.
33141
+
33142
+ - 정산 상세 내역 다운로드 `GET /platform/transfer-summaries/sheet-file`
33143
+ - 정산건 다건 조회 `GET /platform/transfer-summaries`
33144
+ - 수기 정산건 생성 `POST /platform/transfers/manual`
33145
+ - 주문 정산건 생성 `POST /platform/transfers/order`
33146
+ - 주문 취소 정산건 생성 `POST /platform/transfers/order-cancel`
33147
+ - 정산 내역 다건 조회 `GET /platform/partner-settlements`
33148
+ - 지급 내역 다건 조회 `GET /platform/payouts`
33149
+ - 일괄 지급 내역 다건 조회 `GET /platform/bulk-payouts`
33150
+ - 이체 내역 다건 조회 `GET /platform/account-transfers`
33151
+ - 일괄 이체 내역 다건 조회 `GET /platform/bulk-account-transfers`
33152
+
33153
+ ### 2. 테스트 환경 지정이 필요한 API
33154
+
33155
+ 테스트 환경 지정을 위해 쿼리 파라미터 `test`가 추가되었습니다.\
33156
+ 해당 파라미터는 선택 값이며 기본값은 `false`입니다.
33157
+
33158
+ ```http
33159
+ #라이브 환경 데이터만 조회 (기본값)
33160
+ GET /platform/transfers/{id}
33161
+
33162
+ #테스트 환경 데이터만 조회
33163
+ GET /platform/transfers/{id}?test=true
33164
+ ```
33165
+
33166
+ 영향 받는 API는 다음과 같습니다.
33167
+
33168
+ - 정산건 조회 `GET /platform/transfers/{id}`
33169
+ - 정산건 삭제 `DELETE /platform/transfers/{id}`
33170
+ - 추가 수수료 정책 다건 조회 `GET /platform/additional-fee-policies`
33171
+ - 추가 수수료 정책 생성 `POST /platform/additional-fee-policies`
33172
+ - 추가 수수료 정책 조회 `GET /platform/additional-fee-policies/{id}`
33173
+ - 추가 수수료 정책 수정 `PATCH /platform/additional-fee-policies/{id}`
33174
+ - 추가 수수료 정책 보관 `POST /platform/additional-fee-policies/{id}/archive`
33175
+ - 추가 수수료 정책 복원 `POST /platform/additional-fee-policies/{id}/recover`
33176
+ - 계약 다건 조회 `GET /platform/contracts`
33177
+ - 계약 생성 `POST /platform/contracts`
33178
+ - 계약 조회 `GET /platform/contracts/{id}`
33179
+ - 계약 수정 `PATCH /platform/contracts/{id}`
33180
+ - 계약 보관 `POST /platform/contracts/{id}/archive`
33181
+ - 계약 복원 `POST /platform/contracts/{id}/recover`
33182
+ - 할인 분담 정책 다건 조회 `GET /platform/discount-share-policies`
33183
+ - 할인 분담 정책 생성 `POST /platform/discount-share-policies`
33184
+ - 할인 분담 정책 조회 `GET /platform/discount-share-policies/{id}`
33185
+ - 할인 분담 정책 수정 `PATCH /platform/discount-share-policies/{id}`
33186
+ - 할인 분담 정책 보관 `POST /platform/discount-share-policies/{id}/archive`
33187
+ - 할인 분담 정책 복원 `POST /platform/discount-share-policies/{id}/recover`
33188
+ - 파트너 다건 조회 `GET /platform/partners`
33189
+ - 파트너 생성 `POST /platform/partners`
33190
+ - 파트너 다건 생성 `POST /platform/partners/batch`
33191
+ - 파트너 일괄 국세청 연동 `POST /platform/partners/member-company-connect`
33192
+ - 파트너 국세청 연동 `POST /platform/partners/member-company-connect/{id}`
33193
+ - 파트너 일괄 국세청 연동 해제 `POST /platform/partners/member-company-disconnect`
33194
+ - 파트너 국세청 연동 해제 `POST /platform/partners/member-company-disconnect/{id}`
33195
+ - 파트너 조회 `GET /platform/partners/{id}`
33196
+ - 파트너 수정 `PATCH /platform/partners/{id}`
33197
+ - 파트너 보관 `POST /platform/partners/{id}/archive`
33198
+ - 파트너 복원 `POST /platform/partners/{id}/recover`
33199
+ - 예금주 조회 `GET /platform/bank-accounts/{bank}/{accountNumber}/holder`
33200
+ - 사업자 조회 `GET /platform/companies/{businessRegistrationNumber}/state`
33201
+
33202
+ ---
33203
+
33204
+ 작성일자: **2025년 10월 02일**
33205
+
33206
+ - 일반 문의: <cs@portone.io> / 채널톡
33207
+ - 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
32435
33208
 
32436
33209
 
32437
33210
  # https://developers.portone.io/blog/posts/2024-02/v2-oom