@portone/mcp-server 0.15.0-alpha.5 → 0.16.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 (182) 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 +2 -13
  8. package/assets/docs/help/admin-console/pg-settlement-history/content35.md +2 -9
  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 +5 -5
  12. package/assets/docs/help/core-service/channel-setting/daou.md +5 -0
  13. package/assets/docs/help/core-service/channel-setting/galaxia.md +93 -0
  14. package/assets/docs/help/core-service/channel-setting/inicis.md +32 -49
  15. package/assets/docs/help/core-service/channel-setting/kcp_channel.md +60 -41
  16. package/assets/docs/help/core-service/channel-setting/kicc.md +57 -3
  17. package/assets/docs/help/core-service/channel-setting/kpn.md +3 -2
  18. package/assets/docs/help/core-service/channel-setting/mobilians.md +22 -27
  19. package/assets/docs/help/core-service/channel-setting/nice.md +8 -6
  20. package/assets/docs/help/core-service/channel-setting/payco.md +5 -3
  21. package/assets/docs/help/core-service/channel-setting/payletter.md +3 -3
  22. package/assets/docs/help/core-service/how-to-use/additional-galaxia.md +36 -0
  23. package/assets/docs/help/core-service/how-to-use/additional-mobilians.md +15 -21
  24. package/assets/docs/help/core-service/how-to-use/content200009.md +10 -9
  25. package/assets/docs/help/core-service/how-to-use/galaxia-contract.md +67 -0
  26. package/assets/docs/help/core-service/how-to-use/high-risk-industry.md +38 -46
  27. package/assets/docs/help/core-service/how-to-use/information-pg.md +3 -3
  28. package/assets/docs/help/core-service/how-to-use/kcp-contract.md +5 -1
  29. package/assets/docs/help/core-service/how-to-use/kicc-contract.md +38 -7
  30. package/assets/docs/help/core-service/how-to-use/mobilians-contract.md +26 -21
  31. package/assets/docs/help/core-service/how-to-use/requirements.md +5 -1
  32. package/assets/docs/help/core-service/how-to-use/shopify-guide.md +2 -2
  33. package/assets/docs/help/core-service/how-to-use/test-mode-cancel.md +6 -4
  34. package/assets/docs/help/core-service/how-to-use/wordpress-setting.md +2 -1
  35. package/assets/docs/help/core-service/payment-type/content200007.md +1 -1
  36. package/assets/docs/help/core-service/payment-type/content200047.md +28 -42
  37. package/assets/docs/help/core-service/payment-type/content200052.md +8 -1
  38. package/assets/docs/help/core-service/payment-type/hub-service-fee.md +1 -1
  39. package/assets/docs/help/core-service/payment-type/internationl-high-risk-industry.md +67 -26
  40. package/assets/docs/help/core-service/payment-type/internationl-pg.md +3 -1
  41. package/assets/docs/help/core-service/payment-type/schedule-requirement.md +1 -4
  42. package/assets/docs/help/faq/general-inquiry/confirm-process.md +5 -11
  43. package/assets/docs/help/faq/general-inquiry/portone-security.md +59 -0
  44. package/assets/docs/help/faq/general-inquiry/real-channel-info.md +1 -1
  45. package/assets/docs/help/faq/payment-faq/pg-max-min-amount.md +3 -3
  46. package/assets/docs/help/faq/payment-faq/vbank-service-detail.md +1 -1
  47. package/assets/docs/help/faq/payment-faq/vbank-test-guide.md +1 -8
  48. package/assets/docs/help/faq/platform-faq/platform_definition_partner.md +1 -1
  49. package/assets/docs/help/faq/platform-faq/platform_definition_settlement.md +1 -1
  50. package/assets/docs/help/faq/platform-faq/platform_definition_tax.md +24 -0
  51. package/assets/docs/help/faq/platform-faq/platform_introduction.md +1 -1
  52. package/assets/docs/help/faq/platform-faq/platform_introduction_conditions.md +19 -5
  53. package/assets/docs/help/faq/platform-faq/platform_nocode_hosting.md +1 -1
  54. package/assets/docs/help/faq/platform-faq/platform_nocode_use.md +1 -1
  55. package/assets/docs/help/faq/tax-invoice-faq/account_management_guide.md +37 -0
  56. package/assets/docs/help/faq/tax-invoice-faq/bulk_registration_account.md +16 -0
  57. package/assets/docs/help/faq/tax-invoice-faq/difference_account_partner.md +25 -0
  58. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/platform_partnerships.md +1 -1
  59. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_bulk_issuance.md +1 -1
  60. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_cancel.md +1 -1
  61. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_delayed.md +1 -1
  62. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_forward_issuance.md +1 -1
  63. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_guide_atoz.md +1 -1
  64. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_partner_peristalsis.md +1 -1
  65. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_reverse_issuance_definition.md +1 -1
  66. package/assets/docs/help/faq/{platform-faq → tax-invoice-faq}/taxinvoice_reverse_issuance_partner_signup.md +1 -1
  67. package/assets/docs/help/notice-tosspayments-2026-01-15.md +62 -0
  68. package/assets/docs/help/notice-vape-2026-02-19.md +52 -0
  69. package/assets/docs/help/platform-2025-07-23.md +76 -0
  70. package/assets/docs/help/platform-2025-08-13.md +92 -0
  71. package/assets/docs/help/platform-2025-08-21.md +51 -0
  72. package/assets/docs/help/platform-2025-08-28.md +51 -0
  73. package/assets/docs/help/platform-2025-10-02.md +90 -0
  74. package/assets/docs/help/pricing/pg/domestic-and-oversea-fees.md +4 -2
  75. package/assets/docs/help/pricing/portone/portone-pricing.md +3 -1
  76. package/assets/docs/help/procedure/pg-application/content54.md +2 -0
  77. package/assets/docs/help/procedure/pg-application/start.md +8 -24
  78. package/assets/docs/help/procedure/recommendation/package.md +4 -2
  79. package/assets/docs/help/procedure/service-addition/add-service.md +2 -0
  80. package/assets/docs/help/service/identity-verification/identity-verification.md +2 -4
  81. package/assets/docs/help/service/integration-type/integration-type.md +1 -2
  82. package/assets/docs/help/service/pg/pg-service-list.md +29 -6
  83. package/assets/docs/opi/ko/console/guide/reg.md +1 -1
  84. package/assets/docs/opi/ko/extra/confirm-process/readme-v1.md +5 -7
  85. package/assets/docs/opi/ko/extra/confirm-process/readme-v2.md +2 -2
  86. package/assets/docs/opi/ko/extra/identity-verification/readme-v2.md +1 -1
  87. package/assets/docs/opi/ko/extra/link-pay/readme-v1.md +36 -4
  88. package/assets/docs/opi/ko/extra/manual-confirm/readme-v2.md +1 -1
  89. package/assets/docs/opi/ko/extra/mobile-payment/readme-v2.md +610 -0
  90. package/assets/docs/opi/ko/extra/smart-routing/intro.md +1 -1
  91. package/assets/docs/opi/ko/integration/cancel/v1/virtual-account.md +4 -1
  92. package/assets/docs/opi/ko/integration/cancel/v2/readme.md +4 -1
  93. package/assets/docs/opi/ko/integration/pg/v1/blue.md +36 -0
  94. package/assets/docs/opi/ko/integration/pg/v1/danal.md +134 -4
  95. package/assets/docs/opi/ko/integration/pg/v1/daou/readme.md +203 -28
  96. package/assets/docs/opi/ko/integration/pg/v1/eximbay.md +121 -19
  97. package/assets/docs/opi/ko/integration/pg/v1/galaxia.md +591 -0
  98. package/assets/docs/opi/ko/integration/pg/v1/inicis-jp.md +517 -0
  99. package/assets/docs/opi/ko/integration/pg/v1/inicis.md +177 -0
  100. package/assets/docs/opi/ko/integration/pg/v1/kakaopay.md +145 -2
  101. package/assets/docs/opi/ko/integration/pg/v1/kcp-v2-identity-verification.md +2 -0
  102. package/assets/docs/opi/ko/integration/pg/v1/kg-mobilians-v2.md +29 -18
  103. package/assets/docs/opi/ko/integration/pg/v1/kg.md +65 -12
  104. package/assets/docs/opi/ko/integration/pg/v1/kicc-v2.md +275 -0
  105. package/assets/docs/opi/ko/integration/pg/v1/kicc.md +117 -4
  106. package/assets/docs/opi/ko/integration/pg/v1/ksnet/readme.md +22 -2
  107. package/assets/docs/opi/ko/integration/pg/v1/naver.md +60 -0
  108. package/assets/docs/opi/ko/integration/pg/v1/newtoss/readme.md +117 -7
  109. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/kcp-quickpay.md +24 -32
  110. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp/readme.md +164 -3
  111. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md +6 -6
  112. package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md +177 -2
  113. package/assets/docs/opi/ko/integration/pg/v1/nice.md +124 -5
  114. package/assets/docs/opi/ko/integration/pg/v1/payco.md +87 -3
  115. package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md +142 -1
  116. package/assets/docs/opi/ko/integration/pg/v1/paymentwall.md +45 -1
  117. package/assets/docs/opi/ko/integration/pg/v1/paypal.md +38 -2
  118. package/assets/docs/opi/ko/integration/pg/v1/readme.md +9 -3
  119. package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md +52 -16
  120. package/assets/docs/opi/ko/integration/pg/v1/settle/mybank.md +138 -56
  121. package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md +50 -0
  122. package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/readme.md +126 -0
  123. package/assets/docs/opi/ko/integration/pg/v1/smartro.md +78 -0
  124. package/assets/docs/opi/ko/integration/pg/v1/smilepay.md +49 -3
  125. package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md +96 -25
  126. package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/module.md +1 -1
  127. package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/readme.md +34 -2
  128. package/assets/docs/opi/ko/integration/pg/v1/toss.md +114 -1
  129. package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md +74 -15
  130. package/assets/docs/opi/ko/integration/pg/v1/tosspay.md +41 -1
  131. package/assets/docs/opi/ko/integration/pg/v1/welcome/readme.md +12 -0
  132. package/assets/docs/opi/ko/integration/pg/v2/galaxia.md +662 -0
  133. package/assets/docs/opi/ko/integration/pg/v2/inicis-jp.md +6 -18
  134. package/assets/docs/opi/ko/integration/pg/v2/inicis-unified-identity-verification.md +0 -4
  135. package/assets/docs/opi/ko/integration/pg/v2/inicis-v2.md +2 -2
  136. package/assets/docs/opi/ko/integration/pg/v2/kcp-v2-identity-verification.md +1 -1
  137. package/assets/docs/opi/ko/integration/pg/v2/kcp-v2.md +2 -2
  138. package/assets/docs/opi/ko/integration/pg/v2/kicc-v2.md +316 -0
  139. package/assets/docs/opi/ko/integration/pg/v2/kpn.md +3 -3
  140. package/assets/docs/opi/ko/integration/pg/v2/ksnet.md +8 -0
  141. package/assets/docs/opi/ko/integration/pg/v2/paymentwall.md +171 -0
  142. package/assets/docs/opi/ko/integration/pg/v2/readme.md +16 -0
  143. package/assets/docs/opi/ko/integration/pg/v2/smartro-v2.md +1 -1
  144. package/assets/docs/opi/ko/integration/pg/v2/triple-a.md +342 -0
  145. package/assets/docs/opi/ko/integration/pg/v2/welcome.md +1 -1
  146. package/assets/docs/opi/ko/integration/ready/readme.md +113 -164
  147. package/assets/docs/opi/ko/integration/start/v1/non-auth.md +1 -1
  148. package/assets/docs/opi/ko/integration/start/v2/checkout.md +59 -29
  149. package/assets/docs/opi/ko/integration/using-ai-tools.md +42 -0
  150. package/assets/docs/opi/ko/quick-guide/payment.md +5 -5
  151. package/assets/docs/opi/ko/readme.md +2 -2
  152. package/assets/docs/opi/ko/support/code-info/pg-2.md +2 -2
  153. package/assets/docs/opi/ko/support/code-info/pg-3.md +3 -3
  154. package/assets/docs/opi/ko/support/code-info/pg.md +1 -1
  155. package/assets/docs/platform/ko/guides/dictionary.md +47 -0
  156. package/assets/docs/release-notes/api-sdk/2023-07-03.md +3 -3
  157. package/assets/docs/release-notes/platform/2023-08-31.md +2 -2
  158. package/assets/docs/release-notes/platform/2024-08-22.md +5 -5
  159. package/assets/docs/release-notes/platform/2024-10-21.md +9 -9
  160. package/assets/docs/release-notes/platform/2025-02-10.md +2 -2
  161. package/assets/docs/release-notes/platform/2026-02-19.md +55 -0
  162. package/assets/docs/release-notes/platform/2026-03-06.md +198 -0
  163. package/assets/docs/schema/browser-sdk.yml +390 -11
  164. package/assets/docs/schema/v1.openapi.json +297 -72
  165. package/assets/docs/schema/v1.openapi.yml +228 -112
  166. package/assets/docs/schema/v2.openapi.json +16438 -21985
  167. package/assets/docs/schema/v2.openapi.yml +8669 -12670
  168. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrq.md +10 -2
  169. package/assets/docs/sdk/ko/v1-sdk/javascript-sdk/payrt.md +1 -1
  170. package/assets/docs/sdk/ko/v2-mobile-sdk/android.md +62 -24
  171. package/assets/docs/sdk/ko/v2-mobile-sdk/react-native.md +82 -95
  172. package/assets/docs/sdk/ko/v2-mobile-sdk/readme.md +5 -4
  173. package/assets/docs/v1-docs-full.md +5249 -753
  174. package/assets/docs/v2-docs-full.md +2855 -265
  175. package/assets/docs/website-links.md +18 -7
  176. package/manifest.json +1 -1
  177. package/package.json +12 -12
  178. package/server/index.js +12 -12
  179. package/assets/docs/opi/ko/integration/pg/v1/hyphen.md +0 -196
  180. package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md +0 -1152
  181. package/assets/docs/opi/ko/integration/pg/v2/hyphen.md +0 -205
  182. package/assets/docs/schema/browser-sdk.schema.json +0 -510
