@portone/mcp-server 0.15.0-alpha.5 → 0.16.0

package/assets/docs/opi/ko/integration/ready/readme.md

@@ -132,6 +132,21 @@ targetVersions:
 
 <details>
 
+<summary>갤럭시아머니트리</summary>
+
+1. [갤럭시아머니트리 가맹점 관리자](https://cpadmin.billgate.net) 접속 후 로그인을 합니다.
+2. \[기술지원]→\[암호화 정보 확인]을 클릭합니다.
+3. \[상용서버] 또는 \[테스트서버]를 선택합니다.
+4. MID, KEY, IV 값을 확인할 수 있습니다.
+
+(이미지 첨부: 갤럭시아머니트리 BillGate 내 암호화 정보 확인 화면)
+
+5. 포트원 콘솔에서 채널 추가 시 \[MID], \[KEY], \[IV]를 입력한 후 `저장`을 클릭합니다.
+
+</details>
+
+<details>
+
 <summary>나이스정보통신</summary>
 
 <div class="hint" data-style="info">
@@ -210,9 +225,9 @@ targetVersions:
 
 <details>
 
-<summary>모빌리언스</summary>
+<summary>KG파이낸셜</summary>
 
-포트원 콘솔에서 채널 추가 시 계약 완료 후 모빌리언스로부터 전달받은 \[서비스ID]를 입력한 후 `저장`을 클릭합니다.
+포트원 콘솔에서 채널 추가 시 계약 완료 후 KG파이낸셜로부터 전달받은 \[서비스ID]를 입력한 후 `저장`을 클릭합니다.
 
 <div class="hint" data-style="info">
 
@@ -300,6 +315,8 @@ targetVersions:
 
 <summary>키움페이</summary>
 
+#### 채널 설정
+
 1. [키움페이 상점관리자](http://agent.kiwoompay.co.kr/) 접속 후 로그인을 합니다.
 2. \[고객지원]→\[기술지원]→\[연동정보설정]를 클릭합니다.
 3. CPID를 선택하여 `조회하기`를 클릭합니다.
@@ -310,6 +327,19 @@ targetVersions:
 
 6. 포트원 콘솔에서 채널 추가 시 \[CPID], \[결제연동키]를 입력한 후 `저장`을 클릭합니다.
 
+#### 결제 결과 통보 URL 설정
+
+키움페이에서 포트원으로 결제 결과를 전달받기 위해 통보 URL을 설정해야 합니다.
+
+1. [키움페이 상점관리자](http://agent.kiwoompay.co.kr/) 접속 후 로그인을 합니다.
+2. \[고객지원]→\[기술지원]→\[연동정보설정]를 클릭합니다.
+3. CPID를 선택하여 `조회하기`를 클릭합니다.
+4. 결제수단을 선택합니다.
+5. `결제 통지URL` 항목에 `https://service.iamport.kr/daou_payments/result`를 입력합니다.
+6. `취소통지사용여부` 항목을 `아니오`로 설정합니다.
+
+(이미지 첨부: 키움페이 상점관리자 내 통보 URL 설정 화면)
+
 </details>
 
 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
@@ -394,63 +424,8 @@ targetVersions:
 
 <div class="tabs-content" data-title="결제창 일반/정기 결제">
 
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-<div class="hint" data-style="info">
-
-- **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
-- **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
-
-</div>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-<div class="hint" data-style="info">
-
-크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
-
-</div>
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
-1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
-
-2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
-
-3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
-
-   <ul>
-
-   <li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
-   <li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
-
-   <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-   <li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
-
-   <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
-   </ul>
-
-(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
-
-4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
-
-(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
-
-5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-<div class="hint" data-style="warning">
-
-포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
-
-</div>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
+1. KG이니시스 계약 완료 이후, 이니시스로부터 전달 받은 MID, INIAPI Key, CBT 타입 값을 포트원 콘솔에서 채널 추가 시
+   `[PG상점아이디 (MID)]`, `[INIAPI Key]`, `[CBT Type]` 항목에 입력 혹은 선택 후 저장을 클릭합니다.
 
 </div>
 
@@ -512,63 +487,8 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
 <div class="tabs-content" data-title="결제창 일반/정기 결제">
 
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-<div class="hint" data-style="info">
-
-- **INILite Key**는 정기결제 시 필수로 입력해야 합니다.
-- **INIAPI Key**, **INIAPI IV** 하위 상점 관련 API 사용시 필수로 입력해야 합니다. [영수증 내 하위 상점 거래 등록 API 바로가기](/api/rest-v1/partner#post%20%2Fpartners%2Freceipts%2F%7Bimp_uid%7D)
-
-</div>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-<div class="hint" data-style="info">
-
-크레덴셜 중 **hashKey** 는 선택사항으로, KG이니시스에서 제공하는 모바일 금액위변조 방지 기능 사용을 원하실 경우 입력하시면 됩니다.
-
-</div>
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
-1. [KG이니시스 가맹점관리자](http://iniweb.inicis.com/security/login.do) 접속 후 로그인을 합니다.
-
-2. \[상점정보]→\[계약정보]→\[부가정보]를 클릭합니다.
-
-3. 아래의 크레덴셜 값들을 확인합니다. 값이 표시되지 않는 경우 생성/갱신 버튼을 클릭해 주세요.
-
-   <ul>
-
-   <li>**웹결제 signkey 생성 조회**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
-   <li>**INIAPI key 생성 갱신**의 조회 버튼을 클릭하여 \[INIAPI KEY], \[INIAPI IV] 값을 확인할 수 있습니다.</li>
-
-   <!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-   <li>**모바일 금액위변조 HashKey**의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.</li>
-
-   <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
-   </ul>
-
-(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 1)
-
-4. INILite Key의 조회 버튼을 클릭하여 값을 확인할 수 있습니다.
-
-(이미지 첨부: KG이니시스 가맹점관리자 내 크레덴셜 정보 조회 화면 2)
-
-5. 포트원 콘솔에서 채널 추가 시 \[상점아이디]와 위 과정에서 발급받은 크레덴셜 값들을 입력한 후 `저장`을 클릭합니다.
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
-<div class="hint" data-style="warning">
-
-포트원 V1 결제모듈을 사용하시는 경우 KG이니시스로부터 전달받은 키파일을 별도로 등록해야 합니다. 키파일 등록과 관련하여 문의사항이 있는 경우 채널톡으로 문의해주세요.
-
-</div>
-
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
+1. KG이니시스 계약 완료 이후, 이니시스로부터 전달 받은 MID, INIAPI Key, CBT 타입 값을 포트원 콘솔에서 채널 추가 시
+   `[PG상점아이디 (MID)]`, `[INIAPI Key]`, `[CBT Type]` 항목에 입력 혹은 선택 후 저장을 클릭합니다.
 
 </div>
 
@@ -636,25 +556,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
       (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
 
-   4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
-
-   5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
-
-   6. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
-
-   7. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
-
-   8. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
-
-      (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
+   4. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
 
-   9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
+   5. 그룹명을 입력 후 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
 
-   10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
-
-       (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
+   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
 
-   11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
+   6. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
 
 </div>
 
@@ -672,25 +580,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
    (이미지 첨부: KCP 파트너관리자 내 관리용 사설인증서 발급 완료 화면)
 
-4. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
-
-5. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
-
-6. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
-
-7. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
+4. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
 
-8. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
+5. 그룹명을 입력 후 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
 
-   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
-
-9. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
-
-10. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
+(이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
 
-    (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
-
-11. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
+6. 포트원 콘솔에서 채널 추가 시 사이트코드, 사이트키, 앞서 발급한 정기자동결제 그룹아이디를 입력한 후 \[저장]을 클릭합니다.
 
 </div>
 
@@ -755,21 +651,13 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 9. 정기결제를 이용하시는 경우, 아래 절차를 진행해주세요.
 
    1. [KCP 파트너관리자](http://partner.kcp.co.kr/) 접속 후 로그인을 합니다.
-   2. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹등록]을 클릭합니다.
-   3. \[상점정보]→\[사이트코드]에서 그룹등록할 사이트코드를 선택합니다.
-   4. \[그룹정보]에서 \[유형3]을 선택한 후 원하는 그룹명을 입력합니다.
-   5. \[결제입력 정보]에서 \[결제유형] 및 \[납부유형]을 확인하시고 고객사 유형에 맞게 선택합니다.
-   6. \[고지방법]에서 원하시는 고지 방법을 선택한 후 \[등록하기]를 클릭합니다.
+   2. \[결제관리]→\[자동결제]→\[그룹관리]→\[그룹등록]을 클릭합니다.
+   3. 그룹명을 입력 후 그룹을 생성하고 생성된 그룹아이디를 확인합니다.
 
    (이미지 첨부: KCP 파트너관리자 내 관리용 그룹등록 화면)
 
-   7. \[결제관리]→\[정기자동결제 그룹관리]→\[그룹조회]를 클릭합니다.
-   8. \[사이트코드]에서 사용한 사이트코드를 선택한 후 \[검색]을 클릭합니다.
-
-   (이미지 첨부: KCP 파트너관리자 내 관리용 그룹조회 화면)
-
-   9. 포트원 콘솔에서 채널 추가 시 앞서 발급한  \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
-      \[개인키 비밀번호], \[정기자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
+   4. 포트원 콘솔에서 채널 추가 시 앞서 발급한  \[MID(사이트코드)], \[PG-API 인증서키], \[PG-API 개인키],
+      \[개인키 비밀번호], \[자동결제 그룹아이디]를 입력한 후 \[저장]을 클릭합니다.
 
 <!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
 
@@ -864,10 +752,10 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
 
 </details>
 
-<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
-
 <details>
 
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
+
 <summary>페이먼트월</summary>
 
 1. [페이먼트월](http://api.paymentwall.com/developers/applications) 접속 후 로그인을 합니다.
@@ -895,10 +783,41 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
 
 (이미지 첨부: 페이먼트월 Pingback 설정 화면)
 
-</details>
-
 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
 
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
+
+<summary>페이먼트월</summary>
+
+1. [페이먼트월](http://api.paymentwall.com/developers/applications) 접속 후 로그인을 합니다.
+2. \[My Projects]를 클릭합니다.
+
+(이미지 첨부: 페이먼트월 페이지 내 Key 조회 화면)
+
+3. 포트원 콘솔에서 채널 추가 시 \[Project Key], \[Secret Key]를 입력한 후 `저장`을 클릭합니다.
+
+#### 핑백(Pingback) URL 설정하기
+
+페이먼트월에서 포트원으로 결제 결과를 전달받기 위해 핑백 URL을 설정해야 합니다.
+
+1. [페이먼트월](https://api.paymentwall.com/developers/applications) 페이지에서 \[My Projects]를 클릭합니다.
+
+(이미지 첨부: 페이먼트월 My Projects 메뉴)
+
+2. 사용할 프로젝트의 \[Settings] 탭을 클릭합니다.
+
+(이미지 첨부: 페이먼트월 프로젝트 setting 탭)
+
+3. \[Pingback type]을 `URL`로 선택합니다.
+4. \[Pingback URL]에 `https://tx-gateway-service.prod.iamport.co/paymentwall`를 입력합니다.
+5. \[Pingback signature version]을 `3`으로 설정합니다.
+
+(이미지 첨부: 페이먼트월 Pingback 설정 화면)
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
+
+</details>
+
 <details>
 
 <summary>페이팔</summary>
@@ -1009,6 +928,36 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
 
 </details>
 
+<details>
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
+
+<summary>Triple-A</summary>
+
+1. Triple-A 대시보드의 API Credentials 페이지로 이동합니다.
+2. `+ Create credentials` 버튼을 클릭하여 Client ID와 Client Secret을 생성합니다.
+3. API IDs 리스트에서 Merchant key를 확인합니다.
+4. 포트원 콘솔에서 채널 추가 시 확인한 Merchant Key를 PG 상점아이디에 입력하고, Client ID와 Client Secret을 입력한 후 `저장`을 클릭합니다.
+
+<div class="hint" data-style="info">
+
+테스트 환경에서는 Testnet3 testBTC로만 결제가 가능합니다.
+
+</div>
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
+
+</details>
+
+<details>
+
+<summary>이지페이(KICC)</summary>
+
+1. KICC 계약 완료 이후, KICC로부터 전달 받은 MID, 가맹점 암호키 값을 포트원 콘솔에서 채널 추가 시
+   `[가맹점 ID]`, `[암복호화 키]` 항목에 입력한 후 저장을 클릭합니다.
+
+</details>
+
 ## <span id="integration-identifiers">4. 포트원 연동정보 확인하기</span>
 
 포트원을 이용한 결제 연동 시 필요한 연동정보를 확인합니다.

package/assets/docs/opi/ko/integration/start/v1/non-auth.md

@@ -168,7 +168,7 @@ const {
   - 토스페이먼츠 (신모듈)
   - 다날
   - 이지페이(KICC)
-  - 모빌리언스 (휴대폰 소액결제 한정)
+  - KG파이낸셜 (휴대폰 소액결제 한정)
   - 웰컴페이먼츠
   - 스마트로 (신모듈)
   - 헥토파이낸셜 (내통장 결제 한정)

package/assets/docs/opi/ko/integration/start/v2/checkout.md

@@ -128,7 +128,64 @@ const response = await PortOne.requestPayment({
 
 ## 3. 결제 완료 처리 (브라우저)
 
-`PortOne.requestPayment()` 함수의 반환값을 통해 결제 요청의 결과를 확인합니다.
+결제창에서의 작업이 끝나면 완료/실패 여부를 포함한 결과가 전달됩니다. (가상계좌 결제의 경우 완료는 가상계좌 발급 완료를 의미합니다.)
+
+결과는 리다이렉트 방식 또는 반환값 방식 중 하나로 확인할 수 있습니다.
+
+- `redirectUrl`이 설정되어 있고 `forceRedirect: true`인 경우 (리다이렉트 방식)
+  - 완료/실패시 `redirectUrl`로 리다이렉트되고, 쿼리 문자열로 결과를 확인합니다.
+  - 하나의 흐름으로 PC와 모바일 결제를 모두 지원할 수 있는 가장 간단한 방식입니다.
+
+- `redirectUrl`이 설정되지 않은 경우 (반환값 방식)
+  - 완료/실패시 함수의 반환값인 Promise가 리졸브되고, await하여 결과를 확인합니다.
+  - **모바일 결제 UI가 제대로 표시되지 않을 수 있습니다.** PC 결제 UI로 충분할 때에만 사용하십시오.
+  - KG이니시스 일본 결제 등 몇몇 결제 수단의 경우 PC에서도 리다이렉트가 강제되어 이 흐름을 사용할 수 없습니다.
+
+- `redirectUrl`이 설정되어 있고 `forceRedirect: true`가 아닌 경우 (리다이렉트 또는 반환값 방식)
+  - 환경에 따라 리다이렉트가 일어나는지 반환값이 리졸브되는지가 자동으로 결정됩니다. 코드는 두 흐름 모두 지원해야 합니다.
+  - PC 환경에서는 반환값으로, 모바일 환경에서는 리다이렉트로 결과를 확인하여 최적화된 경험을 제공하고 싶을 때 사용하십시오.
+
+리다이렉트 방식과 반환값 방식에 대한 자세한 설명은 아래를 참고하세요.
+
+### 3-1. 리다이렉트 방식의 경우
+
+결제창에서의 작업이 끝나면 지정한 `redirectUrl`로 리다이렉트됩니다. 이 경우에는 함수 호출 결과를 이용할 수 없고,
+결제 성공 여부 등은 [쿼리 문자열](http://en.wikipedia.org/wiki/Query_string)로 전달받게 됩니다.
+
+리다이렉트 방식 결제 지원을 위해, 모바일 환경을 지원해야 하는 경우 **`redirectUrl`을 꼭 지정하여** 호출하여야 합니다.
+지정하지 않은 경우 모바일 결제 UI가 표시되지 않을 수 있습니다.
+
+<div class="hint" data-style="warning">
+
+`redirectUrl`은 `https://` 또는 `http://`로 시작해야 합니다.
+
+</div>
+
+```ts
+PortOne.requestPayment({
+  /* 파라미터 생략 */
+  redirectUrl: `${BASE_URL}/payment-redirect`,
+  forceRedirect: true, // 리다이렉트 방식만 사용하기 위한 설정
+});
+```
+
+쿼리 문자열로 전달되는 주요 필드는 다음과 같습니다.
+전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
+
+|키       |설명               |비고                        |
+|---------|-------------------|----------------------------|
+|paymentId|결제 건 ID         |공통                        |
+|code     |오류 코드          |실패 시                     |
+|message  |오류 문구          |실패 시                     |
+|pgCode   |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시|
+|pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시|
+
+예를 들어 paymentId가 `payment-39ecfa97`, redirectUrl이 `https://example.com/payment-redirect`인 경우,
+결제 성공 시에 `https://example.com/payment-redirect?paymentId=payment-39ecfa97`로 리다이렉트됩니다.
+
+### 3-2. 반환값 방식의 경우
+
+`PortOne.requestPayment()` 함수의 반환값인 프로미스를 통해 결제 요청의 결과를 확인합니다.
 
 `code`가 있으면 결제 과정에서 오류가 발생한 것이므로 적절히 처리하여야 합니다.
 
@@ -169,36 +226,9 @@ async function requestPayment() {
 |pgCode   |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시|
 |pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시|
 
-### 3-1. redirect 방식의 경우
-
-모바일 환경에서의 결제는 대부분 redirect 방식으로 이루어집니다. redirect 방식에서는 브라우저가 결제창으로 리다이렉트되었다가, 결제창에서의 작업이 끝나면
-지정한 `redirectUrl`로 다시 리다이렉트됩니다. 이 경우에는 함수 호출 결과를 이용할 수 없고,
-결제 성공 여부 등은 [쿼리 문자열](http://en.wikipedia.org/wiki/Query_string)로 전달받게 됩니다.
-
-```ts
-PortOne.requestPayment({
-  /* 파라미터 생략 */
-  redirectUrl: `${BASE_URL}/payment-redirect`,
-});
-```
-
-쿼리 문자열로 전달되는 주요 필드는 다음과 같습니다.
-전체 필드 목록은 [requestPayment 응답 형식](https://developers.portone.io/sdk/ko/v2-sdk/payment-response)을 참조해 주시기 바랍니다.
-
-|키       |설명               |비고                        |
-|---------|-------------------|----------------------------|
-|paymentId|결제 건 ID         |공통                        |
-|code     |오류 코드          |실패 시                     |
-|message  |오류 문구          |실패 시                     |
-|pgCode   |PG 오류 코드 그대로|실패 및 PG 오류 코드 존재 시|
-|pgMessage|PG 오류 문구 그대로|실패 및 PG 오류 문구 존재 시|
-
-예를 들어 paymentId가 `payment-39ecfa97`, redirectUrl이 `https://example.com/payment-redirect`인 경우,
-결제 성공 시에 `https://example.com/payment-redirect?paymentId=payment-39ecfa97`로 리다이렉트됩니다.
-
 ## 4. 결제 완료 처리 (서버)
 
-paymentId를 서버에 전달하면, 서버는 포트원의 [결제 조회 API](https://developers.portone.io/api/rest-v2/payment#get%20%2Fpayments%2F%7BpaymentId%7D)를
+서버는 포트원의 [결제 조회 API](https://developers.portone.io/api/rest-v2/payment#get%20%2Fpayments%2F%7BpaymentId%7D)를
 호출하여 해당 결제 건의 상태를 확인하고 결제 완료 처리를 하여야 합니다.
 
 <div class="hint" data-style="info">

package/assets/docs/opi/ko/integration/using-ai-tools.md

@@ -6,6 +6,48 @@ targetVersions:
   - v2
 ---
 
+## AI Codemate
+
+AI Codemate 는 Claude Code를 사용하여 작업자의 프로젝트 환경을 AI를 통해 분석해 맞춤형 결제 연동 코드를 생성하고,
+기존 연동 코드를 검토하는 기능을 제공합니다.
+[(GitHub 저장소 바로가기)](https://github.com/portone-io/portone-cli)
+
+플러그인은 포트원 MCP 서버를 기반으로 공식 문서와 API 스펙을 활용하여 정확한 코드를 생성합니다.
+
+### 설치 방법
+
+Node.js 22.6.0 이상이 설치된 환경에서 다음 명령어를 실행합니다:
+
+```bash
+npx @portone/cli@latest setup
+```
+
+<div class="hint" data-style="info">
+
+명령어 실행 시 사용자의 Claude Code에 포트원 Claude 플러그인이 자동으로 등록됩니다.
+
+</div>
+
+### 사용 방법
+
+#### 결제 연동 코드 생성
+
+Claude Code에서 `/portone-integration:start` 명령어를 입력하면 대화형으로 결제 연동 코드를 생성할 수 있습니다.
+
+```bash
+/portone-integration:start                    # 대화형으로 모든 옵션 선택
+```
+
+### 지원 범위
+
+Claude Code에서 사용하는 모델이 지원하는 모든 프레임워크와 언어를 지원합니다.
+
+<div class="hint" data-style="warning">
+
+신규 프로젝트의 경우 V2 사용을 권장합니다. V1은 레거시 프로젝트 유지보수 용도로 지원됩니다.
+
+</div>
+
 ## 포트원 MCP (Model Context Protocol) 서버
 
 포트원은 쉬운 연동과 빠른 개발을 위해 MCP 서버를 제공합니다. [(GitHub 저장소 바로가기)](https://github.com/portone-io/mcp-server)

package/assets/docs/opi/ko/quick-guide/payment.md

@@ -1773,7 +1773,7 @@ ni @portone/browser-sdk
 
   <div class="hint" data-style="warning">
 
-  KG이니시스 결제 시 PC 환경에서는 구매자 이름, 연락처, 이메일을 필수로 입력해야 합니다.
+  KG이니시스 결제 시 구매자 이름, 전화번호, 이메일을 필수로 입력해야 합니다.
 
   </div>
 
@@ -1783,7 +1783,7 @@ ni @portone/browser-sdk
 
   <div class="hint" data-style="warning">
 
-  스마트로 결제 시 구매자 연락처를 필수로 입력해야 합니다.
+  스마트로 결제 시 구매자 전화번호를 필수로 입력해야 합니다.
 
   </div>
 
@@ -1804,7 +1804,7 @@ ni @portone/browser-sdk
   <div class="hint" data-style="warning">
 
   엑심베이의 경우 구매자 이름과 이메일을 필수로 입력해야 합니다.
-  일본 편의점 결제 사용 시 구매자 연락처를 필수로 입력해야 합니다.
+  일본 편의점 결제 사용 시 구매자 전화번호를 필수로 입력해야 합니다.
 
   </div>
 
@@ -1836,7 +1836,7 @@ ni @portone/browser-sdk
 
   - phoneNumber?: string
 
-    **구매자 연락처**
+    **구매자 전화번호**
 
   - email?: string
 
@@ -2668,7 +2668,7 @@ ni @portone/browser-sdk
 
   - phoneNumber?: string
 
-    **상점 연락처**
+    **상점 전화번호**
 
   - address?: string
 

package/assets/docs/opi/ko/readme.md

@@ -122,7 +122,7 @@ targetVersions:
 
 <span>API 문서 바로가기</span>
 
-<i class="i-ic-baseline-chevron-right inline-block text-2xl" />
+<i class="icon-[ic--baseline-chevron-right] inline-block text-2xl" />
 
 </a>
 
@@ -134,7 +134,7 @@ targetVersions:
 
 <span>API 문서 바로가기</span>
 
-<i class="i-ic-baseline-chevron-right inline-block text-2xl" />
+<i class="icon-[ic--baseline-chevron-right] inline-block text-2xl" />
 
 </a>
 

package/assets/docs/opi/ko/support/code-info/pg-2.md

@@ -21,7 +21,7 @@ targetVersions:
 |       카카오페이      |   `kakaopay`   |
 |다날휴대폰결제/본인인증|     `danal`    |
 |          다날         |  `danal_tpay`  |
-|       모빌리언스      |   `mobilians`  |
+|       KG파이낸셜      |   `mobilians`  |
 |         페이코        |     `payco`    |
 |      (구) 페이팔      |    `paypal`    |
 |      (신) 페이팔      |   `paypal_v2`  |
@@ -37,5 +37,5 @@ targetVersions:
 |      헥토파이낸셜     |    `settle`    |
 |헥토파이낸셜 내통장결제|  `settle_acc`  |
 |         KSNET         |     `ksnet`    |
-|        갤럭시아       |    `galaxia`   |
+|    갤럭시아머니트리   |    `galaxia`   |
 |      웰컴페이먼츠     |    `welcome`   |

package/assets/docs/opi/ko/support/code-info/pg-3.md

@@ -21,11 +21,11 @@ targetVersions:
 
 (파일: 토스페이먼츠 오류코드 다운로드)
 
-## KG모빌리언스
+## KG파이낸셜
 
-(파일: KG모빌리언스 휴대폰 결제 오류코드 다운로드)
+(파일: KG파이낸셜 휴대폰 결제 오류코드 다운로드)
 
-(파일: KG모빌리언스 휴대폰 결제 취소 오류코드 다운로드)
+(파일: KG파이낸셜 휴대폰 결제 취소 오류코드 다운로드)
 
 ## 다날
 

package/assets/docs/opi/ko/support/code-info/pg.md

@@ -28,7 +28,7 @@ API방식으로 연동하실 때는 [비인증 결제(일회성) API](https://de
 |      헥토파이낸셜     |       settle      |     X     |    O   |                                -                               |
 |     이지페이(KICC)    |        kicc       |     O     |    X   |                             불가능                             |
 |        키움페이       |        daou       |     X     |    O   |                                -                               |
-|      KG모빌리언스     |      moblians     |     O     |    X   |                              가능                              |
+|       KG파이낸셜      |     mobilians     |     O     |    X   |                              가능                              |
 |         KSNET         |       ksnet       |     X     |    O   |                                -                               |
 |    스마트로(신모듈)   |    smartro\_v2    |     O     |    X   |                             불가능                             |
 |      웰컴페이먼츠     |      welcome      |     O     |    O   |발급 수단에 따라 상이함. (카드 : 불가능 / 휴대폰소액결제 : 가능)|