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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (257) hide show
  1. package/README.md +62 -47
  2. package/assets/docs/_components/ko/docs-for-llms.md +21 -0
  3. package/assets/docs/_components/ko/llms-txt-support.md +15 -0
  4. package/assets/docs/_components/ko/using-mcp-server.md +60 -0
  5. package/assets/docs/api/rest-v1/_components/v1auth.md +103 -0
  6. package/assets/docs/help/admin-console/analytics/content32.md +4 -4
  7. package/assets/docs/help/admin-console/payment-service/content29.md +223 -110
  8. package/assets/docs/help/admin-console/pg-settlement/content30.md +103 -208
  9. package/assets/docs/help/admin-console/pg-settlement-history/content35.md +167 -0
  10. package/assets/docs/help/admin-console/platform-settlement/partner_settlement_service_guide.md +268 -0
  11. package/assets/docs/help/api-sdk-2025-05-14.md +71 -0
  12. package/assets/docs/help/applepay.md +1 -1
  13. package/assets/docs/help/content100002.md +1 -1
  14. package/assets/docs/help/content100029.md +1 -1
  15. package/assets/docs/help/content100060.md +2 -2
  16. package/assets/docs/help/content200015.md +1 -1
  17. package/assets/docs/help/content200019.md +1 -1
  18. package/assets/docs/help/content200023.md +2 -2
  19. package/assets/docs/help/content200050.md +1 -1
  20. package/assets/docs/help/core-service/channel-setting/danal.md +6 -8
  21. package/assets/docs/help/core-service/channel-setting/eximbay.md +9 -3
  22. package/assets/docs/help/core-service/channel-setting/kcp_channel.md +80 -13
  23. package/assets/docs/help/core-service/channel-setting/naverpay.md +6 -8
  24. package/assets/docs/help/core-service/channel-setting/nice.md +49 -47
  25. package/assets/docs/help/core-service/channel-setting/payletter.md +91 -0
  26. package/assets/docs/help/core-service/channel-setting/paymentwall.md +4 -1
  27. package/assets/docs/help/core-service/how-to-use/additional-nice.md +19 -19
  28. package/assets/docs/help/core-service/how-to-use/cancel-reversal.md +2 -2
  29. package/assets/docs/help/core-service/how-to-use/content200009.md +2 -2
  30. package/assets/docs/help/core-service/how-to-use/danal-contract.md +2 -2
  31. package/assets/docs/help/core-service/how-to-use/daou-contract.md +2 -2
  32. package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +9 -9
  33. package/assets/docs/help/core-service/how-to-use/identity-verification-age-restriction.md +29 -0
  34. package/assets/docs/help/core-service/how-to-use/information-pg.md +4 -4
  35. package/assets/docs/help/core-service/how-to-use/ksnet-contract.md +1 -1
  36. package/assets/docs/help/core-service/how-to-use/nice-contract.md +15 -15
  37. package/assets/docs/help/core-service/how-to-use/open-immediately.md +1 -1
  38. package/assets/docs/help/core-service/how-to-use/point-service.md +7 -7
  39. package/assets/docs/help/core-service/how-to-use/settle-contract.md +2 -2
  40. package/assets/docs/help/core-service/how-to-use/shopify-available-list.md +4 -4
  41. package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +3 -3
  42. package/assets/docs/help/core-service/how-to-use/tosspayments-contract.md +4 -4
  43. package/assets/docs/help/core-service/payment-type/content200007.md +8 -7
  44. package/assets/docs/help/core-service/payment-type/content200036.md +17 -18
  45. package/assets/docs/help/core-service/payment-type/content200042.md +3 -3
  46. package/assets/docs/help/core-service/payment-type/content200052.md +2 -2
  47. package/assets/docs/help/core-service/payment-type/content200053.md +7 -3
  48. package/assets/docs/help/core-service/payment-type/hub-service-fee.md +19 -17
  49. package/assets/docs/help/core-service/payment-type/inicis-easypay-hub-fee.md +5 -6
  50. package/assets/docs/help/core-service/payment-type/inicis-international.md +10 -10
  51. package/assets/docs/help/core-service/payment-type/internationl-pg.md +7 -3
  52. package/assets/docs/help/core-service/payment-type/kcp-easypay-hub-apply.md +4 -5
  53. package/assets/docs/help/core-service/payment-type/kcp-international.md +2 -3
  54. package/assets/docs/help/core-service/payment-type/nice-easypay-hub-fee.md +8 -8
  55. package/assets/docs/help/core-service/payment-type/nice-international.md +14 -14
  56. package/assets/docs/help/core-service/payment-type/payletter-international.md +104 -0
  57. package/assets/docs/help/core-service/payment-type/schedule-requirement.md +2 -2
  58. package/assets/docs/help/core-service/payment-type/tosspayments-easypay-hub-fee.md +6 -6
  59. package/assets/docs/help/faq/general-inquiry/confirm-process.md +16 -16
  60. package/assets/docs/help/faq/general-inquiry/identity-verification-suspended-ip.md +35 -0
  61. package/assets/docs/help/faq/general-inquiry/kcp-business-number-error.md +29 -0
  62. package/assets/docs/help/faq/general-inquiry/platform-contract-method.md +4 -5
  63. package/assets/docs/help/faq/general-inquiry/platform-contract-pg.md +2 -2
  64. package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
  65. package/assets/docs/help/faq/payment-faq/cash-receipt-guide.md +2 -2
  66. package/assets/docs/help/faq/payment-faq/kcp-cash-receipt.md +34 -0
  67. package/assets/docs/help/faq/payment-faq/payment-failure-danal-insufficient-funds.md +29 -0
  68. package/assets/docs/help/faq/payment-faq/payment-failure-kcp-insufficient-funds.md +35 -0
  69. package/assets/docs/help/faq/payment-faq/payment-failure-kiwoompay-insufficient-funds.md +25 -0
  70. package/assets/docs/help/faq/payment-faq/payment-failure-nice-insufficient-funds.md +28 -0
  71. package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
  72. package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +10 -10
  73. package/assets/docs/help/faq/payment-faq/wordpress-woocommerce-taxation.md +67 -0
  74. package/assets/docs/help/faq/platform-faq/platform_additional_fee_setting.md +28 -0
  75. package/assets/docs/help/faq/platform-faq/platform_api_docs.md +24 -0
  76. package/assets/docs/help/faq/platform-faq/platform_definition_partner.md +34 -0
  77. package/assets/docs/help/faq/platform-faq/platform_definition_payout_agency.md +23 -0
  78. package/assets/docs/help/faq/platform-faq/platform_definition_platform.md +17 -0
  79. package/assets/docs/help/faq/platform-faq/platform_definition_settlement.md +29 -0
  80. package/assets/docs/help/faq/platform-faq/platform_difference_settlement_payout.md +29 -0
  81. package/assets/docs/help/faq/platform-faq/platform_ecommerce_discount_policy.md +19 -0
  82. package/assets/docs/help/faq/platform-faq/platform_introduction.md +15 -0
  83. package/assets/docs/help/faq/platform-faq/platform_introduction_conditions.md +16 -0
  84. package/assets/docs/help/faq/platform-faq/platform_nocode_guide.md +5 -5
  85. package/assets/docs/help/faq/platform-faq/platform_nocode_hosting.md +20 -0
  86. package/assets/docs/help/faq/platform-faq/platform_nocode_use.md +28 -0
  87. package/assets/docs/help/faq/platform-faq/platform_partner_bulk_registration.md +31 -0
  88. package/assets/docs/help/faq/platform-faq/platform_partner_info_guide.md +49 -0
  89. package/assets/docs/help/faq/platform-faq/platform_partner_management_tags.md +14 -0
  90. package/assets/docs/help/faq/platform-faq/platform_partner_tax_type.md +18 -0
  91. package/assets/docs/help/faq/platform-faq/platform_partnerships.md +16 -0
  92. package/assets/docs/help/faq/platform-faq/platform_payment_formula_setting.md +20 -0
  93. package/assets/docs/help/faq/platform-faq/platform_paymentdetails_definition.md +11 -0
  94. package/assets/docs/help/faq/platform-faq/platform_paymentdetails_view_features.md +18 -0
  95. package/assets/docs/help/faq/platform-faq/platform_payoutagency_realtime_payment.md +22 -0
  96. package/assets/docs/help/faq/platform-faq/platform_payoutagency_safety_legality.md +22 -0
  97. package/assets/docs/help/faq/platform-faq/platform_payoutagency_scheduled_payment.md +18 -0
  98. package/assets/docs/help/faq/platform-faq/platform_pg_fee_handling.md +18 -0
  99. package/assets/docs/help/faq/platform-faq/platform_policymanagement_calculator.md +1 -1
  100. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_creation_guide.md +24 -0
  101. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_definition.md +19 -0
  102. package/assets/docs/help/faq/platform-faq/platform_privacypolicy_service_compliance.md +28 -0
  103. package/assets/docs/help/faq/platform-faq/platform_settlement_auto_calculation_setting.md +39 -0
  104. package/assets/docs/help/faq/platform-faq/platform_settlement_cancellation_data.md +21 -0
  105. package/assets/docs/help/faq/platform-faq/platform_settlement_custom_attributes.md +18 -0
  106. package/assets/docs/help/faq/platform-faq/platform_settlement_custom_formula_request.md +20 -0
  107. package/assets/docs/help/faq/platform-faq/platform_settlement_cycle_setting.md +42 -0
  108. package/assets/docs/help/faq/platform-faq/platform_settlement_decimal_rounding.md +23 -0
  109. package/assets/docs/help/faq/platform-faq/platform_settlement_hold_date_setting.md +35 -0
  110. package/assets/docs/help/faq/platform-faq/platform_settlement_holidays.md +9 -0
  111. package/assets/docs/help/faq/platform-faq/platform_settlement_manual_registration.md +32 -0
  112. package/assets/docs/help/faq/platform-faq/platform_settlementdetails_view_features.md +26 -0
  113. package/assets/docs/help/faq/platform-faq/platform_settlmentandpayout_guide.md +4 -4
  114. package/assets/docs/help/faq/platform-faq/platform_supported_bank_codes.md +85 -0
  115. package/assets/docs/help/faq/platform-faq/platform_supported_currencies.md +33 -0
  116. package/assets/docs/help/faq/platform-faq/platform_tax_calculation.md +17 -0
  117. package/assets/docs/help/faq/platform-faq/platform_tax_setting_guide.md +1 -1
  118. package/assets/docs/help/faq/platform-faq/platform_tax_withholding_tax_definition.md +14 -0
  119. package/assets/docs/help/faq/platform-faq/platform_virtual_account_withdrawal.md +16 -0
  120. package/assets/docs/help/faq/platform-faq/platform_webhook_definition.md +24 -0
  121. package/assets/docs/help/faq/platform-faq/recommended_withdrawal.md +16 -0
  122. package/assets/docs/help/faq/platform-faq/system_test_environment.md +13 -0
  123. package/assets/docs/help/faq/platform-faq/taxinvoice_bulk_issuance.md +25 -0
  124. package/assets/docs/help/faq/platform-faq/taxinvoice_cancel.md +12 -0
  125. package/assets/docs/help/faq/platform-faq/taxinvoice_delayed.md +18 -0
  126. package/assets/docs/help/faq/platform-faq/taxinvoice_forward_issuance.md +23 -0
  127. package/assets/docs/help/faq/platform-faq/taxinvoice_guide_atoz.md +202 -0
  128. package/assets/docs/help/faq/platform-faq/taxinvoice_partner_peristalsis.md +60 -0
  129. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_buyer_process.md +52 -0
  130. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_definition.md +46 -0
  131. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_partner_signup.md +23 -0
  132. package/assets/docs/help/faq/platform-faq/taxinvoice_reverse_issuance_supplier_process.md +47 -0
  133. package/assets/docs/help/notice-payletter-2025-10-21.md +29 -0
  134. package/assets/docs/help/notice-payletter-2025-10-24.md +46 -0
  135. package/assets/docs/help/platform-2025-07-02.md +73 -0
  136. package/assets/docs/help/platform-2025-07-07.md +56 -0
  137. package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +2 -2
  138. package/assets/docs/help/procedure/payment-integration/test-integration.md +2 -2
  139. package/assets/docs/help/procedure/pg-application/content59.md +1 -1
  140. package/assets/docs/help/procedure/pg-application/start.md +1 -1
  141. package/assets/docs/help/procedure/recommendation/package.md +5 -5
  142. package/assets/docs/help/service/identity-verification/identity-verification.md +6 -6
  143. package/assets/docs/help/service/paymethod/paymethod.md +2 -2
  144. package/assets/docs/help/service/pg/pg-service-list.md +25 -13
  145. package/assets/docs/help/service/version/portone-version.md +1 -1
  146. package/assets/docs/opi/ko/console/guide/billing-payments.md +1 -1
  147. package/assets/docs/opi/ko/console/guide/reg.md +1 -1
  148. package/assets/docs/opi/ko/console/guide/smartrouting.md +0 -2
  149. package/assets/docs/opi/ko/console/pg.md +7 -7
  150. package/assets/docs/opi/ko/etc/recon.md +1 -1
  151. package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md +2 -2
  152. package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md +11 -4
  153. package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md +2 -2
  154. package/assets/docs/opi/ko/extra/identity-verification/v1/all/3.md +3 -3
  155. package/assets/docs/opi/ko/extra/identity-verification/v1/all/readme.md +1 -1
  156. package/assets/docs/opi/ko/extra/identity-verification/v1/credit-auth/4.md +3 -3
  157. package/assets/docs/opi/ko/extra/identity-verification/v1/phone/4.md +3 -3
  158. package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md +74 -0
  159. package/assets/docs/opi/ko/extra/plugins/wordpress/button.md +1 -1
  160. package/assets/docs/opi/ko/extra/plugins/wordpress/edd.md +1 -1
  161. package/assets/docs/opi/ko/extra/plugins/wordpress/woocommerce/subscription.md +1 -1
  162. package/assets/docs/opi/ko/extra/promotion/intro.md +1 -1
  163. package/assets/docs/opi/ko/extra/smart-routing/console-guide.md +1 -1
  164. package/assets/docs/opi/ko/extra/smart-routing/integration.md +2 -2
  165. package/assets/docs/opi/ko/extra/smart-routing/intro.md +9 -9
  166. package/assets/docs/opi/ko/integration/pg/v1/danal.md +5 -0
  167. package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +9 -0
  168. package/assets/docs/opi/ko/integration/pg/v1/daou/undefined.md +8 -0
  169. package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +0 -14
  170. package/assets/docs/opi/ko/integration/pg/v1/inicis.md +58 -0
  171. package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +12 -1
  172. package/assets/docs/opi/ko/integration/pg/v1/kicc.md +3 -1
  173. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +710 -0
  174. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +661 -0
  175. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +10 -71
  176. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +11 -11
  177. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/payment-caution.md +16 -16
  178. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +10 -8
  179. package/assets/docs/opi/ko/integration/pg/v1/nice.md +6 -6
  180. package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +86 -0
  181. package/assets/docs/opi/ko/integration/pg/v1/paypal.md +1 -1
  182. package/assets/docs/opi/ko/integration/pg/v1/readme.md +5 -3
  183. package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +80 -0
  184. package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +10 -9
  185. package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +10 -7
  186. package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md +138 -22
  187. package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md +0 -1
  188. package/assets/docs/opi/ko/integration/pg/v2/inicis-v2.md +13 -1
  189. package/assets/docs/opi/ko/integration/pg/v2/kcp-v2.md +4 -2
  190. package/assets/docs/opi/ko/integration/pg/v2/naverpay.md +1 -1
  191. package/assets/docs/opi/ko/integration/pg/v2/nice-v2.md +40 -40
  192. package/assets/docs/opi/ko/integration/pg/v2/payletter-global.md +9 -2
  193. package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md +13 -12
  194. package/assets/docs/opi/ko/integration/pg/v2/readme.md +1 -1
  195. package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
  196. package/assets/docs/opi/ko/integration/pg/v2/welcome.md +8 -7
  197. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/hyphen.md +27 -0
  198. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/inicis.md +64 -0
  199. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/kcp-v2.md +70 -0
  200. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/paypal-v2.md +25 -0
  201. package/assets/docs/opi/ko/integration/ready/_components/integration-guide/tosspayments.md +15 -0
  202. package/assets/docs/opi/ko/integration/ready/readme.md +26 -10
  203. package/assets/docs/opi/ko/integration/start/_components/sdk-installation.md +71 -0
  204. package/assets/docs/opi/ko/integration/start/v1/non-auth.md +2 -4
  205. package/assets/docs/opi/ko/integration/start/v2/billing/issue.md +1 -1
  206. package/assets/docs/opi/ko/integration/start/v2/checkout.md +4 -2
  207. package/assets/docs/opi/ko/integration/start/v2/readme.md +2 -2
  208. package/assets/docs/opi/ko/integration/using-ai-tools.md +33 -57
  209. package/assets/docs/opi/ko/integration/virtual-account/readme.md +9 -9
  210. package/assets/docs/opi/ko/integration/webhook/readme-v1.md +2 -4
  211. package/assets/docs/opi/ko/integration/webhook/readme-v2.md +1 -3
  212. package/assets/docs/opi/ko/quick-guide/payment.md +16 -16
  213. package/assets/docs/opi/ko/support/code-info/pg-1.md +1 -1
  214. package/assets/docs/opi/ko/support/code-info/pg-2.md +2 -2
  215. package/assets/docs/opi/ko/support/code-info/pg.md +2 -2
  216. package/assets/docs/opi/ko/support/contact.md +1 -13
  217. package/assets/docs/opi/ko/support/pg-terms.md +233 -0
  218. package/assets/docs/platform/ko/guides/dictionary.md +136 -16
  219. package/assets/docs/platform/ko/guides/process.md +1 -1
  220. package/assets/docs/platform/ko/guides/webhook.md +1 -1
  221. package/assets/docs/platform/ko/using-ai-tools.md +33 -57
  222. package/assets/docs/release-notes/api-sdk/2023-07-10.md +7 -7
  223. package/assets/docs/release-notes/api-sdk/2023-07-31.md +1 -1
  224. package/assets/docs/release-notes/api-sdk/2023-08-31.md +2 -2
  225. package/assets/docs/release-notes/api-sdk/2024-01-08.md +4 -4
  226. package/assets/docs/release-notes/api-sdk/2024-06-03.md +1 -1
  227. package/assets/docs/release-notes/api-sdk/2024-09-05.md +0 -1
  228. package/assets/docs/release-notes/api-sdk/2024-09-27.md +1 -1
  229. package/assets/docs/release-notes/console/2025-10-17.md +47 -0
  230. package/assets/docs/release-notes/platform/2025-03-17.md +1 -1
  231. package/assets/docs/release-notes/platform/2025-07-07.md +1 -1
  232. package/assets/docs/release-notes/platform/2025-07-23.md +85 -0
  233. package/assets/docs/release-notes/platform/2025-08-13.md +95 -0
  234. package/assets/docs/release-notes/platform/2025-08-21.md +53 -0
  235. package/assets/docs/release-notes/platform/2025-08-28.md +53 -0
  236. package/assets/docs/release-notes/platform/2025-10-02.md +152 -0
  237. package/assets/docs/schema/browser-sdk.yml +196 -69
  238. package/assets/docs/schema/v1.openapi.json +164 -217
  239. package/assets/docs/schema/v1.openapi.yml +148 -213
  240. package/assets/docs/schema/v2.openapi.json +18056 -11790
  241. package/assets/docs/schema/v2.openapi.yml +4801 -191
  242. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +3 -3
  243. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +3 -3
  244. package/assets/docs/sdk/ko/v2-sdk/_components/sdk-installation.md +71 -0
  245. package/assets/docs/sdk/ko/v2-server-sdk/jvm.md +12 -5
  246. package/assets/docs/sdk/ko/v2-server-sdk/python.md +12 -3
  247. package/assets/docs/v1-docs-full.md +2298 -1026
  248. package/assets/docs/v2-docs-full.md +1412 -362
  249. package/assets/docs/website-links.md +23 -13
  250. package/assets/instructions.md +4 -2
  251. package/manifest.json +3 -14
  252. package/package.json +20 -19
  253. package/server/index.js +1783 -739
  254. package/assets/docs/help/admin-console/platform-settlement/content33-1.md +0 -201
  255. package/assets/docs/help/core-service/payment-type/schedule-logic-guide.md +0 -49
  256. package/assets/docs/help/faq/platform-faq/taxinvoice_guide.md +0 -107
  257. package/assets/docs/help/faq/platform-faq/taxinvoice_signupemail.md +0 -67