@@ -112,6 +112,7 @@ IMP.request_pay(
112
112
  - `phone` (휴대폰소액결제)
113
113
  - `cultureland` (컬쳐랜드 문화상품권)
114
114
  - `smartculture` (스마트문상)
115
+ - `happymoney` (해피머니 문화상품권)
115
116
  - `booknlife`(도서문화상품권)
116
117
 
117
118
  </details>
@@ -122,22 +123,93 @@ IMP.request_pay(
122
123
 
123
124
  매번 고유하게 채번되어야 합니다.
124
125
 
126
+ - name: string
127
+
128
+ **주문명**
129
+
125
130
  - amount: number
126
131
 
127
132
  **결제금액**
128
133
 
129
134
  **string** 이 아닌점에 유의하세요
130
135
 
136
+ - buyer\_name?: string
137
+
138
+ **구매자 이름**
139
+
140
+ - buyer\_email?: string
141
+
142
+ **구매자 이메일**
143
+
131
144
  - buyer\_tel: string
132
145
 
133
146
  **주문자연락처**
134
147
 
135
148
  필수 파라미터 입니다.
136
149
 
150
+ - buyer\_addr?: string
151
+
152
+ **구매자 주소**
153
+
154
+ - buyer\_postcode?: string
155
+
156
+ **구매자 우편번호**
157
+
158
+ - escrow?: boolean
159
+
160
+ **에스크로 결제 여부**
161
+
162
+ - tax\_free?: number
163
+
164
+ **면세금액**
165
+
137
166
  - vbank\_due?: string
138
167
 
139
168
  가상계좌 입금마감일시를 지정할수 있습니다.(미 지정시 Default 30일)
140
169
 
170
+ - m\_redirect\_url?: string
171
+
172
+ **모바일 결제 후 리디렉션 될 URL**
173
+
174
+ - app\_scheme?: string
175
+
176
+ **모바일 앱 URL scheme** (모바일 전용)
177
+
178
+ 모바일 앱에서 결제 시 ISP/앱카드 등에서 결제 완료 후 가맹점 앱으로 돌아올 때 사용됩니다.
179
+
180
+ - notice\_url?: string | string\[]
181
+
182
+ **웹훅 수신 URL**
183
+
184
+ 포트원 관리자 콘솔에 설정한 웹훅 URL 대신 사용할 URL을 지정합니다.
185
+
186
+ - confirm\_url?: string
187
+
188
+ **Confirm process URL**
189
+
190
+ - custom\_data?: object
191
+
192
+ **가맹점 커스텀 데이터**
193
+
194
+ 결제 정보와 함께 저장할 커스텀 데이터입니다. 결제 조회 시 반환됩니다.
195
+
196
+ - customer\_id?: string
197
+
198
+ **구매자 고유 ID**
199
+
200
+ - digital?: boolean
201
+
202
+ **디지털 컨텐츠 여부**
203
+
204
+ 휴대폰 소액결제 시 디지털 컨텐츠(`true`)인지 실물 상품(`false`)인지 구분합니다.
205
+
206
+ - language?: string
207
+
208
+ **결제창 언어**
209
+
210
+ - `ko`: 한국어 (기본값)
211
+ - `en`: 영어
212
+
141
213
  - period?: object
142
214
 
143
215
  고객이 구매하는 제품에 대한 제공기간을 명시합니다.
@@ -150,6 +222,58 @@ IMP.request_pay(
150
222
 
151
223
  **YYYYMMDD**
152
224
 
225
+ - bypass?: object
226
+
227
+ **KG이니시스 전용 파라미터**
228
+
229
+ PC와 모바일에서 사용하는 파라미터가 다릅니다.
230
+
231
+ - acceptmethod?: string
232
+
233
+ **PC 전용 옵션** (콜론 `:` 구분자로 여러 값 연결)
234
+
235
+ - `noeasypay`: 간편결제 버튼을 통합결제창에서 제외
236
+ - `CARDPOINT`: 카드사 포인트 사용
237
+ - `no_receipt`: 현금영수증 미발행
238
+ - `SKIN(색상)`: 결제창 배경색상 변경. 색상표 값으로 설정 가능 (예: `SKIN(BLUE)`). 미설정 시 기본값 `#c1272c`
239
+ - `cardshowopt(카드코드-호출옵션)`: 신용카드 ACS 창에서 앱카드/안심클릭/간편결제 UI 표시 옵션. 카드코드와 호출옵션은 `-`로 구분 (예: `cardshowopt(04-6)`)
240
+ - `disablepoint`: 현대카드 M포인트 강제 미사용
241
+ - `usespcp`: 현대카드 M포인트 사용
242
+ - `cd_ps(카드코드-할부개월)`: 신한카드 제휴 옵션 (배송비 혜택)
243
+
244
+ 예시: `"acceptmethod": "noeasypay:CARDPOINT:SKIN(BLUE)"`
245
+
246
+ - P\_RESERVED?: string
247
+
248
+ **모바일 전용 옵션** (`&` 구분자로 여러 값 연결)
249
+
250
+ - `noeasypay=Y`: 간편결제 버튼을 통합결제창에서 제외
251
+ - `cp_yn=Y`: 신용카드 포인트 사용
252
+ - `dcp_yn=Y`: 카드사 다이렉트 호출 시 카드 포인트 사용
253
+ - `vbank_receipt=Y`: 가상계좌 현금영수증 입력란 표시 (기본적으로 미표시)
254
+ - `bank_receipt=N`: 계좌이체 현금영수증 입력란 숨김 (기본적으로 표시)
255
+ - `twotrs_bank=Y`: 계좌이체 거래 시 필수 입력 값
256
+ - `apprun_check=Y`: 앱 호출 시 Intent 방식으로 호출 (Android 전용, `app_scheme`과 같이 사용 불가)
257
+ - `app_scheme=스키마명://`: 가맹점 앱 scheme 설정 (iOS 지원, ISP/뱅크월렛/은련카드/LPAY/페이코 등)
258
+ - `iosapp=Y`: iOS 앱에서 결제 시 설정
259
+ - `cardshowopt=카드코드:호출옵션`: 신용카드 ACS 창 표시 옵션
260
+
261
+ 예시: `"P_RESERVED": "noeasypay=Y&twotrs_bank=Y&apprun_check=Y"`
262
+
263
+ - ini\_PAYSHOT\_KEY?: string
264
+
265
+ **현대카드 Payshot 고객 Key** (PC 전용)
266
+
267
+ 현대카드 Payshot 사용 시 필수 입력합니다.
268
+ 형식: `{가맹점구분}{YYYYMMDDHHMMSSmsec}{고객id}`
269
+
270
+ - P\_PAYSHOT\_KEY?: string
271
+
272
+ **현대카드 Payshot 고객 Key** (모바일 전용)
273
+
274
+ 현대카드 Payshot 사용 시 필수 입력합니다.
275
+ 형식: `{가맹점구분}{YYYYMMDDHHMMSSmsec}{고객id}`
276
+
153
277
  </div>
154
278
 
155
279
  <div class="tabs-content" data-title="비인증 결제창 요청">
@@ -218,12 +342,65 @@ IMP.request_pay(
218
342
 
219
343
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
220
344
 
345
+ - merchant\_uid: string
346
+
347
+ **주문번호**
348
+
349
+ - name: string
350
+
351
+ **주문명**
352
+
221
353
  - amount: number
222
354
 
223
355
  **결제금액**
224
356
 
225
357
  결제창에 표시될 금액으로 실제 승인은 이루어지지 않습니다.(실 결제를 발생시키기 위해서는 **customer\_uid** 로 **REST API 를 이용하여 결제요청**을 해주셔야 합니다.)
226
358
 
359
+ - buyer\_name?: string
360
+
361
+ **구매자 이름**
362
+
363
+ - buyer\_email?: string
364
+
365
+ **구매자 이메일**
366
+
367
+ - buyer\_tel?: string
368
+
369
+ **구매자 연락처**
370
+
371
+ - m\_redirect\_url?: string
372
+
373
+ **모바일 결제 후 리디렉션 될 URL**
374
+
375
+ - app\_scheme?: string
376
+
377
+ **모바일 앱 URL scheme** (모바일 전용)
378
+
379
+ - notice\_url?: string | string\[]
380
+
381
+ **웹훅 수신 URL**
382
+
383
+ - custom\_data?: object
384
+
385
+ **가맹점 커스텀 데이터**
386
+
387
+ - customer\_id?: string
388
+
389
+ **구매자 고유 ID**
390
+
391
+ - bypass?: object
392
+
393
+ **빌링키 발급 전용 파라미터**
394
+
395
+ - inicis?: object
396
+
397
+ - authtype?: string
398
+
399
+ **빌링키 발급 결제창 표시 구분** (모바일 전용)
400
+
401
+ - `01`: 카드번호, 유효기간, 생일 입력 부분만 표시
402
+ - 미전달: 카드번호, 유효기간, 주민번호, 비밀번호 입력 부분 표시
403
+
227
404
  **빌링키(customer\_uid)로 결제 요청하기**
228
405
 
229
406
  빌링키 발급이 성공하면 실 빌링키는 customer\_uid 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. customer\_uid를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -86,12 +86,119 @@ IMP.request_pay(
86
86
 
87
87
  매번 고유하게 채번되어야 합니다.
88
88
 
89
+ - name: string
90
+
91
+ **주문명**
92
+
89
93
  - amount: number
90
94
 
91
95
  **결제금액**
92
96
 
93
97
  **string** 이 아닌점에 유의하세요
94
98
 
99
+ - buyer\_name?: string
100
+
101
+ **구매자 이름**
102
+
103
+ - buyer\_email?: string
104
+
105
+ **구매자 이메일**
106
+
107
+ - buyer\_tel?: string
108
+
109
+ **구매자 연락처**
110
+
111
+ - buyer\_addr?: string
112
+
113
+ **구매자 주소**
114
+
115
+ - buyer\_postcode?: string
116
+
117
+ **구매자 우편번호**
118
+
119
+ - tax\_free?: number
120
+
121
+ **면세금액**
122
+
123
+ - m\_redirect\_url?: string
124
+
125
+ **모바일 결제 후 리디렉션 될 URL**
126
+
127
+ - app\_scheme?: string
128
+
129
+ **모바일 앱 URL scheme** (모바일 전용, iOS만 지원)
130
+
131
+ 카카오페이 정책에 따라 iOS에서만 사용 가능합니다.
132
+
133
+ - notice\_url?: string | string\[]
134
+
135
+ **웹훅 수신 URL**
136
+
137
+ - confirm\_url?: string
138
+
139
+ **Confirm process URL**
140
+
141
+ - custom\_data?: object
142
+
143
+ **가맹점 커스텀 데이터**
144
+
145
+ - customer\_id?: string
146
+
147
+ **구매자 고유 ID**
148
+
149
+ - display?: object
150
+
151
+ **카드 할부 설정**
152
+
153
+ - card\_quota?: number\[]
154
+
155
+ **할부 개월수**
156
+
157
+ 단일 값만 지정 가능합니다. 지정 시 해당 개월수로 고정됩니다.
158
+
159
+ - card?: object
160
+
161
+ **카드 필터링**
162
+
163
+ - detail?: object\[]
164
+
165
+ **사용 가능한 카드사 목록**
166
+
167
+ - card\_code?: string
168
+
169
+ **카드사 코드**
170
+
171
+ - enabled?: boolean
172
+
173
+ **활성화 여부**
174
+
175
+ - kakaopayMobileAsPC?: boolean
176
+
177
+ **모바일에서 PC URL 사용 여부** (모바일 전용)
178
+
179
+ `true` 설정 시 모바일 환경에서 PC용 결제 URL을 사용합니다.
180
+
181
+ - bypass?: object
182
+
183
+ **PG사 전용 파라미터**
184
+
185
+ - kakaopay?: object
186
+
187
+ **카카오페이 전용 파라미터**
188
+
189
+ - payment\_method\_type?: string
190
+
191
+ **사용 허용할 결제수단 지정**
192
+
193
+ - `CARD`: 카드결제만 허용
194
+ - `MONEY`: 포인트결제만 허용
195
+
196
+ 미입력 시 사용 가능한 전체 결제수단 허용
197
+
198
+ - custom\_message?: string
199
+
200
+ **카카오페이 결제 UI에 표시되는 커스텀 메시지**
201
+
95
202
  </div>
96
203
 
97
204
  <div class="tabs-content" data-title="정기결제창 요청">
@@ -163,6 +270,14 @@ IMP.request_pay(
163
270
 
164
271
  비 인증 결제창에서 고객이 입력한 카드정보와 1:1로 매칭될 빌링키를 지정합니다.
165
272
 
273
+ - merchant\_uid: string
274
+
275
+ **주문번호**
276
+
277
+ - name: string
278
+
279
+ **주문명**
280
+
166
281
  - amount: number
167
282
 
168
283
  **결제금액**
@@ -171,6 +286,34 @@ IMP.request_pay(
171
286
 
172
287
  (실 결제를 원하지 않은 경우 amount 금액을 0원으로 설정합니다.)
173
288
 
289
+ - buyer\_name?: string
290
+
291
+ **구매자 이름**
292
+
293
+ - buyer\_email?: string
294
+
295
+ **구매자 이메일**
296
+
297
+ - buyer\_tel?: string
298
+
299
+ **구매자 연락처**
300
+
301
+ - m\_redirect\_url?: string
302
+
303
+ **모바일 결제 후 리디렉션 될 URL**
304
+
305
+ - notice\_url?: string | string\[]
306
+
307
+ **웹훅 수신 URL**
308
+
309
+ - custom\_data?: object
310
+
311
+ **가맹점 커스텀 데이터**
312
+
313
+ - customer\_id?: string
314
+
315
+ **구매자 고유 ID**
316
+
174
317
  **빌링키(customer\_uid)로 결제 요청하기**
175
318
 
176
319
  빌링키 발급이 성공하면 실 빌링키는 customer\_uid 와 1:1 매칭되어 **포트원 서버에 저장**됩니다. customer\_uid를 고객사 내부서버에 저장하시고 [**비 인증 결제요청 REST API**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)를 호출하시면 결제를 발생시킬 수 있습니다.
@@ -189,9 +332,9 @@ curl -H "Content-Type: application/json" \
189
332
 
190
333
  <details>
191
334
 
192
- <summary> 부가세 지정 미지원</summary>
335
+ <summary> 부가세(`vat_amount`) 지정 미지원</summary>
193
336
 
194
- - 카카오페이 결제 시 부가세 지정은 지원하지 않습니다.
337
+ - 카카오페이 결제 시 `vat_amount`(부가세) 직접 지정은 지원하지 않습니다. `tax_free`(면세금액)는 지원됩니다.
195
338
  - 카카오페이 결제 취소 시 부가세 지정은 지원하지 않습니다.
196
339
 
197
340
  </details>
@@ -121,6 +121,8 @@ const data = await response.json();
121
121
 
122
122
  본인인증을 식별하기 위한 고객사의 주문 고유 번호로 매번 고유하게 채번되어야 합니다.
123
123
 
124
+ 영어 대소문자와 숫자만 사용 가능하며 40자 이하로 입력해야 합니다.
125
+
124
126
  - bypass.kcpV2.web\_siteid: string
125
127
 
126
128
  **KCP 사이트 식별코드**
@@ -1,11 +1,11 @@
1
1
  ---
2
- title: KG모빌리언스 (신모듈)
3
- description: KG모빌리언스 (신모듈) 결제 연동 방법을 안내합니다.
2
+ title: KG파이낸셜 (신모듈)
3
+ description: KG파이낸셜 (신모듈) 결제 연동 방법을 안내합니다.
4
4
  targetVersions:
5
5
  - v1
6
6
  ---
7
7
 
8
- ## 1. KG모빌리언스 채널 설정하기
8
+ ## 1. KG파이낸셜 채널 설정하기
9
9
 
10
10
  [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
11
11
 
@@ -14,7 +14,7 @@ targetVersions:
14
14
  ## 2. 결제 요청하기
15
15
 
16
16
  [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
17
- KG 모빌리언스 결제창을 호출할 수 있습니다.
17
+ KG파이낸셜 결제창을 호출할 수 있습니다.
18
18
  **결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후 **callback** 으로 수신되고
19
19
  모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
20
20
 
@@ -178,7 +178,7 @@ IMP.request_pay(
178
178
 
179
179
  **카드 포인트 사용 여부 (일반 카드 결제시 사용가능)**
180
180
 
181
- 모빌리언스 서비스 ID에 포인트 사용 설정 필요
181
+ KG파이낸셜 서비스 ID에 포인트 사용 설정 필요
182
182
 
183
183
  - card?: object
184
184
 
@@ -202,7 +202,7 @@ IMP.request_pay(
202
202
 
203
203
  **카드사 다이렉트 호출 시 적용할 카드 포인트 사용 여부**
204
204
 
205
- 모빌리언스 서비스 ID에 포인트 사용 설정 필요
205
+ KG파이낸셜 서비스 ID에 포인트 사용 설정 필요
206
206
 
207
207
  기본값: 사용자 선택
208
208
 
@@ -265,7 +265,7 @@ IMP.request_pay(
265
265
 
266
266
  - mobilians\_v2?: object
267
267
 
268
- **모빌리언스 전용 파라미터**
268
+ **KG파이낸셜 전용 파라미터**
269
269
 
270
270
  - cp\_logo?: string
271
271
 
@@ -276,7 +276,7 @@ IMP.request_pay(
276
276
 
277
277
  기본값: `N`
278
278
 
279
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
279
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
280
280
 
281
281
  <div class="hint" data-style="info">
282
282
 
@@ -427,7 +427,7 @@ IMP.request_pay(
427
427
 
428
428
  기본값: `N`
429
429
 
430
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
430
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
431
431
 
432
432
  - EMAIL\_HIDDEN?: string
433
433
 
@@ -550,7 +550,7 @@ IMP.request_pay(
550
550
 
551
551
  - mobilians\_v2?: object
552
552
 
553
- **모빌리언스 전용 파라미터**
553
+ **KG파이낸셜 전용 파라미터**
554
554
 
555
555
  - cp\_logo?: string
556
556
 
@@ -560,7 +560,7 @@ IMP.request_pay(
560
560
  - `N`: 미표기
561
561
 
562
562
  기본값: `N`
563
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
563
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
564
564
 
565
565
  - css\_type?: string
566
566
 
@@ -735,7 +735,7 @@ IMP.request_pay(
735
735
 
736
736
  - mobilians\_v2?: object
737
737
 
738
- **모빌리언스 전용 파라미터**
738
+ **KG파이낸셜 전용 파라미터**
739
739
 
740
740
  - cp\_logo?: string
741
741
 
@@ -745,7 +745,7 @@ IMP.request_pay(
745
745
  - `N`: 미표기
746
746
 
747
747
  기본값: `N`
748
- 사전에 모빌리언스 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
748
+ 사전에 KG파이낸셜 측과 협의된 로고가 등록되어있는 경우 사용 가능합니다.
749
749
 
750
750
  - css\_type?: string
751
751
 
@@ -798,7 +798,7 @@ IMP.request_pay(
798
798
 
799
799
  <summary>매출전표 미지원</summary>
800
800
 
801
- - 모빌리언스 결제는 매출전표를 제공하지 않습니다.
801
+ - KG파이낸셜 결제는 매출전표를 제공하지 않습니다.
802
802
 
803
803
  </details>
804
804
 
@@ -831,11 +831,11 @@ IMP.request_pay(
831
831
 
832
832
  <summary>결제 취소 시 과세 처리</summary>
833
833
 
834
- - **과세**: 입력한 부가세와 상관없이 모빌리언스에서 자동 계산된 부가세 기준으로 처리됩니다.
834
+ - **과세**: 입력한 부가세와 상관없이 KG파이낸셜에서 자동 계산된 부가세 기준으로 처리됩니다.
835
835
 
836
836
  - **복합 과세**:
837
837
  - 첫번째 취소: 입력한 면세액, 부가세액 기준으로 처리됨
838
- - 두번째(마지막) 취소: 입력한 면세액, 부가세액과 상관없이 모빌리언스에서 자동 계산된 나머지 금액을 취소함
838
+ - 두번째(마지막) 취소: 입력한 면세액, 부가세액과 상관없이 KG파이낸셜에서 자동 계산된 나머지 금액을 취소함
839
839
 
840
840
  </details>
841
841
 
@@ -852,7 +852,7 @@ IMP.request_pay(
852
852
  <summary>면세액(`tax_free`), 부가세(`vat`) 파라미터 사용 관련</summary>
853
853
 
854
854
  카드, 간편결제에서만 면세액(`tax_free`), 부가세(`vat`) 파라미터를 사용할 수 있습니다.
855
- 면세액과 부가세 파라미터 사용 시 올바르게 계산된 금액을 입력해야 합니다. 그렇지 않으면 결제가 실패하거나 모빌리언스 측에서 계산된 금액이 적용되어 의도하지 않은 면세액, 부가세 정보로 거래가 발생할 수 있습니다.
855
+ 면세액과 부가세 파라미터 사용 시 올바르게 계산된 금액을 입력해야 합니다. 그렇지 않으면 결제가 실패하거나 KG파이낸셜 측에서 계산된 금액이 적용되어 의도하지 않은 면세액, 부가세 정보로 거래가 발생할 수 있습니다.
856
856
 
857
857
  </details>
858
858
 
@@ -866,9 +866,20 @@ IMP.request_pay(
866
866
 
867
867
  <details>
868
868
 
869
+ <summary>가상계좌 환불 처리</summary>
870
+
871
+ KG파이낸셜 가상계좌 환불은 **매주 목요일 일괄 입금** 처리됩니다.
872
+
873
+ - **화요일까지 접수된 요청**: 같은 주 목요일 입금
874
+ - **수요일부터 접수된 요청**: 다음 주 목요일 입금
875
+
876
+ </details>
877
+
878
+ <details>
879
+
869
880
  <summary>모바일 환경 이슈</summary>
870
881
 
871
- - 아이폰 모바일 환경에서 크롬이나 인앱 브라우저에서 계좌이체를 하면 뱅크페이에서 결제 완료 후 **사파리로 이동하는 이슈**가 있습니다. (모빌리언스 수정 예정)
882
+ - 아이폰 모바일 환경에서 크롬이나 인앱 브라우저에서 계좌이체를 하면 뱅크페이에서 결제 완료 후 **사파리로 이동하는 이슈**가 있습니다. (KG파이낸셜 수정 예정)
872
883
  - 팝업을 사용할 수 없는 웹뷰 환경에서는 **애플페이 결제 불가**합니다.
873
884
 
874
885
  </details>
@@ -1,11 +1,11 @@
1
1
  ---
2
- title: KG모빌리언스 (구모듈)
3
- description: KG모빌리언스 (구모듈) 결제 연동 방법을 안내합니다.
2
+ title: KG파이낸셜 (구모듈)
3
+ description: KG파이낸셜 (구모듈) 결제 연동 방법을 안내합니다.
4
4
  targetVersions:
5
5
  - v1
6
6
  ---
7
7
 
8
- ## 1. KG모빌리언스 채널 설정하기
8
+ ## 1. KG파이낸셜 채널 설정하기
9
9
 
10
10
  [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
11
11
 
@@ -14,7 +14,7 @@ targetVersions:
14
14
  ## 2. 결제 요청하기
15
15
 
16
16
  [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
17
- KG 모빌리언스 결제창을 호출할 수 있습니다.
17
+ KG파이낸셜 결제창을 호출할 수 있습니다.
18
18
  **결제 결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
19
19
  **callback** 으로 수신되고
20
20
  모바일의 경우 **m\_redirect\_url**로 리디렉션됩니다.
@@ -69,11 +69,10 @@ IMP.request_pay(
69
69
 
70
70
  - pay\_method: string
71
71
 
72
- **결제수단 구분 코드**}
72
+ **결제수단 구분코드**
73
73
 
74
- - card (신용카드)
75
-
76
- - phone (휴대폰 소액 결제)
74
+ - card (신용카드)
75
+ - phone (휴대폰 소액결제)
77
76
 
78
77
  - merchant\_uid: string
79
78
 
@@ -81,12 +80,66 @@ IMP.request_pay(
81
80
 
82
81
  매번 고유하게 채번되어야 합니다.
83
82
 
83
+ - name: string
84
+
85
+ **주문명**
86
+
84
87
  - amount: number
85
88
 
86
89
  **결제금액**
87
90
 
88
91
  **string** 이 아닌점에 유의하세요
89
92
 
93
+ - buyer\_name?: string
94
+
95
+ **구매자 이름**
96
+
97
+ - buyer\_email?: string
98
+
99
+ **구매자 이메일**
100
+
101
+ - buyer\_tel?: string
102
+
103
+ **구매자 연락처**
104
+
105
+ - buyer\_addr?: string
106
+
107
+ **구매자 주소**
108
+
109
+ - buyer\_postcode?: string
110
+
111
+ **구매자 우편번호**
112
+
113
+ - vbank\_due?: string
114
+
115
+ **가상계좌 입금마감일시**
116
+
117
+ `YYYYMMDD` 형식으로 지정합니다. 미지정 시 5일 후로 자동 설정됩니다.
118
+
119
+ - m\_redirect\_url?: string
120
+
121
+ **모바일 결제 후 리디렉션 될 URL**
122
+
123
+ - app\_scheme?: string
124
+
125
+ **모바일 앱 URL scheme**
126
+
127
+ - notice\_url?: string | string\[]
128
+
129
+ **웹훅 수신 URL**
130
+
131
+ - confirm\_url?: string
132
+
133
+ **Confirm process URL**
134
+
135
+ - custom\_data?: object
136
+
137
+ **가맹점 커스텀 데이터**
138
+
139
+ - customer\_id?: string
140
+
141
+ **구매자 고유 ID**
142
+
90
143
  인증결제창 호출 파라미터에서 **customer\_uid** 값을 추가하면 비 인증 결제창을 호출할 수 있습니다. 비
91
144
  인증 결제창에서 빌링키를 발급받은 후 해당 빌링키로 결제를 요청합니다.
92
145
 
@@ -116,8 +169,8 @@ IMP.request_pay(
116
169
 
117
170
  <div class="hint" data-style="info">
118
171
 
119
- - 비 인증 결제를 위해서는 **KG모빌리언스와 계약이 완료된 MID 정보를** 관리자콘솔에 설정하셔야 비 인증 결제창을 활성화시킬 수 있습니다.
120
- - **KG모빌리언스 휴대폰 결제는** 빌링키 발급시 **실 결제가 발생됩니다.**
172
+ - 비 인증 결제를 위해서는 **KG파이낸셜과 계약이 완료된 MID 정보를** 관리자콘솔에 설정하셔야 비 인증 결제창을 활성화시킬 수 있습니다.
173
+ - **KG파이낸셜 휴대폰 결제는** 빌링키 발급시 **실 결제가 발생됩니다.**
121
174
  - 최초 승인일자 기준 매월 **동일한 일자에 동일 금액**이 재결제되어야 합니다.
122
175
 
123
176
  </div>
@@ -138,7 +191,7 @@ IMP.request_pay(
138
191
 
139
192
  **PG사 구분코드**
140
193
 
141
- **`mobilians.<KG모빌리언스와 계약이 완료된 MID>`** 로 지정하면 됩니다.
194
+ **`mobilians.<KG파이낸셜과 계약이 완료된 MID>`** 로 지정하면 됩니다.
142
195
 
143
196
  <div class="hint" data-style="warning">
144
197
 
@@ -174,4 +227,4 @@ curl -H "Content-Type: application/json" \
174
227
  https://api.iamport.kr/subscribe/payments/again
175
228
  ```
176
229
 
177
- **포트원을 통해 KG 모빌리언스를 사용할 때에는 API 방식 비 인증 결제를 사용할 수 없습니다.**
230
+ **포트원을 통해 KG파이낸셜을 사용할 때에는 API 방식 비 인증 결제를 사용할 수 없습니다.**