@portone/mcp-server 0.13.0

package/assets/docs/opi/ko/integration/pg/v1/toss-brandpay/widget.md

@@ -0,0 +1,152 @@
+---
+emoji: ⌨
+title: 브랜드페이 위젯 연동
+description: 토스페이먼츠 브랜드페이 위젯 연동 방법을 안내합니다.
+targetVersions:
+  - v1
+---
+
+- 브랜드페이의 경우 고객사의 주문 페이지에 바로 브랜드페이를 통한 결제가 가능하도록 브랜드페이 UI를
+  렌더링 할 수 있는 위젯 기능을 제공합니다.
+
+- 위젯 기능을 연동하기 위해서는 일반적으로 포트원 SDK에서 사용하던 함수가 아닌 `IMP.loadUI` 함수와
+  `IMP.updateLoadUIRequest` 함수를 사용해야 합니다.
+
+(관련 이미지 첨부)
+
+## 브랜드페이 위젯 렌더링
+
+- 브랜드페이 위젯은 고객사 체크아웃 페이지에 결제수단 선택 UI를 렌더링 한 후, 결제버튼 클릭시
+  브랜드페이로 결제를 하는 방식입니다.
+
+- 따라서 다른 PG사와 결제 플로우가 상이하기 때문에 고객사는 **체크아웃 페이지가 렌더링 되는 시점에
+  `IMP.request_pay` 함수 대신 `IMP.loadUI`라는 별도의 함수를 호출해 위젯을 렌더링 해야**합니다.
+
+(관련 이미지 첨부)
+
+```html
+<!--
+  1. 고객사 체크아웃 페이지가 렌더링됩니다.
+  브랜드페이 위젯을 렌더링 하고 싶은 위치에 "portone-ui-container"라는 class 이름을 갖는 div element를 넣습니다.
+  data-portone-ui-type는 브랜드페이 위젯용임을 나타내는 toss-brandpay-widget로 설정합니다.
+  결제하기 버튼 역할을 하는 element의 경우 id를 "portone-toss-brandpay-widget-button"로 설정해야 합니다.
+  포트원 SDK는 해당 id를 가지는 element를 찾아 결제하기 event를 등록합니다.
+-->
+<div class="portone-ui-container" data-portone-ui-type="toss-brandpay-widget">
+  <!-- 3. 여기에 결제수단 위젯이 생성됩니다. -->
+</div>
+
+<div id="portone-toss-brandpay-widget-button">
+  <!-- 1-1. 결제하기 버튼 구현 -->
+</div>
+
+<script>
+  window.onload = function () {
+    // 2. 고객사 체크아웃 페이지가 렌더링 되면
+    // 2-1. "고객사 식별코드"를 전달해 포트원 객체를 초기화합니다.
+    IMP.init(고객사_식별코드);
+
+    // 2-2. "결제 요청 데이터"와 결제 프로세스가 종료되면 호출 될 "콜백 함수"를 전달하여 브랜드페이 위젯 렌더링을 시도합니다.
+    // 이때 전달하는 파라미터는 IMP.request_pay 함수 호출시 전달하는 파라미터와 동일합니다.
+    IMP.loadUI("toss-brandpay-widget", 결제_요청_데이터, 콜백_함수);
+
+    // 4. 구매자가 결제하기 버튼을 누르면 PG사 결제창이 렌더링 됩니다.
+    // 5. 이때 포트원은 내부적으로 IMP.request_pay 함수를 고객사 대신 호출합니다.
+    // 6-7. 포트원 DB에 미결제(ready) 결제 건이 생성됩니다.
+    // 8. PG사 결제창이 호출됩니다.
+    // 9. 결제 프로세스가 종료되면 2-2번에 두번째 파라미터로 전달 한 콜백 함수가 호출됩니다.
+  };
+</script>
+```
+
+<div class="hint" data-style="info">
+
+### 위젯이 렌더링 되지 않을 때
+
+`portone-ui-container` 라는 class 이름을 갖는 div
+element를 찾지 못할 경우 **portone-ui-container를 찾을 수 없습니다.** 라는 에러가
+발생합니다.
+
+`portone-ui-container` element가 2개 이상인데, `data-portone-ui-type`
+attribute가 `toss-brandpay-widget`인 element를 찾지 못할 경우, **data-portone-ui-type에
+올바른 UI 타입을 입력해주세요.** 라는 에러가 발생합니다.
+
+`portone-ui-container` element가 2개 이상이고, `data-portone-ui-type`
+attribute가 `oss-brandpay-widget`인 elemente도 2개 이상인 경우, **동일한 data-portone-ui-type을
+갖는 DOM element가 2개 이상 존재합니다.** 라는 에러가 발생합니다.
+
+</div>
+
+## 결제 요청 데이터 업데이트
+
+- 브랜드페이의 특성상, 고객사 체크아웃 페이지가 렌더링 될 때 결제 요청 데이터가 결정 되어야 합니다.
+  때문에 고객사 체크아웃 페이지에서 포인트나 쿠폰을 적용 해 결제 금액이 바뀌는 경우에 이를 다시
+  업데이트 할 수 있는 방법이 제공돼야 합니다.
+
+- 포트원 SDK는 위와 같은 경우에 대응하기 위해 결제 정보를 업데이트 할 수 있는
+  `IMP.updateLoadUIRequest` 함수를 제공하고 있습니다.  구매자 입력으로 인해 결제 요청 데이터가
+  변경될때 **IMP.updateLoadUIRequest 함수를 호출**하시면 구매자가 결제 버튼을 누를때 최종적으로 변경
+  된 결제 요청 데이터로 브랜드페이 결제창이 호출됩니다.
+
+(관련 이미지 첨부)
+
+```html
+<form>
+  <!-- 결제 요청 데이터를 입력 받는 form -->
+  <!-- ...중략 -->
+  <label for="amount">결제 금액</label>
+  <!-- 4. 구매자가 쿠폰을 적용해 결제 요청 금액이 변경(예) 1000 -> 2000)되었습니다. -->
+  <input id="amount" name="amount" value="1000" onchnage="onChangeAmount()" />
+</form>
+
+<!--
+  1. 고객사 체크아웃 페이지가 렌더링됩니다.
+  브랜드페이 위젯을 렌더링 하고 싶은 위치에 "portone-ui-container"라는 class 이름을 갖는 div element를 넣습니다.
+  data-portone-ui-type는 브랜드페이 위젯용임을 나타내는 toss-brandpay-widget로 설정합니다.
+  결제하기 버튼 역할을 하는 element의 경우 id를 "portone-toss-brandpay-widget-button"로 설정해야 합니다.
+  포트원 SDK는 해당 id를 가지는 element를 찾아 결제하기 event를 등록합니다.
+-->
+<div class="portone-ui-container" data-portone-ui-type="toss-brandpay-widget">
+  <!-- 3. 여기에 결제수단 위젯이 생성됩니다. -->
+</div>
+
+<div id="portone-toss-brandpay-widget-button">
+  <!-- 1-1. 결제하기 버튼 구현 -->
+</div>
+
+<script>
+  var requestData = {
+    pg: "toss_brandpay",
+    amount: 1000,
+    // ...중략
+  };
+  window.onload = function () {
+    // 2. 고객사 체크아웃 페이지가 렌더링 되면
+    // 2-1. "고객사 식별코드"를 전달 해 포트원 객체를 초기화합니다.
+    IMP.init(고객사_식별코드);
+
+    // 2-2. "결제 요청 데이터"와 결제 프로세스가 종료되면 호출 될 "콜백 함수"를 전달하여 브랜드페이 위젯 렌더링을 시도합니다.
+    // 이때 전달하는 파라미터는 IMP.request_pay 함수 호출시 전달하는 파라미터와 동일합니다.
+    IMP.loadUI("toss-brandpay-widget", requestData, 콜백_함수);
+
+    // 6. 구매자가 결제하기 버튼을 누르면 PG사 결제창이 렌더링 됩니다.
+    // 7. 이떄 포트원은 내부적으로 IMP.request_pay 함수를 고객사 대신 호출하며
+    // 결제 요청 금액은 1000에서 2000으로 변경됩니다.
+
+    // 8-9. 포트원 DB에 미결제(ready) 결제 건이 생성됩니다.
+    // 10. PG사 결제창이 호출됩니다.
+    // 11. 결제 프로세스가 종료되면 2-2번에 두번째 파라미터로 전달 한 콜백 함수가 호출됩니다.
+  };
+
+  function onChangeAmount() {
+    // 5. 결제 요청 금액이 변경되면 고객사가 선언한 onChangeAmount 함수가 호출됩니다.
+    // IMP.updateLoadUIRequest에 최종적으로 변경 된 결제 요청 데이터를 전달합니다.
+    requestData.amount = document.getElementById("amount").value;
+    IMP.updateLoadUIRequest("toss-brandpay-widget", requestData);
+  }
+</script>
+```
+
+## loadUI 요청 객체
+
+loadUI 호출시 파라미터인 결제요청 데이터의 경우 IMP.request\_pay의 요청데이터와 동일한 객체이므로, [브랜드페이 연동문서](https://developers.portone.io/opi/ko/integration/pg/v1/toss-brandpay/readme)를 참고해주세요.

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

@@ -0,0 +1,112 @@
+---
+title: 토스페이먼츠(구모듈)
+description: 토스페이먼츠 연동 방법을 확인합니다.
+targetVersions:
+  - v1
+---
+
+<div class="hint" data-style="warning">
+
+**토스페이먼츠(구모듈) 연동 방법에 관한 매뉴얼**입니다.
+
+신규 연동 고객사이시거나 토스페이먼츠 신모듈로의 업그레이드를 원하신다면 [토스페이먼츠(신모듈) 연동 가이드](https://developers.portone.io/opi/ko/integration/pg/v1/newtoss/readme)로 참고하여 진행해주세요.
+구모듈에 비해 신모듈에서 다양한 기능 및 결제수단을 지원하고 있습니다. 신규 고객사의 경우 가급적 신모듈로 연동하는 것을 권장드립니다.
+
+</div>
+
+## 1. 토스페이먼츠 채널 설정하기
+
+[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
+
+(관련 이미지 첨부)
+
+## 2. 결제창 호출
+
+[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk-old/readme) `IMP.request_pay(param, callback)`을 호출하여
+토스페이먼츠 결제창을 호출할 수 있습니다.
+**결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
+**callback** 으로 수신되어
+모바일의 경우 **m\_redirect\_url** 로 리디렉션됩니다.
+
+예시 코드는 아래와 같습니다.
+
+```ts title="Javascript SDK"
+IMP.request_pay(
+  {
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "card",
+    merchant_uid: "order_no_0001", //상점에서 생성한 고유 주문번호
+    name: "주문명:결제테스트",
+    amount: 1004,
+    buyer_email: "test@portone.io",
+    buyer_name: "구매자이름",
+    buyer_tel: "010-1234-5678",
+    buyer_addr: "서울특별시 강남구 삼성동",
+    buyer_postcode: "123-456",
+    m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
+    appCard: true, // 설정시 신용카드 결제모듈에서 앱카드 결제만 활성화됩니다.
+  },
+  function (rsp) {
+    // callback 로직
+    //* ...중략... *//
+  },
+);
+```
+
+**주요 파라미터 설명**
+
+- channelKey: string
+
+  **채널키**
+
+  결제를 진행할 채널을 지정합니다.
+
+  포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+  (최신 JavaScript SDK 버전부터 사용 가능합니다.)
+
+- pg(deprecated)?: string
+
+  **PG사 구분코드**
+
+  `uplus` 로 지정하면 됩니다.
+
+  <div class="hint" data-style="warning">
+
+  `pg` 파라미터는 지원 중단 예정입니다.
+
+  JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
+
+  </div>
+
+- pay\_method: string
+
+  **결제수단 구분코드**
+
+  - card(신용카드)
+  - transfer(퀵계좌이체)
+  - vbank(가상계좌)
+  - phone(휴대폰소액결제)
+  - applepay(애플페이)
+  - tosspay(토스페이)
+  - naverpay(네이버페이)
+  - kakaopay(카카오페이)
+  - lpay(엘페이)
+  - payco(페이코)
+  - samsung(삼성페이)
+
+- merchant\_uid: string
+
+  **주문번호**
+
+  매번 고유하게 채번되어야 합니다.
+
+- amount: number
+
+  **결제금액**
+
+  **string** 이 아닌점에 유의하세요
+
+- escrow?: boolean
+
+  **에스크로 설정여부**

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

@@ -0,0 +1,65 @@
+---
+title: 연동 유의사항
+description: (신) 토스페이 연동 유의사항을 소개합니다.
+targetVersions:
+  - v1
+---
+
+## 토스페이와 사전 계약이 필요한 경우
+
+아래 기능을 사용하시려면 토스페이에 사전 신청 후 계약이 완료되어야 합니다.
+
+- 비인증 결제
+
+## 공통사항
+
+### 매출전표
+
+카드결제인 경우에만 매출전표가 제공됩니다.
+
+### 현금영수증 발급
+
+토스페이의 경우, 현금영수증 발급에 대한 정보를 따로 입력받지 않고, 앱에 저장된 식별정보로 현금영수증을 발급합니다.
+이 떄문에 현금영수증 타입을 `personal`, `corporate`로 지정하더라도 실제로는 다른 타입의 현금영수증이 발급될 수 있습니다.
+
+## 비인증 결제 관련
+
+### 빌링키 발급 웹훅 연동 권장
+
+토스페이 빌링키 발급시 빌링키 발급 웹훅을 반드시 연동하는 것이 좋습니다. `request_pay` 함수의
+`notice_url`을 입력하거나 콘솔에서 웹훅 URL을 입력하여 웹훅을 전달받을 수 있습니다. 만약 웹훅을
+연동하지 않은 경우 구매자가 빌링키 발급 도중 팝업이나 브라우저를 끄는 행위등으로 인해 고객사의 SDK
+콜백 코드가 실행되지 않아 실제로 빌링키가 발급됐지만 발급정보가 누락되는 케이스가 생길 수 있습니다.
+
+- 웹훅 바디는 아래와 같은 형식으로 전달됩니다. 고객사에서는 `merchant_uid`와 `customer_uid`의
+  매핑관계를 따로 저장하고 웹훅으로 전달받은 `merchant_uid`와 매핑된 `customer_uid`를 이용해 빌링키
+  정보 조회 API를 호출하여 빌링키 정보를 가져올 수 있습니다.
+
+```json title="웹훅 바디 예시"
+{
+  "imp_uid": "imp_895265444670",
+  "merchant_uid": "oid_a12512basbasdasdfqwfasd",
+  "status": "paid"
+}
+```
+
+### customer\_uid 재사용 주의
+
+새로운 빌링키를 발급할 때 기존에 발급했던 빌링키와 동일한 `customer_uid`를 사용하여 기존에 발급된
+빌링키를 덮어씌우지 않도록 주의하세요. 토스페이의 경우 한번 빌링키를 발급했던 수단을 재사용 할 수
+없으므로 기존에 사용하던 `customer_uid`를 재사용하는 경우 이전에 빌링키를 발급했던 수단은 더 이상
+사용 불가능합니다.
+
+### 빌링키 정보 최신화
+
+빌링키가 발급된후에 토스페이앱에서 구매자가 직접 빌링키에 연결된 결제수단을 변경할 수 있습니다. 만약
+빌링키에 연결된 결제수단을 서비스 내부적으로 사용하고 있다면 해당 정보를 보여주기 전 포트원의 빌링키
+정보 조회 API를 호출하여 데이터를 최신화하기를 권장합니다.
+
+## 결제 취소 관련
+
+### 부가세를 직접 지정한 결제의 부분 취소 요청 시 부가세 입력은 필수
+
+부가세를 직접 지정한 결제를 부분 취소 요청하는 경우 취소 금액의 부가세를 입력해야 합니다. 만약 부분
+취소 요청 시 부가세를 입력하지 않는 경우 남은 결제금액의 부가세, 과세금액 정보가 올바르지 않게 될 수
+있으며 이후 추가 부분취소 요청 시 취소 가능 과세금액 계산 오류로 취소 요청이 불가능할 수 있습니다.

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

@@ -0,0 +1,308 @@
+---
+title: 토스페이(tosspay_v2)
+description: 토스페이 연동 방법을 안내합니다.
+targetVersions:
+  - v1
+versionVariants:
+  v2: /opi/ko/integration/pg/v2/tosspay-v2
+---
+
+<div class="hint" data-style="info">
+
+토스페이(tosspay\_v2)에서는 일반결제 및 정기결제 모두 지원하고 있습니다.
+신규 연동하시는 고객사께서는 해당 가이드를 참고하여 진행해주세요.
+
+</div>
+
+## 1. 토스페이 채널 설정하기
+
+[결제대행사 채널 설정하기](https://developers.portone.io/opi/ko/integration/ready/readme#3-결제대행사-채널-설정하기) 페이지의 내용을 참고하여 채널 설정을 진행합니다.
+
+(관련 이미지 첨부)
+
+## 2. 최신 JavaScript SDK로 업데이트하기 <a href="#2." id="2." />
+
+토스페이 결제는 최신 SDK에서만 지원되는 기능입니다.
+
+```html title="JS SDK"
+<script src="https://cdn.iamport.kr/v1/iamport.js"></script>
+```
+
+<div class="hint" data-style="info">
+
+**토스페이를 연동하기 위해서는 위에 안내된 JS SDK를 이용하셔야 합니다.**
+
+[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme)문서를 통해 최신 SDK를 설치해주세요.
+
+</div>
+
+## 3.결제 요청하기
+
+[JavaScript SDK](https://developers.portone.io/sdk/ko/v1-sdk/javascript-sdk/readme) `IMP.request_pay(param, callback)`을 호출하여
+결제창을 호출할 수 있습니다. **결제결과**는 PC의 경우 `IMP.request_pay(param, callback)` 호출 후
+**callback**으로 수신되고
+모바일의 경우 **m\_redirect\_url** 로 리디렉션됩니다.
+
+<div class="tabs-container">
+
+<div class="tabs-content" data-title="인증 결제창 요청">
+
+```ts title="Javascript SDK"
+IMP.request_pay(
+  {
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "tosspay", // 'tosspay_card', 'tosspay_money' 도 지원됩니다.
+    merchant_uid: "orderMonthly0001", // 상점에서 관리하는 주문 번호
+    name: "최초인증결제",
+    buyer_email: "test@portone.io",
+    buyer_name: "포트원",
+    buyer_tel: "02-1234-1234",
+    m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
+    amount: 1004,
+    card: {
+      useInstallment: false,
+    },
+    bypass: {
+      expiredTime: "2023-12-02 11:00:00", //결제 만료시간
+      cashReceiptTradeOption: "CULTURE", //현금영수증 발급타입
+    },
+  },
+  function (rsp) {
+    // callback 로직
+  },
+);
+```
+
+<details>
+
+<summary>
+
+<strong>주요 파라미터 설명</strong>
+
+</summary>
+
+- channelKey: string
+
+  **채널키**
+
+  결제를 진행할 채널을 지정합니다.
+
+  포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+  (최신 JavaScript SDK 버전부터 사용 가능합니다.)
+
+- pg(deprecated)?: string
+
+  **PG사 구분코드**
+
+  `tosspay_v2` 로 지정하면 됩니다.
+
+  <div class="hint" data-style="warning">
+
+  `pg` 파라미터는 지원 중단 예정입니다.
+
+  JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
+
+  </div>
+
+- pay\_method: string
+
+  **결제수단 구분코드**
+
+  - `tosspay_money` : 계좌결제만 허용합니다.
+  - `tosspay_card` : 카드결제만 허용합니다.
+  - `tosspay` : 모든 결제수단을 허용합니다.
+
+- merchant\_uid: string
+
+  **주문번호**
+
+  매번 고유하게 채번되어야 합니다.
+
+- amount: number
+
+  **결제금액**
+
+  string 이 아닌점에 유의하세요
+
+- card.useInstallment: boolean
+
+  **할부 사용 가능 여부**
+
+- bypass?: object
+
+  - expiredTime: string
+
+    **결제 만료 기한**
+
+    `yyyy-MM-dd HH:mm:ss` 의 형식입니다.
+
+    입력하지 않을 경우, 기본값인 15분으로 설정됩니다. 최대 60분까지 설정할 수 있습니다.
+
+  - cashReceiptTradeOption: string
+
+    **현금영수증 발급 대상 타입**
+
+    전달하지 않을경우, 기본값은 `GENERAL` 입니다.
+
+    - `GENERAL`: 일반 (default)
+    - `CULTURE`: 문화비
+    - `PUBLIC_TP`: 교통비
+
+</details>
+
+</div>
+
+<div class="tabs-content" data-title="비인증 결제창 요청">
+
+인증결제창 호출 파라미터에서 **customer\_uid**, **customer\_id**값을 추가하면 비인증 결제창을 호출할 수 있습니다.
+비인증 결제창에서 빌링키를 발급받은 후 해당 빌링키로 결제를 요청합니다.
+
+```ts title="Javascript SDK"
+IMP.request_pay(
+  {
+    channelKey: "{콘솔 내 연동 정보의 채널키}",
+    pay_method: "tosspay", // 'tosspay'만 지원됩니다.
+    merchant_uid: "orderMonthly0001", // 상점에서 관리하는 주문 번호
+    name: "최초인증결제",
+    customer_id: "matthew", //고객사가 회원에게 부여한 고유 ID로 필수 입력.
+    customer_uid: "your-customer-unique-id", // 필수 입력.
+    buyer_email: "test@portone.io",
+    buyer_name: "포트원",
+    buyer_tel: "02-1234-1234",
+    m_redirect_url: "{모바일에서 결제 완료 후 리디렉션 될 URL}",
+    notice_url: "{빌링키 발급 결과를 받을 URL}",
+  },
+  function (rsp) {
+    // callback 로직
+  },
+);
+```
+
+<details>
+
+<summary>
+
+<strong>주요 파라미터 설명</strong>
+
+</summary>
+
+- channelKey: string
+
+  **채널키**
+
+  결제를 진행할 채널을 지정합니다.
+
+  포트원 콘솔 내 \[결제 연동] - \[연동 정보] - \[채널 관리] 에서 확인 가능합니다.
+
+  (최신 JavaScript SDK 버전부터 사용 가능합니다.)
+
+- pg(deprecated)?: string
+
+  **PG사 구분코드**
+
+  `tosspay_v2` 로 지정하면 됩니다.
+
+  <div class="hint" data-style="warning">
+
+  `pg` 파라미터는 지원 중단 예정입니다.
+
+  JS SDK를 가장 최신 버전으로 업그레이드 후 `channelKey` 파라미터로 채널 설정(PG사 구분)을 대체해주세요.
+
+  </div>
+
+- pay\_method: string
+
+  **결제수단 구분코드**
+
+  `tosspay` 로 지정하면 됩니다.
+
+- merchant\_uid: string
+
+  **주문번호**
+
+  매번 고유하게 채번되어야 합니다.
+
+- customer\_uid: string
+
+  **빌링키 발급을 위한 결제 수단을 특정하는 고유 번호**
+
+  빌링키 발급시 필수 입력
+
+- customer\_id: string
+
+  **구매자 식별자**
+
+  주의: (신) 토스페이 빌링키 발급시 필수 입력으로 입력 길이는 **50자**로 제한됩니다.
+
+- m\_redirect\_url: string
+
+  **리다이렉트 URL**
+
+  리디렉션 방식으로 진행할 경우, 트랜잭션 종료 이후 302 리디렉션 될 고객사 URL
+
+  (신) 토스페이의 경우 모바일 환경에서 **리디렉션 방식으로 빌링키 발급창이 렌더링 되기 때문에 필수입력입니다.**
+
+- notice\_url?: string
+
+  **빌링키 발급 완료 웹훅 전달 URL**
+
+  빌링키 발급이 완료됐을 때 웹훅이 전달될 URL입니다. 해당 파라미터가 전달되지 않은 경우 콘솔에 등록한 웹훅 주소로 웹훅이 발송됩니다. **(신) 토스페이의 경우 SDK 콜백만으로 빌링키 발급여부를 체크하는 경우 정보 유실 가능성이 있기 때문에, 반드시 웹훅으로 빌링키 발급여부를 체크하길 권장합니다**.
+
+</details>
+
+</div>
+
+<div class="tabs-content" data-title="비인증 결제 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", {
+  method: "POST",
+  headers: {
+    Authorization: `Basic ${ACCESS_TOKEN}`,
+    "Content-Type": "application/json",
+  },
+  body: JSON.stringify({
+    customer_uid: "customer_uid", // [필수 입력] 빌링키 발급시 전달 한 빌링키와 1:1 매핑되는 ID
+    merchant_uid: "merchant_uid", // [필수 입력] 주문 번호
+    amount: 1000, // [필수 입력] 결제 금액
+    name: "주문명", // 주문명
+    cash_recipt_type: "person", // 현금영수증 발급 타입
+    bypass: {
+      tosspay_v2: {
+        cashReceiptTradeType: "GENERAL", // 현금영수증 발급 대상 타입
+        sendFailPush: false, // 결제 실패 시 토스페이앱 푸시알람 발송 여부
+      },
+    },
+  }),
+});
+```
+
+### (신) 토스페이 빌링키 결제 전용 파라미터
+
+- bypass?: object
+
+  - tosspay\_v2?: object
+
+    - cashReceiptTradeOption?: string
+
+      **현금영수증 발급 대상 타입**
+
+      - `GENERAL`: 일반 (default)
+      - `CULTURE`: 문화비
+      - `PUBLIC_TP`: 교통비
+
+    - tosspay\_v2.cashReceiptTradeOption?: boolean
+
+      **결제실패 푸시알람 사용 여부**
+
+      - `false`: 미사용 (default)
+      - `true`: 사용
+
+</div>
+
+</div>