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

package/assets/docs/help/procedure/recommendation/package.md

@@ -17,7 +17,6 @@ searchTags:
   - 카카오페이
   - 다날
   - 추천
-  - 토스페이먼츠
   - 많이쓰는PG
   - PG추천
   - PG사 추천
@@ -25,6 +24,11 @@ searchTags:
   - 전자결제신청방법
   - 추천PG
   - 추천패키지
+  - 네이버페이
+  - 이니시스
+  - KPN
+  - 무료
+  - 가입비
 ---
 
 ### **신용카드 일반결제**
@@ -33,7 +37,9 @@ searchTags:
 
 쇼핑몰에서 가장 일반적으로 사용되는 방식이며 결제대행사(PG사)의 결제창을 띄운 뒤 원하는 카드사를 선택하여 앱 카드 · ISP 등으로 인증 과정을 거치는 방식입니다. 사업자는 고객의 결제정보를 보관하지 않기 때문에 고객은 구매를 원할 때마다 결제를 시도해야합니다.
 
-신용카드 일반결제 를 지원하는 결제대행사 중 포트원에서 추천드리는 곳은 <Highlight text="&quot;KG이니시스&quot; 와 &quot;NHN KCP&quot;" /> 입니다.
+신용카드 일반결제 를 지원하는 결제대행사 중
+
+포트원에서 추천드리는 곳은 <Highlight text="&quot;KG이니시스&quot; 와 &quot;한국결제네트웍스(KPN)&quot;" /> 입니다.
 
 <Callout icon="" title="일반결제 가이드 자세히 보러가기↗" />
 
@@ -55,7 +61,7 @@ searchTags:
 
 ### **본인인증**
 
-본인임을 확인할 수 있는 인증서비스로 결제와 무관하게 인증절차가 필요할 때 사용되며 별도 가입이 필요한 서비스입니다. 보통 회원가입을 진행하는 단계에 도입하거나, 나이 제한 등의 서비스 제한이 필요할 경우 연동하여 사용합니다. 포트원에서 추천드리는 PG사는 ‘**다날**’ 입니다.\
+본인임을 확인할 수 있는 인증서비스로 결제와 무관하게 인증절차가 필요할 때 사용되며 별도 가입이 필요한 서비스입니다. 보통 회원가입을 진행하는 단계에 도입하거나, 나이 제한 등의 서비스 제한이 필요할 경우 연동하여 사용합니다. 포트원에서 추천드리는 PG사는<Highlight text="&quot;다날&quot;" /> 입니다.\
 ※ 결제대행사 다날에서 제공하는 휴대폰 본인인증과 인증서비스가 상이하오니 자세한 사항은 아래 서비스 상세가이드를 참조해주시기 바랍니다.
 
 <Callout icon="" title="본인인증 가이드 자세히 보러가기↗" />
@@ -89,7 +95,7 @@ searchTags:
 
 - 우측 ‘전자결제 직접 선택하기’ 버튼 > 일반결제에서 해외결제를 지원하는 결제대행사 선택 후 ‘신용카드 일반결제’로 신청 가능합니다. 이후, 결제대행사사측에 ‘해외카드’서비스 이용을 별도 요청하시어 계약 진행을 하시기 바랍니다.
 
-5\. 추천패키지 신청 고객사에 제공되는 제휴혜택이 있나요?
+**5. 추천패키지 신청 고객사에 제공되는 제휴혜택이 있나요?**
 
 - 포트원이 추천해드리는 결제대행사 추천패키지를 선택하시면 해당 결제대행사와 계약을 맺으실 때 보다 빠르게 진행 될 수 있습니다.
 - 포트원 추천패키지를 통해 결제대행사(PG사) 계약을 완료한 고객사에는  Salesfroce(세일즈포스) 특별할인가, 메일링 서비스 Stibee(스티비) 요금제 할인코드 서비스까지 특별 제휴혜택을 제공합니다.

package/assets/docs/opi/ko/etc/recon.md

@@ -10,7 +10,7 @@ description: >-
 - 포트원을 통해 연동된 아래 12개의 PG사 내역을 조회할 수 있습니다.
   - 지원 PG : **KCP, KG이니시스, 나이스정보통신, 토스페이, 네이버페이, 다날, 페이코, (구)토스페이먼츠, 토스페이먼츠, 카카오페이, 엑심베이, 헥토파이낸셜**
   - 고객사가 포트원을 통하지 않고 PG 직연동한 경우 지원 불가
