@portone/mcp-server 0.15.0-alpha.4 → 0.15.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 (131) hide show
  1. package/assets/docs/blog/posts/2025-12/portone-chatbot.md +116 -0
  2. package/assets/docs/help/admin-console/analytics/content32.md +0 -32
  3. package/assets/docs/help/admin-console/console-account/content31.md +2 -10
  4. package/assets/docs/help/admin-console/console_home/content34.md +5 -44
  5. package/assets/docs/help/admin-console/integration/content28.md +9 -21
  6. package/assets/docs/help/admin-console/payment-service/content29.md +7 -153
  7. package/assets/docs/help/admin-console/pg-settlement/content30.md +0 -11
  8. package/assets/docs/help/admin-console/pg-settlement-history/content35.md +0 -7
  9. package/assets/docs/help/admin-console-2025-10-17.md +47 -0
  10. package/assets/docs/help/content61.md +1 -1
  11. package/assets/docs/help/core-service/channel-setting/danal.md +1 -1
  12. package/assets/docs/help/core-service/channel-setting/galaxia.md +93 -0
  13. package/assets/docs/help/core-service/channel-setting/inicis.md +2 -3
  14. package/assets/docs/help/core-service/channel-setting/kcp_channel.md +39 -32
  15. package/assets/docs/help/core-service/channel-setting/kicc.md +57 -3
  16. package/assets/docs/help/core-service/channel-setting/nice.md +4 -2
  17. package/assets/docs/help/core-service/how-to-use/additional-galaxia.md +36 -0
  18. package/assets/docs/help/core-service/how-to-use/galaxia-contract.md +67 -0
  19. package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +36 -46
  20. package/assets/docs/help/core-service/how-to-use/information-pg.md +2 -2
  21. package/assets/docs/help/core-service/how-to-use/kcp-contract.md +5 -1
  22. package/assets/docs/help/core-service/how-to-use/kicc-contract.md +38 -7
  23. package/assets/docs/help/core-service/how-to-use/requirements.md +3 -1
  24. package/assets/docs/help/core-service/how-to-use/shopify-guide.md +2 -2
  25. package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +5 -3
  26. package/assets/docs/help/core-service/payment-type/content200007.md +1 -1
  27. package/assets/docs/help/core-service/payment-type/content200047.md +26 -42
  28. package/assets/docs/help/core-service/payment-type/internationl-high-risk-industry.md +66 -0
  29. package/assets/docs/help/core-service/payment-type/internationl-pg.md +3 -1
  30. package/assets/docs/help/core-service/payment-type/schedule-requirement.md +1 -4
  31. package/assets/docs/help/faq/general-inquiry/portone-security.md +59 -0
  32. package/assets/docs/help/faq/payment-faq/vbank-test-guide.md +1 -8
  33. package/assets/docs/help/faq/platform-faq/platform_definition_partner.md +1 -1
  34. package/assets/docs/help/faq/platform-faq/platform_definition_settlement.md +1 -1
  35. package/assets/docs/help/faq/platform-faq/platform_definition_tax.md +24 -0
  36. package/assets/docs/help/faq/platform-faq/platform_introduction.md +1 -1
  37. package/assets/docs/help/faq/platform-faq/platform_introduction_conditions.md +19 -5
  38. package/assets/docs/help/faq/platform-faq/platform_nocode_hosting.md +1 -1
  39. package/assets/docs/help/faq/platform-faq/platform_nocode_use.md +1 -1
  40. package/assets/docs/help/faq/tax-invoice-faq/account_management_guide.md +37 -0
  41. package/assets/docs/help/faq/tax-invoice-faq/bulk_registration_account.md +16 -0
  42. package/assets/docs/help/faq/tax-invoice-faq/difference_account_partner.md +25 -0
  43. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/platform_partnerships.md +1 -1
  44. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_bulk_issuance.md +1 -1
  45. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_cancel.md +1 -1
  46. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_delayed.md +1 -1
  47. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_forward_issuance.md +1 -1
  48. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_guide_atoz.md +1 -1
  49. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_partner_peristalsis.md +1 -1
  50. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_reverse_issuance_definition.md +1 -1
  51. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_reverse_issuance_partner_signup.md +1 -1
  52. package/assets/docs/help/notice-tosspayments-2026-01-15.md +62 -0
  53. package/assets/docs/help/notice-vape-2026-02-19.md +52 -0
  54. package/assets/docs/help/platform-2025-07-23.md +76 -0
  55. package/assets/docs/help/platform-2025-08-13.md +92 -0
  56. package/assets/docs/help/platform-2025-08-21.md +51 -0
  57. package/assets/docs/help/platform-2025-08-28.md +51 -0
  58. package/assets/docs/help/platform-2025-10-02.md +90 -0
  59. package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +4 -2
  60. package/assets/docs/help/pricing/portone/portone-pricing.md +1 -1
  61. package/assets/docs/help/procedure/pg-application/start.md +6 -24
  62. package/assets/docs/help/procedure/service-addition/add-service.md +2 -0
  63. package/assets/docs/help/service/identity-verification/identity-verification.md +2 -4
  64. package/assets/docs/help/service/integration-type/integration-type.md +1 -2
  65. package/assets/docs/help/service/pg/pg-service-list.md +22 -1
  66. package/assets/docs/opi/ko/console/guide/reg.md +1 -1
  67. package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md +5 -7
  68. package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md +2 -2
  69. package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md +1 -1
  70. package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md +1 -1
  71. package/assets/docs/opi/ko/integration/cancel/v1/virtual-account.md +4 -1
  72. package/assets/docs/opi/ko/integration/cancel/v2/readme.md +4 -1
  73. package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +131 -6
  74. package/assets/docs/opi/ko/integration/pg/v1/galaxia.md +579 -0
  75. package/assets/docs/opi/ko/integration/pg/v1/inicis-jp.md +490 -0
  76. package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +17 -0
  77. package/assets/docs/opi/ko/integration/pg/v1/kcp-v2-identity-verification.md +2 -0
  78. package/assets/docs/opi/ko/integration/pg/v1/kg-mobilians-v2.md +11 -0
  79. package/assets/docs/opi/ko/integration/pg/v1/kicc-v2.md +275 -0
  80. package/assets/docs/opi/ko/integration/pg/v1/kicc.md +2 -2
  81. package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +8 -0
  82. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +3 -0
  83. package/assets/docs/opi/ko/integration/pg/v1/nice.md +2 -2
  84. package/assets/docs/opi/ko/integration/pg/v1/paypal.md +1 -1
  85. package/assets/docs/opi/ko/integration/pg/v1/readme.md +8 -2
  86. package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +0 -2
  87. package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +8 -0
  88. package/assets/docs/opi/ko/integration/pg/v2/galaxia.md +662 -0
  89. package/assets/docs/opi/ko/integration/pg/v2/inicis-jp.md +3 -3
  90. package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md +0 -4
  91. package/assets/docs/opi/ko/integration/pg/v2/inicis-v2.md +2 -2
  92. package/assets/docs/opi/ko/integration/pg/v2/kcp-v2-identity-verification.md +1 -1
  93. package/assets/docs/opi/ko/integration/pg/v2/kcp-v2.md +2 -2
  94. package/assets/docs/opi/ko/integration/pg/v2/kicc-v2.md +316 -0
  95. package/assets/docs/opi/ko/integration/pg/v2/kpn.md +3 -3
  96. package/assets/docs/opi/ko/integration/pg/v2/ksnet.md +8 -0
  97. package/assets/docs/opi/ko/integration/pg/v2/paymentwall.md +171 -0
  98. package/assets/docs/opi/ko/integration/pg/v2/readme.md +16 -0
  99. package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
  100. package/assets/docs/opi/ko/integration/pg/v2/triple-a.md +341 -0
  101. package/assets/docs/opi/ko/integration/pg/v2/welcome.md +1 -1
  102. package/assets/docs/opi/ko/integration/ready/readme.md +105 -124
  103. package/assets/docs/opi/ko/integration/start/v2/checkout.md +59 -29
  104. package/assets/docs/opi/ko/integration/using-ai-tools.md +42 -0
  105. package/assets/docs/opi/ko/quick-guide/payment.md +5 -5
  106. package/assets/docs/opi/ko/support/code-info/pg-2.md +1 -1
  107. package/assets/docs/platform/ko/guides/dictionary.md +47 -0
  108. package/assets/docs/release-notes/platform/2023-08-31.md +2 -2
  109. package/assets/docs/release-notes/platform/2024-08-22.md +5 -5
  110. package/assets/docs/release-notes/platform/2024-10-21.md +9 -9
  111. package/assets/docs/release-notes/platform/2025-02-10.md +2 -2
  112. package/assets/docs/release-notes/platform/2026-02-19.md +55 -0
  113. package/assets/docs/release-notes/platform/2026-03-06.md +198 -0
  114. package/assets/docs/schema/browser-sdk.yml +390 -11
  115. package/assets/docs/schema/v1.openapi.json +58 -69
  116. package/assets/docs/schema/v1.openapi.yml +54 -100
  117. package/assets/docs/schema/v2.openapi.json +14855 -20616
  118. package/assets/docs/schema/v2.openapi.yml +7700 -11883
  119. package/assets/docs/sdk/ko/v2-mobile-sdk/android.md +62 -24
  120. package/assets/docs/sdk/ko/v2-mobile-sdk/react-native.md +82 -95
  121. package/assets/docs/sdk/ko/v2-mobile-sdk/readme.md +5 -4
  122. package/assets/docs/v1-docs-full.md +2162 -170
  123. package/assets/docs/v2-docs-full.md +2222 -204
  124. package/assets/docs/website-links.md +15 -5
  125. package/manifest.json +1 -1
  126. package/package.json +12 -12
  127. package/server/index.js +42 -15
  128. package/assets/docs/opi/ko/integration/pg/v1/hyphen.md +0 -196
  129. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +0 -1152
  130. package/assets/docs/opi/ko/integration/pg/v2/hyphen.md +0 -205
  131. package/assets/docs/schema/browser-sdk.schema.json +0 -510
