@portone/mcp-server 0.13.0

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

@@ -0,0 +1,155 @@
+---
+title: 스마트 라우팅
+description: 멀티PG 환경을 클릭 한 번으로 쉽게 만들 수 있는 결제 트래픽 분산 자동화 서비스 입니다.
+targetVersions:
+  - v1
+  - v2
+---
+
+## 스마트 라우팅이란?
+
+(관련 이미지 첨부)
+
+스마트 라우팅은 원클릭 결제 트래픽 자동 분산 서비스로 최초 연동 이후 포트원 관리자콘솔 내에서
+결제대행사 추가/삭제 및 결제대행사 별 결제 요청 비율을 설정할 수 있습니다.
+노코드 방식으로 고객사에서 멀티 PG 인프라를 구성하는데 필요한 개발 리소스를 확 줄였습니다.
+
+SDK 일반결제 및 API 키인(수기) 결제 요청 시 스마트 라우팅 그룹 아이디를 지정하여 호출하는 경우
+설정하신 그룹 내 결제대행사 비율에 따라 확률에 기반하여 결제를 요청합니다.
+
+API 빌링키 발급 요청 시 스마트 라우팅 그룹 아이디를 지정하여 호출하는 경우 설정하신 그룹 내
+모든 결제대행사로 빌링키를 발급 요청합니다. 하나의 포트원 빌링키에 발급된 모든 결제대행사의 빌링키가
+맵핑되며 이를 **슈퍼 빌링키**라고 부릅니다. 슈퍼 빌링키를 이용하여 빌링키 결제 또는 예약 결제 시
+그룹 내 결제대행사 비율에 따라 확률에 기반하여 그 중 하나의 결제대행사 빌링키로 결제를 요청합니다.
+
+## 사용 가능한 PG사 및 결제수단 <span id="available-pg" />
+
+스마트 라우팅 기능은 아래 PG사에 한하여 제공하고 있습니다.
+(추후 지원 PG사 확대 예정)
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT START -->
+
+### 결제창(SDK) 인증결제
+
+- **나이스페이먼츠(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **(구) 나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **KG 이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **토스페이먼츠(신모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **토스페이먼츠(구모듈)** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **스마트로(신모듈)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **스마트로(구모듈)** : 카드 / 실시간 계좌이체 / 가상계좌
+- **다날** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **키움페이** : 카드 / 실시간 계좌이체 / 가상계좌
+- **헥토파이낸셜** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **KG모빌리언스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **KSNET** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **이지페이(KICC)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **웰컴페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **엑심베이** : 카드
+- **하이픈** : 실시간 계좌이체
+
+### API 수기(키인)결제
+
+- **나이스페이먼츠(신모듈)** : 카드
+- **NHN KCP** : 카드
+- **KG 이니시스** : 카드
+- **토스페이먼츠(신모듈)** : 카드
+- **키움페이** : 카드
+- **KSNET** : 카드
+
+### API 빌링키 발급 및 정기결제
+
+- **나이스페이먼츠 (신모듈)** : 카드
+- **(구) 나이스페이먼츠** : 카드
+- **NHN KCP** : 카드
+- **KG이니시스** : 카드
+- **토스페이먼츠(신모듈)** : 카드
+- **키움페이** : 카드
+- **헥토파이낸셜** : 카드
+- **KSNET** : 카드
+- **웰컴페이먼츠** : 카드
+
+<!-- VERSION-SPECIFIC: V1 ONLY CONTENT END -->
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT START -->
+
+### 결제창(SDK) 인증결제
+
+- **나이스페이먼츠** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **KG이니시스** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **토스페이먼츠** : 카드 / 퀵계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **한국결제네트웍스(KPN)** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **KSNET** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **스마트로** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+- **NHN KCP** : 카드 / 실시간 계좌이체 / 가상계좌 / 휴대폰 소액결제
+
+### API 수기(키인)결제
+
+- **나이스페이먼츠** : 카드 / 가상계좌
+- **KG이니시스** : 카드 / 가상계좌
+- **토스페이먼츠** : 카드 / 가상계좌
+- **한국결제네트웍스(KPN)** : 카드 / 가상계좌
+- **KSNET** : 카드 / 가상계좌
+- **스마트로** : 가상계좌
+- **NHN KCP** : 카드 / 가상계좌
+
+### API 빌링키 발급 및 정기결제
+
+- **나이스페이먼츠** : 카드
+- **KG이니시스** : 카드
+- **토스페이먼츠** : 카드
+- **한국결제네트웍스(KPN)** : 카드
+- **KSNET** : 카드
+- **스마트로** : 카드
+- **NHN KCP** : 카드
+
+<!-- VERSION-SPECIFIC: V2 ONLY CONTENT END -->
+
+## 스마트 라우팅 연동 안내
+
+(관련 이미지 첨부)
+
+스마트 라우팅을 사용하기 위해서는 포트원 관리자콘솔 내 \[연동 관리] - \[스마트 라우팅]에서 그룹 설정이 필요합니다.
+자세한 내용은 [스마트 라우팅 그룹 설정 가이드](https://developers.portone.io/opi/ko/extra/smart-routing/console-guide)에서 확인할 수 있습니다.
+
+그룹 설정 후 결제 요청 시 `channelGroupId` 파라미터를 지정하여 호출해야 합니다.
+자세한 내용은 [스마트 라우팅 연동하기](https://developers.portone.io/opi/ko/extra/smart-routing/integration)에서 확인할 수 있습니다.
+
+## 스마트 라우팅 FAQ
+
+<details>
+
+<summary> 스마트 라우팅 그룹 이용 시 지원되는 모든 결제수단을 사용할 수 있는건가요? </summary>
+
+스마트 라우팅 그룹을 지정하여 결제 호출 시 결제 수단에 대한 제약은 없습니다.
+다만, 스마트 라우팅 이용 시 동일한 그룹 내에 설정된 채널은 가급적 동일한 결제수단으로 계약이 완료되어 있어야 합니다.
+
+ex) 카드 및 가상계좌 이용을 원하시는 경우 스마트 라우팅 그룹에서 사용할 모든 PG사와
+카드 및 가상계좌 사용 계약이 필요합니다.
+
+그렇지 않는 경우 결제 호출 시 결제 수단에 따라 에러가 리턴될 수 있으며, 결제창 호출이 불가능할 수 있습니다.
+
+</details>
+
+<details>
+
+<summary> 간편결제도 스마트 라우팅 기능을 사용할 수 있나요? </summary>
+
+**간편결제 허브형을 사용하시는 경우**, 결제대행사 별 계약에 따라 결제창에 표시되는 간편결제가 상이할 수 있습니다.
+
+**간편결제 다이렉트 호출을 사용하시는 경우**, 결제대행사 별 계약에 따라 결제 호출 시 에러가 리턴되며 결제창이
+호출되지 않을 수 있습니다. 가급적 결제대행사 별 동일한 간편결제 수단을 모두 계약하신 후 사용하시길 권장드립니다.
+
+단, **간편결제 직연동**의 경우 스마트 라우팅 기능을 제공하지 않습니다.
+
+</details>
+
+<details>
+
+<summary> SDK(결제창) 빌링키 발급할 때도 사용하고 싶어요!</summary>
+
+SDK(결제창) 빌링키 발급의 경우 해당 기능을 지원하지 않습니다. 빌링키 발급 시 스마트 라우팅 기능을 사용하고
+싶으신 경우 API 방식으로 빌링키를 발급하여 사용하시길 권장드립니다.
+
+</details>

package/assets/docs/opi/ko/integration/cancel/v1/basic.md

@@ -0,0 +1,324 @@
+---
+title: 결제취소(환불) 연동하기
+description: 포트원 결제취소 API를 이용한 결제취소 방법을 안내합니다.
+targetVersions:
+  - v1
+versionVariants:
+  v2: /opi/ko/integration/cancel/v2/readme
+---
+
+## **STEP 01.** 취소 요청하기
+
+필요한 취소 정보를 서버로 전달하여 취소 요청을 진행합니다. 가상계좌 환불의 경우 환불수령 계좌 정보를
+추가 파라미터로 전달해야 합니다. 다음은 환불요청을 하기 위해 서버로 해당 정보를 전달하는 예제입니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="HTML">
+
+```html title="client-side"
+<button onclick="cancelPay()">환불하기</button>
+<script
+  src="https://code.jquery.com/jquery-3.3.1.min.js"
+  integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="
+  crossorigin="anonymous"
+></script>
+<script>
+      function cancelPay() {
+      jQuery.ajax({
+          // 예: http://www.myservice.com/payments/cancel
+          "url": "{환불정보를 수신할 고객사 서비스 URL}",
+          "type": "POST",
+          "contentType": "application/json",
+          "data": JSON.stringify({
+              "merchant_uid": "{결제건의 주문번호}", // 예: ORD20180131-0000011
+              "cancel_request_amount": 2000, // 환불금액
+              "reason": "테스트 결제 환불" // 환불사유
+              // [가상계좌 환불시 필수입력] 환불 수령계좌 예금주
+              "refund_holder": "홍길동",
+              // [가상계좌 환불시 필수입력] 환불 수령계좌 은행코드(예: KG이니시스의 경우 신한은행은 88번)
+              "refund_bank": "88"
+              // [가상계좌 환불시 필수입력] 환불 수령계좌 번호
+              "refund_account": "56211105948400"
+          }),
+          "dataType": "json"
+      });
+  }
+</script>
+```
+
+</div>
+
+<div class="tabs-content" data-title="React.js">
+
+```tsx title="client-side"
+class CancelPay extends React.Component {
+  cancelPay = () => {
+    axios({
+      url: "{환불요청을 받을 서비스 URL}", // 예: http://www.myservice.com/payments/cancel
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+      },
+      data: {
+        merchant_uid: "{결제건의 주문번호}", // 주문번호
+        cancel_request_amount: 2000, // 환불금액
+        reason: "테스트 결제 환불", // 환불사유
+        refund_holder: "홍길동", // [가상계좌 환불시 필수입력] 환불 수령계좌 예금주
+        refund_bank: "88", // [가상계좌 환불시 필수입력] 환불 수령계좌 은행코드(예: KG이니시스의 경우 신한은행은 88번)
+        refund_account: "56211105948400", // [가상계좌 환불시 필수입력] 환불 수령계좌 번호
+      },
+    });
+  };
+  render() {
+    return <button onClick={this.cancelPay}>환불하기</button>;
+  }
+}
+```
+
+</div>
+
+</div>
+
+## **STEP 02.** 결제정보 조회하기
+
+아래와 같이 결제정보를 저장하는 \*\*`Payments`\*\*라는 테이블을 생성했다고 가정합니다.
+
+```js title="server-side"
+/* ... model/payments.js ... */
+const mongoose = require("mongoose");
+const Schema = mongoose.Schema;
+const PaymentsSchema = new Schema({
+  imp_uid: String, // 포트원 `unique key`(환불 요청시 `unique key`로 사용)
+  merchant_uid: String, // 주문번호(결제정보 조회시 사용)
+  amount: { type: Number, default: 0 }, // 결제 금액(환불 가능 금액 계산시 사용)
+  // 환불 된 총 금액(환불 가능 금액 계산시 사용)
+  cancel_amount: { type: Number, default: 0 },
+});
+module.exports = mongoose.model("Payments", PaymentsSchema);
+```
+
+클라이언트에서 받은 주문번호(**`merchant_uid`**)를 사용해서 해당 주문의 결제정보를 **`Payments`** 테이블에서 조회합니다.
+
+```js title="server-side"
+/* ... 중략 ... */
+const Payments = require("./models/payments");
+app.post("/payments/cancel", async (req, res, next) => {
+  try {
+    /* 액세스 토큰(access token) 발급 */
+    /* ... 중략 ... */
+    /* 결제정보 조회 */
+    const { body } = req;
+    const { merchant_uid } = body; // 클라이언트로부터 전달받은 주문번호
+    Payments.find({ merchant_uid }, async function (err, payment) {
+      if (err) {
+        return res.json(err);
+      }
+      const paymentData = payment[0]; // 조회된 결제정보
+      /* 포트원 REST API로 결제환불 요청 */
+      // ...
+    });
+  } catch (error) {
+    res.status(400).send(error);
+  }
+});
+```
+
+## **STEP 03.** **포트원 서버에 취소 요청하기**
+
+취소 요청을 하기 위해서 먼저 [**REST API access token**](https://developers.portone.io/api/rest-v1/auth?v=v1#post%20%2Fusers%2FgetToken)을
+발급받습니다. 발급받은 액세스 토큰(**`access token`**)을 이용하여
+[**포트원 취소 API**](https://developers.portone.io/api/rest-v1/payment?v=v1#post%20%2Fpayments%2Fcancel)를 호출하여 결제 취소를 요청합니다.
+
+<div class="hint" data-style="info">
+
+**휴대폰 소액결제 환불 시 유의사항**
+
+- **결제가 이루어진 월과 환불을 요청하는 월이 다를 경우, 전액환불도 불가능**합니다. 예를 들어, 1월 31일 결제건은 2월 1일에 환불할 수 없습니다.
+
+</div>
+
+아래는 환불요청 시 유의해야 하는 파라미터들입니다.
+
+> **환불 `unique key`**
+>
+> 환불 대상 거래를 특정하기 위해서 `imp_uid` 또는 `merchant_uid`를 환불 `unique key`로 설정합니다.
+> `imp_uid`의 값이 우선순위를 갖게되며 유효하지 않는 `imp_uid`값을 입력하면 `merchant_uid`값과
+> 무관하게 환불요청이 실패합니다.
+
+> **환불 금액**(`amount`)
+>
+> **미입력시 전액이 환불**됩니다.
+
+> **환불 가능 금액**(`checksum`)
+>
+> 환불이 가능한 금액을 입력합니다. 예를 들어, 10\*\*,\*\*000원짜리 제품의 `checksum`은 10,000입니다.
+> 만약 10,000원짜리 제품이 과거 1,000원 부분환불 되었다면, 이후 환불시 `checksum`은
+> 9,000입니다.입력된 `checksum`을 사용해서 서버와 포트원 서버간에 환불 가능 금액이 일치하는지
+> 확인합니다. 만약 일치하지 않으면 환불 요청은 실패하며 미 입력시 검증은 실행되지 않습니다.
+
+<div class="hint" data-style="warning">
+
+**checksum을 입력해야 하는 이유**
+
+`checksum`은 필수입력은 아니지만 **서버와 포트원 서버간에 환불 가능 금액을 검증하기** 위해서 입력을 권장합니다.
+
+예를 들어, 10,000원짜리 제품에 대한 1,000원 부분환불 요청이 포트원 서버에서 완료하였으나 고객사가 서버 혹은 DB오류로 이를 반영하지 못했다면? 포트원 서버의 checksum은 9,000이 되고, 고객사 서버의 checksum은 그대로 10,000이 됩니다.
+
+이후 남은 금액을 환불하려고 할때 `checksum(10,000)`을 입력하면, 해당 값이 포트원 서버의 `checksum(9,000)`과 일치하지 않으므로 요청은 실패합니다.
+
+</div>
+
+아래는 환불 요청을 하는 예제입니다.
+
+```ts title="Node.js"
+/* ... 중략 ... */
+app.post("/payments/cancel", async (req, res, next) => {
+  try {
+    /* 액세스 토큰(access token) 발급 */
+    /* ... 중략 ... */
+    /* 결제정보 조회 */
+    const { body } = req;
+    // 클라이언트로부터 전달받은 주문번호, 환불사유, 환불금액
+    const { merchant_uid, reason, cancel_request_amount } = body;
+    Payments.find({ merchant_uid }, async function (err, payment) {
+      /* ... 중략 ... */
+      const paymentData = payment[0]; // 조회된 결제정보
+      // 조회한 결제정보로부터 imp_uid, amount(결제금액), cancel_amount(환불된 총 금액) 추출
+      const { imp_uid, amount, cancel_amount } = paymentData;
+      // 환불 가능 금액(= 결제금액 - 환불 된 총 금액) 계산
+      const cancelableAmount = amount - cancel_amount;
+      if (cancelableAmount <= 0) {
+        // 이미 전액 환불된 경우
+        return res.status(400).json({ message: "이미 전액환불된 주문입니다." });
+      }
+      /* 포트원 REST API로 결제환불 요청 */
+      const getCancelData = await axios({
+        url: "https://api.iamport.kr/payments/cancel",
+        method: "post",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: access_token, // 포트원 서버로부터 발급받은 엑세스 토큰
+        },
+        data: {
+          reason, // 고객사 클라이언트로부터 받은 환불사유
+          imp_uid, // imp_uid를 환불 `unique key`로 입력
+          amount: cancel_request_amount, // 고객사 클라이언트로부터 받은 환불금액
+          checksum: cancelableAmount, // [권장] 환불 가능 금액 입력
+        },
+      });
+      const { response } = getCancelData.data; // 환불 결과
+      /* 환불 결과 동기화 */
+      // ...
+    });
+  } catch (error) {
+    res.status(400).send(error);
+  }
+});
+```
+
+### **STEP 04.** 환불 결과 저장하기
+
+#### 결제 취소가 완료되면 그 결과를 데이터베이스에 다음과 같이 저장합니다.
+
+```ts title="Node.js"
+/* ... 중략 ... */
+app.post("/payments/cancel", async (req, res, next) => {
+  try {
+    /* 액세스 토큰(access token) 발급 */
+    /* ... 중략 ... */
+    /* 결제정보 조회 */
+    Payments.find({ merchant_uid }, async function (err, payment) {
+      /* ... 중략 ... */
+      /* 포트원 REST API로 결제환불 요청 */
+      /* ... 중략 ... */
+      const { response } = getCancelData.data; // 환불 결과
+      /* 환불 결과 동기화 */
+      const { merchant_uid } = response; // 환불 결과에서 주문정보 추출
+      Payments.findOneAndUpdate(
+        { merchant_uid },
+        response,
+        { new: true },
+        function (err, payment) {
+          // 주문정보가 일치하는 결제정보를 추출해 동기화
+          if (err) {
+            return res.json(err);
+          }
+          res.json(payment); // 고객사 클라이언트로 환불 결과 반환
+        },
+      );
+    });
+  } catch (error) {
+    res.status(400).send(error);
+  }
+});
+```
+
+<div class="hint" data-style="warning">
+
+**취소 시 유의할 점**
+
+REST API[**(POST https://api.iamport.kr/payments/cancel)**](https://developers.portone.io/api/rest-v1/payment?v=v1#post%20%2Fpayments%2Fcancel) 요청에 대한 **응답 코드가 200**이라도 응답 body의 code가 0이 아니면 **환불에 실패했다는 의미**입니다. 실패 사유는 body의 message를 통해 확인하셔야 합니다.
+
+</div>
+
+### **STEP 04.** 환불 응답 처리하기
+
+취소요청에 대한 응답을 클라이언트에게 처리하는 로직을 아래와 같이 작성합니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="HTML">
+
+```html title="client-side"
+<button onclick="cancelPay()">환불하기</button>
+<script
+  src="https://code.jquery.com/jquery-3.3.1.min.js"
+  integrity="sha256-FgpCb/KJQlLNfOu91ta32o/NMZxltwRo8QtmkMRdAu8="
+  crossorigin="anonymous"
+></script>
+<!-- jQuery CDN --->
+<script>
+  function cancelPay() {
+    jQuery
+      .ajax({
+        /* ... 중략 ... */
+      })
+      .done(function (result) {
+        // 환불 성공시 로직
+        alert("환불 성공");
+      })
+      .fail(function (error) {
+        // 환불 실패시 로직
+        alert("환불 실패");
+      });
+  }
+</script>
+```
+
+</div>
+
+<div class="tabs-content" data-title="React.js">
+
+```tsx title="client-side"
+class CancelPay extends React.Component {
+  cancelPay = () => {
+    axios(/* ... 중략 ... */)
+      .then((response) => {
+        // 환불 성공시 로직
+        alert("환불 성공");
+      })
+      .catch((error) => {
+        // 환불 실패시 로직
+        alert("환불 실패");
+      });
+  };
+  render() {
+    return <button onClick={this.cancelPay}>환불하기</button>;
+  }
+}
+```
+
+</div>
+
+</div>

package/assets/docs/opi/ko/integration/cancel/v1/virtual-account.md

@@ -0,0 +1,99 @@
+---
+title: 가상계좌 환불하기
+description: 가상계좌 입금내역을 환불하는 방법을 확인합니다.
+targetVersions:
+  - v1
+versionVariants:
+  v2: /opi/ko/integration/cancel/v2/readme
+---
+
+**가상계좌 환불을 위해서는 PG사 **가상계좌 특약서비스**에 가입되어 있어야 합니다.**
+
+<div class="hint" data-style="info">
+
+**가상계좌 특약서비스에 가입해야 하는 이유**
+
+신용카드와는 달리 가상계좌의 경우 결제/환불에 대한 수수료는 환불대상에서 제외됩니다.예를 들어 10,000원 결제건에 대해서 고객사는
+
+- 결제 시, 9,700원(10,000원 - 가상계좌 발행 수수료 300원)을 PG사로부터 정산받습니다.
+- 환불 시, 10,300원(환불되어야할 10,000원 + 환불 계좌로의 송금 수수료 300원)을 PG사로 지불합니다.
+
+PG사는 이런 과정에서 발생할 수 있는 혼란을 미연에 방지하고자 **가상계좌 특약서비스에 가입한 고객사에 한해서만 가상계좌 환불을 제공**하고 있습니다.
+
+</div>
+
+가상계좌의 경우 단방향 결제수단이여서 환불 대상을 알 수 없으므로 환불 금액 외에 다음의 환불 수령계좌 정보를 입력해야 합니다.
+
+- `refund_holder`: 환불 수령계좌 예금주
+- `refund_account`: 환불 수령계좌 번호
+- `refund_bank`: 환불 수령계좌 은행코드
+
+<div class="hint" data-style="info">
+
+**가상계좌 은행코드는 PG사에 따라 다릅니다**
+
+`은행코드는`같은 은행이더라도 PG사에 따라 상이하므로 \*\*은행코드(TODO)\*\*표에서 은행코드를 확인해 주세요
+
+</div>
+
+아래는 가상계좌 환불을 요청하는 예제입니다.
+
+```ts title="Node.js"
+/* ... 중략 ... */
+app.post("/payments/cancel", async (req, res, next) => {
+  try {
+    /* 액세스 토큰(access token) 발급 */
+    /* ... 중략 ... */
+    /* 결제정보 조회 */
+    const { body } = req;
+    // 클라이언트로부터 전달받은 주문번호, 환불사유, 환불금액, 가상계좌 정보(예금주, 계좌번호, 은행코드)
+    const {
+      merchant_uid,
+      reason,
+      cancel_request_amount,
+      refund_holder,
+      refund_bank,
+      refund_account,
+    } = body;
+    Payments.find({ merchant_uid }, async function (err, payment) {
+      /* ... 중략 ... */
+      const paymentData = payment[0]; // 조회된 결제정보
+      // 조회한 결제정보로부터 imp_uid, amount(결제금액), cancel_amount(환불된 총 금액) 추출
+      const { imp_uid, amount, cancel_amount } = paymentData;
+      // 환불 가능 금액(= 결제금액 - 환불된 총 금액) 계산
+      const cancelableAmount = amount - cancel_amount;
+      if (cancelableAmount <= 0) {
+        // 이미 전액 환불된 경우
+        return res.status(400).json({ message: "이미 전액환불된 주문입니다." });
+      }
+      /* 포트원 REST API로 결제환불 요청 */
+      const getCancelData = await axios({
+        url: "https://api.iamport.kr/payments/cancel",
+        method: "post",
+        headers: {
+          "Content-Type": "application/json",
+          Authorization: access_token, // 포트원 서버로부터 발급받은 엑세스 토큰
+        },
+        data: {
+          reason, // 고객사 클라이언트로부터 받은 환불사유
+          imp_uid, // imp_uid를 환불 `unique key`로 입력
+          amount: cancel_request_amount, // 고객사 클라이언트로부터 받은 환불금액
+          checksum: cancelableAmount, // [권장] 환불 가능 금액 입력
+          refund_holder, // [가상계좌 환불시 필수입력] 환불 수령계좌 예금주
+          refund_bank, // [가상계좌 환불시 필수입력] 환불 수령계좌 은행코드(ex. KG이니시스의 경우 신한은행은 88번)
+          refund_account, // [가상계좌 환불시 필수입력] 환불 수령계좌 번호
+        },
+      });
+      const { response } = getCancelData.data; // 환불 결과
+      /* 환불 결과 동기화 */
+      // ...
+    });
+  } catch (error) {
+    res.status(400).send(error);
+  }
+});
+```
+
+다음과 같이 가상계좌 환불을 요청하여 성공하면 PG사 담당자가 다음날 해당 계좌로 환불 금액을 입금합니다. 이는 통상적으로 영업일 기준 하루 정도 소요됩니다.
+
+(이미지 첨부: 가상게좌 환불 FLOW)