@@ -25,8 +25,8 @@ targetVersions:
25
25
 
26
26
  | PG사 |상점아이디 (예시)| 용도 | 채널키 |
27
27
  |:---------------------:|:---------------:|:---------------:|:----------------------------------------------:|
28
- |**(신) 나이스페이먼츠**| MID-a | **인증 결제용** |channel-key-12345678-1234-5678-9012-123456789012|
29
- |**(신) 나이스페이먼츠**| MID-b |**비인증 결제용**|channel-key-abcdefgh-abcd-efgh-ijkl-abcdefghijkl|
28
+ |**(신) 나이스정보통신**| MID-a | **인증 결제용** |channel-key-12345678-1234-5678-9012-123456789012|
29
+ |**(신) 나이스정보통신**| MID-b |**비인증 결제용**|channel-key-abcdefgh-abcd-efgh-ijkl-abcdefghijkl|
30
30
  | 카카오페이 | MID-c | 인증 결제용 |channel-key-98765432-9876-5432-1098-987654321098|
31
31
 
32
32
  다음과 같이 `channelKey` 속성에 `channel-key-98765432-9876-5432-1098-987654321098`를 지정하면 등록한 카카오페이 설정으로 결제창이 호출됩니다
@@ -49,15 +49,15 @@ IMP.request_pay({
49
49
 
50
50
  </div>
51
51
 
52
- 위에서 등록한 PG 설정 중 **(신) 나이스페이먼츠 (인증 결제용)** 와 **(신) 나이스페이먼츠 (비인증 결제용)** 의 경우 **PG사 코드값이 동일**하지만, `channelKey` 파라미터를 통해 구분이 가능합니다.
52
+ 위에서 등록한 PG 설정 중 **(신) 나이스정보통신 (인증 결제용)** 와 **(신) 나이스정보통신 (비인증 결제용)** 의 경우 **PG사 코드값이 동일**하지만, `channelKey` 파라미터를 통해 구분이 가능합니다.
53
53
 
54
54
  <div class="tabs-container">
55
55
 
56
- <div class="tabs-content" data-title="(신) 나이스페이먼츠 인증 결제용 호출">
56
+ <div class="tabs-content" data-title="(신) 나이스정보통신 인증 결제용 호출">
57
57
 
58
58
  ```ts
59
59
  IMP.request_pay({
60
- channelKey: "channel-key-12345678-1234-5678-9012-123456789012", // (신) 나이스페이먼츠 인증 결제용 채널키
60
+ channelKey: "channel-key-12345678-1234-5678-9012-123456789012", // (신) 나이스정보통신 인증 결제용 채널키
61
61
  amount: 1000,
62
62
  name: "테스트 주문",
63
63
  buyer_name: "구매자",
@@ -67,11 +67,11 @@ IMP.request_pay({
67
67
 
68
68
  </div>
69
69
 
70
- <div class="tabs-content" data-title="(신) 나이스페이먼츠 비인증 결제용 호출">
70
+ <div class="tabs-content" data-title="(신) 나이스정보통신 비인증 결제용 호출">
71
71
 
72
72
  ```ts
73
73
  IMP.request_pay({
74
- channelKey: "channel-key-abcdefgh-abcd-efgh-ijkl-abcdefghijkl", // (신) 나이스페이먼츠 비인증 결제용 채널키
74
+ channelKey: "channel-key-abcdefgh-abcd-efgh-ijkl-abcdefghijkl", // (신) 나이스정보통신 비인증 결제용 채널키
75
75
  amount: 1000,
76
76
  name: "테스트 주문",
77
77
  buyer_name: "구매자",
@@ -8,7 +8,7 @@ description: >-
8
8
  ## PG 거래대사 유의사항
9
9
 
10
10
  - 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
11
- - 지원 PG : **KCP, KG이니시스, 나이스페이먼츠, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
11
+ - 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
12
12
  - 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
13
13
  - 9/26 이후 지원 예정 PG사 : KPN, 하이픈, KSNET
14
14
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: 컨펌 프로세스
3
- description: 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스 입니다.
3
+ description: 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스입니다.
4
4
  targetVersions:
5
5
  - v1
6
6
  versionVariants:
@@ -53,7 +53,7 @@ versionVariants:
53
53
 
54
54
  **컨펌 프로세스 신청 방법**
55
55
 
56
- 기술지원 메일(<support@portone.io>)로 **고객사 식별코드**를 기재하여 메일 발송
56
+ 기술지원 메일(<tech.support@portone.io>)로 **고객사 식별코드**를 기재하여 메일 발송
57
57
 
58
58
  (이미지 첨부: 포트원 콘솔 내 고객사 식별코드 확인 예시)
59
59
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: 컨펌 프로세스
3
- description: 결제승인의 주체를 고객사 서버로 가져갈수 있는 서비스 입니다.
3
+ description: 결제 승인의 주체를 고객사 서버로 가져갈 있는 서비스입니다.
4
4
  targetVersions:
5
5
  - v2
6
6
  versionVariants:
@@ -9,11 +9,18 @@ versionVariants:
9
9
 
10
10
  **해당 서비스는 결제 승인 직전에 고객사에서 결제 의사를 최종적으로 확인하는 서비스입니다.**
11
11
 
12
- (관련 이미지 첨부)
12
+ <div class="hint" data-style="info">
13
+
14
+ **수동 승인 기능 안내**
15
+
16
+ V2 신규 연동 시에는 컨펌 프로세스와 동일한 목적으로 사용할 수 있는 [수동 승인](https://developers.portone.io/opi/ko/extra/manual-confirm/readme-v2) 기능을 이용하시기를 권장합니다.
17
+ 수동 승인은 더 간편한 연동 방식을 제공하며, 채널 설정에서 간단히 켤 수 있습니다.
18
+
19
+ </div>
13
20
 
14
21
  ## 컨펌 프로세스란?
15
22
 
16
- - 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스 입니다.
23
+ - 결제 승인 직전 고객사에 결제 승인 요청 의사를 마지막으로 확인하는 서비스입니다.
17
24
 
18
25
  - 기본적인 결제 플로우상 고객사에서 결제 요청 후 별도의 확인 없이 결제 승인되는 구조입니다.
19
26
  하지만 해당 서비스 이용 시 고객사가 최종적으로 결제 승인 요청의 주체가 될 수 있습니다.
@@ -62,7 +69,7 @@ versionVariants:
62
69
 
63
70
  **컨펌 프로세스 신청 방법**
64
71
 
65
- 기술지원 메일(<support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
72
+ 기술지원 메일(<tech.support@portone.io>)로 **상점 아이디**를 기재하여 메일 발송
66
73
 
67
74
  포트원 콘솔 로그인 후 \[결제연동] 페이지 상단에서 상점 아이디를 확인 하실 수 있습니다.
68
75
 
@@ -10,8 +10,8 @@ versionVariants:
10
10
  **본인인증 서비스**란 인증 절차를 거쳐 본인 여부와 입력한 정보의 정확성을 확인하여 주는 서비스입니다. 현재 지원하는 본인인증 서비스는 아래와 같습니다.
11
11
 
12
12
  - 다날 휴대폰 본인인증
13
- - KG이니시스 통합인증
14
13
  - KCP 휴대폰 본인인증
14
+ - KG이니시스 통합인증
15
15
 
16
16
  ## 휴대폰 본인인증
17
17
 
@@ -40,7 +40,7 @@ versionVariants:
40
40
  이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
41
41
  하는 방식으로 이루어집니다.
42
42
 
43
- > **이용가능 수단 : 네이버 / PASS / 페이코 / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
43
+ > **이용가능 수단 : 네이버 / PASS / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
44
44
 
45
45
  (이미지 첨부: 휴대폰 본인인증 화면 예시)
46
46
 
@@ -97,7 +97,7 @@ app.post("/certifications", async (request, response) => {
97
97
 
98
98
  - `name`: 이름
99
99
  - `gender`: 성별
100
- - `birth`: 생년월일
100
+ - `birthday`: 생년월일(YYYY-MM-DD)
101
101
  - `unique_key`: CI 값과 동일. 온라인 주민번호와 같은 개인고유식별키
102
102
  - `phone :`휴대폰 번호
103
103
 
@@ -111,9 +111,9 @@ app.post("/certifications", async (request, response) => {
111
111
  // imp_uid로 인증 정보 조회
112
112
  /* ...중략... */
113
113
  const certificationsInfo = getCertifications.data; // 조회한 인증 정보
114
- const { name, birth } = certificationsInfo;
114
+ const { name, birthday } = certificationsInfo;
115
115
  // 연령 제한 로직
116
- if (new Date(birth).getFullYear() <= 1999) {
116
+ if (new Date(birthday).getFullYear() <= 1999) {
117
117
  // 연령 만족
118
118
  } else {
119
119
  // 연령 미달
@@ -12,6 +12,6 @@ targetVersions:
12
12
  이용하거나 사용자 본인이 가입된 간편인증을 통해 인증요청을 보내고 간편인증 페이지에서 인증처리를
13
13
  하는 방식으로 이루어 집니다.
14
14
 
15
- > **이용가능 수단 : 네이버 / PASS / 페이코 / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
15
+ > **이용가능 수단 : 네이버 / PASS / TOSS / 금융인증서 / 카카오 / 신한 / KB모바일 / 삼성패스**
16
16
 
17
17
  [이미지 링크](<https://developers.portone.io/gitbook-assets/ko/image (24) (2).png>)
@@ -87,7 +87,7 @@ app.post("/certifications", async (request, response) => {
87
87
 
88
88
  - `name`: 이름
89
89
  - `gender`: 성별
90
- - `birth`: 생년월일
90
+ - `birthday`: 생년월일(YYYY-MM-DD)
91
91
  - `unique_key`: CI 값과 동일. 온라인 주민번호와 같은 개인고유식별키
92
92
  - `unique_in_site`: DI 값과 동일. 상점아이디(사이트)별로 할당되는 식별키
93
93
 
@@ -110,10 +110,10 @@ app.post("/certifications", async (request, response) => {
110
110
  /* ...중략... */
111
111
  const certificationsInfo = getCertifications.data; // 조회한 인증 정보
112
112
  // unique_key: 개인식별 고유 키, unique_in_site: 사이트 별 개인식별 고유 키
113
- const { unique_key, unique_in_site, name, gender, birth } =
113
+ const { unique_key, unique_in_site, name, gender, birthday } =
114
114
  certificationsInfo;
115
115
  // 연령 제한 로직
116
- if (new Date(birth).getFullYear() <= 1999) {
116
+ if (new Date(birthday).getFullYear() <= 1999) {
117
117
  // 연령 만족
118
118
  } else {
119
119
  // 연령 미달
@@ -89,7 +89,7 @@ app.post("/certifications", async (request, response) => {
89
89
 
90
90
  - `name`: 이름
91
91
  - `gender`: 성별
92
- - `birth`: 생년월일
92
+ - `birthday`: 생년월일(YYYY-MM-DD)
93
93
  - `unique_key`: CI 값과 동일. 온라인 주민번호와 같은 개인고유식별키
94
94
  - `unique_in_site`: DI 값과 동일. 상점아이디(사이트)별로 할당되는 식별키
95
95
 
@@ -125,10 +125,10 @@ app.post("/certifications", async (request, response) => {
125
125
  /* ...중략... */
126
126
  const certificationsInfo = getCertifications.data; // 조회한 인증 정보
127
127
  // unique_key: 개인식별 고유 키, unique_in_site: 사이트 별 개인식별 고유 키
128
- const { unique_key, unique_in_site, name, gender, birth } =
128
+ const { unique_key, unique_in_site, name, gender, birthday } =
129
129
  certificationsInfo;
130
130
  // 연령 제한 로직
131
- if (new Date(birth).getFullYear() <= 1999) {
131
+ if (new Date(birthday).getFullYear() <= 1999) {
132
132
  // 연령 만족
133
133
  } else {
134
134
  // 연령 미달
@@ -0,0 +1,74 @@
1
+ ---
2
+ title: 수동 승인
3
+ description: 고객사 서버에서 API를 호출하여 결제를 승인하는 연동 방식입니다.
4
+ targetVersions:
5
+ - v2
6
+ ---
7
+
8
+ 포트원을 통해 PG의 결제 UI를 표시하면, 구매자는 UI에서 정보 입력 및 인증을 진행합니다. 이 과정이 끝나고 UI가 닫히면 자동으로 결제 승인(또는 가상계좌 발급, 빌링키 발급)이 일어납니다.
9
+
10
+ 그러나 채널 설정에서 **수동 승인**을 켜면, 결제 UI가 완료되더라도 고객사 서버에서 포트원의 **수동 승인** API를 호출하지 않으면 결제 승인 등이 일어나지 않습니다.
11
+
12
+ <div class="hint" data-style="warning">
13
+
14
+ **수동 승인을 사용할 수 없는 PG**
15
+
16
+ 엑심베이, 페이레터 해외결제의 경우 수동 승인을 지원하지 않고, 채널 설정에서도 해당 항목이 보이지 않습니다.
17
+
18
+ 이는 근본적으로 위챗 결제와 같이 일부 해외 결제수단이 수동 승인을 지원하지 않기 때문입니다. 따라서 추후 포트원에 추가되는 PG가 이러한 결제수단을 지원한다면, 해당 PG에서는 수동 승인을 이용할 수 없을 가능성이 높습니다.
19
+
20
+ </div>
21
+
22
+ <div class="hint" data-style="info">
23
+
24
+ **컨펌 프로세스와의 비교**
25
+
26
+ 수동 승인은 컨펌 프로세스와 동일한 목적의 기능이며, V2 신규 연동에서는 더 간편한 수동 승인 이용을 권장합니다.
27
+
28
+ 컨펌 프로세스를 이용할 수 있는 PG의 목록도 수동 승인과 동일합니다.
29
+
30
+ </div>
31
+
32
+ ## 수동 승인이 유용한 경우
33
+
34
+ - 결제 승인 전 마지막으로 재고 확인이 필요할 때
35
+ - 수량이 한정된 선착순 판매일 때
36
+ - 결제 완료 상태를 웹훅으로 수신하기보다, 직접 API를 호출해서 결제를 완료시키는 것을 선호할 때
37
+ - 수동 승인 방식으로 타 결제사를 연동한 상태에서 포트원도 같은 구조로 연동하고 싶을 때
38
+
39
+ ## 자동 승인이 유용한 경우
40
+
41
+ - 수동 승인을 지원하지 않는 PG를 이용할 때
42
+ - 수동 승인을 지원하지 않는 PG를 추후 연동할 가능성이 높을 때 (특히, 위챗 등 다양한 해외 결제수단 연동을 고려하고 있을 때)
43
+ - 결제 완료 등 결제 상태를 웹훅으로 수신하는 데 불편함이 없을 때
44
+
45
+ ## 인증 결제 수동 승인 이용 방법
46
+
47
+ 채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
48
+
49
+ 수동 승인이 켜진 채널로 `PortOne.requestPayment`를 호출하면 응답에 `paymentToken` 필드가 포함됩니다.
50
+ (수동 승인을 켜지 않은 채널이면 `paymentToken` 필드는 포함되지 않습니다.)
51
+
52
+ 이렇게 UI 호출 응답으로 받은 `paymentToken`을 이용해 서버에서 [인증 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment?v=v2#post%20%2Fpayments%2F%7BpaymentId%7D%2Fconfirm) API를 호출하면 결제가 승인됩니다. (가상계좌 발급 건의 경우 수동 승인 API 호출 시에 가상계좌가 발급됩니다.)
53
+
54
+ ## 빌링키 발급 수동 승인 이용 방법
55
+
56
+ 채널 설정에서 수동 승인을 켭니다. 수동 승인 설정은 채널별로 적용됩니다.
57
+
58
+ 수동 승인이 켜진 채널로 `PortOne.requestIssueBillingKey`나 `PortOne.requestIssueBillingKeyAndPay`를 호출하면 응답에 `billingIssueToken` 필드가 포함됩니다.
59
+ (수동 승인을 켜지 않은 채널이면 `billingIssueToken` 필드는 포함되지 않습니다.)
60
+
61
+ 이때 빌링키는 아직 발급된 상태가 아닙니다. 따라서 응답으로 전달되는 `billingKey` 값은 `NEEDS_CONFIRMATION`입니다. `requestIssueBillingKeyAndPay`를 사용한 경우에는 `txId` 값 또한 `NEEDS_CONFIRMATION`으로 전달됩니다.
62
+
63
+ 이렇게 UI 호출 응답으로 받은 `billingIssueToken`을 이용해 서버에서 포트원 API를 호출하면 빌링키가 발급됩니다. `requestIssueBillingKeyAndPay`의 경우 빌링키 발급과 함께 초회 결제도 일어납니다.
64
+
65
+ - `requestIssueBillingKey`의 경우 [빌링키 발급 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm) API를 호출합니다.
66
+ - `requestIssueBillingKeyAndPay`의 경우 [빌링키 발급 및 초회 결제 수동 승인](https://developers.portone.io/api/rest-v2/payment.billingKey?v=v2#post%20%2Fbilling-keys%2Fconfirm-issue-and-pay) API를 호출합니다.
67
+
68
+ <div class="hint" data-style="info">
69
+
70
+ **수동 승인 API 호출 시점**
71
+
72
+ 수동 승인 API는 가능한 한 즉시 호출하는 것을 권장합니다. 타임아웃 시간은 PG별로 상이하지만, 오래 대기하면 승인이 실패할 수 있습니다.
73
+
74
+ </div>
@@ -8,7 +8,7 @@ targetVersions:
8
8
  <div class="hint" data-style="warning">
9
9
 
10
10
  해당 플러그인은 현재 유지보수 되지 않으며, 신규 워드프레스 버전에서는 정상작동을 보장하지 않습니다.\
11
- 연동과 관련하여 기술지원이 필요하신 경우 <support@portone.io>로 문의바랍니다.
11
+ 연동과 관련하여 기술지원이 필요하신 경우 <tech.support@portone.io>로 문의바랍니다.
12
12
 
13
13
  </div>
14
14
 
@@ -8,7 +8,7 @@ targetVersions:
8
8
  <div class="hint" data-style="warning">
9
9
 
10
10
  해당 플러그인은 현재 유지보수 되지 않으며, 신규 워드프레스 버전에서는 정상작동을 보장하지 않습니다.\
11
- 연동과 관련하여 기술지원이 필요하신 경우 <support@portone.io>로 문의바랍니다.
11
+ 연동과 관련하여 기술지원이 필요하신 경우 <tech.support@portone.io>로 문의바랍니다.
12
12
 
13
13
  </div>
14
14
 
@@ -33,7 +33,7 @@ Woocommerce Subscriptions 플러그인
33
33
 
34
34
  다음 PG사의 경우, 정기결제 수단을 다음과 같이 선택합니다.
35
35
 
36
- - **나이스페이먼츠**: 포트원(KEY-IN결제/정기결제)
36
+ - **나이스정보통신**: 포트원(KEY-IN결제/정기결제)
37
37
  - **KG이니시스 / 다날(신용카드, 휴대폰소액결제)**: 포트원(정기결제-결제창방식)
38
38
 
39
39
  결제 수단을 포트원(정기결제-결제창방식)으로 선택한 화면입니다.
@@ -9,7 +9,7 @@ targetVersions:
9
9
  ## 프로모션이란?
10
10
 
11
11
  고객사가 카드사와 계약하여 사용자에게 즉시 할인을 제공하는 **카드 즉시 할인 서비스**를 운영하고 관리할
12
- 수 있는 서비스 입니다.
12
+ 수 있는 서비스입니다.
13
13
 
14
14
  카드 즉시 할인 서비스를 이용시 필요한 **프로모션 관리 시스템**과 **프로모션 정산 대사 시스템** 을 제공합니다.
15
15
  포트원 콘솔에서 기간, 할인 조건, 예산 등 다양한 옵션의 프로모션을 설정할 수 있으며,
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: 스마트 라우팅 - 콘솔 가이드
3
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
3
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
4
4
  targetVersions:
5
5
  - v1
6
6
  - v2
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: 스마트 라우팅 - 연동하기
3
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
3
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
4
4
  targetVersions:
5
5
  - v1
6
6
  - v2
@@ -1313,7 +1313,7 @@ if (!issueResponse.ok)
1313
1313
  사용 가능한 빌링키가 없는 경우 그룹 내 채널 비율이 0으로 설정되어있더라도 해당 결제대행사로 결제가
1314
1314
  일어날 수 있습니다.
1315
1315
 
1316
- 예를 들어, 그룹 내에 나이스페이먼츠, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
1316
+ 예를 들어, 그룹 내에 나이스정보통신, KG이니시스, 토스페이먼츠 총 3개의 결제대행사를 설정한 경우 빌링키
1317
1317
  발급 시 3개의 결제대행사로부터 빌링키를 발급 받은 후 슈퍼 빌링키에 맵핑 됩니다.
1318
1318
  이후 그룹 설정을 토스페이먼츠 0%, 스마트로 100%로 변경한 경우 위에 발급한 슈퍼 빌링키로 결제 요청 시
1319
1319
  토스페이먼츠 빌링키만 사용이 가능하기 때문에 0%로 결제 비율이 설정되어있음에도 토스페이먼츠로 결제가
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  title: 스마트 라우팅
3
- description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
3
+ description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스입니다.
4
4
  targetVersions:
5
5
  - v1
6
6
  - v2
@@ -31,8 +31,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
31
31
 
32
32
  ### 결제창(SDK) 인증결제
33
33
 
34
- - **나이스페이먼츠(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
35
- - **(구) 나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
34
+ - **나이스정보통신(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
35
+ - **(구) 나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
36
36
  - **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
37
37
  - **KG 이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
38
38
  - **토스페이먼츠(신모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
@@ -51,7 +51,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
51
51
 
52
52
  ### API 수기(키인)결제
53
53
 
54
- - **나이스페이먼츠(신모듈)** : 카드
54
+ - **나이스정보통신(신모듈)** : 카드
55
55
  - **NHN KCP** : 카드
56
56
  - **KG 이니시스** : 카드
57
57
  - **토스페이먼츠(신모듈)** : 카드
@@ -60,8 +60,8 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
60
60
 
61
61
  ### API 빌링키 발급 및 정기결제
62
62
 
63
- - **나이스페이먼츠 (신모듈)** : 카드
64
- - **(구) 나이스페이먼츠** : 카드
63
+ - **나이스정보통신 (신모듈)** : 카드
64
+ - **(구) 나이스정보통신** : 카드
65
65
  - **NHN KCP** : 카드
66
66
  - **KG이니시스** : 카드
67
67
  - **토스페이먼츠(신모듈)** : 카드
@@ -76,7 +76,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
76
76
 
77
77
  ### 결제창(SDK) 인증결제
78
78
 
79
- - **나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
79
+ - **나이스정보통신** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
80
80
  - **KG이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
81
81
  - **토스페이먼츠** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
82
82
  - **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
@@ -86,7 +86,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
86
86
 
87
87
  ### API 수기(키인)결제
88
88
 
89
- - **나이스페이먼츠** : 카드 / 가상계좌
89
+ - **나이스정보통신** : 카드 / 가상계좌
90
90
  - **KG이니시스** : 카드 / 가상계좌
91
91
  - **토스페이먼츠** : 카드 / 가상계좌
92
92
  - **한국결제네트웍스(KPN)** : 카드 / 가상계좌
@@ -96,7 +96,7 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
96
96
 
97
97
  ### API 빌링키 발급 및 정기결제
98
98
 
99
- - **나이스페이먼츠** : 카드
99
+ - **나이스정보통신** : 카드
100
100
  - **KG이니시스** : 카드
101
101
  - **토스페이먼츠** : 카드
102
102
  - **한국결제네트웍스(KPN)** : 카드
@@ -33,6 +33,7 @@ IMP.request_pay(
33
33
  buyer_tel: "010-1234-5678",
34
34
  buyer_addr: "서울특별시 강남구 삼성동",
35
35
  buyer_postcode: "123-456",
36
+ company: "고객사",
36
37
  },
37
38
  function (rsp) {
38
39
  // callback 로직
@@ -102,6 +103,10 @@ IMP.request_pay(
102
103
 
103
104
  가상계좌 결제창 호출 시 `사업자등록번호 10자리` 필수 입력 (미설정 시 다날 결제창에서 오류 발생 가능)
104
105
 
106
+ - company?: string
107
+
108
+ 휴대폰 결제시 결제창에 표시될 표시될 상호명. 입력하지 않으면 포트원 대표상점명으로 표시됩니다.
109
+
105
110
  </div>
106
111
 
107
112
  <div class="tabs-content" data-title="비인증 결제(결제창 방식)">
@@ -93,6 +93,9 @@ IMP.request_pay(
93
93
  - payco (페이코)
94
94
  - samsung (삼성페이)
95
95
  - applepay (애플페이)
96
+ - cultureland (문화상품권)
97
+ - smartculture (스마트문화상품권)
98
+ - booknlife (도서문화상품권)
96
99
 
97
100
  - merchant\_uid: string
98
101
 
@@ -126,6 +129,12 @@ IMP.request_pay(
126
129
  - `Y`: 허용
127
130
  - `N`: 차단
128
131
 
132
+ - bypass.daou.DIRECT\_YN?: string
133
+
134
+ **카드, 간편결제 다이렉트 호출 시 키움페이 페이지 노출여부**
135
+
136
+ 'Y'로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 카드사, 간편결제 결제창이 호출됩니다.
137
+
129
138
  - app\_scheme?: string
130
139
 
131
140
  **모바일 앱 URL Scheme**
@@ -212,3 +212,11 @@ GET http://api.iamport.kr/payments/{포트원 번호}?**extension=true**
212
212
  초당 50건 이상의 비인증 결제 API가 호출될 경우 오류가 발생할 수 있습니다.
213
213
 
214
214
  </details>
215
+
216
+ <details>
217
+
218
+ <summary>도서문화상품권, 스마트문화상품권 거래는 부분취소 불가능</summary>
219
+
220
+ 도서문화상품권, 스마트문화상품권 거래는 부분취소가 불가능하며 전체취소만 가능합니다.
221
+
222
+ </details>
@@ -117,20 +117,6 @@ IMP.request_pay(
117
117
  - HKD
118
118
  - CAD
119
119
  - AUD
120
- - CNY
121
- - TWD
122
- - MYR
123
- - VND
124
- - PHP
125
- - MNT
126
- - NZD
127
- - AED
128
- - MOP
129
- - BRL
130
- - KZT
131
- - NOK
132
- - SAR
133
- - TRY
134
120
 
135
121
  - language?: string
136
122
 
@@ -441,4 +441,62 @@ KG이니시스 설정이 완료되었으면 아래와 같이 파라미터 설정
441
441
 
442
442
  </div>
443
443
 
444
+ <div class="tabs-content" data-title="이니시스 에스크로 상태변경 웹훅">
445
+
446
+ 에스크로 상태 변경이 이뤄지면 고객사의 웹훅을 호출하여 통해 아래와 같은 데이터가 전송됩니다.
447
+
448
+ ```json
449
+ {
450
+ "event": "Inicis.Escrow.Changed",
451
+ "imp_uid": "imp_123412341234",
452
+ "merchant_uid": "asdfasdfasdf",
453
+ "status": "paid",
454
+ "extra": {
455
+ "escrow_status": "4",
456
+ "changed_at": 112312323,
457
+ "denied_reason": "구매 거절 사유"
458
+ }
459
+ }
460
+ ```
461
+
462
+ 웹훅 데이터 필드 설명
463
+
464
+ |필드명 |타입 |설명 |
465
+ |---------------------|------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
466
+ |`event` |string|이벤트 타입 (항상 `Inicis.Escrow.Changed`) |
467
+ |`imp_uid` |string|포트원 거래 고유번호 |
468
+ |`merchant_uid` |string|고객사 주문번호 |
469
+ |`status` |string|결제 상태 |
470
+ |`extra.escrow_status`|string|에스크로 상태구분 <br />- `2`: 배송등록<br />- `3`: 구매확인<br />- `31`: 자동구매확인<br />- `32`: 강제구매확인<br />- `4`: 구매거절<br />- `8`: 거래취소<br />- `10`: 거절확인|
471
+ |`extra.changed_at` |number|상태 변경 시각 (Unix Timestamp) |
472
+ |`extra.denied_reason`|string|구매 거절 사유 (구매거절시 전달) |
473
+
474
+ <div class="hint" data-style="warning">
475
+
476
+ 이니시스 에스크로 웹훅 기능을 사용하려면 별도 설정이 필요합니다.
477
+ <cs@portone.io>로 아래와 같이 설정 요청 메일을 보내주세요.
478
+
479
+ ```text
480
+ 제목: [에스크로 상태 변화에 따른 통보 수신 URL 설정 요청]
481
+
482
+ 안녕하세요, 포트원 담당자님
483
+
484
+ 에스크로 상태 변화에 따른 통보 수신 URL 설정 요청드립니다.
485
+
486
+ ■ 고객사 정보
487
+ - 상호명: [상호명 입력]
488
+ - 사업자번호: [사업자번호 입력]
489
+ - 이니시스 MID: [MID 입력]
490
+
491
+ ■ 이니시스 에스크로 상태변화 수신 URL
492
+ -URL : https://service.iamport.kr/inicis_payments/escrow/changed
493
+ -한글 인코딩 : UTF-8
494
+
495
+ 감사합니다.
496
+ ```
497
+
498
+ </div>
499
+
500
+ </div>
501
+
444
502
  </div>
@@ -185,10 +185,21 @@ curl -H "Content-Type: application/json" \
185
185
 
186
186
  </div>
187
187
 
188
- <div class="hint" data-style="info">
188
+ ## 유의사항
189
+
190
+ <details>
191
+
192
+ <summary> 부가세 지정 미지원</summary>
193
+
194
+ - 카카오페이 결제 시 부가세 지정은 지원하지 않습니다.
195
+ - 카카오페이 결제 취소 시 부가세 지정은 지원하지 않습니다.
196
+
197
+ </details>
189
198
 
190
199
  ## 참고사항
191
200
 
201
+ <div class="hint" data-style="info">
202
+
192
203
  - 카카오페이 결제버튼이 노출되는 것을 권장 합니다.
193
204
  - 카카오페이 고객사 사이니지 이미지를 [다운받아](http://biz.kakaopay.com/online/guide) 활용할 수 있습니다.
194
205
 
@@ -255,7 +255,8 @@ KICC는 **현금성 결제수단** (실시간 계좌이체, 가상계좌)에 한
255
255
  "code": "367",
256
256
  "quota": 3
257
257
  }
258
- }
258
+ },
259
+ "company": "고객사" //해당 파라미터를 설정하지 않으면 카드사 모듈 창에 iamport 로 표기
259
260
  }
260
261
  ```
261
262
 
@@ -263,6 +264,7 @@ KICC는 **현금성 결제수단** (실시간 계좌이체, 가상계좌)에 한
263
264
 
264
265
  - **`code`** : 카드사 금융결제원 표준 코드. [**링크**](https://developers.portone.io/opi/ko/support/code-info/card-code) 참조 (**string**)
265
266
  - **`quota`** : 할부 개월 수. 일시불일 시 0 으로 지정. (**number**)
267
+ - **`company`** : 카드사 모듈 바로 호출 시 결제창에 표시될 상호명. 입력하지 않으면 iamport로 표시됩니다.
266
268
 
267
269
  <div class="hint" data-style="danger">
268
270