@@ -56,7 +56,7 @@
56
56
  - [결제 연동 하기](https://developers.portone.io/opi/ko/console/guide/connect)
57
57
  - [결제 내역](https://developers.portone.io/opi/ko/console/guide/list): 결제가 이루어진 거래내역을 조회할 수 있는 메뉴입니다.
58
58
  - [복수 PG설정 및 사용하기](https://developers.portone.io/opi/ko/console/pg): 복수 PG를 사용하는 경우 설정방법을 확인할 수 있습니다.
59
- - [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v1): 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스입니다.
59
+ - [컨펌 프로세스](https://developers.portone.io/opi/ko/extra/confirm-process/readme-v1): 결제 승인 직전에 고객사 측에 결제 의사를 최종적으로 확인하는 기능입니다.
60
60
  - [통합인증 준비하기](https://developers.portone.io/opi/ko/extra/identity-verification/v1/all/0): 통합인증 연동을 시작하기 위한 준비작업을 소개합니다.
61
61
  - [통합인증 요청하기](https://developers.portone.io/opi/ko/extra/identity-verification/v1/all/1): 통합인증 페이지를 호출하는 방법을 확인합니다.
62
62
  - [인증 완료정보 전달하기](https://developers.portone.io/opi/ko/extra/identity-verification/v1/all/2): 통합인증 이후 획득된 정보를 처리하는 방법을 안내합니다.
@@ -96,12 +96,15 @@
96
96
  - [키움페이 (다우데이타/페이조아)](https://developers.portone.io/opi/ko/integration/pg/v1/daou/readme): 키움페이 연동 방법을 안내합니다.
97
97
  - [키움페이 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/daou/undefined): 결제 연동시 유의사항을 안내합니다.
98
98
  - [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v1/eximbay): 엑심베이 결제 연동 방법을 안내합니다.
99
+ - [갤럭시아머니트리](https://developers.portone.io/opi/ko/integration/pg/v1/galaxia): 갤럭시아머니트리 연동 방법을 안내합니다.
100
+ - [KG이니시스 일본결제](https://developers.portone.io/opi/ko/integration/pg/v1/inicis-jp): KG이니시스 일본결제 연동 방법을 안내합니다.
99
101
  - [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis): KG이니시스 결제창 연동 가이드입니다.
100
102
  - [카카오페이](https://developers.portone.io/opi/ko/integration/pg/v1/kakaopay): 카카오페이 연동 방법을 안내합니다.
101
103
  - [NHN KCP(신모듈) 본인인증 연동하기](https://developers.portone.io/opi/ko/integration/pg/v1/kcp-v2-identity-verification): NHN KCP(신모듈) 본인인증 연동 방법을 안내합니다.
102
104
  - [KG모빌리언스 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg-mobilians-v2): KG모빌리언스 (신모듈) 결제 연동 방법을 안내합니다.
103
105
  - [KG모빌리언스 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kg): KG모빌리언스 (구모듈) 결제 연동 방법을 안내합니다.
104
- - [이지페이(KICC)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc): 이지페이(KICC) 결제창 연동 방법을 안내합니다.
106
+ - [이지페이(KICC) 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/kicc-v2): 이지페이(KICC) 해외결제 결제 연동 방법을 안내합니다.
107
+ - [이지페이(KICC) (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc): 이지페이(KICC) (구모듈) 결제창 연동 방법을 안내합니다.
105
108
  - [KSNET](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/readme): KSNET 결제창 연동 가이드입니다.
106
109
  - [연동 주의사항](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/warning): KSNET 연동 시 주의사항을 확인할 수 있습니다.
107
110
  - [네이버페이(결제형)](https://developers.portone.io/opi/ko/integration/pg/v1/naver): 네이버페이 결제형 연동 방법을 안내합니다.
@@ -112,7 +115,7 @@
112
115
  - [빌링키 발급 / API 연동 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/billing-api-caution): (신)나이스정보통신 비인증 결제 연동 유의사항을 소개합니다.
113
116
  - [일반결제 연동 유의사항](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/payment-caution): 나이스정보통신(신모듈) 일반결제 연동 유의사항을 소개합니다.
114
117
  - [나이스정보통신 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme): 나이스정보통신 연동 방법을 안내합니다.
115
- - [() 나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v1/nice): () 나이스정보통신 결제창 연동 가이드를 안내합니다.
118
+ - [나이스정보통신 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice): 나이스정보통신 (구모듈) 결제창 연동 가이드를 안내합니다.
116
119
  - [페이코](https://developers.portone.io/opi/ko/integration/pg/v1/payco): 페이코 결제 연동방법을 안내합니다.
117
120
  - [페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global): 페이레터 해외결제 연동 방법을 안내합니다.
118
121
  - [페이먼트월](https://developers.portone.io/opi/ko/integration/pg/v1/paymentwall): 페이먼트월 결제창 연동가이드를 확인 합니다.
@@ -278,6 +281,8 @@
278
281
  - [파트너 정산 자동화 2025-08-21](https://developers.portone.io/release-notes/platform/2025-08-21)
279
282
  - [파트너 정산 자동화 2025-08-28](https://developers.portone.io/release-notes/platform/2025-08-28)
280
283
  - [파트너 정산 자동화 2025-10-02](https://developers.portone.io/release-notes/platform/2025-10-02)
284
+ - [파트너 정산 자동화 2026-02-19](https://developers.portone.io/release-notes/platform/2026-02-19)
285
+ - [파트너 정산 자동화 2026-03-06](https://developers.portone.io/release-notes/platform/2026-03-06)
281
286
 
282
287
  ### 블로그
283
288
 
@@ -288,6 +293,7 @@
288
293
  - [Data Evolution: The Shift from AWS DMS to GCP Datastream](https://developers.portone.io/blog/posts/2024-04/gcp-datastream): Gives an overview of the PortOne Data Infrastructure and the migration story from AWS DMS to GCP Datastream.
289
294
  - [Solid로 간결하게 고성능 웹앱 만들기](https://developers.portone.io/blog/posts/2024-04/solid): 포트원에서 사용하는 프론트엔드 웹 프레임워크 중 하나인 Solid에 대해 소개하고, 포트원 내에서의 활용 사례를 다룹니다.
290
295
  - [포트원 V2 이야기 - Event Sourcing으로 결제 시스템 만들기 (기본편)](https://developers.portone.io/blog/posts/2024-07/v2-event-sourcing-basic): 포트원 V2 시스템의 근간을 이루고 있는 기술 중 하나인 Event Sourcing에 대해 소개합니다.
296
+ - [포트원 AI 챗봇이 반복되는 기술 문의를 획기적으로 단축한 비결](https://developers.portone.io/blog/posts/2025-12/portone-chatbot): 잘 만든 AI 서비스 하나로 1000개의 기술 문의를 대신한 이야기
291
297
 
292
298
 
293
299
  # https://developers.portone.io/opi/ko/console/guide/api-keys
@@ -703,16 +709,14 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
703
709
 
704
710
  ---
705
711
  title: 컨펌 프로세스
706
- description: 결제요청의 주체를 고객사 서버로 가져갈수 있는 서비스입니다.
712
+ description: 결제 승인 직전에 고객사 측에 결제 의사를 최종적으로 확인하는 기능입니다.
707
713
  targetVersions:
708
714
  - v1
709
715
  versionVariants:
710
716
  v2: /opi/ko/extra/confirm-process/readme-v2
711
717
  ---
712
718
 
713
- ## 해당 서비스는 결제요청직전에 고객사 측에 결제의사를 최종적으로 확인하는 서비스입니다.
714
-
715
- ![](</gitbook-assets/ko/image (259).png>)
719
+ 결제 승인 직전에 고객사 측에 결제 의사를 최종적으로 확인하는 기능입니다.
716
720
 
717
721
  (이미지 첨부: 컨펌 프로세스)
718
722
 
@@ -720,9 +724,9 @@ versionVariants:
720
724
 
721
725
  **해당 서비스가 반드시 필요한 고객사는 아래와 같은 경우입니다.**
722
726
 
723
- - 판매 제품이 재고적으로 소량인 경우
724
- - 선착순방식으로 결제가 진행되는 경우
725
- - 결제 요청전 마지막으로 고객사에서 처리하고 싶은 업무처리가 있는 경우
727
+ - 판매 제품의 재고가 소량으로 재고파악이 필요한 경우 (한정된 상품 또는 고가 제품 판매시)
728
+ - 선착순 방식으로 결제가 진행되어야 하는 경우
729
+ - 결제 승인 마지막으로 고객사에서 처리하고 싶은 로직이 존재하는 경우
726
730
 
727
731
  </div>
728
732
 
@@ -3168,6 +3172,9 @@ versionVariants:
3168
3172
 
3169
3173
  PG사는 이런 과정에서 발생할 수 있는 혼란을 미연에 방지하고자 **가상계좌 특약서비스에 가입한 고객사에 한해서만 가상계좌 환불을 제공**하고 있습니다.
3170
3174
 
3175
+ 단, **토스페이먼츠**의 경우 별도의 특약 가입 없이도 가상계좌 환불이 가능합니다.
3176
+ 이 경우 환불 시 기존 거래에서 발생한 수수료는 환불되지 않습니다.
3177
+
3171
3178
  </div>
3172
3179
 
3173
3180
  가상계좌의 경우 단방향 결제수단이여서 환불 대상을 알 수 없으므로 환불 금액 외에 다음의 환불 수령계좌 정보를 입력해야 합니다.
@@ -3180,7 +3187,7 @@ PG사는 이런 과정에서 발생할 수 있는 혼란을 미연에 방지하
3180
3187
 
3181
3188
  **가상계좌 은행코드는 PG사에 따라 다릅니다**
3182
3189
 
3183
- `은행코드는`같은 은행이더라도 PG사에 따라 상이하므로 \*\*은행코드(TODO)\*\*표에서 은행코드를 확인해 주세요
3190
+ 은행코드는 같은 은행이더라도 PG사에 따라 상이하므로 [은행코드표](https://developers.portone.io/opi/ko/support/code-info/pg-1?v=v1)에서 은행코드를 확인해 주세요.
3184
3191
 
3185
3192
  </div>
3186
3193
 
@@ -3874,12 +3881,6 @@ targetVersions:
3874
3881
 
3875
3882
  [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk-old/readme) `IMP.request_pay(param, callback)`을 호출하여 키움페이 결제창을 호출할 수 있습니다. **결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후 **callback**으로 수신되고 모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
3876
3883
 
3877
- <div class="hint" data-style="warning">
3878
-
3879
- **키움페이 결제창 연동을 위해서는 ****JS SDK Version 1.2.0**** 이상을 사용하셔야 합니다.**
3880
-
3881
- </div>
3882
-
3883
3884
  <div class="tabs-container">
3884
3885
 
3885
3886
  <div class="tabs-content" data-title="인증결제창 요청">
@@ -3955,6 +3956,7 @@ IMP.request_pay(
3955
3956
  - cultureland (컬쳐랜드 문화상품권)
3956
3957
  - smartculture (스마트문화상품권)
3957
3958
  - booknlife (도서문화상품권)
3959
+ - phone (휴대폰결제)
3958
3960
 
3959
3961
  - merchant\_uid: string
3960
3962
 
@@ -3994,6 +3996,43 @@ IMP.request_pay(
3994
3996
 
3995
3997
  'Y'로 입력하는 경우 키움페이 화면이 노출되지 않고 바로 카드사, 간편결제 결제창이 호출됩니다.
3996
3998
 
3999
+ - bypass.daou.CARDQUOTA?: string
4000
+
4001
+ **카드사별 할부개월 수 설정**
4002
+
4003
+ ^ 로 구분된 다수의 카드 할부 설정 그룹으로 구성되며, 각 그룹은 `{키움페이_카드사_코드}-{할부_개월수_옵션1}:{할부_개월수_옵션2}:...` 형식으로 구성하여 카드사별 할부 개월 수를 지정합니다.
4004
+
4005
+ 예시로 `CCBC-0:2:3:4:5:6^CCNH-0:2:3^CCKM-0:2:3:4` 를 입력하는 경우 BC카드는 일시불, 2, 3, 4, 5, 6개월, 농협카드는 일시불, 2, 3개월, 국민카드는 일시불, 2, 3, 4개월 할부가 선택 가능하도록 표시됩니다.
4006
+
4007
+ 카드사 코드
4008
+
4009
+ |카드사 명 |코드|
4010
+ |------------|----|
4011
+ |비씨카드 |CCBC|
4012
+ |국민카드 |CCKM|
4013
+ |제주은행 |CCCJ|
4014
+ |신한카드 |CCLG|
4015
+ |씨티은행 |CCCT|
4016
+ |롯데카드 |CCLO|
4017
+ |신협카드 |CCCU|
4018
+ |새마을금고 |CCMG|
4019
+ |현대카드 |CCDI|
4020
+ |NH카드 |CCNH|
4021
+ |현대증권 |CCHD|
4022
+ |우리카드 |CCPH|
4023
+ |하나SK카드 |CCHN|
4024
+ |우체국카드 |CCPO|
4025
+ |전북은행 |CCJB|
4026
+ |저축은행카드|CCSB|
4027
+ |카카오뱅크 |CCKA|
4028
+ |삼성카드 |CCSS|
4029
+ |산은카드 |CCKD|
4030
+ |수협 |CCSU|
4031
+ |하나은행 |CCKE|
4032
+ |토스뱅크 |CCTS|
4033
+ |광주은행 |CCKJ|
4034
+ |K뱅크 |CKBK|
4035
+
3997
4036
  - app\_scheme?: string
3998
4037
 
3999
4038
  **모바일 앱 URL Scheme**
@@ -4170,6 +4209,99 @@ curl -H "Content-Type: application/json" \
4170
4209
 
4171
4210
  </div>
4172
4211
 
4212
+ <div class="tabs-content" data-title="통신사 노출 제어">
4213
+
4214
+ ```json title="모든 통신사 노출"
4215
+ {
4216
+ "phone": {
4217
+ "detail": [
4218
+ {
4219
+ "carrier": "*", // 모두 활성화
4220
+ "enabled": true
4221
+ }
4222
+ ]
4223
+ }
4224
+ }
4225
+ ```
4226
+
4227
+ ```json title="특정 통신사만 노출"
4228
+ {
4229
+ "phone": {
4230
+ "detail": [
4231
+ {
4232
+ "carrier": "SKT", // SKT만 활성화
4233
+ "enabled": true
4234
+ }
4235
+ ]
4236
+ }
4237
+ }
4238
+ ```
4239
+
4240
+ ```json title="2개 이상 통신사 노출"
4241
+ {
4242
+ "phone": {
4243
+ "detail": [
4244
+ {
4245
+ "carrier": "SKT",
4246
+ "enabled": true
4247
+ },
4248
+ {
4249
+ "carrier": "KTF",
4250
+ "enabled": true
4251
+ },
4252
+ {
4253
+ "carrier": "LGT",
4254
+ "enabled": false
4255
+ },
4256
+ {
4257
+ "carrier": "CJH",
4258
+ "enabled": false
4259
+ }
4260
+ ]
4261
+ }
4262
+ }
4263
+ // SKT, KTF 을 제외한 나머지 통신사는 비활성화 됩니다.
4264
+ ```
4265
+
4266
+ ```json title="특정 통신사만 비노출"
4267
+ {
4268
+ "phone": {
4269
+ "detail": [
4270
+ {
4271
+ "carrier": "SKT",
4272
+ "enabled": false
4273
+ }
4274
+ ]
4275
+ }
4276
+ }
4277
+ ```
4278
+
4279
+ <div class="hint" data-style="info">
4280
+
4281
+ `phone 파라미터 미 설정시`(기본값) 모든 통신사 노출됨
4282
+
4283
+ </div>
4284
+
4285
+ </div>
4286
+
4287
+ <div class="tabs-content" data-title="휴대폰 번호 고정">
4288
+
4289
+ ```json
4290
+ {
4291
+ "prefill": {
4292
+ "phoneNumber": "휴대폰번호" // 휴대폰번호 입력(하이픈 제거)
4293
+ }
4294
+ }
4295
+ ```
4296
+
4297
+ <div class="hint" data-style="info">
4298
+
4299
+ 휴대폰 결제시 해당 파라미터를 설정하면 휴대폰번호를 고정시킬수 있습니다.
4300
+
4301
+ </div>
4302
+
4303
+ </div>
4304
+
4173
4305
  </div>
4174
4306
 
4175
4307
 
@@ -4631,6 +4763,1083 @@ IMP.request_pay({
4631
4763
  </div>
4632
4764
 
4633
4765
 
4766
+ # https://developers.portone.io/opi/ko/integration/pg/v1/galaxia
4767
+
4768
+ ---
4769
+ title: 갤럭시아머니트리
4770
+ description: 갤럭시아머니트리 연동 방법을 안내합니다.
4771
+ targetVersions:
4772
+ - v1
4773
+ ---
4774
+
4775
+ ## 1. 갤럭시아머니트리 채널 설정하기
4776
+
4777
+ [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
4778
+
4779
+ ## 2. 최신 JavaScript SDK로 업데이트하기 <a href="#2." id="2." />
4780
+
4781
+ 갤럭시아머니트리 결제는 최신 SDK에서만 지원되는 기능입니다.
4782
+
4783
+ ```html title="JS SDK"
4784
+ <script src="https://cdn.iamport.kr/v1/iamport.js"></script>
4785
+ ```
4786
+
4787
+ <div class="hint" data-style="info">
4788
+
4789
+ **갤럭시아머니트리를 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다**
4790
+
4791
+ </div>
4792
+
4793
+ [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) 문서를 통해 최신 SDK를 설치해주세요.
4794
+
4795
+ ## 3. 결제 요청하기
4796
+
4797
+ [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
4798
+ 갤럭시아머니트리 결제/빌링키 발급/빌링키 발급과 동시에 결제창을 호출할 수 있습니다. **트랜잭션 결과**는
4799
+ PC의 경우 **callback** 함수로 전달되고
4800
+ 모바일의 경우 **m\_redirect\_url**로 302 리디렉션됩니다.
4801
+
4802
+ <div class="tabs-container">
4803
+
4804
+ <div class="tabs-content" data-title="일반 결제 창 요청">
4805
+
4806
+ ```ts title="Javascript SDK"
4807
+ IMP.request_pay(
4808
+ {
4809
+ channelKey: "{콘솔 내 연동 정보의 채널키}",
4810
+ pay_method: "card",
4811
+ merchant_uid: "orderNo0001", // 고객사에서 채번한 주문 고유 번호입니다.
4812
+ name: "주문명:결제테스트",
4813
+ amount: 1000,
4814
+ customer_id: "matthew", // 고객사가 회원에게 부여한 고유 ID입니다. (필수)
4815
+ m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
4816
+ bypass: {
4817
+ galaxia: {
4818
+ ITEM_CODE: "상품코드", // 필수, 최대 10바이트
4819
+ },
4820
+ },
4821
+ },
4822
+ function (rsp) {
4823
+ // callback 로직
4824
+ const { imp_uid, merchant_uid } = rsp;
4825
+
4826
+ // 콜백 함수로 전달 받은 imp_uid로 포트원 결제 내역 조회 API를 통해 결제 상태를 판단합니다.
4827
+ },
4828
+ );
4829
+ ```
4830
+
4831
+ ### 주요 파라미터 설명
4832
+
4833
+ - channelKey: string
4834
+
4835
+ **채널키**
4836
+
4837
+ 결제를 진행할 채널을 지정합니다.
4838
+
4839
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
4840
+
4841
+ (최신 JavaScript SDK 버전부터 사용 가능합니다.)
4842
+
4843
+ - pg(deprecated)?: string
4844
+
4845
+ **PG사 구분코드**
4846
+
4847
+ <div class="hint" data-style="warning">
4848
+
4849
+ `pg` 파라미터는 지원 중단 예정입니다.
4850
+
4851
+ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
4852
+
4853
+ </div>
4854
+
4855
+ - pay\_method?: string
4856
+
4857
+ **결제수단 구분코드**
4858
+
4859
+ <details>
4860
+
4861
+ <summary>결제수단 구분코드</summary>
4862
+
4863
+ - `card` (신용카드) - 기본값
4864
+ - `trans` (실시간 계좌이체)
4865
+ - `vbank` (가상계좌)
4866
+ - `phone` (휴대폰소액결제)
4867
+ - `cultureland` (컬쳐랜드)
4868
+ - `smartculture` (스마트문상)
4869
+ - `booknlife` (도서문화상품권)
4870
+ - `happymoney` (해피머니)
4871
+ - `kakaopay` (카카오페이)
4872
+ - `naverpay` (네이버페이)
4873
+ - `tosspay` (토스페이)
4874
+ - `samsungpay` (삼성페이)
4875
+ - `applepay` (애플페이)
4876
+ - `payco` (페이코)
4877
+
4878
+ </details>
4879
+
4880
+ - merchant\_uid: string
4881
+
4882
+ **주문 번호**
4883
+
4884
+ 매번 고유하게 채번되어야 합니다. (최대 64자)
4885
+
4886
+ - customer\_id: string
4887
+
4888
+ **구매자 고유 ID**
4889
+
4890
+ 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. (최대 20자)
4891
+
4892
+ 갤럭시아머니트리의 경우 필수로 입력해야 합니다.
4893
+
4894
+ - name: string
4895
+
4896
+ **주문명**
4897
+
4898
+ 갤럭시아머니트리의 경우 필수로 입력해야 합니다.
4899
+
4900
+ - amount: number
4901
+
4902
+ **결제 금액**
4903
+
4904
+ **string** 이 아닌 점에 유의하세요.
4905
+
4906
+ - tax\_free?: number
4907
+
4908
+ **면세 금액** (기본값: 0)
4909
+
4910
+ - vat\_amount?: number
4911
+
4912
+ **부가세 금액**
4913
+
4914
+ 미 입력시 과세 금액의 1/11로 자동 계산됩니다.
4915
+
4916
+ - buyer\_name?: string
4917
+
4918
+ **구매자 이름**
4919
+
4920
+ 계좌이체 결제시 구매자 이름은 필수 입력입니다.
4921
+
4922
+ - buyer\_tel?: string
4923
+
4924
+ **구매자 연락처**
4925
+
4926
+ - buyer\_email?: string
4927
+
4928
+ **구매자 이메일 주소**
4929
+
4930
+ - m\_redirect\_url?: string
4931
+
4932
+ **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL**
4933
+
4934
+ 주의: 갤럭시아머니트리의 경우 **모바일 환경에서 필수 입력**입니다.
4935
+
4936
+ - notice\_url?: string 또는 **string\[]**
4937
+
4938
+ **트랜잭션 종료 후 웹훅이 발송 될 고객사 서버 URL**
4939
+
4940
+ 주의: notice\_url 파라미터 설정시, 콘솔에 설정 된 웹훅 URL은 override 되며 notice\_url에 전달 한 주소로만 웹훅이 발송됩니다.
4941
+
4942
+ - app\_scheme?: string
4943
+
4944
+ **IOS 앱에서 결제시 카드/은행 앱에서 인증 후 복귀 될 고객사 커스텀 앱 URL Scheme**
4945
+
4946
+ - 예: portone://
4947
+ - 주의: **IOS 앱 결제시 필수** 입력이며 **앱이 아닌 모바일 웹 결제시에는 입력하지 마세요.**
4948
+
4949
+ - currency?: 'KRW'
4950
+
4951
+ **결제 통화**
4952
+
4953
+ 갤럭시아머니트리의 경우 KRW만 허용되며, 미 입력시 KRW로 자동 적용됩니다.
4954
+
4955
+ - escrow?: boolean
4956
+
4957
+ **에스크로 결제 여부** (기본값: false)
4958
+
4959
+ 갤럭시아머니트리의 경우, 계좌이체/가상계좌 결제시 에스크로 결제가 허용됩니다.
4960
+
4961
+ - vbank\_due: string
4962
+
4963
+ **가상계좌 입금기한**
4964
+
4965
+ - YYYY-MM-DD
4966
+ - YYYYMMDD
4967
+
4968
+ 주의: 갤럭시아머니트리의 경우 가상계좌 결제시 **필수 입력**입니다.
4969
+
4970
+ - display?: object
4971
+
4972
+ **결제창에 렌더링될 카드 할부 개월수 리스트 설정값**
4973
+
4974
+ - card\_quota?: number\[]
4975
+
4976
+ **할부 개월수**
4977
+
4978
+ 예시
4979
+
4980
+ - `[]`: 일시불만 결제 가능
4981
+ - `2,3,4,5,6`: 일시불을 포함한 2, 3, 4, 5, 6개월까지 할부개월 선택 가능
4982
+ - `3`: 3개월 할부만 표시
4983
+
4984
+ - card?: object
4985
+
4986
+ **카드 결제 관련 설정**
4987
+
4988
+ - direct?: object
4989
+
4990
+ **카드사 다이렉트 호출 설정**
4991
+
4992
+ - code?: string
4993
+
4994
+ **카드사 금융결제원 표준 코드**
4995
+
4996
+ [카드사 코드](https://developers.portone.io/opi/ko/support/code-info/card-code) 참조
4997
+
4998
+ - quota?: number
4999
+
5000
+ **할부 개월 수**
5001
+
5002
+ 일시불일 시 0으로 설정합니다.
5003
+
5004
+ - phone?: object
5005
+
5006
+ **휴대폰 결제 관련 설정**
5007
+
5008
+ - carrier?: string
5009
+
5010
+ **휴대폰 통신사 코드**
5011
+
5012
+ `SKT`, `KTF`, `LGT`, `CJH`, `KCT`, `SKL`
5013
+
5014
+ - bypass: object
5015
+
5016
+ - galaxia: object
5017
+
5018
+ - ITEM\_CODE: string
5019
+
5020
+ **구매 상품코드**
5021
+
5022
+ 갤럭시아머니트리에서 발급받은 상품 코드를 입력합니다. (최대 10자, 필수)
5023
+
5024
+ <details>
5025
+
5026
+ <summary>
5027
+
5028
+ <strong>갤럭시아머니트리 지원 결제 수단</strong>
5029
+
5030
+ </summary>
5031
+
5032
+ - card (신용카드)
5033
+ - trans (실시간 계좌이체) + 에스크로
5034
+ - vbank (가상계좌) + 에스크로
5035
+ - phone (휴대폰소액결제)
5036
+ - cultureland (컬쳐랜드)
5037
+ - smartculture (스마트문상)
5038
+ - booknlife (도서문화상품권)
5039
+ - happymoney (해피머니)
5040
+ - kakaopay (카카오페이)
5041
+ - naverpay (네이버페이)
5042
+ - tosspay (토스페이)
5043
+ - samsungpay (삼성페이)
5044
+ - applepay (애플페이)
5045
+ - payco (페이코)
5046
+ - moneytree (머니트리)
5047
+
5048
+ </details>
5049
+
5050
+ </div>
5051
+
5052
+ <div class="tabs-content" data-title="빌링키 발급 창 요청">
5053
+
5054
+ 일반 결제 창 호출 파라미터에서 **customer\_uid** 값을 추가하면 빌링키 발급 창을 호출할 수 있습니다.
5055
+ 빌링키 발급 창에서 빌링키를 발급 받은 후, 빌링 결제 API를 호출해 해당 빌링키로 결제를 할 수 있습니다.
5056
+
5057
+ ```ts title="Javascript SDK"
5058
+ IMP.request_pay(
5059
+ {
5060
+ channelKey: "{콘솔 내 연동 정보의 채널키}",
5061
+ pay_method: "card", // 빌링키 발급 수단입니다. 갤럭시아머니트리의 경우 'card'만 지원됩니다.
5062
+ merchant_uid: "orderMonthly0001", // 고객사에서 채번한 주문 고유 번호입니다.
5063
+ name: "빌링키 발급",
5064
+ amount: 1000,
5065
+ customer_id: "matthew", // 고객사가 회원에게 부여한 고유 ID입니다. (필수)
5066
+ customer_uid: "your-customer-unique-id", // 고객사가 구매자의 결제 수단을 특정하기 위해 채번한 고유 ID로 빌링키 발급시 필수 입력입니다.
5067
+ m_redirect_url: "{모바일에서 빌링키 발급 완료 후 리디렉션 될 URL}",
5068
+ bypass: {
5069
+ galaxia: {
5070
+ ITEM_CODE: "상품코드", // 필수, 최대 10바이트
5071
+ },
5072
+ },
5073
+ },
5074
+ function (rsp) {
5075
+ // callback 로직
5076
+ const { imp_uid, merchant_uid } = rsp;
5077
+
5078
+ // 콜백 함수로 전달 받은 imp_uid로 포트원 결제 내역 조회 API를 통해 빌링키 발급 상태를 판단합니다.
5079
+ },
5080
+ );
5081
+ ```
5082
+
5083
+ ### 주요 파라미터 설명
5084
+
5085
+ - channelKey: string
5086
+
5087
+ **채널키**
5088
+
5089
+ 결제를 진행할 채널을 지정합니다.
5090
+
5091
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
5092
+
5093
+ (최신 JavaScript SDK 버전부터 사용 가능합니다.)
5094
+
5095
+ - pg(deprecated)?: string
5096
+
5097
+ **PG사 구분코드**
5098
+
5099
+ <div class="hint" data-style="warning">
5100
+
5101
+ `pg` 파라미터는 지원 중단 예정입니다.
5102
+
5103
+ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
5104
+
5105
+ </div>
5106
+
5107
+ - pay\_method: 'card'
5108
+
5109
+ **빌링키 발급 수단**
5110
+
5111
+ 갤럭시아머니트리의 경우, 빌링키 발급 수단은 `card`만 허용되며 **반드시 `card`를 필수로 입력해주셔야** 합니다.
5112
+
5113
+ - merchant\_uid: string
5114
+
5115
+ **주문 번호**
5116
+
5117
+ 매번 고유하게 채번되어야 합니다.
5118
+
5119
+ - customer\_id: string
5120
+
5121
+ **구매자 고유 ID**
5122
+
5123
+ 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다.
5124
+
5125
+ - customer\_uid: string
5126
+
5127
+ **빌링키 발급 수단 고유 ID**
5128
+
5129
+ 고객사가 구매자의 빌링키 발급 수단을 특정하기 위해 채번한 고유 번호로 빌링키 발급시 필수 입력입니다.
5130
+
5131
+ - name: string
5132
+
5133
+ **주문명**
5134
+
5135
+ 갤럭시아머니트리의 경우 필수로 입력해야 합니다.
5136
+
5137
+ - amount: number
5138
+
5139
+ **결제 금액**
5140
+
5141
+ **string** 이 아닌 점에 유의하세요.
5142
+
5143
+ 빌링키 발급시 amount가 0이거나 미입력시 1000원으로 노출됩니다. (결제 발생하지 않음)
5144
+
5145
+ - buyer\_name?: string
5146
+
5147
+ **구매자 이름**
5148
+
5149
+ - buyer\_tel?: string
5150
+
5151
+ **구매자 연락처**
5152
+
5153
+ - buyer\_email?: string
5154
+
5155
+ **구매자 이메일 주소**
5156
+
5157
+ - m\_redirect\_url?: string
5158
+
5159
+ **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL**
5160
+
5161
+ 주의: 갤럭시아머니트리의 경우 **모바일 환경에서 필수 입력**입니다.
5162
+
5163
+ - notice\_url?: string | string\[]
5164
+
5165
+ **트랜잭션 종료 후 웹훅이 발송 될 고객사 서버 URL**
5166
+
5167
+ 주의: notice\_url 파라미터 설정시, 콘솔에 설정 된 웹훅 URL은 override 되며 notice\_url에 전달 한 주소로만 웹훅이 발송됩니다.
5168
+
5169
+ - bypass: object
5170
+
5171
+ - galaxia: object
5172
+
5173
+ - ITEM\_CODE: string
5174
+
5175
+ **구매 상품코드**
5176
+
5177
+ 갤럭시아머니트리에서 발급받은 상품 코드를 입력합니다. (최대 10자, 필수)
5178
+
5179
+ <details>
5180
+
5181
+ <summary>
5182
+
5183
+ <strong>갤럭시아머니트리 지원 빌링키 발급 수단</strong>
5184
+
5185
+ </summary>
5186
+
5187
+ - card
5188
+
5189
+ </details>
5190
+
5191
+ </div>
5192
+
5193
+ <div class="tabs-content" data-title="빌링키 발급과 동시에 결제 창 요청">
5194
+
5195
+ ```ts title="Javascript SDK"
5196
+ IMP.request_pay(
5197
+ {
5198
+ channelKey: "{콘솔 내 연동 정보의 채널키}",
5199
+ pay_method: "phone", // 빌링키 발급 및 결제 수단입니다. 갤럭시아머니트리의 경우 'phone'만 지원됩니다.
5200
+ merchant_uid: "orderNo0001", // 고객사에서 채번한 주문 고유 번호입니다.
5201
+ name: "주문명:결제테스트",
5202
+ amount: 1000, // 전달한 금액 만큼 실제로 승인이 됩니다.
5203
+ customer_id: "matthew", // 고객사가 회원에게 부여한 고유 ID입니다. (필수)
5204
+ customer_uid: "your-customer-unique-id", // 고객사가 구매자의 결제 수단을 특정하기 위해 채번한 고유 ID로 빌링키 발급시 필수 입력입니다.
5205
+ m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
5206
+ bypass: {
5207
+ galaxia: {
5208
+ ITEM_CODE: "상품코드", // 필수, 최대 10바이트
5209
+ },
5210
+ },
5211
+ },
5212
+ function (rsp) {
5213
+ // callback 로직
5214
+ const { imp_uid, merchant_uid } = rsp;
5215
+
5216
+ // 콜백 함수로 전달 받은 imp_uid로 포트원 결제 내역 조회 API를 통해 결제 상태를 판단합니다.
5217
+ },
5218
+ );
5219
+ ```
5220
+
5221
+ ### 주요 파라미터 설명
5222
+
5223
+ - channelKey: string
5224
+
5225
+ **채널키**
5226
+
5227
+ 결제를 진행할 채널을 지정합니다.
5228
+
5229
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
5230
+
5231
+ (최신 JavaScript SDK 버전부터 사용 가능합니다.)
5232
+
5233
+ - pg(deprecated)?: string
5234
+
5235
+ **PG사 구분코드**
5236
+
5237
+ <div class="hint" data-style="warning">
5238
+
5239
+ `pg` 파라미터는 지원 중단 예정입니다.
5240
+
5241
+ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
5242
+
5243
+ </div>
5244
+
5245
+ - pay\_method: 'phone'
5246
+
5247
+ **빌링키 발급 및 결제 수단**
5248
+
5249
+ 갤럭시아머니트리의 경우, 빌링키 발급과 동시에 결제 수단은 `phone`만 허용되며 **반드시 `phone`을 필수로 입력해주셔야** 합니다.
5250
+
5251
+ - merchant\_uid: string
5252
+
5253
+ **주문 번호**
5254
+
5255
+ 매번 고유하게 채번되어야 합니다.
5256
+
5257
+ - customer\_id: string
5258
+
5259
+ **구매자 고유 ID**
5260
+
5261
+ 고객사가 구매자를 특정하기 위해 채번한 고유 번호입니다. (최대 20자)
5262
+
5263
+ - customer\_uid: string
5264
+
5265
+ **빌링키 발급 수단 고유 ID**
5266
+
5267
+ 고객사가 구매자의 빌링키 발급 수단을 특정하기 위해 채번한 고유 번호로 빌링키 발급시 필수 입력입니다.
5268
+
5269
+ - name: string
5270
+
5271
+ **주문명**
5272
+
5273
+ 갤럭시아머니트리의 경우 필수로 입력해야 합니다.
5274
+
5275
+ - amount: number
5276
+
5277
+ **결제 금액**
5278
+
5279
+ **string** 이 아닌 점에 유의하세요.
5280
+
5281
+ - buyer\_name?: string
5282
+
5283
+ **구매자 이름**
5284
+
5285
+ - buyer\_tel?: string
5286
+
5287
+ **구매자 연락처**
5288
+
5289
+ - buyer\_email?: string
5290
+
5291
+ **구매자 이메일 주소**
5292
+
5293
+ - m\_redirect\_url?: string
5294
+
5295
+ **모바일 환경에서 트랜잭션 종료 후 302 리디렉션 될 URL**
5296
+
5297
+ 주의: 갤럭시아머니트리의 경우 **모바일 환경에서 필수 입력**입니다.
5298
+
5299
+ - phone?: object
5300
+
5301
+ **휴대폰 결제 관련 설정**
5302
+
5303
+ - carrier?: string
5304
+
5305
+ **휴대폰 통신사 코드**
5306
+
5307
+ `SKT`, `KTF`, `LGT`, `CJH`, `KCT`, `SKL`
5308
+
5309
+ - bypass: object
5310
+
5311
+ - galaxia: object
5312
+
5313
+ - ITEM\_CODE: string
5314
+
5315
+ **구매 상품코드**
5316
+
5317
+ 갤럭시아머니트리에서 발급받은 상품 코드를 입력합니다. (최대 10자, 필수)
5318
+
5319
+ <details>
5320
+
5321
+ <summary>
5322
+
5323
+ <strong>갤럭시아머니트리 지원 빌링키 발급과 동시에 결제 수단</strong>
5324
+
5325
+ </summary>
5326
+
5327
+ - phone (휴대폰소액결제)
5328
+
5329
+ </details>
5330
+
5331
+ </div>
5332
+
5333
+ </div>
5334
+
5335
+ <details>
5336
+
5337
+ <summary>
5338
+
5339
+ <strong>가능한 트랜잭션 환경</strong>
5340
+
5341
+ </summary>
5342
+
5343
+ - PC (iframe)
5344
+ - 모바일 (리디렉션)
5345
+
5346
+ </details>
5347
+
5348
+
5349
+ # https://developers.portone.io/opi/ko/integration/pg/v1/inicis-jp
5350
+
5351
+ ---
5352
+ title: KG이니시스 일본결제
5353
+ description: KG이니시스 일본결제 연동 방법을 안내합니다.
5354
+ targetVersions:
5355
+ - v1
5356
+ ---
5357
+
5358
+ ## 채널 설정하기
5359
+
5360
+ - [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
5361
+
5362
+ ## 가능한 결제 수단에
5363
+
5364
+ - **결제창 일반 결제**
5365
+
5366
+ `pay_method` 파라미터를 결제 수단에 따라 아래와 같이 설정합니다.
5367
+
5368
+ - 카드 : `card`
5369
+
5370
+ - 편의점결제 : `cvs`
5371
+
5372
+ - 간편결제
5373
+ - PayPay : `paypay`
5374
+ - Amazon Pay : `amazonpay`
5375
+ - Rakuten Pay : `rakutenpay`
5376
+ - Merpay : `merpay`
5377
+ - au PAY : `aupay`
5378
+ - dBarai : `dbarai`
5379
+
5380
+ ## SDK 결제 요청하기
5381
+
5382
+ [JavaScript SDK (신규)](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme)의 `IMP.request_pay(param, callback)`을 호출하여
5383
+ KSNET 결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
5384
+ **callback**으로 수신되고 모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
5385
+
5386
+ <div class="hint" data-style="info">
5387
+
5388
+ 이니시스 일본결제는 최신 SDK에서만 지원됩니다.
5389
+ 기존 JavaScript SDK를 사용 중이신 경우 [JavaScript SDK (신규)](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) 문서를 참고하여 업데이트를 진행해주세요.
5390
+
5391
+ **이니시스 일본결제를 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다.**
5392
+
5393
+ </div>
5394
+
5395
+ ```html
5396
+ <script src="https://cdn.iamport.kr/v1/iamport.js"></script>
5397
+ ```
5398
+
5399
+ <div class="hint" data-style="danger">
5400
+
5401
+ **기존에 deprecated된 응답들은 모두 제거**됐습니다.
5402
+
5403
+ 이니시스 일본결제 연동시에 사용되는 신규 JS SDK는 기존 모듈에서 제공했던 CallBack 파라미터가 대부분 삭제되었습니다.(특히 deprecated 로 명시된 파라미터는 모두 삭제되었습니다.)
5404
+
5405
+ 해당 JS SDK 사용시 Callback 으로 내려받을수 있는 데이터는 오직 아래 두가지 입니다.
5406
+
5407
+ **`imp_uid`, `merchant_uid`**
5408
+
5409
+ 따라서 해당 SDK를 사용하실때는 `IMP.request_pay`로부터 응답된 객체(또는 쿼리 파라미터)에서 `imp_uid`를 가지고 **포트원 REST API(GET `/payments/imp_uid`)로 결제 상세 내역(승인 상태, 승인 결과 등등)을 조회**하여 응답 파라미터 중 status 파라미터로 결제 상태를 파악하셔야 합니다.
5410
+
5411
+ </div>
5412
+
5413
+ <div class="tabs-container">
5414
+
5415
+ <div class="tabs-content" data-title="SDK 결제요청 (JPPG)">
5416
+
5417
+ ```javascript
5418
+ IMP.request_pay(
5419
+ {
5420
+ channelKey: "{콘솔 내 연동 정보의 채널키}",
5421
+ pay_method: "card",
5422
+ merchant_uid: "order_id_1667634130160",
5423
+ name: "Test",
5424
+ amount: 100,
5425
+ currency: "JPY",
5426
+ popup: true,
5427
+ buyer_name: "Port One",
5428
+ buyer_email: "buyer@example.com",
5429
+ buyer_tel: "0216705176",
5430
+ buyer_first_name_kana: "ポート",
5431
+ buyer_last_name_kana: "ワン",
5432
+ m_redirect_url: "https://helloworld.com/payments/result",
5433
+ notice_url: "https://helloworld.com/api/v1/payments/notice",
5434
+ storeDetails: {
5435
+ storeName: "波音戸音 毛流",
5436
+ storeNameKana: "ポートーンモール",
5437
+ storeNameEn: "Portone Mall",
5438
+ storeNameShort: "PTM",
5439
+ contactName: "サポート窓口",
5440
+ email: "help@example.com",
5441
+ phoneNumber: "0216705176",
5442
+ openingHours: {
5443
+ open: "11:00",
5444
+ close: "23:00",
5445
+ },
5446
+ },
5447
+ card: {
5448
+ display: {
5449
+ card_quota: [0, 3, 5, 6, 10, 12],
5450
+ },
5451
+ },
5452
+ cvs: {
5453
+ payment_deadline: {
5454
+ valid_hours: 48,
5455
+ due_date: "2026-04-01T23:59:59Z",
5456
+ },
5457
+ },
5458
+ bypass: {
5459
+ inicis_jp: {
5460
+ paymentUI: {
5461
+ colorTheme: "red1",
5462
+ logoUrl: "https://example.com/logo.svg",
5463
+ },
5464
+ },
5465
+ },
5466
+ },
5467
+ function (rsp) {
5468
+ // callback 로직
5469
+ //* ...중략... *//
5470
+ },
5471
+ );
5472
+ ```
5473
+
5474
+ **주요 파라미터 설명**
5475
+
5476
+ - channelKey: string
5477
+
5478
+ **채널키**
5479
+
5480
+ 결제를 진행할 채널을 지정합니다.
5481
+
5482
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
5483
+
5484
+ - pay\_method: string
5485
+
5486
+ **결제수단 구분코드**
5487
+
5488
+ - `card` (카드)
5489
+ - `cvs` (편의점)
5490
+ - `paypay` (PayPay)
5491
+ - `amazonpay` (Amazon Pay)
5492
+ - `rakutenpay` (Rakuten Pay)
5493
+ - `merpay` (Merpay)
5494
+ - `aupay` (au PAY)
5495
+ - `dbarai` (dBarai)
5496
+
5497
+ - merchant\_uid: string
5498
+
5499
+ **주문번호**
5500
+
5501
+ 고객사에서 매번 고유하게 채번되어야 합니다.
5502
+
5503
+ - name: string
5504
+
5505
+ **주문명**
5506
+
5507
+ 이니시스 일본결제의 경우 영어와 일본어만 허용합니다.
5508
+
5509
+ - amount: number
5510
+
5511
+ **결제금액**
5512
+
5513
+ - currency: string
5514
+
5515
+ **결제 통화 코드**
5516
+
5517
+ [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 통화 코드
5518
+
5519
+ - `JPY`: 일본 엔
5520
+
5521
+ 이니시스 일본결제는 일본 엔(JPY)만 지원합니다.
5522
+
5523
+ - popup: boolean
5524
+
5525
+ **결제창 팝업 여부**
5526
+
5527
+ 이니시스 일본결제는 팝업 결제창만 지원합니다. (iframe 미지원)
5528
+
5529
+ - buyer\_name: string
5530
+
5531
+ **주문자 명**
5532
+
5533
+ - buyer\_email?: string
5534
+
5535
+ **주문자 이메일**
5536
+
5537
+ 편의점 결제 시 해당 메일로 입금 요청 메일이 발송됩니다.
5538
+
5539
+ - buyer\_tel?: string
5540
+
5541
+ **주문자 연락처**
5542
+
5543
+ - buyer\_first\_name\_kana?: string
5544
+
5545
+ **주문자의 이름 (후리가나)**
5546
+
5547
+ 편의점 결제 시 필수 값 입니다.
5548
+
5549
+ 가타카나만 허용합니다.
5550
+
5551
+ - buyer\_last\_name\_kana?: string
5552
+
5553
+ **주문자의 성 (후리가나)**
5554
+
5555
+ 편의점 결제 시 필수 값 입니다.
5556
+
5557
+ 가타카나만 허용합니다.
5558
+
5559
+ - storeDetails: object
5560
+
5561
+ **상점 정보(가맹점 정보)**
5562
+
5563
+ - storeName: string
5564
+
5565
+ **상점명**
5566
+
5567
+ - storeNameKana: string
5568
+
5569
+ **상점명 (후리가나)**
5570
+
5571
+ 가타카나만 허용합니다.
5572
+
5573
+ - storeNameEn: string
5574
+
5575
+ **상점명 (영문)**
5576
+
5577
+ 알파벳만 허용합니다.
5578
+
5579
+ - storeNameShort: string
5580
+
5581
+ **상점명 (약어)**
5582
+
5583
+ - contactName: string
5584
+
5585
+ **상점 연락처 정보 이름**
5586
+
5587
+ ex. 고객센터 (일어)
5588
+
5589
+ - email: string
5590
+
5591
+ **상점 이메일**
5592
+
5593
+ - phoneNumber: string
5594
+
5595
+ **상점 연락처**
5596
+
5597
+ - openingHours: object
5598
+
5599
+ **상점 영업시간**
5600
+
5601
+ - open: string
5602
+
5603
+ **영업 시작 시간**
5604
+
5605
+ HH:mm 포맷으로 입력해야하며 00:00\~23:59 범위의 값만 허용합니다.
5606
+
5607
+ - close: string
5608
+
5609
+ **영업 종료 시간**
5610
+
5611
+ HH:mm 포맷으로 입력해야하며 00:00\~23:59 범위의 값만 허용합니다.
5612
+
5613
+ - card?: object
5614
+
5615
+ **카드 결제 시 파라미터**
5616
+
5617
+ - display?: object
5618
+
5619
+ - card\_quota?: number\[]
5620
+
5621
+ **카드 할부 개월수 리스트**
5622
+
5623
+ 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
5624
+
5625
+ - `[]`: 할부개월 수로 일시불만 노출
5626
+ - `[3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
5627
+
5628
+ - cvs?: object
5629
+
5630
+ **편의점 결제 시 파라미터**
5631
+
5632
+ - payment\_deadline?: object
5633
+
5634
+ **지불 기한**
5635
+
5636
+ 편의점 결제 이용 시 아래 `valid_hours`, `due_date` 두 파라미터 중 하나는 필수입니다.
5637
+
5638
+ - valid\_hours?: integer
5639
+
5640
+ **유효 시간**
5641
+
5642
+ 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
5643
+
5644
+ - due\_date?: string
5645
+
5646
+ **만료 시점**
5647
+
5648
+ 시간은 ISO8601 형식으로 입력해야 합니다.
5649
+
5650
+ - bypass?: object
5651
+
5652
+ - inicis\_jp?: object
5653
+
5654
+ - paymentUI?: object
5655
+
5656
+ - colorTheme?: string
5657
+
5658
+ **결제창 색상**
5659
+
5660
+ 사용 가능 색상 목록
5661
+
5662
+ - `red1`
5663
+ - `red2`
5664
+ - `red3`
5665
+ - `red4`
5666
+ - `orange`
5667
+ - `yellow`
5668
+ - `black`
5669
+ - `purple`
5670
+ - `green`
5671
+ - `blue1`
5672
+ - `blue2`
5673
+ - `blue3`
5674
+ - `blue4`
5675
+ - `blue5`
5676
+ - `blue6`
5677
+
5678
+ - logoUrl?: string
5679
+
5680
+ **가맹점 로고 이미지 URL**
5681
+
5682
+ 69\*20 픽셀 크기의 이미지 URL
5683
+
5684
+ </div>
5685
+
5686
+ <div class="tabs-content" data-title="SDK 결제요청 (SBPS)">
5687
+
5688
+ ```javascript
5689
+ IMP.request_pay(
5690
+ {
5691
+ channelKey: "{콘솔 내 연동 정보의 채널키}",
5692
+ pay_method: "card",
5693
+ merchant_uid: "order_id_1667634130160",
5694
+ name: "Test",
5695
+ amount: 100,
5696
+ currency: "JPY",
5697
+ popup: true,
5698
+ buyer_name: "Port One",
5699
+ buyer_email: "buyer@example.com",
5700
+ buyer_tel: "0216705176",
5701
+ m_redirect_url: "https://helloworld.com/payments/result",
5702
+ notice_url: "https://helloworld.com/api/v1/payments/notice",
5703
+ card: {
5704
+ display: {
5705
+ card_quota: [0, 3, 5, 6, 10, 12],
5706
+ },
5707
+ },
5708
+ bypass: {
5709
+ inicis_jp: {
5710
+ paymentUI: {
5711
+ colorTheme: "red1",
5712
+ logoUrl: "https://example.com/logo.svg",
5713
+ },
5714
+ },
5715
+ },
5716
+ },
5717
+ function (rsp) {
5718
+ // callback 로직
5719
+ //* ...중략... *//
5720
+ },
5721
+ );
5722
+ ```
5723
+
5724
+ **주요 파라미터 설명**
5725
+
5726
+ - channelKey: string
5727
+
5728
+ **채널키**
5729
+
5730
+ 결제를 진행할 채널을 지정합니다.
5731
+
5732
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
5733
+
5734
+ - pay\_method: string
5735
+
5736
+ **결제수단 구분코드**
5737
+
5738
+ - `card` (카드)
5739
+ - `paypay` (PayPay)
5740
+
5741
+ - merchant\_uid: string
5742
+
5743
+ **주문번호**
5744
+
5745
+ 고객사에서 매번 고유하게 채번되어야 합니다.
5746
+
5747
+ - name: string
5748
+
5749
+ **주문명**
5750
+
5751
+ 이니시스 일본결제의 경우 영어와 일본어만 허용합니다.
5752
+
5753
+ - amount: number
5754
+
5755
+ **결제금액**
5756
+
5757
+ - currency: string
5758
+
5759
+ **결제 통화 코드**
5760
+
5761
+ [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 통화 코드
5762
+
5763
+ - `JPY`: 일본 엔
5764
+
5765
+ 이니시스 일본결제는 일본 엔(JPY)만 지원합니다.
5766
+
5767
+ - popup: boolean
5768
+
5769
+ **결제창 팝업 여부**
5770
+
5771
+ 이니시스 일본결제는 팝업 결제창만 지원합니다. (iframe 미지원)
5772
+
5773
+ - buyer\_name: string
5774
+
5775
+ **주문자 명**
5776
+
5777
+ - buyer\_email?: string
5778
+
5779
+ **주문자 이메일**
5780
+
5781
+ - buyer\_tel?: string
5782
+
5783
+ **주문자 연락처**
5784
+
5785
+ - card?: object
5786
+
5787
+ - display?: object
5788
+
5789
+ - card\_quota?: number\[]
5790
+
5791
+ **카드 할부 개월수 리스트**
5792
+
5793
+ 이니시스 일본결제의 경우 일시불, 3, 5, 6, 10, 12개월만 지정 가능합니다.
5794
+
5795
+ - `[]`: 할부개월 수로 일시불만 노출
5796
+ - `[3, 5, 6]`: 할부개월 수로 일시불 및 3, 5, 6개월 노출
5797
+
5798
+ - bypass?: object
5799
+
5800
+ - inicis\_jp?: object
5801
+
5802
+ - paymentUI?: object
5803
+
5804
+ - colorTheme?: string
5805
+
5806
+ **결제창 색상**
5807
+
5808
+ 사용 가능 색상 목록
5809
+
5810
+ - `red1`
5811
+ - `red2`
5812
+ - `red3`
5813
+ - `red4`
5814
+ - `orange`
5815
+ - `yellow`
5816
+ - `black`
5817
+ - `purple`
5818
+ - `green`
5819
+ - `blue1`
5820
+ - `blue2`
5821
+ - `blue3`
5822
+ - `blue4`
5823
+ - `blue5`
5824
+ - `blue6`
5825
+
5826
+ - logoUrl?: string
5827
+
5828
+ **가맹점 로고 이미지 URL**
5829
+
5830
+ 69\*20 픽셀 크기의 이미지 URL
5831
+
5832
+ </div>
5833
+
5834
+ </div>
5835
+
5836
+ ### 유의 사항
5837
+
5838
+ #### 결제 취소
5839
+
5840
+ 카드결제 및 간편결제의 경우 결제 취소 및 부분취소를 지원하지만 편의점 결제의 경우 결제 취소를 지원하지 않습니다.
5841
+
5842
+
4634
5843
  # https://developers.portone.io/opi/ko/integration/pg/v1/inicis
4635
5844
 
4636
5845
  ---
@@ -5233,6 +6442,23 @@ IMP.request_pay(
5233
6442
 
5234
6443
  **string** 이 아닌점에 유의하세요
5235
6444
 
6445
+ - bypass?: object
6446
+
6447
+ **PG사 전용 파라미터**
6448
+
6449
+ - kakaopay?: object
6450
+
6451
+ **카카오페이 전용 파라미터**
6452
+
6453
+ - payment\_method\_type?: string
6454
+
6455
+ **사용 허용할 결제수단 지정**
6456
+
6457
+ - `CARD`: 카드결제만 허용
6458
+ - `MONEY`: 포인트결제만 허용
6459
+
6460
+ 미입력 시 사용 가능한 전체 결제수단 허용
6461
+
5236
6462
  </div>
5237
6463
 
5238
6464
  <div class="tabs-content" data-title="정기결제창 요청">
@@ -5484,6 +6710,8 @@ const data = await response.json();
5484
6710
 
5485
6711
  본인인증을 식별하기 위한 고객사의 주문 고유 번호로 매번 고유하게 채번되어야 합니다.
5486
6712
 
6713
+ 영어 대소문자와 숫자만 사용 가능하며 40자 이하로 입력해야 합니다.
6714
+
5487
6715
  - bypass.kcpV2.web\_siteid: string
5488
6716
 
5489
6717
  **KCP 사이트 식별코드**
@@ -6421,6 +7649,17 @@ IMP.request_pay(
6421
7649
 
6422
7650
  <details>
6423
7651
 
7652
+ <summary>가상계좌 환불 처리</summary>
7653
+
7654
+ 모빌리언스 가상계좌 환불은 **매주 목요일 일괄 입금** 처리됩니다.
7655
+
7656
+ - **화요일까지 접수된 요청**: 같은 주 목요일 입금
7657
+ - **수요일부터 접수된 요청**: 다음 주 목요일 입금
7658
+
7659
+ </details>
7660
+
7661
+ <details>
7662
+
6424
7663
  <summary>모바일 환경 이슈</summary>
6425
7664
 
6426
7665
  - 아이폰 모바일 환경에서 크롬이나 인앱 브라우저에서 계좌이체를 하면 뱅크페이에서 결제 완료 후 **사파리로 이동하는 이슈**가 있습니다. (모빌리언스 수정 예정)
@@ -6610,11 +7849,290 @@ curl -H "Content-Type: application/json" \
6610
7849
  **포트원을 통해 KG 모빌리언스를 사용할 때에는 API 방식 비 인증 결제를 사용할 수 없습니다.**
6611
7850
 
6612
7851
 
7852
+ # https://developers.portone.io/opi/ko/integration/pg/v1/kicc-v2
7853
+
7854
+ ---
7855
+ title: 이지페이(KICC) 해외결제
7856
+ description: 이지페이(KICC) 해외결제 결제 연동 방법을 안내합니다.
7857
+ targetVersions:
7858
+ - v1
7859
+ ---
7860
+
7861
+ ## 채널 설정하기
7862
+
7863
+ - [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 내용을 참고하여 PG 설정을 진행합니다.
7864
+
7865
+ ## 가능한 결제 수단
7866
+
7867
+ - **결제창 일반 결제**
7868
+
7869
+ KICC 해외결제를 통해 위챗페이와 알리페이 플러스를 이용할 수 있습니다.
7870
+ 이용하고자 하는 결제사 별 파라미터는 아래를 참고해주세요.
7871
+
7872
+ ## SDK 결제 요청하기
7873
+
7874
+ 결제 요청 시에는 `request_pay` 함수를 호출해야 합니다.
7875
+ `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 KICC 채널 사용을 명시해주세요.
7876
+
7877
+ KICC 기준으로 작성한 예시 코드는 아래와 같습니다.
7878
+
7879
+ <div class="tabs-container">
7880
+
7881
+ <div class="tabs-content" data-title="위챗페이">
7882
+
7883
+ ```javascript
7884
+ IMP.request_pay(
7885
+ {
7886
+ channelKey: "{콘솔 내 연동 정보의 채널키}",
7887
+ pay_method: "wechat",
7888
+ merchant_uid: "order_no_0001",
7889
+ name: "주문명:결제테스트",
7890
+ amount: 1004,
7891
+ buyer_email: "test@portone.io",
7892
+ buyer_name: "구매자이름",
7893
+ buyer_tel: "010-1234-5678",
7894
+ buyer_addr: "서울특별시 강남구 삼성동",
7895
+ buyer_postcode: "123-456",
7896
+ m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
7897
+ },
7898
+ function (rsp) {
7899
+ // callback 로직
7900
+ //* ...중략... *//
7901
+ },
7902
+ );
7903
+ ```
7904
+
7905
+ **주요 파라미터 설명**
7906
+
7907
+ - channelKey: string
7908
+
7909
+ **채널키**
7910
+
7911
+ 결제를 진행할 채널을 지정합니다.
7912
+
7913
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
7914
+
7915
+ - pay\_method: string
7916
+
7917
+ **결제수단 구분코드**
7918
+
7919
+ - wechat (위챗페이)
7920
+ - alipay\_plus (알리페이 플러스)
7921
+
7922
+ - merchant\_uid: string
7923
+
7924
+ **주문번호**
7925
+
7926
+ 고객사에서 매번 고유하게 채번되어야 합니다.
7927
+
7928
+ - buyer\_name: string
7929
+
7930
+ **주문자 이름**
7931
+
7932
+ - buyer\_email: string
7933
+
7934
+ **주문자 이메일**
7935
+
7936
+ - buyer\_tel: string
7937
+
7938
+ **주문자 연락처**
7939
+
7940
+ - amount: number
7941
+
7942
+ **결제금액**
7943
+
7944
+ - currency: string
7945
+
7946
+ **결제 통화 코드**
7947
+
7948
+ [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 통화 코드
7949
+
7950
+ - `KRW`: 한국 원
7951
+ - `USD`: 미국 달러
7952
+
7953
+ 미입력하거나 올바르지 않은 값을 입력한 경우 원화(KRW)결제로 동작합니다.
7954
+
7955
+ - language: string
7956
+
7957
+ **결제창 언어**
7958
+
7959
+ - `ko`: 한국어
7960
+ - `en`: 영어
7961
+ - `zh`: 중국어 (중국본토)
7962
+
7963
+ </div>
7964
+
7965
+ <div class="tabs-content" data-title="알리페이 플러스">
7966
+
7967
+ ```javascript
7968
+ IMP.request_pay(
7969
+ {
7970
+ channelKey: "{콘솔 내 연동 정보의 채널키}",
7971
+ pay_method: "alipay_plus",
7972
+ merchant_uid: "order_no_0001",
7973
+ name: "주문명:결제테스트",
7974
+ amount: 1004,
7975
+ buyer_email: "test@portone.io",
7976
+ buyer_name: "구매자이름",
7977
+ buyer_tel: "010-1234-5678",
7978
+ buyer_addr: "서울특별시 강남구 삼성동",
7979
+ buyer_postcode: "123-456",
7980
+ m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
7981
+ order_description: "주문 상세 내용",
7982
+ alipay_plus: {
7983
+ wallet: "alipay",
7984
+ },
7985
+ },
7986
+ function (rsp) {
7987
+ // callback 로직
7988
+ //* ...중략... *//
7989
+ },
7990
+ );
7991
+ ```
7992
+
7993
+ **주요 파라미터 설명**
7994
+
7995
+ - channelKey: string
7996
+
7997
+ **채널키**
7998
+
7999
+ 결제를 진행할 채널을 지정합니다.
8000
+
8001
+ 포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
8002
+
8003
+ - pay\_method: string
8004
+
8005
+ **결제수단 구분코드**
8006
+
8007
+ - wechat (위챗페이)
8008
+ - alipay\_plus (알리페이 플러스)
8009
+
8010
+ - merchant\_uid: string
8011
+
8012
+ **주문번호**
8013
+
8014
+ 고객사에서 매번 고유하게 채번되어야 합니다.
8015
+
8016
+ - buyer\_name: string
8017
+
8018
+ **주문자 이름**
8019
+
8020
+ - buyer\_email: string
8021
+
8022
+ **주문자 이메일**
8023
+
8024
+ - buyer\_tel: string
8025
+
8026
+ **주문자 연락처**
8027
+
8028
+ - order\_description: string
8029
+
8030
+ **주문 상세 정보**
8031
+
8032
+ 주문 상세 정보로 고객사에서 자유롭게 입력합니다.
8033
+
8034
+ 알리페이 플러스 결제시 필수입니다.
8035
+
8036
+ KICC와 알리페이 플러스에서는 영문만 사용하는 것을 권장합니다.
8037
+
8038
+ - amount: number
8039
+
8040
+ **결제금액**
8041
+
8042
+ - currency: string
8043
+
8044
+ **결제 통화 코드**
8045
+
8046
+ [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) 통화 코드
8047
+
8048
+ - `KRW`: 한국 원
8049
+ - `USD`: 미국 달러
8050
+
8051
+ 미입력하거나 올바르지 않은 값을 입력한 경우 원화(KRW)결제로 동작합니다.
8052
+
8053
+ - language: string
8054
+
8055
+ **결제창 언어**
8056
+
8057
+ - `ko`: 한국어
8058
+ - `en`: 영어
8059
+ - `zh`: 중국어 (중국본토)
8060
+
8061
+ - alipay\_plus: object
8062
+
8063
+ **알리페이 플러스 정보**
8064
+
8065
+ - wallet?: string
8066
+
8067
+ **알리페이 플러스를 통해 이용할 간편결제**
8068
+
8069
+ 미입력 시 이용 가능한 간편결제 수단이 모두 노출되는 알리페이 플러스 통합 월렛 화면이 표기됩니다.
8070
+
8071
+ - `alipay`: Alipay (알리페이)
8072
+ - `true_money`: TrueMoney (트루머니)
8073
+ - `alipay_hk`: AlipayHK (알리페이 홍콩)
8074
+ - `touch_n_go`: Touch 'n Go (터치앤고)
8075
+ - `gcash`: GCash (지캐시)
8076
+ - `dana`: DANA (다나)
8077
+ - `rabbit_line_pay`: Rabbit LINE Pay (래빗 라인페이)
8078
+ - `bpi`: BPI - Bank of the Philippine Islands (필리핀 제도 은행)
8079
+ - `boost`: Boost (부스트)
8080
+ - `bill_ease`: BillEase (빌이즈)
8081
+ - `tinaba`: Tinaba (티나바)
8082
+ - `mpay`: MPay (엠페이)
8083
+ - `kredivo`: Kredivo (크레디보)
8084
+
8085
+ </div>
8086
+
8087
+ </div>
8088
+
8089
+ ## 유의 사항
8090
+
8091
+ <div class="tabs-container">
8092
+
8093
+ <div class="tabs-content" data-title="위챗페이">
8094
+
8095
+ ### 결제 승인
8096
+
8097
+ 위챗페이의 경우 위챗 앱을 이용해 QR코드를 스캔하여 결제를 진행하는 방식으로 결제창이 닫힌 이후에도 구매자가 QR코드를 이미
8098
+ 스캔해둔 상태라면 언제든지 결제 승인이 발생할 수 있습니다.
8099
+
8100
+ 따라서 PC에서 callback / Mobile에서 redirect 된 이후 결제내역 조회를 통해 확인된 상태값을 100% 신뢰하지 않도록
8101
+ 해야하며 웹훅 연동은 필수로 진행해야합니다.
8102
+
8103
+ ### 결제 취소
8104
+
8105
+ 위챗페이의 경우 결제 취소가 비동기로 처리됩니다. 결제 취소 요청에 대한 응답으로 주문 상태를 변경하지 않고
8106
+ 웹훅을 통해 결제 취소 결과를 반영하도록 처리가 필요합니다.
8107
+
8108
+ ### 도메인 등록
8109
+
8110
+ 위챗페이는 KICC를 통해 결제창이 오픈될 고객사 결제 페이지 도메인에 대한 등록 요청이 필요합니다.
8111
+
8112
+ 등록되어있지 않은 도메인에 대해서는 모바일 결제 시도 시 오류 페이지로 연결되므로 유의 바랍니다.
8113
+
8114
+ </div>
8115
+
8116
+ <div class="tabs-content" data-title="알리페이 플러스">
8117
+
8118
+ ### 결제 승인
8119
+
8120
+ 알리페이 플러스의 경우 일부 결제 수단은 앱으로 QR코드를 스캔하여 결제를 진행하는 방식으로 결제창이 닫힌 이후에도 구매자가 QR코드를 이미
8121
+ 스캔해둔 상태라면 언제든지 결제 승인이 발생할 수 있습니다.
8122
+
8123
+ 따라서 PC에서 callback / Mobile에서 redirect 된 이후 결제내역 조회를 통해 확인된 상태값을 100% 신뢰하지 않도록
8124
+ 해야하며 웹훅 연동은 필수로 진행해야합니다.
8125
+
8126
+ </div>
8127
+
8128
+ </div>
8129
+
8130
+
6613
8131
  # https://developers.portone.io/opi/ko/integration/pg/v1/kicc
6614
8132
 
6615
8133
  ---
6616
- title: 이지페이(KICC)
6617
- description: 이지페이(KICC) 결제창 연동 방법을 안내합니다.
8134
+ title: 이지페이(KICC) (구모듈)
8135
+ description: 이지페이(KICC) (구모듈) 결제창 연동 방법을 안내합니다.
6618
8136
  targetVersions:
6619
8137
  - v1
6620
8138
  ---
@@ -7182,6 +8700,14 @@ IMP.request_pay(
7182
8700
 
7183
8701
  - 결제를 요청하는 사이트의 url을 입력하여야 합니다.
7184
8702
 
8703
+ - sndKakaopayType?: string
8704
+
8705
+ **카카오페이 결제시 허용할 결제수단**
8706
+
8707
+ - `CARD`: 카드 결제만 허용
8708
+ - `MONEY`: 카카오머니 결제만 허용
8709
+ - 미입력시 모든 결제수단 허용
8710
+
7185
8711
  </div>
7186
8712
 
7187
8713
  <div class="tabs-content" data-title="비인증 결제창 요청">
@@ -9589,6 +11115,8 @@ IMP.request_pay(
9589
11115
  - Leave : 간편결제+선불머니 서비스 해지 (사전 협의 필요)
9590
11116
  - PrepaidRefundAccount: 선불머니 환급계좌 등록 및 변경 (사전 협의 필요)
9591
11117
  - PrepaidRefund: 선불머니 환급 요청 (사전 협의 필요)
11118
+ - PrepaidLimitRaise: 선불머니 보유한도 상향 요청 (사전 협의 필요)
11119
+ - PrepaidKYC: 선불머니 고객 확인 재이행 (사전 협의 필요)
9592
11120
 
9593
11121
  - encryptedCI: string
9594
11122
 
@@ -9757,6 +11285,7 @@ PIN 초기화 이후 [빌링키 삭제 API](https://developers.portone.io/api/re
9757
11285
  - `Leave`: 간편결제+선불머니 서비스 해지 (선불머니 환급 완료 후 진행 가능)
9758
11286
  - `PrepaidRefundAccount`: 선불머니 환급계좌 등록 및 변경
9759
11287
  - `PrepaidRefund`: 선불머니 환급 요청
11288
+ - `PrepaidLimitRaise`: 선불머니 보유한도 상향 요청
9760
11289
 
9761
11290
  </details>
9762
11291
 
@@ -11416,8 +12945,8 @@ JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미
11416
12945
  # https://developers.portone.io/opi/ko/integration/pg/v1/nice
11417
12946
 
11418
12947
  ---
11419
- title: () 나이스정보통신
11420
- description: () 나이스정보통신 결제창 연동 가이드를 안내합니다.
12948
+ title: 나이스정보통신 (구모듈)
12949
+ description: 나이스정보통신 (구모듈) 결제창 연동 가이드를 안내합니다.
11421
12950
  targetVersions:
11422
12951
  - v1
11423
12952
  ---
@@ -12468,7 +13997,7 @@ IMP.request_pay({
12468
13997
  <div class="hint" data-style="info">
12469
13998
 
12470
13999
  STC API를 사용하기 위해서는 **Paypal과의 STC 데이터 협의**가 필요하며,
12471
- **포트원 지원팀(<tech.support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
14000
+ 판매자 보호 정책에 관한 자세한 내용 협의가 필요한 경우 페이팔에 직접 문의해 주세요.
12472
14001
 
12473
14002
  연동을 원하시는 경우 원활한 연동절차를 위해 요청 전 **아래 pdf의 Create REST API Application 섹션을 완료**해주세요.
12474
14003
 
@@ -12503,7 +14032,7 @@ versionVariants:
12503
14032
 
12504
14033
  [나이스정보통신 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)
12505
14034
 
12506
- [() 나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
14035
+ [나이스정보통신 (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
12507
14036
 
12508
14037
  [NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme)
12509
14038
 
@@ -12527,10 +14056,12 @@ versionVariants:
12527
14056
 
12528
14057
  [KSNET](https://developers.portone.io/opi/ko/integration/pg/v1/ksnet/readme)
12529
14058
 
12530
- [이지페이(KICC)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc)
14059
+ [이지페이(KICC) (구모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/kicc)
12531
14060
 
12532
14061
  [웰컴페이먼츠](https://developers.portone.io/opi/ko/integration/pg/v1/welcome/readme)
12533
14062
 
14063
+ [갤럭시아머니트리](https://developers.portone.io/opi/ko/integration/pg/v1/galaxia)
14064
+
12534
14065
  ## 국내 간편결제
12535
14066
 
12536
14067
  [네이버페이(결제형)](https://developers.portone.io/opi/ko/integration/pg/v1/naver)
@@ -12561,6 +14092,10 @@ versionVariants:
12561
14092
 
12562
14093
  [페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global)
12563
14094
 
14095
+ [이지페이(KICC) 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/kicc-v2)
14096
+
14097
+ [KG이니시스 일본결제](https://developers.portone.io/opi/ko/integration/pg/v1/inicis-jp)
14098
+
12564
14099
 
12565
14100
  # https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme
12566
14101
 
@@ -13035,8 +14570,6 @@ await fetch("https://api.iamport.kr/subscribe/payments/again", {
13035
14570
 
13036
14571
  고위험 산업에 해당하는 산업군들은 다음과 같습니다.
13037
14572
 
13038
- 각 산업별 STC에 필요한 요청 파라미터들이 달라, 고위험 산업에 해당하는 고객사 분들께는 페이팔 전자결제 신청 시 포트원 지원팀에서 안내가 될 예정입니다.
13039
-
13040
14573
  1. 이벤트/티켓 판매 산업
13041
14574
 
13042
14575
  2. 연료 산업
@@ -15127,6 +16660,14 @@ SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js 인지 확
15127
16660
  </script>
15128
16661
  ```
15129
16662
 
16663
+ <div class="hint" data-style="warning">
16664
+
16665
+ 페이지 내에 `id="paypal"`인 HTML 요소를 사용하지 마세요.
16666
+
16667
+ 페이팔 SDK가 내부적으로 동일한 id를 사용하기 때문에 충돌이 발생하여 결제 오류가 발생할 수 있습니다.
16668
+
16669
+ </div>
16670
+
15130
16671
  <div class="hint" data-style="info">
15131
16672
 
15132
16673
  ### 페이팔 일반결제 버튼이 보이지 않을 때
@@ -20991,7 +22532,7 @@ targetVersions:
20991
22532
  | 헥토파이낸셜 | `settle` |
20992
22533
  |헥토파이낸셜 내통장결제| `settle_acc` |
20993
22534
  | KSNET | `ksnet` |
20994
- | 갤럭시아 | `galaxia` |
22535
+ | 갤럭시아머니트리 | `galaxia` |
20995
22536
  | 웰컴페이먼츠 | `welcome` |
20996
22537
 
20997
22538
 
@@ -23886,7 +25427,7 @@ title: 전자결제 신청
23886
25427
  description: 결제대행사 및 결제수단을 선택하고 전자결제를 신청하는 과정을 안내합니다.
23887
25428
  ---
23888
25429
 
23889
- 포트원 관리자콘솔에서 [로그인](https://admin.portone.io/auth/signin)을 한 뒤 좌측 상단에 있는
25430
+ 포트원 관리자콘솔에서 [로그인](https://admin.portone.io/auth/signin)을 한 뒤 좌측 하단에 있는
23890
25431
  **\[전자결제 신청]** 버튼을 클릭하면 고객사가 사용하고자 하는 모든 결제 수단과 이를 지원하는 결제대행사를
23891
25432
  신청할 수 있는 페이지로 이동합니다.
23892
25433
 
@@ -27311,6 +28852,21 @@ targetVersions:
27311
28852
 
27312
28853
  <details>
27313
28854
 
28855
+ <summary>갤럭시아머니트리</summary>
28856
+
28857
+ 1. [갤럭시아머니트리 가맹점 관리자](https://cpadmin.billgate.net) 접속 후 로그인을 합니다.
28858
+ 2. \[기술지원]→\[암호화 정보 확인]을 클릭합니다.
28859
+ 3. \[상용서버] 또는 \[테스트서버]를 선택합니다.
28860
+ 4. MID, KEY, IV 값을 확인할 수 있습니다.
28861
+
28862
+ (이미지 첨부: 갤럭시아머니트리 BillGate 내 암호화 정보 확인 화면)
28863
+
28864
+ 5. 포트원 콘솔에서 채널 추가 시 \[MID], \[KEY], \[IV]를 입력한 후 `저장`을 클릭합니다.
28865
+
28866
+ </details>
28867
+
28868
+ <details>
28869
+
27314
28870
  <summary>나이스정보통신</summary>
27315
28871
 
27316
28872
  <div class="hint" data-style="info">
@@ -27479,6 +29035,8 @@ targetVersions:
27479
29035
 
27480
29036
  <summary>키움페이</summary>
27481
29037
 
29038
+ #### 채널 설정
29039
+
27482
29040
  1. [키움페이 상점관리자](http://agent.kiwoompay.co.kr/) 접속 후 로그인을 합니다.
27483
29041
  2. \[고객지원]→\[기술지원]→\[연동정보설정]를 클릭합니다.
27484
29042
  3. CPID를 선택하여 `조회하기`를 클릭합니다.
@@ -27489,6 +29047,19 @@ targetVersions:
27489
29047
 
27490
29048
  6. 포트원 콘솔에서 채널 추가 시 \[CPID], \[결제연동키]를 입력한 후 `저장`을 클릭합니다.
27491
29049
 
29050
+ #### 결제 결과 통보 URL 설정
29051
+
29052
+ 키움페이에서 포트원으로 결제 결과를 전달받기 위해 통보 URL을 설정해야 합니다.
29053
+
29054
+ 1. [키움페이 상점관리자](http://agent.kiwoompay.co.kr/) 접속 후 로그인을 합니다.
29055
+ 2. \[고객지원]→\[기술지원]→\[연동정보설정]를 클릭합니다.
29056
+ 3. CPID를 선택하여 `조회하기`를 클릭합니다.
29057
+ 4. 결제수단을 선택합니다.
29058
+ 5. `결제 통지URL` 항목에 `https://service.iamport.kr/daou_payments/result`를 입력합니다.
29059
+ 6. `취소통지사용여부` 항목을 `아니오`로 설정합니다.
29060
+
29061
+ (이미지 첨부: 키움페이 상점관리자 내 통보 URL 설정 화면)
29062
+
27492
29063
  </details>
27493
29064
 
27494
29065
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -27573,63 +29144,8 @@ targetVersions:
27573
29144
 
27574
29145
  <div class="tabs-content" data-title="결제창 일반/정기 결제">
27575
29146
 
27576
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
27577
-
27578
- <div class="hint" data-style="info">
27579
-
27580
- - **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
27581
- - **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
27582
-
27583
- </div>
27584
-
27585
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
27586
-
27587
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
27588
-
27589
- <div class="hint" data-style="info">
27590
-
27591
- 크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
27592
-
27593
- </div>
27594
-
27595
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
27596
-
27597
- 1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
27598
-
27599
- 2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
27600
-
27601
- 3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
27602
-
27603
- <ul>
27604
-
27605
- <li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
27606
- <li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
27607
-
27608
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
27609
-
27610
- <li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
27611
-
27612
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
27613
-
27614
- </ul>
27615
-
27616
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
27617
-
27618
- 4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
27619
-
27620
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
27621
-
27622
- 5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
27623
-
27624
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
27625
-
27626
- <div class="hint" data-style="warning">
27627
-
27628
- 포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
27629
-
27630
- </div>
27631
-
27632
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
29147
+ 1. KG이니시스 계약 완료 이후, 이니시스로부터 전달 받은 MID, INIAPI Key, CBT 타입 값을 포트원 콘솔에서 채널 추가 시
29148
+ `[PG상점아이디 (MID)]`, `[INIAPI Key]`, `[CBT Type]` 항목에 입력 혹은 선택 후 저장을 클릭합니다.
27633
29149
 
27634
29150
  </div>
27635
29151
 
@@ -27691,63 +29207,8 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
27691
29207
 
27692
29208
  <div class="tabs-content" data-title="결제창 일반/정기 결제">
27693
29209
 
27694
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
27695
-
27696
- <div class="hint" data-style="info">
27697
-
27698
- - **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
27699
- - **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
27700
-
27701
- </div>
27702
-
27703
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
27704
-
27705
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
27706
-
27707
- <div class="hint" data-style="info">
27708
-
27709
- 크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
27710
-
27711
- </div>
27712
-
27713
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
27714
-
27715
- 1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
27716
-
27717
- 2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
27718
-
27719
- 3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
27720
-
27721
- <ul>
27722
-
27723
- <li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
27724
- <li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
27725
-
27726
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
27727
-
27728
- <li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
27729
-
27730
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
27731
-
27732
- </ul>
27733
-
27734
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
27735
-
27736
- 4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
27737
-
27738
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
27739
-
27740
- 5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
27741
-
27742
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
27743
-
27744
- <div class="hint" data-style="warning">
27745
-
27746
- 포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
27747
-
27748
- </div>
27749
-
27750
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
29210
+ 1. KG이니시스 계약 완료 이후, 이니시스로부터 전달 받은 MID, INIAPI Key, CBT 타입 값을 포트원 콘솔에서 채널 추가 시
29211
+ `[PG상점아이디 (MID)]`, `[INIAPI Key]`, `[CBT Type]` 항목에 입력 혹은 선택 후 저장을 클릭합니다.
27751
29212
 
27752
29213
  </div>
27753
29214
 
@@ -27815,7 +29276,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
27815
29276
 
27816
29277
  (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
27817
29278
 
27818
- 4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
29279
+ 4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
27819
29280
 
27820
29281
  5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
27821
29282
 
@@ -27827,7 +29288,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
27827
29288
 
27828
29289
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
27829
29290
 
27830
- 9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
29291
+ 9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
27831
29292
 
27832
29293
  10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
27833
29294
 
@@ -27851,7 +29312,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
27851
29312
 
27852
29313
  (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
27853
29314
 
27854
- 4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
29315
+ 4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
27855
29316
 
27856
29317
  5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
27857
29318
 
@@ -27863,7 +29324,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
27863
29324
 
27864
29325
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
27865
29326
 
27866
- 9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
29327
+ 9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
27867
29328
 
27868
29329
  10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
27869
29330
 
@@ -27934,7 +29395,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
27934
29395
  9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
27935
29396
 
27936
29397
  1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
27937
- 2. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
29398
+ 2. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
27938
29399
  3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
27939
29400
  4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
27940
29401
  5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
@@ -27942,7 +29403,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
27942
29403
 
27943
29404
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
27944
29405
 
27945
- 7. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
29406
+ 7. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
27946
29407
  8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
27947
29408
 
27948
29409
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
@@ -28043,10 +29504,10 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
28043
29504
 
28044
29505
  </details>
28045
29506
 
28046
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
28047
-
28048
29507
  <details>
28049
29508
 
29509
+ <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
29510
+
28050
29511
  <summary>페이먼트월</summary>
28051
29512
 
28052
29513
  1. [페이먼트월](http://api.paymentwall.com/developers/applications) 접속 후 로그인을 합니다.
@@ -28074,10 +29535,41 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
28074
29535
 
28075
29536
  (이미지 첨부: 페이먼트월 Pingback 설정 화면)
28076
29537
 
28077
- </details>
28078
-
28079
29538
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
28080
29539
 
29540
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
29541
+
29542
+ <summary>페이먼트월</summary>
29543
+
29544
+ 1. [페이먼트월](http://api.paymentwall.com/developers/applications) 접속 후 로그인을 합니다.
29545
+ 2. \[My Projects]를 클릭합니다.
29546
+
29547
+ (이미지 첨부: 페이먼트월 페이지 내 Key 조회 화면)
29548
+
29549
+ 3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
29550
+
29551
+ #### 핑백(Pingback) URL 설정하기
29552
+
29553
+ 페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
29554
+
29555
+ 1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
29556
+
29557
+ (이미지 첨부: 페이먼트월 My Projects 메뉴)
29558
+
29559
+ 2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
29560
+
29561
+ (이미지 첨부: 페이먼트월 프로젝트 setting 탭)
29562
+
29563
+ 3. \[Pingback type]을 `URL`로 선택합니다.
29564
+ 4. \[Pingback URL]에 `https://tx-gateway-service.prod.iamport.co/paymentwall`를 입력합니다.
29565
+ 5. \[Pingback signature version]을 `3`으로 설정합니다.
29566
+
29567
+ (이미지 첨부: 페이먼트월 Pingback 설정 화면)
29568
+
29569
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
29570
+
29571
+ </details>
29572
+
28081
29573
  <details>
28082
29574
 
28083
29575
  <summary>페이팔</summary>
@@ -28188,6 +29680,36 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
28188
29680
 
28189
29681
  </details>
28190
29682
 
29683
+ <details>
29684
+
29685
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
29686
+
29687
+ <summary>Triple-A</summary>
29688
+
29689
+ 1. Triple-A 대시보드의 API Credentials 페이지로 이동합니다.
29690
+ 2. `+ Create credentials` 버튼을 클릭하여 Client ID와 Client Secret을 생성합니다.
29691
+ 3. API IDs 리스트에서 Merchant key를 확인합니다.
29692
+ 4. 포트원 콘솔에서 채널 추가 시 확인한 Merchant Key를 PG 상점아이디에 입력하고, Client ID와 Client Secret을 입력한 후 `저장`을 클릭합니다.
29693
+
29694
+ <div class="hint" data-style="info">
29695
+
29696
+ 테스트 환경에서는 Testnet3 testBTC로만 결제가 가능합니다.
29697
+
29698
+ </div>
29699
+
29700
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
29701
+
29702
+ </details>
29703
+
29704
+ <details>
29705
+
29706
+ <summary>이지페이(KICC)</summary>
29707
+
29708
+ 1. KICC 계약 완료 이후, KICC로부터 전달 받은 MID, 가맹점 암호키 값을 포트원 콘솔에서 채널 추가 시
29709
+ `[가맹점 ID]`, `[암복호화 키]` 항목에 입력한 후 저장을 클릭합니다.
29710
+
29711
+ </details>
29712
+
28191
29713
  ## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
28192
29714
 
28193
29715
  포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.
@@ -28260,6 +29782,48 @@ targetVersions:
28260
29782
  - v2
28261
29783
  ---
28262
29784
 
29785
+ ## AI Codemate
29786
+
29787
+ AI Codemate 는 Claude Code를 사용하여 작업자의 프로젝트 환경을 AI를 통해 분석해 맞춤형 결제 연동 코드를 생성하고,
29788
+ 기존 연동 코드를 검토하는 기능을 제공합니다.
29789
+ [(GitHub 저장소 바로가기)](https://github.com/portone-io/portone-cli)
29790
+
29791
+ 플러그인은 포트원 MCP 서버를 기반으로 공식 문서와 API 스펙을 활용하여 정확한 코드를 생성합니다.
29792
+
29793
+ ### 설치 방법
29794
+
29795
+ Node.js 22.6.0 이상이 설치된 환경에서 다음 명령어를 실행합니다:
29796
+
29797
+ ```bash
29798
+ npx @portone/cli@latest setup
29799
+ ```
29800
+
29801
+ <div class="hint" data-style="info">
29802
+
29803
+ 명령어 실행 시 사용자의 Claude Code에 포트원 Claude 플러그인이 자동으로 등록됩니다.
29804
+
29805
+ </div>
29806
+
29807
+ ### 사용 방법
29808
+
29809
+ #### 결제 연동 코드 생성
29810
+
29811
+ Claude Code에서 `/portone-integration:start` 명령어를 입력하면 대화형으로 결제 연동 코드를 생성할 수 있습니다.
29812
+
29813
+ ```bash
29814
+ /portone-integration:start # 대화형으로 모든 옵션 선택
29815
+ ```
29816
+
29817
+ ### 지원 범위
29818
+
29819
+ Claude Code에서 사용하는 모델이 지원하는 모든 프레임워크와 언어를 지원합니다.
29820
+
29821
+ <div class="hint" data-style="warning">
29822
+
29823
+ 신규 프로젝트의 경우 V2 사용을 권장합니다. V1은 레거시 프로젝트 유지보수 용도로 지원됩니다.
29824
+
29825
+ </div>
29826
+
28263
29827
  ## 포트원 MCP (Model Context Protocol) 서버
28264
29828
 
28265
29829
  포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)
@@ -29676,6 +31240,10 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
29676
31240
 
29677
31241
  ## **공통 용어**
29678
31242
 
31243
+ ### 정산
31244
+
31245
+ 포트원 콘솔에서는 '정산'을 '파트너에게 지급할 금액을 산출하는 과정'으로 정의합니다.
31246
+
29679
31247
  ### 고객사 / 파트너
29680
31248
 
29681
31249
  고객사는 포트원의 결제서비스를 이용하고 있는 포트원의 고객을 의미합니다.
@@ -29696,6 +31264,18 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
29696
31264
 
29697
31265
  </div>
29698
31266
 
31267
+ ### 전 영업일
31268
+
31269
+ 선택한 날짜가 공휴일인 경우, 그 이전의 가장 가까운 영업일을 의미합니다.
31270
+
31271
+ ### 후 영업일
31272
+
31273
+ 선택한 날짜가 공휴일인 경우, 그 이후의 가장 가까운 영업일을 의미합니다.
31274
+
31275
+ ### 달력일
31276
+
31277
+ 영업일과 관계없이 선택한 날짜를 의미합니다. 주말과 공휴일도 포함됩니다.
31278
+
29699
31279
  ---
29700
31280
 
29701
31281
  ## **정산금 계산 자동화 용어**
@@ -29713,6 +31293,32 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
29713
31293
 
29714
31294
  소득자(개인 파트너)가 자신의 세금을 직접 납부하지 않고, 원천징수 대상소득을 지급하는 원천징수 의무자(플랫폼사)가 그 금액을 미리 떼어서 대신 납부하는 세금입니다. 원천 징수세는 계약 등록에서 미리 설정할 수 있습니다.
29715
31295
 
31296
+ ### 정산 파라미터
31297
+
31298
+ 정산 금액을 계산하기 위해 시스템에 전달되는 데이터 변수들을 의미합니다. 정산 파라미터는 플랫폼 프로모션, 수수료율 등 다양한 요소를 포함할 수 있으며, 이를 기반으로 정산금 계산식을 만들 수 있습니다.
31299
+
31300
+ ### 정산 시작일
31301
+
31302
+ 정산 주기를 계산하기 위한 기점이 되는 날짜입니다. 일반적으로 결제 완료 시점 또는 구매 확정 시점으로 설정합니다.
31303
+
31304
+ ### 정산일
31305
+
31306
+ 정산금 지급이 가능해지는 시점입니다.
31307
+
31308
+ <div class="hint" data-style="Info">
31309
+
31310
+ 정산일 = 정산 시작일 + 보류일
31311
+
31312
+ </div>
31313
+
31314
+ ### 부가세 부담 주체
31315
+
31316
+ 플랫폼에서 부과하는 중개 수수료에 대한 부가세의 부담 주체를 의미합니다.
31317
+
31318
+ **파트너 부담** : 중개 수수료에 부가세를 별도로 청구합니다. 파트너 정산 금액에서 중개수수료에 대한 부가세를 자동 차감 후 지급합니다.
31319
+
31320
+ **우리 회사 부담** : 중개 수수료에 부가세를 포함하여 정산합니다. 즉, 파트너 정산 금액에 영향을 미치지 않습니다.
31321
+
29716
31322
  ---
29717
31323
 
29718
31324
  ## **지급대행 서비스 용어**
@@ -29732,6 +31338,7 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
29732
31338
  ### 즉시지급(바로지급)과 예약지급
29733
31339
 
29734
31340
  **즉시지급**은 지급 요청 즉시 실시간으로 송금이 실행되는 지급 방식입니다.
31341
+
29735
31342
  **예약지급**은 미래의 특정 시점에 지급이 실행되도록 예약하는 지급 방식입니다. 예약지급은 주말과 공휴일도 포함시켜 달력일로 예약할 수 있습니다.
29736
31343
 
29737
31344
  <div class="hint" data-style="warning">
@@ -29783,6 +31390,10 @@ description: 파트너 정산 자동화 솔루션에서 자주 사용되는 용
29783
31390
 
29784
31391
  </div>
29785
31392
 
31393
+ ### 발행 마감일
31394
+
31395
+ 전자세금계산서법에 따라 세금계산서를 반드시 발행해야 하는 법적 기한입니다. 일반적으로 거래가 발생한 달의 다음 달 10일까지 국세청에 전송되어야 합니다.
31396
+
29786
31397
 
29787
31398
  # https://developers.portone.io/platform/ko/guides/process
29788
31399
 
@@ -33829,10 +35440,10 @@ writtenAt: 2023-09-01T00:00:00.000Z
33829
35440
 
33830
35441
  플랫폼 및 마켓플레이스 사업자가 손쉽게 하위정산 할 수 있는 파트너정산 서비스가 런칭 되었습니다.
33831
35442
  파트너(셀러) 등록, 계약 등록, 정산등록 과 같은 정산의 세밀한 모든 부분을 관리자 콘솔로 관리하세요!
33832
- 해당 서비스는 유료 서비스입니다. 문의를 원하시면 신청(<https://platform.contact.portone.io/>)하시면
35443
+ 해당 서비스는 유료 서비스입니다. 문의를 원하시면 신청(<https://inquiry.portone.io/fs>하시면
33833
35444
  영업일 2일안에 연락드리겠습니다.
33834
35445
 
33835
- [→ 파트너 정산 자동화 서비스 소개](https://portone.io/korea/ko/service/platform)
35446
+ [→ 파트너 정산 자동화 서비스 소개](https://portone.io/platform)
33836
35447
  [→ 파트너 정산 자동화 연동가이드 확인하기](https://developers.portone.io/platform/ko/readme)
33837
35448
 
33838
35449
 
@@ -34394,17 +36005,17 @@ writtenAt: 2024-08-22T00:00:00.000Z
34394
36005
 
34395
36006
  **주문 정산건 생성 요청**
34396
36007
 
34397
- - **`discounts`:[\[CreatePlatformOrderTransferBodyDiscount\[\]\]](/api/rest-v2/type-def#CreatePlatformOrderTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
36008
+ - **`discounts`:[\[CreatePlatformOrderTransferBodyDiscount\[\]\]](/api/rest-v2/platform.transfer#CreatePlatformOrderTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
34398
36009
  - **`taxFreeAmount?: integer`** 면세 할인 금액
34399
36010
 
34400
36011
  **주문 취소 정산건 생성 요청**
34401
36012
 
34402
- - **`discounts`:[\[CreatePlatformOrderCancelTransferBodyDiscount\[\]\]](/api/rest-v2/type-def#CreatePlatformOrderCancelTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
36013
+ - **`discounts`:[\[CreatePlatformOrderCancelTransferBodyDiscount\[\]\]](/api/rest-v2/platform.transfer#CreatePlatformOrderCancelTransferBodyDiscount)** 할인 정보에 면세 할인 금액 필드가 추가되었습니다.
34403
36014
  - **`taxFreeAmount?: integer`** 면세 할인 금액
34404
36015
 
34405
36016
  **주문 정산건 생성, 주문 취소 정산건 생성 응답**
34406
36017
 
34407
- - **`amount`:[\[PlatformOrderSettlementAmount\]](/api/rest-v2/type-def#PlatformOrderSettlementAmount)** 정산 금액 정보에 필드가 추가되었습니다.
36018
+ - **`amount`:[\[PlatformOrderSettlementAmount\]](/api/rest-v2/platform.transfer#PlatformOrderSettlementAmount)** 정산 금액 정보에 필드가 추가되었습니다.
34408
36019
  - **`paymentTaxFree: integer`** 결제 면세 금액
34409
36020
  - 기존 `taxFree`를 대체하는 필드입니다. `taxFree`를 사용하고 계셨다면 `paymentTaxFree`를 대신 사용해 주세요
34410
36021
 
@@ -34417,13 +36028,13 @@ writtenAt: 2024-08-22T00:00:00.000Z
34417
36028
 
34418
36029
  - **`discountShareTaxFree: integer`** 면세 할인 분담 금액
34419
36030
 
34420
- - **`discounts`:[\[PlatformOrderTransferDiscount\[\]\]](/api/rest-v2/type-def#PlatformOrderTransferDiscount)** 정산 금액 계산 시 사용된 할인 정보에 필드가 추가되었습니다.
36031
+ - **`discounts`:[\[PlatformOrderTransferDiscount\[\]\]](/api/rest-v2/platform.transfer#PlatformOrderTransferDiscount)** 정산 금액 계산 시 사용된 할인 정보에 필드가 추가되었습니다.
34421
36032
  - **`taxFreeAmount: integer`** 면세 할인 금액
34422
36033
  - **`shareTaxFreeAmount: integer`** 면세 할인 분담 금액
34423
36034
 
34424
36035
  **정산 상세 내역 다운로드 필드 추가**
34425
36036
 
34426
- - **`fields?`:[\[PlatformTransferSheetField\[\]\]](/api/rest-v2/type-def#PlatformTransferSheetField)** 다운로드 할 시트 필드가 추가되었습니다.
36037
+ - **`fields?`:[\[PlatformTransferSheetField\[\]\]](/api/rest-v2/platform.transfer#PlatformTransferSheetField)** 다운로드 할 시트 필드가 추가되었습니다.
34427
36038
  - **`SETTLEMENT_PAYMENT_SUPPLY_AMOUNT`**: 결제 공급가액
34428
36039
  - 기존 `SETTLEMENT_SUPPLY_AMOUNT`를 대체하는 필드입니다. `SETTLEMENT_SUPPLY_AMOUNT`를 사용하고 계셨다면 `SETTLEMENT_PAYMENT_SUPPLY_AMOUNT`를 대신 사용해 주세요
34429
36040
 
@@ -34523,32 +36134,32 @@ writtenAt: 2024-10-21T00:00:00.000Z
34523
36134
 
34524
36135
  일괄 지급 내역 다건 조회 응답값이 수정되었습니다.
34525
36136
 
34526
- - **`items`: [PlatformBulkPayout\[\]](/api/rest-v2/type-def#PlatformBulkPayout)** 일괄 지급 내역에 필드가 추가되었습니다.
36137
+ - **`items`: [PlatformBulkPayout\[\]](/api/rest-v2/platform.bulkPayout#PlatformBulkPayout)** 일괄 지급 내역에 필드가 추가되었습니다.
34527
36138
  - **`scheduledAt?: string`** 일괄지급 예정일시
34528
- - **`status`: [PlatformBulkPayoutStatus](/api/rest-v2/type-def#PlatformBulkPayoutStatus)** 일괄지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
36139
+ - **`status`: [PlatformBulkPayoutStatus](/api/rest-v2/platform.bulkPayout#PlatformBulkPayoutStatus)** 일괄지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
34529
36140
 
34530
- - **`counts`: [PlatformBulkPayoutStatusStats](/api/rest-v2/type-def#PlatformBulkPayoutStatusStats)** 일괄지급 상태별 통계에 `scheduled`상태인 일괄지급 건 수가 추가되었습니다.
36141
+ - **`counts`: [PlatformBulkPayoutStatusStats](/api/rest-v2/platform.bulkPayout#PlatformBulkPayoutStatusStats)** 일괄지급 상태별 통계에 `scheduled`상태인 일괄지급 건 수가 추가되었습니다.
34531
36142
  - **`scheduled: integer`** 예약된 일괄지급 건 수
34532
36143
 
34533
36144
  #### ✔️ 지급 내역 다건 조회
34534
36145
 
34535
36146
  지급 내역 다건 조회 응답값이 수정되었습니다.
34536
36147
 
34537
- - **`items`: [PlatformPayout\[\]](/api/rest-v2/type-def#PlatformPayout)** 지급 내역에 필드가 추가되었습니다.
36148
+ - **`items`: [PlatformPayout\[\]](/api/rest-v2/platform.payout#PlatformPayout)** 지급 내역에 필드가 추가되었습니다.
34538
36149
  - **`scheduledAt?: string`** 지급 예정일시
34539
- - **`status`: [PlatformPayoutStatus](/api/rest-v2/type-def#PlatformPayoutStatus)** 지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
36150
+ - **`status`: [PlatformPayoutStatus](/api/rest-v2/platform.payout#PlatformPayoutStatus)** 지급 상태에 `SCHEDULED` (예약됨) 상태가 추가되었습니다.
34540
36151
 
34541
- - **`counts`: [PlatformPayoutStatusStats](/api/rest-v2/type-def#PlatformPayoutStatusStats)** 지급 상태별 통계에 `scheduled` 상태인 지급 건 수가 추가되었습니다.
36152
+ - **`counts`: [PlatformPayoutStatusStats](/api/rest-v2/platform.payout#PlatformPayoutStatusStats)** 지급 상태별 통계에 `scheduled` 상태인 지급 건 수가 추가되었습니다.
34542
36153
  - **`scheduled: integer`** 예약된 지급 건 수
34543
36154
 
34544
36155
  #### ✔️ 정산 내역 다건 조회
34545
36156
 
34546
36157
  정산 내역 다건 조회 응답값이 수정되었습니다.
34547
36158
 
34548
- - **`items`: [PlatformPartnerSettlement\[\]](/api/rest-v2/type-def#PlatformPartnerSettlement)** 정산 내역에 필드가 추가되었습니다.
34549
- - **`status`: [PlatformPartnerSettlementStatus](/api/rest-v2/type-def#PlatformPartnerSettlementStatus)** 정산 상태에 `PAYOUT_SCHEDULED` (지급 예약) 상태가 추가되었습니다.
36159
+ - **`items`: [PlatformPartnerSettlement\[\]](/api/rest-v2/platform.partnerSettlement#PlatformPartnerSettlement)** 정산 내역에 필드가 추가되었습니다.
36160
+ - **`status`: [PlatformPartnerSettlementStatus](/api/rest-v2/platform.partnerSettlement#PlatformPartnerSettlementStatus)** 정산 상태에 `PAYOUT_SCHEDULED` (지급 예약) 상태가 추가되었습니다.
34550
36161
 
34551
- - **`counts`: [PlatformPartnerSettlementStatusStats](/api/rest-v2/type-def#PlatformPartnerSettlementStatusStats)** 정산 상태별 통계에 payoutScheduled 상태인 정산 내역 건 수가 추가되었습니다.
36162
+ - **`counts`: [PlatformPartnerSettlementStatusStats](/api/rest-v2/platform.partnerSettlement#PlatformPartnerSettlementStatusStats)** 정산 상태별 통계에 payoutScheduled 상태인 정산 내역 건 수가 추가되었습니다.
34552
36163
  - **`payoutScheduled: integer`** 지급 예약된 정산 내역 건 수
34553
36164
 
34554
36165
  ---
@@ -34897,8 +36508,8 @@ writtenAt: 2025-02-10T00:00:00.000Z
34897
36508
 
34898
36509
  > 영향 API : [정산건 조회](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#get%20%2Fplatform%2Ftransfers%2F%7Bid%7D), [주문 정산건 생성](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#post%20%2Fplatform%2Ftransfers%2Forder), [주문 취소 정산건 생성](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#post%20%2Fplatform%2Ftransfers%2Forder-cancel), [정산건 다건 조회](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#get%20%2Fplatform%2Ftransfer-summaries)
34899
36510
 
34900
- - 사용자 정의 함수 : [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/type-def?v=v2#PlatformOrderTransfer).amount.**userDefinedFormulas**
34901
- - 정산 파라미터 : [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/type-def?v=v2#PlatformOrderTransfer).**parameters**
36511
+ - 사용자 정의 함수 : [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#PlatformOrderTransfer).amount.**userDefinedFormulas**
36512
+ - 정산 파라미터 : [PlatformOrderTransfer](https://developers.portone.io/api/rest-v2/platform.transfer?v=v2#PlatformOrderTransfer).**parameters**
34902
36513
 
34903
36514
  더 궁금한 점이 있다면 고객 지원팀에 문의해 주세요! 🚀
34904
36515
 
@@ -35926,6 +37537,267 @@ GET /platform/transfers/{id}?test=true
35926
37537
  - 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
35927
37538
 
35928
37539
 
37540
+ # https://developers.portone.io/release-notes/platform/2026-02-19
37541
+
37542
+ ---
37543
+ releasedAt: 2026-02-19T00:00:00.000Z
37544
+ writtenAt: 2026-02-19T00:00:00.000Z
37545
+ ---
37546
+
37547
+ 안녕하세요, 파트너 정산 자동화 팀입니다.
37548
+
37549
+ 이번 업데이트에서는 세금 계산서 메뉴가 개편되고, 사용성을 대폭 개선하는 거래처 관리 기능을 새롭게 제공합니다. 또한 헬프센터 자주 묻는 질문에 세금계산서 카테고리가 신설되어 관련 안내를 보다 쉽게 찾으실 수 있습니다.
37550
+
37551
+ ---
37552
+
37553
+ ## 거래처 관리 기능 신규 제공
37554
+
37555
+ 세금계산서 정발행·역발행 시 활용할 수 있는 거래처 관리 기능이 추가되었습니다.
37556
+
37557
+ "거래처 관리" 메뉴에서 거래처의 사업자 정보를 등록하고 관리할 수 있으며, CSV 또는 엑셀 파일로 일괄 등록도 가능합니다.
37558
+
37559
+ 일괄 등록 시 사업자 정보 조회 및 휴폐업 상태 조회 실행 여부를 선택할 수 있습니다.
37560
+
37561
+ (이미지 첨부: 거래처 관리 화면)
37562
+
37563
+ ---
37564
+
37565
+ ## 세금계산서 작성에 따른 연동
37566
+
37567
+ 세금계산서 작성 시 거래처 검색으로 공급받는자 정보를 간편하게 설정할 수 있습니다. 정발행 시 공급받는자가 거래처로 자동 등록되며, 역발행은 사전에 거래처 등록 및 국세청 연동이 필요합니다. 세금계산서 내역은 거래처 단위 또는 사업자등록번호 기준으로 검색할 수 있고, 일괄 등록 시 거래처 아이디로 자동 매핑됩니다.
37568
+
37569
+ (이미지 첨부: 세금계산서 작성 페이지 하단)
37570
+
37571
+ ---
37572
+
37573
+ ## 세금계산서 단독 고객사 메뉴 개편
37574
+
37575
+ 세금계산서 단독 이용 고객사의 관리자 콘솔 메뉴가 아래와 같이 개편되었습니다.
37576
+
37577
+ 세금계산서 > 세금계산서 작성 / 세금계산서 관리 / 거래처 관리
37578
+
37579
+ 기존에 파트너 정산 자동화 탭에 있던 세금계산서 관련 기능이 독립 메뉴로 분리되어, 보다 직관적으로 접근할 수 있습니다.
37580
+
37581
+ (이미지 첨부: 포트원 관리자 콘솔 메뉴)
37582
+
37583
+ ---
37584
+
37585
+ ## 자주 묻는 질문에 세금계산서 탭 신설
37586
+
37587
+ 헬프센터 자주 묻는 질문에 세금계산서 카테고리가 신설되었습니다. 거래처 관리, 정발행·역발행, 국세청 연동 등 세금계산서 관련 FAQ를 한 곳에서 확인하실 수 있습니다. 기존 파트너 정산 자동화 탭에 있던 세금계산서 관련 FAQ가 새로운 세금계산서 탭으로 이동되었습니다.
37588
+
37589
+ (이미지 첨부: 포트원 헬프센터 자주 묻는 질문)
37590
+
37591
+ ---
37592
+
37593
+ 작성일자: **2026년 2월 19일**
37594
+
37595
+ - 일반 문의: <cs@portone.io> / 채널톡
37596
+ - 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
37597
+
37598
+
37599
+ # https://developers.portone.io/release-notes/platform/2026-03-06
37600
+
37601
+ ---
37602
+ releasedAt: 2026-03-06T00:00:00.000Z
37603
+ writtenAt: 2026-03-06T00:00:00.000Z
37604
+ ---
37605
+
37606
+ 안녕하세요, 포트원 파트너 정산 자동화팀 입니다.
37607
+
37608
+ 파트너 정산 자동화 제품에 대한 전반적인 사용성 개선과 안정화에 대한 업데이트가 진행됨에 따라 업데이트 사항을 안내해 드립니다.
37609
+
37610
+ ---
37611
+
37612
+ ## 정산 상세 내역의 상태 라벨 개선
37613
+
37614
+ 정산 상세 내역에서 상태의 명칭이 불명확한 부분을 개선하였습니다.
37615
+
37616
+ |기존 |신규 |설명 |
37617
+ |---------|---------|----------------------------------------------------------------|
37618
+ |정산 예정|정산 예정|정산 시작일에 도래하지 않아 아직 금액 및 정산일 확정이 안된 경우|
37619
+ |정산 중 |정산 중 |정산 시작일을 지나 정산 금액 및 정산일이 확정된 상태 |
37620
+ |정산 완료|정산 확정|정산일이 지나 지급 가능한 상태 |
37621
+ |N/A |지급 확정|특정 지급건에 집계되어 이체 가능한 상태 |
37622
+ |이체 중 |지급 중 |지급이 예약되어 있거나 지급이 진행중인 상태 |
37623
+ |이체 완료|지급 완료|지급 및 정산이 완료된 상태 |
37624
+
37625
+ (이미지 첨부: 정산 상세 내역 상태 라벨 개선 화면)
37626
+
37627
+ ---
37628
+
37629
+ ## 정산 상세 내역 및 정산 내역 삭제 기능 지원
37630
+
37631
+ 정산 내역 및 정산 상세 내역에 특정 상태인 데이터 삭제가 콘솔 및 API로 제공됩니다.
37632
+
37633
+ ### 삭제 가능한 상태
37634
+
37635
+ - 정산 상세 내역(주문/수기 정산건): **정산 예정, 정산 중, 정산 확정**
37636
+ - 정산 내역: **지급 예정, 지급 보류, 지급 취소, 지급 제외**
37637
+
37638
+ ### 유의 사항
37639
+
37640
+ - 삭제된 데이터에 대한 복원은 불가능합니다.
37641
+ - 정산 내역 건별 삭제 시 연관된 정산 상세 내역(주문/수기정산건)이 삭제 가능하다면 함께 삭제됩니다.
37642
+
37643
+ (이미지 첨부: 정산 내역/상세 내역 삭제 기능 (1))
37644
+
37645
+ (이미지 첨부: 정산 내역/상세 내역 삭제 기능 (2))
37646
+
37647
+ ---
37648
+
37649
+ ## 정산 내역 지급 예정 상태로 복원 시 오류 해결
37650
+
37651
+ 기존 지급 보류/지급 실패 상태에서 지급 예정 상태로 변경 시 오류가 발생하였으나 해당 부분이 해결되었습니다.
37652
+
37653
+ 위 오류는 상태 변경 과정에서 같은 집계 조건의 지급 예정 상태의 내역이 추가 생성된 경우 발생하는 오류로, 현재는 지급 예정 상태의 내역을 **중복 적재 가능**하게 개선하였습니다.
37654
+
37655
+ (이미지 첨부: 지급 예정 복원 오류 개선)
37656
+
37657
+ ---
37658
+
37659
+ ## 비활성화 가상 계좌 노출 지원
37660
+
37661
+ 더즌 계좌 변경 안내에 따라서 신규 계좌 발급이 완료되었습니다. 다만 기존 계좌의 내역 조회를 지속 지원해드리기 위해 비활성 상태로 계좌 노출이 지원됩니다.
37662
+
37663
+ ### 안내 사항
37664
+
37665
+ - 비활성 계좌도 이전 입출금 내역에 대해 확인하실 수 있습니다.
37666
+ - 비활성 계좌는 출금/지급 시 활용할 수 없으며, 잔액 조회가 불가합니다.
37667
+
37668
+ (이미지 첨부: 비활성화 가상 계좌 노출)
37669
+
37670
+ ---
37671
+
37672
+ ## 출금 시 입금 계좌 예금주 저장
37673
+
37674
+ 기존 예치금 출금 시 조회된 입금 계좌 예금주가 이체 내역에 반영되지 않던 부분을 개선하였습니다. 배포 이후로 진행되는 모든 출금 건들에 대해서 입금 대상 계좌에 대한 예금주 정보가 저장됩니다.
37675
+
37676
+ ---
37677
+
37678
+ ## 이체 속도 개선
37679
+
37680
+ 현재 이체 프로세스를 개선하여 기존보다 **3배 더 많은 이체 건**들을 병렬 처리할 수 있게 되었습니다.
37681
+
37682
+ (이미지 첨부: 이체 속도 개선)
37683
+
37684
+ ---
37685
+
37686
+ ## 정산 내역 ‘지급 제외’ 상태 추가
37687
+
37688
+ 정산 내역 중 영구적으로 지급을 제외할 데이터를 관리하기 위한 “지급 제외” 상태를 추가합니다.
37689
+
37690
+ - 지급 보류/취소/예정 상태와 별개로 정산 내역에 “지급 제외” 상태가 추가됩니다.
37691
+ - “지급 제외” 상태는 지급이 불가능한 상태입니다. (지급 내역 확정 시 자동 제외됩니다.)
37692
+ - “지급 제외” 상태는 “지급 보류 / 지급 예정” 상태로 변경할 수 있습니다.
37693
+ - “지급 보류 / 취소 / 예정” 상태에서 “지급 제외” 상태로 변경할 수 있습니다.
37694
+
37695
+ (이미지 첨부: 정산 내역 ‘지급 제외’ 상태)
37696
+
37697
+ ---
37698
+
37699
+ ## 세금계산서 기능 개선
37700
+
37701
+ - 거래처 관리 엑셀 다운로드 시 주소/업태/업종 데이터가 추가됩니다.
37702
+ - ‘요청’ 상태의 세금계산서를 회수 없이 메일 주소만 변경하여 재전송 가능하도록 개선됩니다.
37703
+ - 세금계산서 메뉴에서 상태값 외 다른 항목(예: 발행일, 금액 등)으로도 필터 및 정렬(오름/내림차순) 가능하도록 개선됩니다.
37704
+ - 세금계산서 내역 관리에서 체크박스 일괄 ‘발행취소, 삭제, 재전송’ 기능이 가능하도록 개선됩니다.
37705
+
37706
+ ---
37707
+
37708
+ ## API 변경 사항 안내
37709
+
37710
+ ### A. 정산 내역 삭제 API 제공
37711
+
37712
+ 오등록되거나 재등록이 필요한 정산 데이터를 삭제하기 위해서 정산 내역 단위 삭제 API가 제공됩니다.\
37713
+ 해당 정산 내역을 삭제하시게 되면 연관된 정산 상세 내역 데이터와 함께 삭제가 진행되므로 유의하여 활용해주시길 바랍니다.
37714
+
37715
+ ```http
37716
+ POST /platform/partner-settlements/delete?test=false
37717
+ Content-Type: application/json
37718
+
37719
+ {
37720
+ "partnerSettlementIds": []
37721
+ }
37722
+ ```
37723
+
37724
+ - _해당 API는 unstable 입니다._
37725
+
37726
+ ---
37727
+
37728
+ ### B. 정산 내역 일괄 지급 처리 API 제공
37729
+
37730
+ 외화 정산 내역의 경우에는 현재 지급 대행 등이 제공되지 않아 지급 건을 수기 보정 요청주시던 부분에 대해서 직접 보정이 가능하도록 API를 제공합니다.
37731
+ 해당 API를 활용하시면 자동적으로 일괄 지급 / 지급 내역 등을 생성하여 지급 완료 상태로 데이터가 보정됩니다.
37732
+
37733
+ ```http
37734
+ POST /platform/partner-settlements/complete-payout?test=false
37735
+ Content-Type: application/json
37736
+
37737
+ {
37738
+ "bulkPayoutId": "",
37739
+ "name": "",
37740
+ "partnerSettlementIds": [],
37741
+ "completeAt": "2026-02-01"
37742
+ }
37743
+ ```
37744
+
37745
+ - _해당 API는 unstable 입니다._
37746
+
37747
+ ---
37748
+
37749
+ ### C. 주문 정산 / 주문 취소 정산 / 수기 정산 등록 시 id 직접 지정 가능
37750
+
37751
+ 중복 등록 방지 및 고객사 자체 아이디 매핑을 위해 주문/주문 취소/수기 정산 등록 시 id 필드를 직접 지정할 수 있습니다.
37752
+ id 필드가 지정되지 않은 경우에는 자동 생성되며 기존과 같이 활용하실 수 있습니다.
37753
+
37754
+ ```http
37755
+ POST /platform/transfers/manual
37756
+ POST /platform/transfers/order
37757
+ POST /platform/transfers/order-cancel
37758
+
37759
+ Content-Type: application/json
37760
+
37761
+ {
37762
+ "id": "custom-id"
37763
+ // ... 기존 API 명세
37764
+ }
37765
+ ```
37766
+
37767
+ 참고: order-cancel 의 경우 transfer\_id 와 id 가 동시에 존재하는데, transfer\_id 는 기존과 같이 취소 대상 원본 주문 정산 건에 대한 식별자입니다.
37768
+
37769
+ ---
37770
+
37771
+ ### D. 정산 상세 다건 조회 API 사용자 정의 속성 검색 지원 및 성능 개선
37772
+
37773
+ 정산 상세 내역 조회 시 사용자 정의 속성에 대한 지원이 추가됩니다. 접두사 일치로 검색이 지원됩니다.
37774
+
37775
+ ```http
37776
+ POST /platform/transfer-summaries
37777
+ Content-Type: application/json
37778
+
37779
+ {
37780
+ "filter": {
37781
+ "userDefinedProperty": {
37782
+ "key": "USER DEFINED KEY",
37783
+ "value": "exact match"
37784
+ }
37785
+ }
37786
+ // ...
37787
+ }
37788
+ ```
37789
+
37790
+ 또한 정산 상세 다건 조회 시 파트너 정보 조회 비용을 최적화하여 조회 성능을 개선하였습니다.
37791
+ P50 기준 내부 테스트 결과 **60% 이상의 latency 감소**가 확인되었습니다.
37792
+
37793
+ ---
37794
+
37795
+ 작성일자: **2026년 3월 3일**
37796
+
37797
+ - 일반 문의: <cs@portone.io> / 채널톡
37798
+ - 기술지원 문의: <support.b2b@portone.io> / 파트너스 슬랙 채널
37799
+
37800
+
35929
37801
  # https://developers.portone.io/blog/posts/2024-02/v2-oom
35930
37802
 
35931
37803
  ---
@@ -38470,3 +40342,123 @@ Event Sourcing의 경우 굉장히 낯선 기술이고, 국내에서 해당 기
38470
40342
 
38471
40343
  과감한 결정을 한 만큼 장기적으로 그 효과는 강력할 것이라고 생각합니다.
38472
40344
  Event Sourcing이라는 단단한 뿌리 위에서 폭발적으로 성장하는 포트원을 지켜봐 주세요!
40345
+
40346
+
40347
+ # https://developers.portone.io/blog/posts/2025-12/portone-chatbot
40348
+
40349
+ ---
40350
+ title: 포트원 AI 챗봇이 반복되는 기술 문의를 획기적으로 단축한 비결
40351
+ description: 잘 만든 AI 서비스 하나로 1000개의 기술 문의를 대신한 이야기
40352
+ author: portone-io
40353
+ date: 2025-12-17T15:00:00.000Z
40354
+ tags:
40355
+ - AI
40356
+ - Chatbot
40357
+ ---
40358
+
40359
+ 안녕하세요, 온라인 비즈니스 결제 인프라를 만드는 포트원입니다.
40360
+ 결제 연동은 복잡합니다. 개발 환경도 다르고, 사용하는 언어도 제각각이죠. 그러다 보니 포트원 CS 채널에는 하루에도
40361
+ 수많은 '기술 문의'가 쏟아집니다.
40362
+ 문제는 여기서 발생합니다. 고객의 질문은 고도화되는데, CS 담당자가 모든 개발 지식을 알 수는 없으니까요.
40363
+ 결국 문의는 개발팀으로 넘어오고, "문의 - CS팀 - 개발자 - 답변 작성 - CS팀 - 고객"으로 이어지는 비효율의
40364
+ 무한 루프가 시작됩니다.
40365
+
40366
+ **"이 단순 반복 업무를 AI가 대신할 수는 없을까?"**
40367
+
40368
+ 최근 포트원이 공개한 AI 챗봇, ‘포트원 AI Assistant’ 프로젝트는 위 질문에서 시작되었습니다.
40369
+ 해커톤에서 시작된 실험을 실제 서비스로 안착시키기까지, 포트원의 한지환 프로덕트 오너와 전우제 백엔드 엔지니어가
40370
+ 함께한 치열했던 개발기를 공개합니다.
40371
+
40372
+ ## ‘단순한 기술 문의의 반복, 어려워지는 온보딩’
40373
+
40374
+ 포트원 개발팀은 단순한 기술 문의가 지속적으로 반복되며 개발자들이 CS답변에 쓰는 리소스가 점점 늘어나는 상황과,
40375
+ 결제 연동 과정에서 고객들이 길어지는 상담으로 이탈하는 문제를 발견했습니다.
40376
+
40377
+ 한지환 프로덕트 오너 : 포트원의 미션은 '온라인 비즈니스를 하고 있는 누구나 결제 연동을 쉽게 하는 것'입니다. 그런데
40378
+ 아이러니하게도 연동 과정에서 고객들이 겪는 어려움을 해결해 주는 과정이 점점 느려졌어요. 기술 문의가 들어오면
40379
+ CS팀에서 개발자에게 전달하고, 개발자가 내용을 확인하고 답변을 줄 때까지 고객은 기다려야 했죠. 내부적으로도 리소스
40380
+ 낭비가 심했습니다. 개발자들이 코드 짜는 시간보다 기술 문의 답변을 검수해 주는 시간이 점점 늘어나기 시작했거든요.
40381
+
40382
+ 전우제 엔지니어 : 반복되는 기술 문의를 들여다보면 패턴이 보였어요. "결제 연동 오류가 나요"라고 하는데, 살펴보면
40383
+ 뻔한 실수인 경우가 많았죠. 개발자가 보면 1초 만에 아는 내용인데, CS팀을 거치다 보니 답변이 늦어지는 상황이
40384
+ 반복됐습니다. 이 시간을 단축하고 싶다는 니즈는 개발팀 내에서도 꽤 오래전부터 있었습니다
40385
+
40386
+ ## 해커톤이 가져다준 AI 실험 기회
40387
+
40388
+ 이 문제를 해결하기 위해 처음부터 거창한 프로젝트를 띄운 건 아니었습니다.
40389
+ 시작은 포트원 개발팀이 참여한 'AWS X 메가존 해커톤'이었습니다.
40390
+
40391
+ 전우제 엔지니어 : 사실 이 아이디어가 해커톤 메인 출품작은 아니었어요.
40392
+ 하지만 해커톤 기간 동안 AWS Bedrock과 Claude 모델을 마음껏 테스트해 볼 수 있는 '크레딧'이 생겼다는 게 중요했습니다. 회사 입장에서 AI 도입의 가장 큰 장벽은 '비용'이거든요.
40393
+
40394
+ "이게 진짜 될까?" 싶은 아이디어를 비용 걱정 없이 검증해 볼 수 있는 완벽한 타이밍이었죠.
40395
+ 그때 얻은 'AI 서비스 구성 감각'이 실제 제품 개발로 이어지는 결정적인 트리거가 됐습니다.
40396
+
40397
+ ## AI를 '답변 기계'가 아닌 '사고 파트너'로
40398
+
40399
+ 가장 큰 기술적 난관은 AI 챗봇의 고질병인 '할루시네이션(거짓 답변)'이었습니다.
40400
+ 결제 연동 가이드에서 없는 함수를 있다고 하거나, 잘못된 파라미터를 알려주면 치명적이니까요.
40401
+
40402
+ 보통은 이를 해결하기 위해 RAG(검색 증강 생성)와 Vector DB를 사용하지만,
40403
+ 포트원 개발팀은 조금 다른 접근을 택했습니다.
40404
+
40405
+ ### Vector DB 없는 RAG? "MCP의 도입"
40406
+
40407
+ 초기 테스트 결과, 단순히 문서를 쪼개서 Vector DB에 넣고 검색하는 방식은 한계가 명확했습니다. 문맥이 잘린 채
40408
+ 검색되다 보니 AI가 엉뚱한 문서를 참고해서 답변하는 경우가 많았죠.
40409
+
40410
+ 그래서 우리는 MCP(Model Context Protocol) 개념을 적극적으로 도입했습니다.
40411
+
40412
+ 쉽게 말해, AI에게 미리 정답지(문서 조각)를 쥐여주는 게 아니라, "네가 모르는 게 있으면
40413
+ 우리 개발자 문서 도구(Tool)를 사용해서 직접 검색해 봐"라고 시키는 방식입니다. AI를 단순 답변기가 아니라,
40414
+ 문서를 검색하고 내용을 판단하는 '사고 파트너(Thinking Partner)'로 설계한 것이죠.
40415
+
40416
+ ### 비용과 성능의 줄타기 (Claude 4.0 Sonnet)
40417
+
40418
+ 모델 선정도 치열했습니다. 성능이 좋은 모델은 비싸고, 싼 모델은 답변 품질이 다소 낮습니다.
40419
+
40420
+ 비용 절감과 품질 사이에서 고민하다 결국 Claude 4.0 Sonnet을 채택했습니다. 저렴하지 않은 모델을 썼음에도 비용은
40421
+ 오히려 통제 가능했습니다.
40422
+
40423
+ - MCP 서버를 최적화하여 불필요한 토큰 소모를 줄였습니다.
40424
+ - 답변의 정확도가 올라가니, 사용자가 여러 번 다시 묻는 횟수가 줄어들어 전체적인 토큰 사용량은 합리적인 수준(하루 100건 사용 기준 월 $25\~30 내외)으로 유지되었습니다.
40425
+
40426
+ ### "기다림도 UX다"
40427
+
40428
+ (관련 이미지 첨부)
40429
+
40430
+ LLM의 답변 속도를 우리가 직접 획기적으로 줄이는 건 불가능했죠. 대신 이용자 입장에서의
40431
+ '체감 시간'을 줄이려고 했습니다.
40432
+ 단순히 로딩 바가 도는 게 아니라, "현재 개발자 문서를 검색하고 있습니다...", "관련 내용을 분석 중입니다..." 처럼
40433
+ AI가 현재 수행 중인 작업을 실시간으로 보여주었습니다. (Perplexity나 Gemini처럼요.) 이 작은 장치가 고객이
40434
+ 이탈하지 않고 답변을 기다리게 만드는 핵심 UX가 되었습니다.
40435
+
40436
+ ## AI 챗봇 도입 성과 : "CS 문의가 줄었습니다"
40437
+
40438
+ (관련 이미지 첨부)
40439
+
40440
+ 포트원 AI 챗봇 도입 3주 차, 변화는 데이터로 나타나고 있습니다.
40441
+
40442
+ 한지환 프로덕트 오너 : CS팀에서 먼저 피드백이 왔어요. "체감상 기술 문의가 확 줄었다"고요. 하루 평균 약 50\~100건
40443
+ 정도의 문의를 AI가 처리하고 있습니다. 도입 후 약 1,000건의 문의를 처리했죠. 특히 "API 키 어디서 찾나요?",
40444
+ "이 오류 코드는 뭔가요?" 같은 단순 문의는 AI 챗봇 선에서 대부분 해결됩니다.
40445
+
40446
+ 재미있는 건 개발자들의 반응입니다. "CS팀에서 넘어오는 기술 문의 난이도가 올라갔다"고 해요.
40447
+
40448
+ 전우제 엔지니어 : 예전엔 "뭐가 안 돼요"라는 단순한 질문이 왔다면, 이제는 AI를 통해 1차적인 해결을 시도해 본
40449
+ 고객들이 "AI 챗봇을 보고 여기까지 해봤는데, 이 부분에서 막힙니다"라고 구체적인 질문을 던집니다.
40450
+
40451
+ 비효율적인 핑퐁이 사라지고, 개발자와 CS팀 모두가 '진짜 해결해야 할 문제'에 집중할 수 있게 된 것입니다.
40452
+
40453
+ ## 포트원의 다음 미션 : "결제 연동, 클릭 한 번으로 해결"
40454
+
40455
+ 포트원 AI Assistant는 이제 시작입니다. 포트원은 '단순히 질문을 답변해주는 봇'을 넘어 '결제를 직접 연동하는
40456
+ 에이전트(Agent)'를 꿈꿉니다.
40457
+
40458
+ 한지환 프로덕트 오너 : 지금은 "PG 어떻게 연동해요?"라고 물으면 방법을 알려주죠. 하지만 포트원이 준비하는
40459
+ 다음 단계는 그 이상입니다. 고객의 깃허브(Github)를 AI가 분석하고, 프로젝트 환경에 맞는 결제 연동 코드를 직접
40460
+ 짜서 PR(Pull Request)까지 날려주는 단계. 이미 PoC(개념 검증)는 마쳤고 개발이 진행 중입니다.
40461
+
40462
+ 개발자가 더 이상 단순 반복 업무에 시달리지 않는 세상, 누구나 말 한마디로 결제를 연동하는 세상.
40463
+
40464
+ 포트원의 ‘AI를 활용한 결제 연동 경험 혁신’은 이제 막 본궤도에 올랐습니다.