@portone/mcp-server 0.14.0 → 0.15.0-alpha.1

package/assets/docs/opi/ko/integration/pg/v1/nice-v2/billing-api-caution.md

@@ -1,6 +1,6 @@
 ---
 title: 빌링키 발급 / API 연동 유의사항
-description: (신)나이스페이먼츠 비인증 결제 연동 유의사항을 소개합니다.
+description: (신)나이스정보통신 비인증 결제 연동 유의사항을 소개합니다.
 targetVersions:
   - v1
 ---
@@ -22,7 +22,7 @@ targetVersions:
 
 ## 비인증 결제
 
-(신) 나이스페이먼츠는 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`),
+(신) 나이스정보통신은 발급 된 빌링키로 결제(`POST /subscribe/payments/again`),
 키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를
 모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다.
 
@@ -30,9 +30,9 @@ targetVersions:
 
 |파라미터                     |데이터 타입           |의미                                                                                               |
 |-----------------------------|----------------------|---------------------------------------------------------------------------------------------------|
-|vat\_amount                  |double                |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스페이먼츠와 사전 협의 필요|
-|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스페이먼츠와 사전 협의 필요                               |
-|use\_card\_point             |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스페이먼츠와 사전 협의 필요                                       |
+|vat\_amount                  |double                |총 결제 금액 중 부가세 금액. 부가세 직접 입력 방식을 위해 사용. 단, 나이스정보통신와 사전 협의 필요|
+|intereset\_free\_by\_merchant|boolean(기본값: false)|상점 부담 무이자 할부 적용 여부. 단, 나이스정보통신와 사전 협의 필요                               |
+|use\_card\_point             |boolean(기본값: false)|카드사 포인트 사용 여부. 단, 나이스정보통신와 사전 협의 필요                                       |
 
 ## 가상계좌
 
@@ -42,12 +42,12 @@ targetVersions:
 |------------------------------|-----------|-----------------------|
 |business\_registration\_number|string     |구매자 사업자 등록 번호|
 
-(신) 나이스페이먼츠의 경우 API를 통한 가상 계좌 발급 시, 향후 해당 거래 건을 에스크로 배송 정보로 등록할 때
+(신) 나이스정보통신의 경우 API를 통한 가상 계좌 발급 시, 향후 해당 거래 건을 에스크로 배송 정보로 등록할 때
 사용될 구매자의 사업자 번호를 `business_registration_number` 파라미터로 입력받고 있습니다.
 
 ### API로 가상계좌 채번은 가능하나 발급된 가상계좌 정보는 수정 불가능
 
-(신) 나이스페이먼츠는 `POST /vbanks` API로 가상 계좌를 채번 할 수 있지만 `PUT /vbanks` API로
+(신) 나이스정보통신은 `POST /vbanks` API로 가상 계좌를 채번 할 수 있지만 `PUT /vbanks` API로
 **이미 채번 된 가상계좌 정보(입금 기한, 입금 금액)를 수정할 수 없습니다.**
 
 ## 에스크로 결제
@@ -58,20 +58,20 @@ targetVersions:
 |-----------|-----------|-----------------------------------------------------------------------------------------|
 |send\_email|boolean    |에스크로 구매 확정시 결제 창에 입력했던 이메일로 해당 사실을 전송할지 여부 (기본값: true)|
 
-(신) 나이스페이먼츠의 경우 에스크로 결제건에 대해 배송 정보 등록 API 호출 시 `send_email` 파라미터를
+(신) 나이스정보통신의 경우 에스크로 결제건에 대해 배송 정보 등록 API 호출 시 `send_email` 파라미터를
 이용하여 구매 확정됐을 때 결제창에 입력한 이메일로 구매 확정 내용을 전송할지 여부를 제어할 수 있습니다.
 기본 값은 true(구매 확정 여부 이메일 전송)이며 false로 입력 시 구매가 확정되어도 이메일로 안내되지 않습니다.
 
 ### 배송 정보 수정 불가
 
-(신) 나이스페이먼츠는 `POST /escrow/logis/{imp_uid}` API로 에스크로 배송 정보 등록은 가능하지만
+(신) 나이스정보통신은 `POST /escrow/logis/{imp_uid}` API로 에스크로 배송 정보 등록은 가능하지만
 `PUT /escrow/logis/{imp_uid}` API로 **수정은 불가능**합니다.
 
 ## 현금영수증
 
 ### 결제창에서 발급 받지 못한 현금영수증은 API로 발급 불가능
 
-(신) 나이스페이먼츠의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
+(신) 나이스정보통신의 경우 현금성 결제(가상계좌, 계좌이체, 네이버페이 포인트 결제 등)시 승인 단계에서
 현금영수증을 발급 요청할 수 있습니다. 이때 결제 승인 단계에서 현금영수증을 발급 요청하지 못한 경우,
 현금영수증 발급 API(`POST /receipts/{imp_uid}`)를 사용한다고 하더라도 발급이 되지 않으니 참고 부탁드립니다.
 
@@ -79,7 +79,7 @@ targetVersions:
 
 API로 현금영수증 발급(`POST /receipts/{imp_uid}`)시 발급 받을 현금영수증 정보(현금영수증 발급 유형,
 현금영수증 발행 식별 정보, 현금영수증 발행 식별 정보 유형)를 전달해야 합니다.
-단, (신) 나이스페이먼츠의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다.
+단, (신) 나이스정보통신의 경우 **현금영수증 카드 번호로 현금영수증 발급이 불가능**하오니 참고 부탁드립니다.
 
 <details>
 

package/assets/docs/opi/ko/integration/pg/v1/nice-v2/payment-caution.md

@@ -1,6 +1,6 @@
 ---
 title: 일반결제 연동 유의사항
-description: 나이스페이먼츠(신모듈) 일반결제 연동 유의사항을 소개합니다.
+description: 나이스정보통신(신모듈) 일반결제 연동 유의사항을 소개합니다.
 targetVersions:
   - v1
 ---
@@ -25,11 +25,11 @@ PG사로부터 정확한 사유를 전달받지 못하기 때문에 다음과
 
 ### 토스뱅크 카드사 다이렉트 호출 미지원
 
-나이스페이먼츠(신모듈)의 경우 토스뱅크 카드(card.direct.code = "092") 다이렉트 호출이 불가능합니다.
+나이스정보통신(신모듈)의 경우 토스뱅크 카드(card.direct.code = "092") 다이렉트 호출이 불가능합니다.
 
 ### 카드사 다이렉트 호출시 고정 할부 개월수 필수 입력
 
-나이스페이먼츠(신모듈)는 **카드사 다이렉트 호출시
+나이스정보통신(신모듈)는 **카드사 다이렉트 호출시
 고정 할부 개월수를 <span style="color:red"> 필수 </span>로 입력**해야 합니다.
 결제 금액이 할부 지원 금액 미만(일반적으로 50,000원 이상 결제 시 할부 기능을 지원하나
 카드사에 따라 다를 수 있습니다.)인 경우 **할부 개월수를 0(일시불)으로 전달**해야 합니다.
@@ -84,7 +84,7 @@ IMP.request_pay(
 
 ### 모바일 환경에서는 다이렉트 호출시에만 할부 옵션 설정 가능
 
-나이스페이먼츠(신모듈)의 경우 일반 카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나
+나이스정보통신(신모듈)의 경우 일반 카드 결제 시(간편결제 제외) 할부 옵션(고정 할부 개월수)사용이 가능하나
 **모바일 환경**에서는 **카드사 다이렉트 호출할 때만 할부 옵션 사용이 가능합니다.** 만약 모바일 환경에서 다이렉트 호출 코드 없이
 할부 옵션을 전달하는 경우 무시됩니다.
 
@@ -132,7 +132,7 @@ IMP.request_pay(
 
 ### 가상계좌 입금 기한(`vbank_due`) 필수 입력
 
-나이스페이먼츠(신모듈) 가상 계좌 발급 시, 입금 기한은 필수 입력해야 하며 아래 4가지 형식만 유효합니다.
+나이스정보통신(신모듈) 가상 계좌 발급 시, 입금 기한은 필수 입력해야 하며 아래 4가지 형식만 유효합니다.
 입금 기한을 입력하지 않거나, 유효하지 않은 형식을 입력할 경우 가상계좌 발급 결제창이 호출되지 않고 "결제 창 호출에 실패하였습니다.
 나이스페이 V2 가상계좌 발급시 유효한 입금 기한을 필수로 입력해야 합니다." 라는 에러 메세지가 리턴되오니 유의하시기 바랍니다.
 
@@ -145,17 +145,17 @@ IMP.request_pay(
 
 ### 계좌이체 다이렉트 호출시 은행 코드 지정 불가능
 
-나이스페이먼츠(신모듈) 계좌이체 다이렉트 호출은 은행 코드를 지정하지 않고 바로 뱅크페이 결제창이 띄워지는 구조입니다.
+나이스정보통신(신모듈) 계좌이체 다이렉트 호출은 은행 코드를 지정하지 않고 바로 뱅크페이 결제창이 띄워지는 구조입니다.
 
 ### 계좌이체 다이렉트 호출시 현금영수증 정보는 필수 입력
 
 계좌이체 거래는 계좌에서 현금성 결제로 현금영수증 발급이 가능하므로 현금영수증 정보를 필수로 입력해야 합니다.
-만약 입력하지 않을 경우 나이스페이먼츠(신모듈) 계좌이체 다이렉트 호출 시 **현금영수증 발급 유형은 필수 입력**입니다.
+만약 입력하지 않을 경우 나이스정보통신(신모듈) 계좌이체 다이렉트 호출 시 **현금영수증 발급 유형은 필수 입력**입니다.
 라는 에러 메시지가 뜨면서 결제창이 호출되지 않으니 유의하시기 바랍니다.
 
 ### 계좌이체 에스크로 결제시에는 다이렉트 호출 불가능
 
-나이스페이먼츠 정책상 계좌이체 + 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
+나이스정보통신 정책상 계좌이체 + 에스크로 결제시에는 다이렉트 호출이 불가능합니다.
 아래와 같이 계좌이체 + 에스크로 + 다이렉트 호출을 위한 파라미터를 설정할 경우
 "나이스페이 V2 계좌이체 에스크로 결제시 다이렉트 호출은 불가능합니다."라는 에러 메시지가 뜨면서
 결제창이 호출되지 않으니 유의하시기 바랍니다.
@@ -163,7 +163,7 @@ IMP.request_pay(
 ### 계좌이체 에스크로 결제시 결제창에 올바른 이메일을 입력해야 함
 
 존재하지 않는 이메일을 입력할 경우 **이메일 주소 오류**라는 에러 메시지와 함께 승인에 실패합니다.
-또한 실제로 존재하는 이메일 도메인이더라도 나이스페이먼츠 정책상 유효하지 않다고 취급하는
+또한 실제로 존재하는 이메일 도메인이더라도 나이스정보통신 정책상 유효하지 않다고 취급하는
 이메일 주소(예: .finance로 끝나는 이메일 주소)를 입력한 경우 승인은 정상적으로 되지만
 **이후 API로 에스크로 등록시 에스크로 구매 확정 이메일이 전송되지 않습니다.**
 
@@ -207,15 +207,15 @@ IMP.request_pay(
 
 ### 컬쳐랜드(`cultureland`)만 지원
 
-나이스페이먼츠(신모듈)은 상품권 결제시 컬쳐랜드만 지원하며 북앤라이프, 스마트문상 등은 지원하지 않습니다.
+나이스정보통신(신모듈)은 상품권 결제시 컬쳐랜드만 지원하며 북앤라이프, 스마트문상 등은 지원하지 않습니다.
 
 ### MallUserID(`bypass.nice_v2.MallUserID`)는 필수 입력
 
-나이스페이먼츠(신모듈) 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수 입력이며, bypass 파라미터로 전달할 수 있습니다.
+나이스정보통신(신모듈) 상품권 결제시 고객사 구매자 ID를 의미하는 MalluserID는 필수 입력이며, bypass 파라미터로 전달할 수 있습니다.
 
-### 승인 완료시 나이스페이먼츠로부터 승인번호(`apply_num`)가 전달되지 않음
+### 승인 완료시 나이스정보통신로부터 승인번호(`apply_num`)가 전달되지 않음
 
-나이스페이먼츠(신모듈)은 상품권 결제시에는 승인 번호를 전달하지 않아 승인번호 확인이 어렵습니다.
+나이스정보통신(신모듈)은 상품권 결제시에는 승인 번호를 전달하지 않아 승인번호 확인이 어렵습니다.
 따라서 결제 내역 조회시 승인 번호는 null로 리턴됩니다.
 
 <details>
@@ -260,7 +260,7 @@ GET /payments/{imp_uid}
 
 ### 결제 수단 지정 시 카드 또는 포인트 지정 필요
 
-나이스페이먼츠(신모듈)를 통한 네이버페이 결제 시 카드 또는 포인트 결제를 지정하여 호출해야합니다.
+나이스정보통신(신모듈)를 통한 네이버페이 결제 시 카드 또는 포인트 결제를 지정하여 호출해야합니다.
 결제 수단(`pay_method`) 파라미터에 `naverpay` 입력은 불가능하며 `naverpay_card`(카드)
 또는 `naverpay_point`(포인트/머니) 둘 중 하나로 입력해야 정상적으로 결제창이 호출되오니 유의하시기 바랍니다.
 
@@ -345,9 +345,9 @@ IMP.request_pay({
 ### SSGPAY 은행 계좌 결제시 현금영수증 발급 정보를 확인할 수 없음
 
 SSGPAY 은행 계좌 결제 시 현금영수증 발급 정보를 입력하여 정상적으로 발급되더라도
-승인 완료(status: paid)시 나이스페이먼츠에서 현금영수증 발급 정보를 전달하지 않아
+승인 완료(status: paid)시 나이스정보통신에서 현금영수증 발급 정보를 전달하지 않아
 포트원 API로 결제/현금영수증 발급 내역 조회 또는 포트원 콘솔에서 현금영수증 내역을 확인할 수 없습니다.
-단, 나이스페이먼츠 어드민에서는 확인이 가능합니다.
+단, 나이스정보통신 어드민에서는 확인이 가능합니다.
 
 <details>
 

package/assets/docs/opi/ko/integration/pg/v1/nice-v2/readme.md

@@ -1,17 +1,17 @@
 ---
-title: 나이스페이먼츠 (신모듈)
-description: 나이스페이먼츠 연동 방법을 안내합니다.
+title: 나이스정보통신 (신모듈)
+description: 나이스정보통신 연동 방법을 안내합니다.
 targetVersions:
   - v1
 versionVariants:
   v2: /opi/ko/integration/pg/v2/nice-v2
 ---
 
-## 1. 나이스페이먼츠(신모듈) 채널 설정하기
+## 1. 나이스정보통신(신모듈) 채널 설정하기
 
 [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
 
-아래 기능을 사용하시려면 나이스페이먼츠에 사전 신청 후 계약이 완료되어야 합니다.
+아래 기능을 사용하시려면 나이스정보통신에 사전 신청 후 계약이 완료되어야 합니다.
 그렇지 않은 상태에서 해당 기능 이용시 PG창 호출에 실패하거나, 승인에 실패하거나,
 승인에 성공하더라도 의도한 바와는 다른 응답을 얻게 될 수 있으니 주의 해주시기 바랍니다.
 
@@ -42,7 +42,7 @@ versionVariants:
 
 ## 2. 최신 JavaScript SDK로 업데이트하기 <a href="#2." id="2." />
 
-나이스페이먼츠(신모듈) 결제는 최신 SDK에서만 지원되는 기능입니다.
+나이스정보통신(신모듈) 결제는 최신 SDK에서만 지원되는 기능입니다.
 
 ```html title="JS SDK"
 <script src="https://cdn.iamport.kr/v1/iamport.js"></script>