-  - 9/26 이후 지원 예정 PG사 : KPN, 하이픈, KSNET
+  - 9/26 이후 지원 예정 PG사 : KPN, KSNET
 
 - 고객사 주문번호를 정확하게 확인하기 위해서는 **실제 사용하시는 주문번호의 연동**이 필요합니다.
 

package/assets/docs/opi/ko/extra/smart-routing/intro.md

@@ -47,7 +47,6 @@ API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정
 - **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
 - **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
 - **엑심베이** : 카드
-- **하이픈** : 실시간 계좌이체
 
 ### API 수기(키인)결제
 

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

@@ -76,7 +76,7 @@ IMP.request_pay(
   - trans (실시간 계좌이체)
   - vbank(가상계좌)
   - phone(휴대폰 소액결제) : 휴대폰 결제인 경우 pg 파라미터는 **`danal`** 로 지정하면 됩니다.
-  - cultureland (문화상품권)
+  - cultureland (컬쳐랜드 문화상품권)
   - booknlife (도서문화상품권)
 
 - merchant\_uid: string

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

@@ -93,7 +93,7 @@ IMP.request_pay(
   - payco (페이코)
   - samsung (삼성페이)
   - applepay (애플페이)
-  - cultureland (문화상품권)
+  - cultureland (컬쳐랜드 문화상품권)
   - smartculture (스마트문화상품권)
   - booknlife (도서문화상품권)
 
@@ -193,7 +193,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" \

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

@@ -110,7 +110,7 @@ IMP.request_pay(
   - `trans` (실시간 계좌이체)
   - `vbank`(가상계좌)
   - `phone` (휴대폰소액결제)
-  - `cultureland` (문화상품권)
+  - `cultureland` (컬쳐랜드 문화상품권)
   - `smartculture` (스마트문상)
   - `booknlife`(도서문화상품권)
 
@@ -275,7 +275,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" \

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

@@ -289,7 +289,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#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
+빌링키 결제([**POST /subscribe/payments/again**](https://developers.portone.io/api/rest-v1/nonAuthPayment#post%20%2Fsubscribe%2Fpayments%2Fagain)) REST API를 다음과 같이 호출합니다.
 
 ```sh
 curl -H "Content-Type: application/json" \

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

@@ -334,7 +334,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" \

package/assets/docs/opi/ko/integration/pg/v1/nhn-kcp.md

@@ -667,7 +667,7 @@ IMP.request_pay(
       kcpQuick: {
         //KCP퀵페이 설정 정보
         actionType: "Register", //결제수단 등록
-        memberCI: "djkDFJ45dFndkl", //본인인증 후 전달된 CI 값
+        encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
         memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
       },
     },
@@ -702,7 +702,7 @@ IMP.request_pay(
       kcpQuick: {
         //KCP퀵페이 설정 정보
         actionType: "Deregister", //결제수단 삭제
-        memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
+        encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
         memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
       },
     },
@@ -741,7 +741,7 @@ IMP.request_pay(
       kcpQuick: {
         //KCP퀵페이 설정 정보
         actionType: "Pay", //결제 요청
-        memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
+        encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
         memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
       },
     },
@@ -780,7 +780,7 @@ IMP.request_pay(
       kcpQuick: {
         //KCP퀵페이 설정 정보
         actionType: "PinChange", //PIN번호 변경
-        memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
+        encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
         memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
       },
     },
@@ -815,7 +815,7 @@ IMP.request_pay(
       kcpQuick: {
         //KCP퀵페이 설정 정보
         actionType: "PinReset", //PIN번호 초기화
-        memberCI: "djkDFJ45dFndkl", //결제수단 등록시 입력한 CI 값
+        encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
         memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
       },
     },
@@ -854,7 +854,7 @@ IMP.request_pay(
       kcpQuick: {
         //KCP퀵페이 설정 정보
         actionType: "PhoneChange", //등록된 휴대폰 번호 변경
-        memberCI: "djkDFJ45dFndkl", //본인인증 후 전달된 CI 값
+        encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
         memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
       },
     },
@@ -893,7 +893,7 @@ IMP.request_pay(
       kcpQuick: {
         //KCP퀵페이 설정 정보
         actionType: "Terminate", //유저 및 결제수단 삭제
-        memberCI: "djkDFJ45dFndkl", //본인인증 후 전달된 CI 값
+        encryptedCI: "encrypted_ci", // 본인인증 후 전달받은 CI를 암호화한 값
         memeberID: "use_your_unique_id", //사용자에 대한 고유 식별값
       },
     },
@@ -997,9 +997,9 @@ IMP.request_pay(
       - PhoneChange : 전화번호 변경
       - Terminate : 결제 수단 해지
 
-    - memberCI: string
+    - encryptedCI: string
 
-      **본인인증 CI값**
+      **암호화된 본인인증 CI**
 
     - memberID: string
 
@@ -1051,6 +1051,33 @@ IMP.request_pay(
 
 <details>
 
+<summary>`encryptedCI` 파라미터 안내</summary>
+
+본인인증 후 전달받은 CI 값을 아래 방법으로 암호화하여 입력해야합니다.
+
+포트원 계정의 [REST API Secret](https://developers.portone.io/api/rest-v1/auth?v=v1) 을 SHA-256 해시 알고리즘으로 처리하여 암호화 키를 생성한 후, 해당 키를 사용해 CI 데이터를 AES-256-ECB 방식으로 암호화해야 합니다.
+암호화된 결과는 Base64로 인코딩하여 encryptedCI 파라미터 값으로 전달합니다.
+
+```pseudo
+FUNCTION encryptCi(ci, apiSecret):
+# Step 1: SHA-256으로 API Secret을 해시하여 암호화 키 생성
+key = SHA256(apiSecret)
+
+# Step 2: AES-256-ECB 알고리즘으로 CI 데이터를 암호화
+encryptedData = AES256Encrypt(data = ci, key = key, mode = ECB)
+
+# Step 3: 암호화된 데이터를 Base64로 인코딩
+base64EncodedData = Base64Encode(encryptedData)
+
+# Step 4: Base64 인코딩된 결과 반환
+RETURN base64EncodedData
+END FUNCTION
+```
+
+</details>
+
+<details>
+
 <summary>결제수단을 여러개 등록할 수 있습니다.</summary>
 
 한 고객에게 여러개의 결제수단을 등록할 수 있습니다.
@@ -1063,7 +1090,7 @@ IMP.request_pay(
 
 <summary>결제수단 삭제 요청시 등록할 때 입력한 정보를 동일하게 입력해야 합니다.</summary>
 
-결제수단 삭제(actionType:Deregister) 요청시 결제수단 등록할 때 사용된 `customer_uid` + `memberCI` + `memberID` + `deviceID` + `noAuth` 조합을
+결제수단 삭제(actionType:Deregister) 요청시 결제수단 등록할 때 사용된 `customer_uid` + `encryptedCI` + `memberID` + `deviceID` + `noAuth` 조합을
 동일하게 전송해야 합니다.
 
 </details>

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

@@ -22,7 +22,7 @@ targetVersions:
 
 ## 비인증 결제
 
-(신) 나이스정보통신은 발급 된 빌링키로 재결제(`POST /subscribe/payemnts/again`),
+(신) 나이스정보통신은 발급 된 빌링키로 결제(`POST /subscribe/payments/again`),
 키인 결제(`POST /subscribe/payments/onetime`) 그리고 스케줄 결제(`POST /subscribe/payments/schedule`)를
 모두 지원하며 기본 파라미터 외에 아래 3개의 파라미터를 추가로 지원합니다.
 

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

@@ -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" \

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

@@ -78,9 +78,14 @@ SDK 스크립트의 주소가 `https://cdn.iamport.kr/v1/iamport.js` 인지 확
 
 </div>
 
+## 결제수단별 승인 가능 통화
+
+- 카드: `KRW`, `USD`, `JPY`
+- Alipay: `USD`, `CNY`
+- WeChatPay: `KRW`, `USD`, `CNY`
+
 ## 유의사항
 
 - `merchant_uid` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
-- 페이레터의 경우 구매자 이메일을 필수로 받고있어,`buyer_email`을 필수로 입력하셔야 합니다.
-- 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
+- 페이레터의 경우 구매자 이메일을 필수로 받고 있어,`buyer_email`을 필수로 입력하셔야 합니다.
 - WeChatPay, Alipay 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.

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

@@ -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)

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" \

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/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", {

package/assets/docs/opi/ko/integration/pg/v2/eximbay-v2.md

@@ -1078,3 +1078,5 @@ const response = await axios({
   - Klarna(`P197`) : 엑심베이 정책에 따라 신규 결제 사용 불가
 
 - 모바일 앱 내에서 결제를 연동할 경우 `appScheme` 파라미터를 설정하고 `bypass.eximbay_v2.settings.call_from_app` 파라미터를 "Y"로 설정해야 합니다.
+
+- 엑심베이의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.

package/assets/docs/opi/ko/integration/pg/v2/hyphen.md

@@ -84,7 +84,7 @@ function requestPayment() {
 
 - storeId: string
 
-  **상점 아이디**
+  **스토어 아이디**
 
   포트원 계정에 생성된 상점을 식별하는 고유한 값으로 관리자 콘솔에서 확인할 수 있습니다.
 

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

@@ -61,9 +61,16 @@ targetVersions:
 빌링키 발급 및 결제 요청 시에는 [requestIssueBillingKeyAndPay](https://developers.portone.io/sdk/ko/v2-sdk/billing-key-and-pay-request?v=v2) 함수를 호출해야 합니다.
 `channelKey` 파라미터에 결제 채널 연동 후 생성된 채널 키값을 지정하여 페이레터 해외결제 채널 사용을 명시해주세요.
 
+## 결제수단별 승인 가능 통화
+
+- 카드: `KRW`, `USD`, `JPY`
+- Alipay: `USD`, `CNY`
+- Alipay+: `USD`
+- WeChatPay: `KRW`, `USD`, `CNY`
+
 ## 유의사항
 
 - `paymentId` 에는 영문, 숫자만으로 이루어진 문자열만 입력할 수 있습니다.
 - 페이레터의 경우 구매자 이메일을 필수로 받고있어,`customer.email`을 필수로 입력하셔야 합니다.
-- 해외결제시 카드는 `KRW`, `USD`, `JPY`, 알리페이⋅위챗페이는 `CNY`를 지원합니다.
 - WeChatPay, Alipay, Alipay+ 결제 시 `bypass.payletter_global.servicename` 파라미터를 필수로 입력하셔야 합니다.
+- 페이레터의 경우 결제창을 닫은 이후에 결제가 성공 처리될 수 있습니다. 웹훅을 연동하여 결제 실패 상태에서 결제 성공 상태로 바뀌는 경우를 처리해야 합니다.

package/assets/docs/opi/ko/integration/pg/v2/paypal-v2.md

@@ -1760,7 +1760,7 @@ Pay Later(할부) 기능을 여러 국가에 제공하기 위해서는 **페이
 페이팔은 이상 거래를 줄이기 위해 Risk Data Acquisition 정책을 시행하고 있습니다.
 일반적으로 페이팔 창에서 진행되는 결제나 빌링키 발급은 페이팔이 구매자 접속 정보를 직접 확인하여 이상 거래를 판단합니다.
 
-하지만 발급된 빌링키로 브라우저에서 재결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
+하지만 발급된 빌링키로 브라우저에서 결제하는 경우 \[고객사 브라우저]에서 \[포트원 API]를 통해 \[페이팔 API]가 호출되는 구조로 페이팔이 구매자 접속 정보를 직접 확인할 수 없어 이상거래를 판단하기 어렵습니다.
 따라서 구매자의 브라우저/디바이스 접속 정보를 페이팔에 전달해야 합니다.
 때문에 브라우저에서 발급된 빌링키를 이용하여 결제를 호출하는 경우 **고객사 클라이언트 페이지에 페이팔 Fraudnet 스크립트/Magnes SDK를 반드시 추가해야** 합니다.
 

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

@@ -138,14 +138,6 @@ versionVariants:
 
     - 간편결제 : 토스페이
 
-- **하이픈**
-
-  - 연동 기능 : 간편결제(결제창)
-
-  - 결제 수단
-
-    - 간편결제 : 바로계좌결제
-
 #### 해외결제
 
 - **페이팔**

package/assets/docs/opi/ko/integration/pg/v2/tosspayments.md

@@ -218,7 +218,7 @@ async function schedulePayment() {
   - 상품권 결제 요청 시, 사용하고자 하는 상품권 종류에 따라 아래 목록을 참고하여 `giftCertificateType` 파라미터를 입력해야 합니다.
     - 도서문화상품권 : `BOOKNLIFE`
     - 스마트문상 ((구)게임문화상품권) : `SMART_MUNSANG`
-    - 문화상품권 : `CULTURELAND`
+    - 컬쳐랜드 문화상품권 : `CULTURELAND`
 
 - `paymentId`
   - 토스페이먼츠를 사용하는 경우 영문 대소문자, 숫자, 특수문자(-,\_)만 허용되며, 6자 이상 64자 이하만 가능합니다.

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

@@ -840,38 +840,6 @@ DI\_CODE는 12자리로 고객사에서 자체적으로 사이트(서비스)를
 
 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
 
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
-
-<details>
-
-<summary>하이픈</summary>
-
-1. [HYPHEN PAY & 바로계좌결제 운영 백오피스](http://payadmin.hyphen.im/) 접속 후 **바로계좌결제** 선택 후
-   로그인을 합니다.
-
-   (이미지 첨부: HYPHEN 백오피스 로그인 화면)
-
-2. \[상점관리]→\[바로계좌결제 상점정보관리]를 클릭합니다.
-
-3. 상점명을 클릭합니다.
-
-   (이미지 첨부: HYPHEN \[상점관리] - \[상점정보관리] 예시 화면)
-
-4. \[상점 기본정보]에서 \[상점번호]를 확인합니다.
-
-   (이미지 첨부: HYPHEN \[상점 기본정보] 예시 화면)
-
-5. \[암호화 키, 토큰]에서 \[암호화 키]와 \[암호화 토큰]을 확인합니다.
-
-   (이미지 첨부: HYPHEN \[암호화 키, 토큰] 예시 화면)
-
-6. 포트원 콘솔에서 채널 추가 시 \[PG상점아이디(상점 번호)], \[암호화 키], \[암호화 토큰]을
-   입력한 후 \[저장]을 클릭합니다.
-
-</details>
-
-<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
-
 #### 해외 결제대행사
 
 <details>
@@ -909,6 +877,24 @@ PG 거래대사 메뉴를 사용하시는 경우 \[대사 시크릿 키] 항목
 
 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://service.iamport.kr/paymentwall/webhook`를 입력합니다.
+5. \[Pingback signature version]을 `3`으로 설정합니다.
+
+(이미지 첨부: 페이먼트월 Pingback 설정 화면)
+
 </details>
 
 <!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->

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

@@ -98,7 +98,6 @@ V2는 최신 결제 기능을 가장 빠르게 제공합니다.
 - **한국결제네트웍스(KPN)**
 - **NHN KCP**
 - **토스페이**
-- **하이픈 바로계좌결제**
 
 ### 본인인증
 

package/assets/docs/opi/ko/integration/webhook/readme-v2.md

@@ -46,7 +46,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
     - `Transaction.PartialCancelled`: **결제가 부분 취소**되었을 때
     - `Transaction.Cancelled`: **결제가 완전 취소**되었을 때
     - `Transaction.Failed`: **결제(예약 결제 포함)가 실패**했을 때
-    - `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (해외 결제시 발생 가능)
+    - `Transaction.PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
     - `Transaction.CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
     - `Transaction.DisputeCreated`: **분쟁이 발생**되었을 때
     - `Transaction.DisputeResolved`: **분쟁이 해소**되었을 때
@@ -127,7 +127,7 @@ Webhook을 활용하면 커스텀 기능이나 다른 애플리케이션과 연
   - `PartialCancelled`: **결제가 부분 취소**되었을 때
   - `Cancelled`: **결제가 완전 취소**되었을 때
   - `Failed`: **결제(예약 결제 포함)가 실패**했을 때
-  - `PayPending`: **결제 승인 대기** 상태가 되었을 때 (해외 결제시 발생 가능)
+  - `PayPending`: **결제 승인 대기** 상태가 되었을 때 (페이팔에서 발생 가능)
   - `CancelPending`: (결제 취소가 비동기로 수행되는 경우) **결제 취소를 요청**했을 때
 
 웹훅 payload 예시: