@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
@@ -0,0 +1,341 @@
1
+ ---
2
+ title: Triple-A
3
+ description: Triple-A 결제 연동 방법을 안내합니다.
4
+ targetVersions:
5
+ - v2
6
+ ---
7
+
8
+ ## 채널 설정하기
9
+
10
+ - [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
11
+
12
+ ## SDK 결제 요청하기
13
+
14
+ 결제 요청 시에는 `requestPayment` 함수를 호출해야 합니다. `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키를 지정하여 Triple-A 채널 사용을 명시해주세요.
15
+
16
+ <div class="tabs-container">
17
+
18
+ <div class="tabs-content" data-title="SDK 결제 요청">
19
+
20
+ ```javascript
21
+ import * as PortOne from "@portone/browser-sdk/v2";
22
+ PortOne.requestPayment({
23
+ storeId: "store-4ff4af41-85e3-4559-8eb8-0d08a2c6ceec", // 고객사 storeId로 변경해주세요.
24
+ channelKey: "channel-key-9987cb87-6458-4888-b94e-68d9a2da896d", // 콘솔 결제 연동 화면에서 채널 연동 시 생성된 채널 키를 입력해주세요.
25
+ paymentId: `payment${crypto.randomUUID()}`,
26
+ orderName: "PortOne Purchase",
27
+ totalAmount: 100, // 1 USD
28
+ currency: "USD",
29
+ customer: {
30
+ fullName: "PortOne",
31
+ email: "test@example.com",
32
+ },
33
+ });
34
+ ```
35
+
36
+ </div>
37
+
38
+ </div>
39
+
40
+ ### 사용 가능 파라미터
41
+
42
+ - storeId: string
43
+
44
+ **상점 아이디**
45
+
46
+ - paymentId: string
47
+
48
+ **고객사 주문 고유 번호**
49
+
50
+ - 고객사가 채번하는 주문 고유 번호입니다.
51
+ - 이미 승인된 `paymentId`로 결제를 시도하는 경우 에러가 발생합니다.
52
+
53
+ - orderName: string
54
+
55
+ **주문명**
56
+
57
+ Triple-A로 전달되지 않으며 포트원 결제 내역 확인 시에만 사용됩니다.
58
+
59
+ - channelKey: string
60
+
61
+ **채널 키**
62
+
63
+ Triple-A 채널의 채널키를 입력합니다.
64
+
65
+ - totalAmount: number
66
+
67
+ **결제 금액**
68
+
69
+ 결제 금액을 정수로 나타냅니다.
70
+
71
+ 해외 통화의 경우 통화의 최소 단위(minor unit)를 기준으로 합니다. 예를 들어, USD의 최소 단위는 센트(0.01 USD)이므로, 6 USD의 경우 100배하여 600으로 입력합니다.
72
+
73
+ 최소 단위는 [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)에 표준화된 것을 기준으로 합니다.
74
+
75
+ - KRW: 1배
76
+ - USD: 100배
77
+ - JPY: 1배
78
+
79
+ - currency: string
80
+
81
+ **결제 통화 코드**
82
+
83
+ - ISO 4217 통화 코드
84
+ - [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217)
85
+
86
+ - locale?: Locale
87
+
88
+ **결제창 언어**
89
+
90
+ - `EN_US`: 영어
91
+ - `ZH_CN`: 중국어 (중국 본토)
92
+ - `JA_JP`: 일본어
93
+ - `RU_RU`: 러시아어
94
+ - `VI_VN`: 베트남어
95
+ - `ID_ID`: 인도네시아어
96
+ - `FR_FR`: 프랑스어
97
+ - `NL_NL`: 네덜란드어
98
+ - `ES_ES`: 스페인어
99
+ - `PT_PT`: 포르투갈어
100
+ - `DE_DE`: 독일어
101
+ - `IT_IT`: 이탈리아어
102
+ - `PL_PL`: 폴란드어
103
+ - `AR_001`: 현대 표준 아랍어
104
+
105
+ - customer?: object
106
+
107
+ **고객 정보**
108
+
109
+ - customerId?: string
110
+
111
+ **구매자 ID**
112
+
113
+ 구매자를 식별하는 고유한 값으로, 값이 없으면 포트원에서 자동으로 생성합니다.
114
+
115
+ - fullName?: string
116
+
117
+ **구매자 전체 이름**
118
+
119
+ `fullName`이 없고 `firstName`과 `lastName`이 있는 경우 `${lastName} ${firstName}`이 대신 사용됩니다.
120
+
121
+ - firstName?: string
122
+
123
+ **구매자 이름**
124
+
125
+ `firstName`을 입력하는 경우 `lastName`도 필수로 입력해야 합니다. `fullName`이 없고,
126
+ `firstName`과 `lastName`이 존재하는 경우 `{firstName} {lastName}`으로 저장됩니다.
127
+
128
+ - lastName?: string
129
+
130
+ **구매자 성**
131
+
132
+ `lastName`을 입력하는 경우 `firstName`도 필수로 입력해야 합니다.
133
+
134
+ - phoneNumber?: string
135
+
136
+ **구매자 휴대전화 번호**
137
+
138
+ `+6591234567`과 같이 `+(국가코드)`로 시작하는 [E.164](https://www.itu.int/rec/T-REC-E.164/) 형식의 전화번호를 입력합니다.
139
+
140
+ - email?: string
141
+
142
+ **구매자 이메일 주소**
143
+
144
+ - products?: object\[]
145
+
146
+ **구매 상품 정보**
147
+
148
+ 입력 시 결제창에 상품 정보가 표시됩니다.
149
+
150
+ - id: string
151
+
152
+ **상품 ID**
153
+
154
+ - name: string
155
+
156
+ **상품명**
157
+
158
+ - amount: number
159
+
160
+ **상품 단위 가격**
161
+
162
+ 상품의 단위당 가격을 정수로 나타냅니다.
163
+
164
+ 해외 통화의 경우 통화의 최소 단위(minor unit)를 기준으로 합니다. 예를 들어, USD의 최소 단위는 센트(0.01 USD)이므로, 6 USD의 경우 100배하여 600으로 입력합니다.
165
+
166
+ 최소 단위는 [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)에 표준화된 것을 기준으로 합니다.
167
+
168
+ - KRW: 1배
169
+ - USD: 100배
170
+ - JPY: 1배
171
+
172
+ - quantity: number
173
+
174
+ **상품 수량**
175
+
176
+ - bypass?: oneof object
177
+
178
+ - triple\_a?: object
179
+
180
+ **Triple-A 특수 파라미터**
181
+
182
+ - payer\_poi?: string
183
+
184
+ **결제자 신원 증명 정보**
185
+
186
+ 신분증, 여권 등 결제자의 신원을 증명할 수 있는 자료의 URL을 입력합니다.
187
+
188
+ SGD 1500 이상의 결제 등 결제자 신원 조회가 필요한 경우에, `payer_poi`를 입력하면 별도의 신원 요청 과정을 거치지 않고 결제가 진행됩니다.
189
+
190
+ - shipping\_cost?: number
191
+
192
+ **배송비**
193
+
194
+ 결제창에 표시할 배송비를 정수로 나타냅니다.
195
+ `products`가 지정된 경우에만 사용할 수 있습니다.
196
+
197
+ 해외 통화의 경우 통화의 최소 단위(minor unit)를 기준으로 합니다. 예를 들어, USD의 최소 단위는 센트(0.01 USD)이므로, 6 USD의 경우 100배하여 600으로 입력합니다.
198
+
199
+ 최소 단위는 [ISO 4217](https://www.iso.org/iso-4217-currency-codes.html)에 표준화된 것을 기준으로 합니다.
200
+
201
+ - KRW: 1배
202
+ - USD: 100배
203
+ - JPY: 1배
204
+
205
+ - shipping\_discount?: number
206
+
207
+ **배송비 할인 금액**
208
+
209
+ 결제창에 표시할 배송비 할인 금액을 정수로 나타냅니다.
210
+ `products`가 지정된 경우에만 사용할 수 있습니다.
211
+
212
+ - tax\_cost?: number
213
+
214
+ **세금**
215
+
216
+ 결제창에 표시할 세금을 정수로 나타냅니다.
217
+ `products`가 지정된 경우에만 사용할 수 있습니다.
218
+
219
+ ## API 결제 취소 요청하기
220
+
221
+ 암호화폐 결제의 경우 결제 취소를 위해서는 환불받을 지갑 주소를 입력받아야 합니다.
222
+
223
+ API로 취소 요청 시, 구매자의 이메일 주소를 전달하면 해당 메일을 통해 지갑 주소 입력 및 환불 절차가 진행됩니다.
224
+
225
+ 결제 취소 요청을 구매자가 확인하고 지갑 주소를 입력하는 시점에 환불 금액이 확정됩니다.
226
+ 환불 금액은 결제 요청 금액을 환불 시점에 암호화폐로 환산한 금액입니다.
227
+ 환불 금액이 확정된 이후 입력한 지갑 주소로 환불이 진행됩니다.
228
+
229
+ <div class="tabs-container">
230
+
231
+ <div class="tabs-content" data-title="API 결제 취소">
232
+
233
+ ```ts
234
+ const response = await fetch(
235
+ `https://api.portone.io/payments/${paymentId}/cancel`,
236
+ {
237
+ method: "POST",
238
+ headers: {
239
+ Authorization: `PortOne ${PORTONE_API_SECRET}`,
240
+ "Content-Type": "application/json",
241
+ },
242
+ body: JSON.stringify({
243
+ reason: "단순 변심 전체 취소",
244
+ refundEmail: "buyer@example.com",
245
+ }),
246
+ },
247
+ );
248
+
249
+ const {
250
+ cancellation: { id },
251
+ } = await response.json(); // id: 취소 요청 아이디
252
+ ```
253
+
254
+ </div>
255
+
256
+ </div>
257
+
258
+ ### 사용 가능 파라미터
259
+
260
+ - paymentId: string
261
+
262
+ **고객사 주문 고유 번호**
263
+
264
+ - 결제 요청 시에 사용한 `paymentId`를 입력합니다.
265
+
266
+ - storeId?: string
267
+
268
+ **상점 아이디**
269
+
270
+ 하위 상점의 결제를 취소할 경우 필수로 입력합니다.
271
+
272
+ - amount?: number
273
+
274
+ 취소 총 금액
275
+
276
+ 값을 입력하지 않으면 전액 취소됩니다.
277
+
278
+ - currentCancellableAmount?: number
279
+
280
+ **결제 건의 취소 가능 잔액**
281
+
282
+ 본 취소 요청 이전의 취소 가능 잔액으로써, 값을 입력하면 잔액이 일치하는 경우에만 취소가 진행됩니다.
283
+ 값을 입력하지 않으면 별도의 검증 처리를 수행하지 않습니다.
284
+
285
+ - refundEmail: string
286
+
287
+ **환불 이메일**
288
+
289
+ Triple-A 결제 환불에 필요합니다. 해당 이메일로 환불 안내가 발송됩니다.
290
+
291
+ - reason: string
292
+
293
+ **취소 사유**
294
+
295
+ - skipWebhook?: boolean
296
+
297
+ **웹훅 생략 여부**
298
+
299
+ 취소가 성공했을 때 웹훅을 전송하지 않으려면 `true`로 설정합니다.
300
+
301
+ ## API 결제 취소 요청 취소
302
+
303
+ 결제 취소를 요청했을 때, 구매자가 아직 지갑 주소를 입력하지 않았다면 취소 요청을 취소할 수 있습니다.
304
+
305
+ 결제 취소 요청 결과로 획득한 `cancellation.id` 값을 사용하여 요청합니다.
306
+
307
+ <div class="tabs-container">
308
+
309
+ <div class="tabs-content" data-title="API 결제 취소 요청 취소">
310
+
311
+ ```ts
312
+ const response = await fetch(
313
+ `https://api.portone.io/payments/${paymentId}/cancellations/${cancellationId}/stop`,
314
+ {
315
+ method: "POST",
316
+ headers: { Authorization: `PortOne ${PORTONE_API_SECRET}` },
317
+ },
318
+ );
319
+ ```
320
+
321
+ </div>
322
+
323
+ </div>
324
+
325
+ ### 사용 가능 파라미터
326
+
327
+ - paymentId: string
328
+
329
+ **고객사 주문 고유 번호**
330
+
331
+ - 결제 요청 시에 사용한 `paymentId`를 입력합니다.
332
+
333
+ - cancellationId: string
334
+
335
+ **취소 요청 아이디**
336
+
337
+ - storeId?: string
338
+
339
+ **상점 아이디**
340
+
341
+ 하위 상점의 취소 요청인 경우 필수로 입력합니다.
@@ -942,7 +942,7 @@ const issueResponse = await axios({
942
942
  **발급 은행**
943
943
 
944
944
  - 은행코드는 ENUM으로 정의되어 있습니다.
945
- - [BANK ENUM 바로가기](https://developers.portone.io/api/rest-v2/type-def#Bank)
945
+ - [BANK ENUM 바로가기](https://developers.portone.io/api/rest-v2/payment#Bank)
946
946
 
947
947
  - expiry: object
948
948
 
@@ -132,6 +132,21 @@ targetVersions:
132
132
 
133
133
  <details>
134
134
 
135
+ <summary>갤럭시아머니트리</summary>
136
+
137
+ 1. [갤럭시아머니트리 가맹점 관리자](https://cpadmin.billgate.net) 접속 후 로그인을 합니다.
138
+ 2. \[기술지원]→\[암호화 정보 확인]을 클릭합니다.
139
+ 3. \[상용서버] 또는 \[테스트서버]를 선택합니다.
140
+ 4. MID, KEY, IV 값을 확인할 수 있습니다.
141
+
142
+ (이미지 첨부: 갤럭시아머니트리 BillGate 내 암호화 정보 확인 화면)
143
+
144
+ 5. 포트원 콘솔에서 채널 추가 시 \[MID], \[KEY], \[IV]를 입력한 후 `저장`을 클릭합니다.
145
+
146
+ </details>
147
+
148
+ <details>
149
+
135
150
  <summary>나이스정보통신</summary>
136
151
 
137
152
  <div class="hint" data-style="info">
@@ -300,6 +315,8 @@ targetVersions:
300
315
 
301
316
  <summary>키움페이</summary>
302
317
 
318
+ #### 채널 설정
319
+
303
320
  1. [키움페이 상점관리자](http://agent.kiwoompay.co.kr/) 접속 후 로그인을 합니다.
304
321
  2. \[고객지원]→\[기술지원]→\[연동정보설정]를 클릭합니다.
305
322
  3. CPID를 선택하여 `조회하기`를 클릭합니다.
@@ -310,6 +327,19 @@ targetVersions:
310
327
 
311
328
  6. 포트원 콘솔에서 채널 추가 시 \[CPID], \[결제연동키]를 입력한 후 `저장`을 클릭합니다.
312
329
 
330
+ #### 결제 결과 통보 URL 설정
331
+
332
+ 키움페이에서 포트원으로 결제 결과를 전달받기 위해 통보 URL을 설정해야 합니다.
333
+
334
+ 1. [키움페이 상점관리자](http://agent.kiwoompay.co.kr/) 접속 후 로그인을 합니다.
335
+ 2. \[고객지원]→\[기술지원]→\[연동정보설정]를 클릭합니다.
336
+ 3. CPID를 선택하여 `조회하기`를 클릭합니다.
337
+ 4. 결제수단을 선택합니다.
338
+ 5. `결제 통지URL` 항목에 `https://service.iamport.kr/daou_payments/result`를 입력합니다.
339
+ 6. `취소통지사용여부` 항목을 `아니오`로 설정합니다.
340
+
341
+ (이미지 첨부: 키움페이 상점관리자 내 통보 URL 설정 화면)
342
+
313
343
  </details>
314
344
 
315
345
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -394,63 +424,8 @@ targetVersions:
394
424
 
395
425
  <div class="tabs-content" data-title="결제창 일반/정기 결제">
396
426
 
397
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
398
-
399
- <div class="hint" data-style="info">
400
-
401
- - **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
402
- - **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
403
-
404
- </div>
405
-
406
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
407
-
408
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
409
-
410
- <div class="hint" data-style="info">
411
-
412
- 크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
413
-
414
- </div>
415
-
416
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
417
-
418
- 1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
419
-
420
- 2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
421
-
422
- 3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
423
-
424
- <ul>
425
-
426
- <li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
427
- <li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
428
-
429
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
430
-
431
- <li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
432
-
433
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
434
-
435
- </ul>
436
-
437
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
438
-
439
- 4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
440
-
441
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
442
-
443
- 5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
444
-
445
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
446
-
447
- <div class="hint" data-style="warning">
448
-
449
- 포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
450
-
451
- </div>
452
-
453
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
427
+ 1. KG이니시스 계약 완료 이후, 이니시스로부터 전달 받은 MID, INIAPI Key, CBT 타입 값을 포트원 콘솔에서 채널 추가 시
428
+ `[PG상점아이디 (MID)]`, `[INIAPI Key]`, `[CBT Type]` 항목에 입력 혹은 선택 후 저장을 클릭합니다.
454
429
 
455
430
  </div>
456
431
 
@@ -512,63 +487,8 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
512
487
 
513
488
  <div class="tabs-content" data-title="결제창 일반/정기 결제">
514
489
 
515
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
516
-
517
- <div class="hint" data-style="info">
518
-
519
- - **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
520
- - **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
521
-
522
- </div>
523
-
524
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
525
-
526
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
527
-
528
- <div class="hint" data-style="info">
529
-
530
- 크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
531
-
532
- </div>
533
-
534
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
535
-
536
- 1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
537
-
538
- 2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
539
-
540
- 3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
541
-
542
- <ul>
543
-
544
- <li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
545
- <li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
546
-
547
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
548
-
549
- <li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
550
-
551
- <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
552
-
553
- </ul>
554
-
555
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
556
-
557
- 4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
558
-
559
- (이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
560
-
561
- 5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
562
-
563
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
564
-
565
- <div class="hint" data-style="warning">
566
-
567
- 포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
568
-
569
- </div>
570
-
571
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
490
+ 1. KG이니시스 계약 완료 이후, 이니시스로부터 전달 받은 MID, INIAPI Key, CBT 타입 값을 포트원 콘솔에서 채널 추가 시
491
+ `[PG상점아이디 (MID)]`, `[INIAPI Key]`, `[CBT Type]` 항목에 입력 혹은 선택 후 저장을 클릭합니다.
572
492
 
573
493
  </div>
574
494
 
@@ -636,7 +556,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
636
556
 
637
557
  (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
638
558
 
639
- 4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
559
+ 4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
640
560
 
641
561
  5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
642
562
 
@@ -648,7 +568,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
648
568
 
649
569
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
650
570
 
651
- 9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
571
+ 9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
652
572
 
653
573
  10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
654
574
 
@@ -672,7 +592,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
672
592
 
673
593
  (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
674
594
 
675
- 4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
595
+ 4. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
676
596
 
677
597
  5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
678
598
 
@@ -684,7 +604,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
684
604
 
685
605
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
686
606
 
687
- 9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
607
+ 9. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
688
608
 
689
609
  10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
690
610
 
@@ -755,7 +675,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
755
675
  9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
756
676
 
757
677
  1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
758
- 2. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
678
+ 2. \[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
759
679
  3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
760
680
  4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
761
681
  5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
@@ -763,7 +683,7 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
763
683
 
764
684
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
765
685
 
766
- 7. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
686
+ 7. \[자동결제]→\[그룹관리]→\[그룹조회]를 클릭합니다.
767
687
  8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
768
688
 
769
689
  (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
@@ -864,10 +784,10 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
864
784
 
865
785
  </details>
866
786
 
867
- <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
868
-
869
787
  <details>
870
788
 
789
+ <!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
790
+
871
791
  <summary>페이먼트월</summary>
872
792
 
873
793
  1. [페이먼트월](http://api.paymentwall.com/developers/applications) 접속 후 로그인을 합니다.
@@ -895,10 +815,41 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
895
815
 
896
816
  (이미지 첨부: 페이먼트월 Pingback 설정 화면)
897
817
 
898
- </details>
899
-
900
818
  <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
901
819
 
820
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
821
+
822
+ <summary>페이먼트월</summary>
823
+
824
+ 1. [페이먼트월](http://api.paymentwall.com/developers/applications) 접속 후 로그인을 합니다.
825
+ 2. \[My Projects]를 클릭합니다.
826
+
827
+ (이미지 첨부: 페이먼트월 페이지 내 Key 조회 화면)
828
+
829
+ 3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
830
+
831
+ #### 핑백(Pingback) URL 설정하기
832
+
833
+ 페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
834
+
835
+ 1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
836
+
837
+ (이미지 첨부: 페이먼트월 My Projects 메뉴)
838
+
839
+ 2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
840
+
841
+ (이미지 첨부: 페이먼트월 프로젝트 setting 탭)
842
+
843
+ 3. \[Pingback type]을 `URL`로 선택합니다.
844
+ 4. \[Pingback URL]에 `https://tx-gateway-service.prod.iamport.co/paymentwall`를 입력합니다.
845
+ 5. \[Pingback signature version]을 `3`으로 설정합니다.
846
+
847
+ (이미지 첨부: 페이먼트월 Pingback 설정 화면)
848
+
849
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
850
+
851
+ </details>
852
+
902
853
  <details>
903
854
 
904
855
  <summary>페이팔</summary>
@@ -1009,6 +960,36 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
1009
960
 
1010
961
  </details>
1011
962
 
963
+ <details>
964
+
965
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
966
+
967
+ <summary>Triple-A</summary>
968
+
969
+ 1. Triple-A 대시보드의 API Credentials 페이지로 이동합니다.
970
+ 2. `+ Create credentials` 버튼을 클릭하여 Client ID와 Client Secret을 생성합니다.
971
+ 3. API IDs 리스트에서 Merchant key를 확인합니다.
972
+ 4. 포트원 콘솔에서 채널 추가 시 확인한 Merchant Key를 PG 상점아이디에 입력하고, Client ID와 Client Secret을 입력한 후 `저장`을 클릭합니다.
973
+
974
+ <div class="hint" data-style="info">
975
+
976
+ 테스트 환경에서는 Testnet3 testBTC로만 결제가 가능합니다.
977
+
978
+ </div>
979
+
980
+ <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
981
+
982
+ </details>
983
+
984
+ <details>
985
+
986
+ <summary>이지페이(KICC)</summary>
987
+
988
+ 1. KICC 계약 완료 이후, KICC로부터 전달 받은 MID, 가맹점 암호키 값을 포트원 콘솔에서 채널 추가 시
989
+ `[가맹점 ID]`, `[암복호화 키]` 항목에 입력한 후 저장을 클릭합니다.
990
+
991
+ </details>
992
+
1012
993
  ## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
1013
994
 
1014
995
  포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.