@@ -50,7 +50,7 @@ versionVariants:
 
 <div class="hint" data-style="info">
 
-**(신) 나이스페이먼츠를 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다**
+**(신) 나이스정보통신를 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다**
 
 </div>
 
@@ -76,7 +76,7 @@ versionVariants:
 ## 3.결제 요청하기
 
 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
-(신) 나이스페이먼츠 결제창을 호출할 수 있습니다. **결제 결과**는 PC의 경우 `IMP.request_pay(param,
+(신) 나이스정보통신 결제창을 호출할 수 있습니다. **결제 결과**는 PC의 경우 `IMP.request_pay(param,
 callback)` 호출 후 **callback**으로 수신되고 모바일의 경우
 **m\_redirect\_url** 로 리디렉션됩니다.
 
@@ -189,7 +189,7 @@ IMP.request_pay(
 
   **가상계좌 입금기한 (YYYY-MM-DD)**
 
-  (신) 나이스페이먼츠의 경우 필수 입력이며 날짜는 무조건 23:59:59로 설정 됨
+  (신) 나이스정보통신의 경우 필수 입력이며 날짜는 무조건 23:59:59로 설정 됨
 
 - escrow: boolean
 
@@ -241,6 +241,8 @@ IMP.request_pay(
 
 <div class="tabs-content" data-title="비인증 결제창 요청">
 
+(신) 나이스정보통신의 경우 비인증 결제창 방식은 간편결제(네이버페이 / 카카오페이)만 지원합니다.
+
 ```ts title="Javascript SDK"
 IMP.request_pay(
   {

package/assets/docs/opi/ko/integration/pg/v1/nice.md

@@ -1,20 +1,20 @@
 ---
-title: (구) 나이스페이먼츠
-description: (구) 나이스페이먼츠 결제창 연동 가이드를 안내합니다.
+title: (구) 나이스정보통신
+description: (구) 나이스정보통신 결제창 연동 가이드를 안내합니다.
 targetVersions:
   - v1
 ---
 
 <div class="hint" data-style="warning">
 
-**나이스페이먼츠(구모듈) 연동 방법에 관한 매뉴얼**입니다.
+**나이스정보통신(구모듈) 연동 방법에 관한 매뉴얼**입니다.
 
-신규 연동 고객사이시거나 나이스페이먼츠 신모듈로 업그레이드를 원하신다면 [나이스페이먼츠(신모듈) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)를 참고하여 진행해주세요.
+신규 연동 고객사이시거나 나이스정보통신 신모듈로 업그레이드를 원하신다면 [나이스정보통신(신모듈) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)를 참고하여 진행해주세요.
 구모듈에 비해 신모듈에서 다양한 기능 및 결제수단을 지원하고 있습니다. 신규 고객사의 경우 가급적 신모듈로 연동하는 것을 권장드립니다.
 
 </div>
 
-## 1. 나이스페이먼츠 채널 설정하기
+## 1. 나이스정보통신 채널 설정하기
 
 [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
 
@@ -169,7 +169,7 @@ curl -H "Content-Type: application/json" \
 
 빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다.
 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서
-재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```sh
 curl -H "Content-Type: application/json" \
@@ -179,7 +179,7 @@ curl -H "Content-Type: application/json" \
 
 <div class="hint" data-style="info">
 
-**나이스페이먼츠는 비인증 결제는 API 방식으로만 지원됩니다.**
+**나이스정보통신은 비인증 결제는 API 방식으로만 지원됩니다.**
 
 비인증 결제를 연동하기 위해서는 카드정보를 획득할수 있는 UI를 구성해 주셔야 하며
 해당 가이드는 [**비인증결제 연동하기**](https://developers.portone.io/opi/ko/integration/start/v1/non-auth)에서 확인해주시면 됩니다.

package/assets/docs/opi/ko/integration/pg/v1/payletter-global.md

@@ -0,0 +1,91 @@
+---
+title: 페이레터 해외결제
+description: 페이레터 해외결제 연동 방법을 안내합니다.
+targetVersions:
+  - v1
+---
+
+## 채널 설정하기
+
+- [결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기)의 페이레터 해외결제 채널 설정 내용을 참고하여 채널 설정을 진행합니다.
+
+## 가능한 결제 수단
+
+- **결제창 일반 결제**
+
+  페이레터의 경우, `pay_method` 파라미터를 지원하고 있지 않아,
+  계약된 모든 결제 수단이 페이레터 결제창에 노출됩니다.
+
+  특정 결제 수단만 노출하고 싶으신 경우, 아래에 후술될 `bypass.payletter_global.pginfo` 파라미터를 사용하시면 됩니다.
+
+- **일반 결제**
+  - 특정 결제 수단만 결제창에 표기하고 싶으신 경우, `bypass.payletter_global.pginfo` 파라미터를 결제수단에 따라 아래와 같이 설정하시면 됩니다.
+    - 해외카드 비인증 : `PLCreditCard`
+    - 해외카드 인증(3DS) : `PLCreditCardMpi`
+    - 유니온페이 : `PLUnionPay_HC`
+    - 위챗페이 PC결제: `WeChatPayQRCodePayment`
+    - 위챗페이 모바일결제 : `WeChatPayH5Payment`
+    - 알리페이 : `ICBAlipay`
+
+## SDK 결제 요청하기
+
+결제 요청 시에는 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
+
+## 가능한 빌링키 발급 및 결제 수단
+
+- **빌링키 발급 및 결제**
+
+  페이레터의 경우, `pay_method` 파라미터를 지원하고 있지 않아,
+  계약된 모든 빌링키 발급 및 결제 수단이 페이레터 결제창에 노출됩니다.
+  특정 결제 수단만 노출하고 싶으신 경우, 아래에 후술될 `bypass.payletter_global.pginfo` 파라미터를 사용하시면 됩니다.
+
+- **가능한 빌링키 발급 및 결제 수단**
+  - 특정 빌링키 발급 및 결제 수단만 결제창에 표기하고 싶으신 경우, `bypass.payletter_global.pginfo` 파라미터를 결제 수단에 따라 아래와 같이 설정하시면 됩니다.
+
+  - 빌링키 발급 및 결제의 경우, 위챗, 알리페이 등의 간편결제 수단으로 발급하는 것을 지원하지 않고 있어 아래의 결제 수단으로만 발급이 가능합니다.
+    - 해외카드 비인증 : `PLCreditCard`
+    - 해외카드 인증(3DS) : `PLCreditCardMpi`
+    - 유니온페이 : `PLUnionPay_HC`
+
+## SDK 빌링키 발급 및 결제 요청하기
+
+빌링키 발급 및 결제 요청 시에는 `customer_uid` 파라미터를 포함하여 [JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출해야 합니다.
+
+<div class="hint" data-style="warning">
+
+페이레터 해외결제는 **SDK 1.3.0 부터 사용 가능**합니다.
+
+SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js` 인지 확인해주세요.
+
+위 JS SDK 를 이용하여 페이팔 정기결제 연동시 callback Data는 아래와 같이 두가지 형태로만 내려갑니다.
+
+- `imp_uid`
+- `merchant_uid`
+
+해당 SDK를 사용하실때는 IMP.request\_pay로부터 응답된 객체(또는 쿼리 파라미터)에서 imp\_uid를 가지고
+**포트원 REST API(GET /payments/imp\_uid)로 결제 상세 내역(승인 상태, 승인 결과 등등)을 조회**하여
+응답 파라미터 중 status(결제 상태) 파라미터에 따라 추가 로직을 구현해야 합니다.
+
+</div>
+
+### 비동기 결제
+
+<div class="hint" data-style="warning">
+
+페이레터 일반결제, 빌링키 발급 및 결제는 승인 요청 시 바로 승인되지 않고 일정 시간 후 처리되는 **승인 대기(pending) 상태**가 존재합니다. 따라서 고객사는 트랜잭션 종료시 콜백 함수로 전달되는 포트원 번호(imp\_uid)로 결제 내역을 조회(GET /payments/{imp\_uid})한 후 응답되는 status를 보고 각 상황에 맞는 후 처리 로직을 작성해야 합니다.
+
+승인 대기 상태에서는 고객사는 반드시 (가상계좌나 정기결제와 같이 결제가 비동기로 승인되는 경우 포트원 → 고객사로 결제 결과를 통보해주는) 웹훅 기능을 연동해야 합니다.
+
+</div>
+
+## 결제수단별 승인 가능 통화
+
+- 카드: `KRW`, `USD`, `JPY`
+- Alipay: `USD`, `CNY`
+- WeChatPay: `KRW`, `USD`, `CNY`
+
+## 유의사항
+
+- `merchant_uid` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
+- 페이레터의 경우 구매자 이메일을 필수로 받고 있어,`buyer_email`을 필수로 입력하셔야 합니다.
+- WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.

package/assets/docs/opi/ko/integration/pg/v1/paypal.md

@@ -141,7 +141,7 @@ IMP.request_pay({
 <div class="hint" data-style="info">
 
 STC API를 사용하기 위해서는 **Paypal과의 STC 데이터 협의**가 필요하며,
-**포트원 지원팀(<support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
+**포트원 지원팀(<tech.support@portone.io>)을 통해 요청**해주시면 협의 프로세스를 안내해드리고 있습니다.
 
 연동을 원하시는 경우 원활한 연동절차를 위해 요청 전 **아래 pdf의 Create REST API Application 섹션을 완료**해주세요.
 

package/assets/docs/opi/ko/integration/pg/v1/readme.md

@@ -12,11 +12,11 @@ versionVariants:
 
 ## 국내결제
 
-[나이스페이먼츠 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)
+[나이스정보통신 (신모듈)](https://developers.portone.io/opi/ko/integration/pg/v1/nice-v2/readme)
 
-[(구) 나이스페이먼츠](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
+[(구) 나이스정보통신](https://developers.portone.io/opi/ko/integration/pg/v1/nice)
 
-[NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp)
+[NHN KCP](https://developers.portone.io/opi/ko/integration/pg/v1/nhn-kcp/readme)
 
 [KG이니시스](https://developers.portone.io/opi/ko/integration/pg/v1/inicis)
 
@@ -58,8 +58,6 @@ versionVariants:
 
 [토스페이먼츠 브랜드페이](https://developers.portone.io/opi/ko/integration/pg/v1/toss-brandpay/readme)
 
-[하이픈](https://developers.portone.io/opi/ko/integration/pg/v1/hyphen)
-
 ## 해외결제
 
 [엑심베이](https://developers.portone.io/opi/ko/integration/pg/v1/eximbay)
@@ -71,3 +69,5 @@ versionVariants:
 [페이팔(Reference Transaction) 정기결제](https://developers.portone.io/opi/ko/integration/pg/v1/rt/readme)
 
 [페이팔(Express Checkout)](https://developers.portone.io/opi/ko/integration/pg/v1/paypal)
+
+[페이레터 해외결제](https://developers.portone.io/opi/ko/integration/pg/v1/payletter-global)

package/assets/docs/opi/ko/integration/pg/v1/rt/readme.md

@@ -240,10 +240,10 @@ status가 cancelled 이고 cancel\_history에 취소 요청 내역이 있는 경
 
 페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
 일반 결제나 빌링키 발급은 페이팔 버튼을 통해 진행되기 때문에 페이팔이 이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 있지만,
-발급 된 빌링키로 재결제 (again API 호출) 할때는 고객사 서버에서 포트원 API를 통해 페이팔 API가 호출되는 구조이기 때문에
+발급 된 빌링키로 결제 (again API 호출) 할때는 고객사 서버에서 포트원 API를 통해 페이팔 API가 호출되는 구조이기 때문에
 이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 없습니다.
 
-따라서 발급 된 빌링키로 재결제를 할때는 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달할 수 있도록
+따라서 발급 된 빌링키로 결제를 할때는 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달할 수 있도록
 **again API가 호출되는 고객사 클라이언트 페이지에 반드시 페이팔 Fraudnet 스크립트/Magnes SDK를 아래와 같이 추가해야** 합니다.
 
 **페이팔 정기결제를 통한 again API 호출시에는 Magnes & Fraudnet 조치가
@@ -333,7 +333,7 @@ STC 기능을 사용하시기 위해 다음 정보를 확인하셔야 합니다.
 
 1. 페이팔 Business 계정 가입시 산업 종류(Industry)를 결정하는데, 계정의 산업 종류를 확인해야 합니다.
 
-2. 계정의 산업 종류를 확인하신 뒤, loadUI 호출 해 빌링키를 발급 받을때 그리고 발급 된 빌링키로 재결제(again API 호출)할 때
+2. 계정의 산업 종류를 확인하신 뒤, loadUI 호출 해 빌링키를 발급 받을때 그리고 발급 된 빌링키로 결제(again API 호출)할 때
    모두 bypass.paypal\_v2 객체에 아래와 같은 형식으로 전달해주셔야 합니다.
 
 <details>

package/assets/docs/opi/ko/integration/pg/v1/rt/warning.md

@@ -36,10 +36,10 @@ GET /subscribe/customers/{customer_uid}
 페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
 일반 결제나 빌링키 발급은 페이팔 버튼을 통해 진행되기 때문에
 페이팔이 이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 있지만,
-브라우저에서 발급 된 빌링키로 재결제 (again API 호출) 할때는 고객사 브라우저에서 포트원 API를 통해
+브라우저에서 발급 된 빌링키로 결제 (again API 호출) 할때는 고객사 브라우저에서 포트원 API를 통해
 페이팔 API가 호출되는 구조이기 때문에 이상 거래 판단을 위한 구매자 접속 정보를 얻을 수 없습니다.
 
-따라서 발급 된 빌링키로 재결제를 할때는 구매자의 브라우저/디바이스 접속 정보를
+따라서 발급 된 빌링키로 결제를 할때는 구매자의 브라우저/디바이스 접속 정보를
 페이팔에 전달할 수 있도록 **again API가 호출되는 고객사 클라이언트 페이지에
 반드시 페이팔 Fraudnet 스크립트/Magnes SDK를 아래와 같이 추가해야** 합니다.
 

package/assets/docs/opi/ko/integration/pg/v1/settle/readme.md

@@ -168,7 +168,7 @@ curl -H "Content-Type: application/json" \
 
 **빌링키로 결제 요청하기**
 
-빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 발급과 최초 결제가 성공하면 빌링키는 전달된 `customer_uid` 와 1:1 매칭되어 포트원에 저장됩니다. 보안상의 이유로 서버는 빌링키에 직접 접근할 수 없기 때문에 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```sh
 curl -H "Content-Type: application/json" \
@@ -183,3 +183,83 @@ curl -H "Content-Type: application/json" \
 </div>
 
 </div>
+
+## 3. 고정식 가상계좌 연동하기
+
+헥토파이낸셜의 고정식 가상계좌 연동 방법을 안내합니다.
+
+### 입금통보 설정
+
+헥토파이낸셜 MID 발급 후 `settle_pgdev@settlebank.co.kr`에 아래 입금통보 주소로 설정 요청해야합니다.
+
+요청 입금통보 주소: <https://service.iamport.kr/settle_payments/notice_vbank>
+
+<div class="hint" data-style="info">
+
+자세한 내용은 [가상계좌 입금통보 설정](https://developers.portone.io/opi/ko/integration/virtual-account/readme?v=v1)을 참고하세요.
+
+</div>
+
+### 가상계좌 발급 API
+
+**주요 파라미터**
+
+- `merchant_uid`: 고객사 거래 고유번호 (필수)
+- `amount`: 결제 금액 (고정식 가상계좌 시 필수)
+- `vbank_num`: PG사로부터 받은 가상계좌 번호 (필수)
+- `vbank_holder`: 가상계좌 예금주명 (필수)
+- `fixed_unlimited_vbank`: 고정식 무제한 가상계좌 여부
+- `pg`: PG사 구분자 `{PG사}.{PG상점 아이디}` (필수)
+
+**에스크로 결제시 추가 파라미터**
+
+- `escrow_password`: 에스크로 비밀번호 (필수)
+- `buyer_email`: 구매자 이메일 (필수)
+
+<div class="hint" data-style="warning">
+
+고정식 무제한 가상계좌 발급 유의사항
+
+- `amount`는 생략 가능하며, 지정 시 0원으로 발급됩니다.
+- `tax_free`, `vat_amount` 파라미터를 사용할 수 없습니다.
+- 에스크로 결제를 지원하지 않습니다.
+
+</div>
+
+### 발급 정보 변경 API
+
+입금 전 가상계좌의 입금기한이나 금액을 수정할 수 있습니다.
+
+- `imp_uid`: 포트원 거래고유번호 (필수)
+- `amount`: 수정할 결제금액 (선택)
+- `vbank_due`: 수정할 입금기한 UNIX TIMESTAMP (필수)
+
+<div class="hint" data-style="warning">
+
+- 면세, 복합과세로 발급된 가상계좌의 경우 발급 정보 변경 기능이 제공되지 않습니다.
+- 고정식 무제한 가상계좌의 경우 amount 파라미터를 전달하여도 적용되지 않습니다.
+
+</div>
+
+### 입금 내역 확인
+
+#### 결제건 조회 API
+
+고정식 무제한 가상계좌의 경우 `deposit_history` 필드로 입금 내역을 확인할 수 있습니다.
+
+**응답 필드 (주요)**
+
+- `deposit_history`: 입금 내역 배열
+  - `pg_tid`: PG사 승인번호
+  - `amount`: 입금 금액
+  - `depositor_name`: 입금자명
+  - `deposited_at`: 입금 시각
+
+<div class="hint" data-style="warning">
+
+**유의 사항**
+
+- **무제한 가상계좌**: 웹훅 수신 후 반드시 결제건 조회 API로 `deposit_history`를 확인하여 정확한 입금 내역을 검증하세요.
+- **취소 후 입금**: 취소된 무제한 가상계좌로 입금이 발생하면 status가 `cancelled`로 유지되므로, `deposit_history`와 `cancel_history`를 모두 확인해야 합니다.
+
+</div>

package/assets/docs/opi/ko/integration/pg/v1/smartro-v2/caution.md

@@ -309,7 +309,7 @@ PortOne.requestPayment({
 ### 주문 번호에 특수문자 입력 불가능
 
 스마트로는 주문 번호(`merchant_uid`)에 특수문자를 허용하고 있지 않습니다.
-따라서 결제창에서 일반결제를 할 때와 발급된 빌링키로 API를 통해 재결제를 하는 경우
+따라서 결제창에서 일반결제를 할 때와 발급된 빌링키로 API를 통해 결제를 하는 경우
 숫자, 문자(알파벳 소문자와 대문자) 또는 그 조합으로 이루어진 주문 번호를 사용해주세요.
 
 ### 주문 번호 40자 길이 제한

package/assets/docs/opi/ko/integration/pg/v1/spb/readme.md

@@ -275,33 +275,34 @@ STC 기능을 사용하시기 위해 다음 정보를 확인하셔야 합니다.
 // 해당 파라미터들은 산업군 별로 추가가 필요하거나 제외해도 되는 파라미터들이 있습니다.
 {
   "additional_data": [
+    // 상점의 구매자 계정 기준으로 정보 입력
     {
-      "key": "sender_account_id", // 고객사 account ID(merchant-id)
+      "key": "sender_account_id", // 구매자 계정 ID
       "value": "A12345N343"
     },
     {
-      "key": "sender_first_name", // 고객사의 account에 등록 된 구매자의 이름
+      "key": "sender_first_name", // 구매자 이름
       "value": "John"
     },
     {
-      "key": "sender_last_name", // 고객사의 account에 등록 된 구매자의 이름
+      "key": "sender_last_name", // 구매자 성
       "value": "Doe"
     },
     {
-      "key": "sender_email", // 고객사의 account에 등록 된 구매자의 이메일 주소
+      "key": "sender_email", // 구매자 이메일 주소
       "value": "example@example.com"
     },
     {
-      "key": "sender_phone", // 고객사의 account에 등록 된 구매자의 연락처
+      "key": "sender_phone", // 구매자 휴대전화 번호
       "value": "(02)16705176"
     },
     {
-      "key": "sender_country_code", // 고객사의 account에 등록 된 국가 코드
+      "key": "sender_country_code", // 구매자 국가 코드
       "value": "KR" // ISO Alpha-2 형식 국가 코드
     },
     {
-      "key": "sender_create_date", // 고객사의 account에 등록 된 국가 코드
-      "value": "2023-10-10T23:59:59+09:00" // IOS8601 형식
+      "key": "sender_create_date", // 구매자 계정 생성 시각
+      "value": "2023-10-10T23:59:59+09:00" // RFC 3339 형식
     }
   ]
 }
@@ -397,7 +398,7 @@ STC 기능을 사용하시기 위해 다음 정보를 확인하셔야 합니다.
 
 ### Alternative Methods
 
-페이팔은 간편 결제를 Alternative Methods라고 부르고 있습니다. Alternative Methods도 Pay Later 처럼 결제가 가능한 국가와 통화는 매우 제한적입니다.
+페이팔은 간편 결제를 Alternative Methods라고 부르고 있습니다. Alternative Methods도 Pay Later처럼 결제가 가능한 국가와 화폐는 매우 제한적입니다.
 
 - Bancontact
   - 구매자: BE / EUR

package/assets/docs/opi/ko/integration/pg/v1/tosspay-v2/readme.md

@@ -257,7 +257,7 @@ IMP.request_pay(
 
 **빌링키로 결제 요청하기**
 
-빌링키 발급 시 전달한 `customer_uid`를 이용해서 재결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 발급 시 전달한 `customer_uid`를 이용해서 빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment?v=v1#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```ts
 await fetch("https://api.iamport.kr/subscribe/payments/again", {