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

package/assets/docs/schema/v1.openapi.json

@@ -100,13 +100,11 @@
             "x-portone-description": "베네피아 계정 비밀번호"
           },
           {
-            "name": "pg",
+            "name": "channel_key",
             "in": "formData",
-            "description": "KCP PG설정이 2개 이상인 경우, 조회가 진행되길 원하는 KCP사이트코드를 지정하실 수 있습니다.\n     pg 파라메터는 <b>kcp.{KCP사이트코드}</b> 형식의 문자열입니다. pg 파라메터가 누락되는 경우 PG설정 내 KCP설정을 자동 탐색하여 처리하게 됩니다.",
-            "required": false,
-            "type": "string",
-            "x-portone-name": "PG 구분코드",
-            "x-portone-description": "사용하고자 하는 PG사 구분코드"
+            "description": "베네피아 포인트 조회 시 사용할 채널의 채널키",
+            "required": true,
+            "type": "string"
           }
         ],
         "responses": {
@@ -253,13 +251,11 @@
             "x-portone-description": "주문자 우편번호"
           },
           {
-            "name": "pg",
+            "name": "channel_key",
             "in": "formData",
-            "description": "PG 구분코드<br>\n     KCP PG설정이 2개 이상인 경우, 결제가 진행되길 원하는 KCP사이트코드를 지정하실 수 있습니다.\n     pg 파라메터는 <b>kcp.{KCP사이트코드}</b> 형식의 문자열입니다. pg 파라메터가 누락되는 경우 PG설정 내 KCP설정을 자동 탐색하여 처리하게 됩니다.",
-            "required": false,
-            "type": "string",
-            "x-portone-name": "PG 구분코드",
-            "x-portone-description": "사용하고자 하는 PG사 구분코드"
+            "description": "베네피아 포인트 결제 시 사용할 채널의 채널키",
+            "required": true,
+            "type": "string"
           },
           {
             "name": "notice_url",
@@ -502,22 +498,22 @@
           {
             "name": "pg",
             "in": "formData",
-            "description": "PG사 구분자<br>다날 상점아이디를 2개 이상 동시에 사용하시려는 경우 설정하시면 됩니다. <b>danal.{상점아이디}</b> 형태로 지정. Deprecated 되었으므로 channelKey 파라미터를 사용해주세요.",
+            "description": "PG사 구분자<br>다날 상점아이디를 2개 이상 동시에 사용하시려는 경우 설정하시면 됩니다. <b>danal.{상점아이디}</b> 형태로 지정. Deprecated 되었으므로 channel_key 파라미터를 사용해주세요.",
             "required": false,
             "type": "string",
             "x-portone-name": "PG사 구분코드(deprecated)",
             "x-portone-summary": "<p>본인인증을 요청하고자 하는 PG사 구분자</p>\n",
-            "x-portone-description": "다날 상점아이디를 2개 이상 동시에 사용하시려는 경우 설정하시면 됩니다. **danal.{상점아이디}** 형태로 지정. Deprecated 되었으므로 channelKey 파라미터를 사용해주세요."
+            "x-portone-description": "다날 상점아이디를 2개 이상 동시에 사용하시려는 경우 설정하시면 됩니다. **danal.{상점아이디}** 형태로 지정. Deprecated 되었으므로 channel_key 파라미터를 사용해주세요."
           },
           {
-            "name": "channelKey",
+            "name": "channel_key",
             "in": "formData",
-            "description": "본인인증을 요청하고자 하는 PG사의 채널키로 kcp(신모듈) 본인인증을 사용하시려는 경우 반드시 channelKey를 입력해야합니다.",
+            "description": "본인인증을 요청하고자 하는 PG사의 채널키로 kcp(신모듈) 본인인증을 사용하시려는 경우 반드시 channel_key를 입력해야합니다.",
             "required": true,
             "type": "string",
             "x-portone-name": "채널키",
             "x-portone-summary": "<p>본인인증을 요청하고자 하는 PG사의 채널키</p>\n",
-            "x-portone-description": "kcp(신모듈) 본인인증을 사용하시려는 경우 반드시 channelKey를 입력해야합니다."
+            "x-portone-description": "kcp(신모듈) 본인인증을 사용하시려는 경우 반드시 channel_key를 입력해야합니다."
           },
           {
             "name": "verification_method",
@@ -975,7 +971,7 @@
             "x-portone-description": "고객(카드소지자) 우편번호"
           },
           {
-            "name": "channelGroupId",
+            "name": "channel_group_id",
             "in": "formData",
             "description": "<ul><li>관리자 콘솔의 [연동관리] -> [스마트 라우팅] 메뉴에서 확인할 수 있습니다.</li> <li> 스마트 라우팅 그룹 ID를 지정하여 결제를 요청하면, 스마트 라우팅 그룹 내 활성화 된 모든 채널로 빌링키 발급 요청을 합니다. <br>이때, pg 파라메터는 무시됩니다.</li></ul>",
             "required": false,
@@ -987,7 +983,7 @@
         ],
         "responses": {
           "200": {
-            "description": "정상 등록 시, 일반 빌링키 발급은 CustomerResponse를 반환하며, channelGroupId를 이용한 슈퍼 빌링키 발급은 SuperBillingKeyResponse를 반환합니다.",
+            "description": "정상 등록 시, 일반 빌링키 발급은 CustomerResponse를 반환하며, channel_group_id를 이용한 슈퍼 빌링키 발급은 SuperBillingKeyResponse를 반환합니다.",
             "schema": {
               "properties": {
                 "CustomerResponse": {
@@ -1322,6 +1318,13 @@
           "application/json"
         ],
         "parameters": [
+          {
+            "name": "channel_key",
+            "in": "formData",
+            "description": "편의점결제 수납번호 발급 시 사용할 채널의 채널키",
+            "required": true,
+            "type": "string"
+          },
           {
             "name": "merchant_uid",
             "in": "formData",
@@ -1420,15 +1423,6 @@
             "x-portone-name": "주문자 우편번호",
             "x-portone-description": "주문자의 우편번호"
           },
-          {
-            "name": "pg",
-            "in": "formData",
-            "description": "PG 구분코드. 갤럭시아컴즈 상점아이디를 2개 이상 동시에 사용하시려는 경우 설정하시면 됩니다. <b>galaxia.{상점아이디}</b> 형태로 지정",
-            "required": false,
-            "type": "string",
-            "x-portone-name": "PG 구분코드",
-            "x-portone-description": "결제 하고자 하는 PG사 구분코드"
-          },
           {
             "name": "confirm_url",
             "in": "formData",
@@ -1987,6 +1981,15 @@
             "x-portone-name": "결제금액",
             "x-portone-description": "결제 요청할 금액"
           },
+          {
+            "name": "imp_uid",
+            "in": "formData",
+            "description": "PIN 인증(PinCheck)을 진행한 거래의 포트원 거래번호",
+            "required": true,
+            "type": "string",
+            "x-portone-name": "포트원 거래번호",
+            "x-portone-description": "PIN 인증(PinCheck)을 진행한 거래의 포트원 거래번호"
+          },
           {
             "name": "notice_url",
             "in": "formData",
@@ -2014,6 +2017,233 @@
         "x-portone-category": "pg.kcpquick"
       }
     },
+    "/kcpquick/prepare/{merchant_uid}": {
+      "put": {
+        "tags": [
+          "kcpquick"
+        ],
+        "summary": "KCP 선불머니 거래 사전등록 수정 API",
+        "description": "KCP 선불머니 거래 사전등록 정보를 수정합니다.",
+        "operationId": "prepare_update",
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "merchant_uid",
+            "in": "path",
+            "description": "고객사 주문번호",
+            "required": true,
+            "type": "string",
+            "maxLength": 40,
+            "x-portone-name": "고객사 주문번호",
+            "x-portone-description": "수정할 거래의 고객사 주문번호"
+          },
+          {
+            "name": "btid",
+            "in": "formData",
+            "description": "고객사 생성 거래등록번호(btid). 최대 20자",
+            "required": true,
+            "type": "string",
+            "maxLength": 20,
+            "x-portone-name": "고객사 생성 거래등록번호",
+            "x-portone-description": "고객사에서 생성한 거래등록번호(btid). 최대 20자"
+          },
+          {
+            "name": "cust_ip",
+            "in": "formData",
+            "description": "고객 IP 주소",
+            "required": true,
+            "type": "string",
+            "format": "ipv4",
+            "x-portone-name": "고객 IP",
+            "x-portone-description": "고객 IP 주소"
+          },
+          {
+            "name": "code_verifier",
+            "in": "formData",
+            "description": "요청자 검증을 위한 랜덤 문자열(code_verifier). 최대 200자",
+            "required": true,
+            "type": "string",
+            "maxLength": 200,
+            "x-portone-name": "요청자 검증 문자열",
+            "x-portone-description": "요청자 검증을 위한 랜덤 문자열(code_verifier). 최대 200자"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "정상 수정"
+          },
+          "400": {
+            "description": "파라미터가 올바르지 않은 경우"
+          },
+          "401": {
+            "description": "인증 Token이 전달되지 않았거나 유효하지 않은 경우"
+          },
+          "404": {
+            "description": "사전등록 정보를 찾을 수 없는 경우"
+          }
+        },
+        "x-portone-supported-pgs": [
+          "kcp_quick"
+        ],
+        "x-portone-category": "pg.kcpquick"
+      },
+      "post": {
+        "tags": [
+          "kcpquick"
+        ],
+        "summary": "KCP 선불머니 거래 사전등록 API",
+        "description": "KCP 선불머니 거래를 위한 사전등록 정보를 저장합니다.",
+        "operationId": "prepare_create",
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "merchant_uid",
+            "in": "path",
+            "description": "고객사 주문번호",
+            "required": true,
+            "type": "string",
+            "maxLength": 40,
+            "x-portone-name": "고객사 주문번호",
+            "x-portone-description": "사전등록할 거래의 고객사 주문번호"
+          },
+          {
+            "name": "btid",
+            "in": "formData",
+            "description": "고객사 생성 거래등록번호(btid). 최대 20자",
+            "required": true,
+            "type": "string",
+            "maxLength": 20,
+            "x-portone-name": "고객사 생성 거래등록번호",
+            "x-portone-description": "고객사에서 생성한 거래등록번호(btid). 최대 20자"
+          },
+          {
+            "name": "cust_ip",
+            "in": "formData",
+            "description": "고객 IP 주소",
+            "required": true,
+            "type": "string",
+            "format": "ipv4",
+            "x-portone-name": "고객 IP",
+            "x-portone-description": "고객 IP 주소"
+          },
+          {
+            "name": "code_verifier",
+            "in": "formData",
+            "description": "요청자 검증을 위한 랜덤 문자열(code_verifier). 최대 200자",
+            "required": true,
+            "type": "string",
+            "maxLength": 200,
+            "x-portone-name": "요청자 검증 문자열",
+            "x-portone-description": "요청자 검증을 위한 랜덤 문자열(code_verifier). 최대 200자"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "정상 등록"
+          },
+          "400": {
+            "description": "파라미터가 올바르지 않은 경우"
+          },
+          "401": {
+            "description": "인증 Token이 전달되지 않았거나 유효하지 않은 경우"
+          },
+          "409": {
+            "description": "이미 동일한 merchant_uid로 사전등록된 정보가 존재하는 경우"
+          }
+        },
+        "x-portone-supported-pgs": [
+          "kcp_quick"
+        ],
+        "x-portone-category": "pg.kcpquick"
+      }
+    },
+    "/kcpquick/members/{member_id}/fido/release": {
+      "post": {
+        "tags": [
+          "kcpquick"
+        ],
+        "summary": "(KCP 퀵페이) 생체인증(FIDO) 사용 해제 API",
+        "description": "KCP 퀵페이 회원의 생체인증(FIDO) 사용을 해제합니다.",
+        "operationId": "releaseFido",
+        "consumes": [
+          "application/json"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "parameters": [
+          {
+            "name": "member_id",
+            "in": "path",
+            "description": "생체인증 해제할 회원 고유 아이디(memberID)",
+            "required": true,
+            "type": "string",
+            "x-portone-name": "회원 고유 아이디",
+            "x-portone-description": "생체인증 해제할 회원 고유 아이디(memberID)"
+          },
+          {
+            "name": "channel_key",
+            "in": "formData",
+            "description": "KCP 퀵페이 채널의 채널키",
+            "required": true,
+            "type": "string",
+            "x-portone-name": "채널키",
+            "x-portone-description": "KCP 퀵페이 채널의 채널키"
+          }
+        ],
+        "responses": {
+          "200": {
+            "description": "정상 해제",
+            "schema": {
+              "properties": {
+                "code": {
+                  "type": "integer",
+                  "example": 0
+                },
+                "message": {
+                  "type": "string",
+                  "example": "생체인증 사용이 정상적으로 해제되었습니다."
+                },
+                "response": {
+                  "properties": {
+                    "member_id": {
+                      "description": "생체인증 해제된 회원 ID",
+                      "type": "string"
+                    }
+                  }
+                }
+              }
+            }
+          },
+          "400": {
+            "description": "필수 파라미터 누락, 존재하지 않는 채널, KCP 퀵페이 채널이 아닌 경우"
+          },
+          "401": {
+            "description": "인증 Token이 전달되지 않았거나 유효하지 않은 경우"
+          },
+          "404": {
+            "description": "생체인증 해제 대상 회원을 찾을 수 없는 경우"
+          },
+          "500": {
+            "description": "KCP 생체인증 해제 처리 중 오류가 발생한 경우"
+          }
+        },
+        "x-portone-supported-pgs": [
+          "kcp_quick"
+        ],
+        "x-portone-category": "pg.kcpquick"
+      }
+    },
     "/payments/{imp_uid}/naver/cancel": {
       "post": {
         "tags": [
@@ -3294,6 +3524,13 @@
           "application/json"
         ],
         "parameters": [
+          {
+            "name": "channel_key",
+            "in": "formData",
+            "description": "구매평 조회 시 사용할 네이버페이 주문형 채널의 채널키",
+            "required": true,
+            "type": "string"
+          },
           {
             "name": "from",
             "in": "query",
@@ -3606,7 +3843,7 @@
             "required": false,
             "type": "boolean",
             "x-portone-name": "테스트 결제건 포함 여부",
-            "x-portone-description": "테스트 채널을 통해 발생한 결제건을 조회 결과에 포함할지 여부 (기본값: `false`)\n\n(본 파라미터는 `2026년 1월 26일`부터 추가 예정입니다.)"
+            "x-portone-description": "테스트 채널을 통해 발생한 결제건을 조회 결과에 포함할지 여부 (기본값: `false`)"
           }
         ],
         "responses": {
@@ -5127,6 +5364,13 @@
           "application/json"
         ],
         "parameters": [
+          {
+            "name": "channel_key",
+            "in": "formData",
+            "description": "현금영수증 발급 시 사용할 채널의 채널키",
+            "required": true,
+            "type": "string"
+          },
           {
             "name": "merchant_uid",
             "in": "path",
@@ -5313,16 +5557,6 @@
             "x-portone-summary": "<p>현금영수증 발행금액 중 면세금액으로 지정하지 않으면 0원으로 적용</p>\n",
             "x-portone-description": "발행금액의 1/11 이 부가세로 자동 적용되므로, 부가세금액 조정을 위해서는 tax_free 파라메터를 활용해주세요."
           },
-          {
-            "name": "pg",
-            "in": "formData",
-            "description": "PG설정이 2개 이상인 경우, 현금영수증 발행처리를 원하는 PG사를 지정하실 수 있습니다.\n     pg 파라메터는 <b>{PG사}</b> 혹은 <b>{PG사}.{PG상점아이디}</b> 형태의 문자열입니다. <br>\n     지정하지 않거나 유효하지 않은 값이 전달되면 기본PG설정된 값을 이용해 결제하게 됩니다. <br>\n     <ul><li>나이스페이먼츠, KCP 2가지 PG설정이 되어있다면, pg 파라메터로 <b>nice</b> 또는 <b>kcp</b>로 구분 가능</li>\n     <li>나이스페이먼츠로부터 2개 이상의 상점아이디를 발급받았다면, <b>nice.MID1</b> 또는 <b>nice.MID2</b>로 구분 가능</li></ul>",
-            "required": false,
-            "type": "string",
-            "maxLength": 80,
-            "x-portone-name": "PG 구분코드",
-            "x-portone-description": "현금영수증을 발행할 PG사 구분코드"
-          },
           {
             "name": "vat_amount",
             "in": "formData",
@@ -6033,6 +6267,16 @@
             "type": "string",
             "x-portone-name": "프로모션 아이디",
             "x-portone-description": "`promotion-id-`로 시작하며, 프로모션 아이디에 설정된 할인 내용을 적용하여 결제합니다. 비인증 결제 경우 빌링키 발급시 저장된 마스킹된 카드번호를 통해 프로모션 적용 여부가 결정됩니다."
+          },
+          {
+            "name": "bypass",
+            "in": "formData",
+            "description": "JSON string 형식의 PG사별로 특화된 파라미터. <br>전달 한 값은 가공 없이 그대로 PG사로 전달 됩니다. <br>각 PG사별 스펙은 PG사별 연동 문서 참고해주세요",
+            "required": false,
+            "type": "string",
+            "x-portone-name": "bypass 데이터",
+            "x-portone-summary": "<p>JSON string 형식의 PG사별로 특화된 파라미터</p>\n",
+            "x-portone-description": "전달 한 값은 가공 없이 그대로 PG사로 전달 됩니다. 각 PG사별 스펙은 PG사별 연동 문서 참고해주세요"
           }
         ],
         "responses": {
@@ -6427,7 +6671,7 @@
             "x-portone-description": "`promotion-id-`로 시작하며, 프로모션 아이디에 설정된 할인 내용을 적용하여 결제합니다. 비인증 결제 경우 빌링키 발급시 저장된 마스킹된 카드번호를 통해 프로모션 적용 여부가 결정됩니다."
           },
           {
-            "name": "channelKey",
+            "name": "channel_key",
             "in": "formData",
             "description": "<ul><li>관리자 콘솔의 [연동관리] -> [연동 정보] 메뉴에서 확인할 수 있습니다.</li><li>슈퍼 빌링키 결제시, 결제 채널을 특정하고 싶을 때 명시할 수 있습니다.</li></ul>",
             "required": false,
@@ -6608,7 +6852,7 @@
           "subscribe"
         ],
         "summary": "결제 예약 API",
-        "description": "customer__uid를 이용하여 비인증 결제 요청을 예약할 수 있는 API입니다.<br>비 인증 결제(빌링키) API를 포트원이 대신 수행하는 개념)<br>\n     결제 요청에 대한 결과는 notice_url에 설정한 EndPoint URL로 웹훅을 통해 수신(POST request)받을 수 있습니다.<br><br>\n     <ul> <li>기존에 빌링키가 등록된 customer_uid가 존재하는 경우 해당 customer_uid와 해당되는 빌링키로 schedule정보가 예약됩니다.(카드정보 선택사항)</li>\n     <li>등록된 customer_uid가 없는 경우 빌링키 신규 발급을 먼저 진행한 후 schedule정보를 예약합니다.(카드정보 필수사항)</li>\n     <li>예약건 별로 고유의 merchant_uid를 전달해주셔야 합니다.</li>\n     <li>schedules의 상세정보(선택정보) <b> buyer_name, buyer_email, buyer_tel, buyer_addr, buyer_postcode</b> 누락시,<br>\n     <b>customer_uid</b>에 해당되는 <b>customer_name, customer_email, customer_tel, customer_addr, customer_postcode</b> 정보로 대체됩니다.(둘 다 입력시 buyer_* 정보를 우선합니다)</li>\n     <li>슈퍼빌링키의 customer_uid로 요청하는 경우, 결제 시점 해당 스마트 라우팅 그룹 내 채널 비율 설정에 따라 결제를 요청합니다.\n     특정 빌링키로 결제를 요청하려면 channelKey에 결제를 희망하는 빌링키의 채널 키를 입력해 주세요.</li></ul>",
+        "description": "customer__uid를 이용하여 비인증 결제 요청을 예약할 수 있는 API입니다.<br>비 인증 결제(빌링키) API를 포트원이 대신 수행하는 개념)<br>\n     결제 요청에 대한 결과는 notice_url에 설정한 EndPoint URL로 웹훅을 통해 수신(POST request)받을 수 있습니다.<br><br>\n     <ul> <li>기존에 빌링키가 등록된 customer_uid가 존재하는 경우 해당 customer_uid와 해당되는 빌링키로 schedule정보가 예약됩니다.(카드정보 선택사항)</li>\n     <li>등록된 customer_uid가 없는 경우 빌링키 신규 발급을 먼저 진행한 후 schedule정보를 예약합니다.(카드정보 필수사항)</li>\n     <li>예약건 별로 고유의 merchant_uid를 전달해주셔야 합니다.</li>\n     <li>schedules의 상세정보(선택정보) <b> buyer_name, buyer_email, buyer_tel, buyer_addr, buyer_postcode</b> 누락시,<br>\n     <b>customer_uid</b>에 해당되는 <b>customer_name, customer_email, customer_tel, customer_addr, customer_postcode</b> 정보로 대체됩니다.(둘 다 입력시 buyer_* 정보를 우선합니다)</li>\n     <li>슈퍼빌링키의 customer_uid로 요청하는 경우, 결제 시점 해당 스마트 라우팅 그룹 내 채널 비율 설정에 따라 결제를 요청합니다.\n     특정 빌링키로 결제를 요청하려면 channel_key에 결제를 희망하는 빌링키의 채널 키를 입력해 주세요.</li></ul>",
         "operationId": "schedule",
         "consumes": [
           "application/json",
@@ -6752,25 +6996,14 @@
             }
           },
           {
-            "name": "pg",
-            "in": "formData",
-            "description": "신규 customer_uid를 등록하는 경우에만 유효합니다.(기존에 등록된 customer_uid로만 schedule 하는 경우에는 pg파라메터 적용되지 않습니다.)<br><br>API 방식 비인증 PG설정이 2개 이상인 경우, 결제가 진행되길 원하는 PG사를 지정하실 수 있습니다. pg 파라메터는 <b>{PG사}</b> 혹은 <b>{PG사}.{PG상점아이디}</b> 형태의 문자열입니다. <br>지정하지 않거나 유효하지 않은 값이 전달되면 기본PG설정된 값을 이용해 결제하게 됩니다. <br><ul><li>나이스페이먼츠, KCP 2가지 PG설정이 되어있다면, pg 파라메터로 <b>nice</b> 또는 <b>kcp</b>로 구분 가능</li><li>나이스페이먼츠로부터 2개 이상의 상점아이디를 발급받았다면, <b>nice.MID1</b> 또는 <b>nice.MID2</b>로 구분 가능</li></ul>",
-            "required": false,
-            "type": "string",
-            "maxLength": 80,
-            "x-portone-name": "pg 구분코드",
-            "x-portone-summary": "<p>결제 예약을 요청할 PG사 구분코드</p>\n",
-            "x-portone-description": "신규 customer_uid를 등록하는 경우에만 유효합니다.(기존에 등록된 customer_uid로만 schedule 하는 경우에는 pg파라메터 적용되지 않습니다.)\n\nAPI 방식 비인증 PG설정이 2개 이상인 경우, 결제가 진행되길 원하는 PG사를 지정하실 수 있습니다. pg 파라메터는 **{PG사}** 혹은 **{PG사}.{PG상점아이디}** 형태의 문자열입니다.\n\n지정하지 않거나 유효하지 않은 값이 전달되면 기본PG설정된 값을 이용해 결제하게 됩니다.\n- 나이스페이먼츠, KCP 2가지 PG설정이 되어있다면, pg 파라메터로 **nice** 또는 **kcp**로 구분 가능\n- 나이스페이먼츠로부터 2개 이상의 상점아이디를 발급받았다면, **nice.MID1** 또는 **nice.MID2**로 구분 가능"
-          },
-          {
-            "name": "channelKey",
+            "name": "channel_key",
             "in": "formData",
-            "description": "<ul><li>관리자 콘솔의 [연동관리] -> [연동 정보] 메뉴에서 확인할 수 있습니다.</li><li>슈퍼 빌링키 결제시, 결제 채널을 특정하고 싶을 때 명시할 수 있습니다.</li></ul>",
+            "description": "<ul><li>관리자 콘솔의 [연동관리] -> [연동 정보] 메뉴에서 확인할 수 있습니다.</li><li>이미 발급된 빌링키가 존재하고 해당 빌링키가 슈퍼 빌링키인 경우 특정 채널에서 발급된 빌링키를 선택하려는 경우 사용합니다.</li><li>발급된 빌링키가 없는 경우 빌링키 발급 시 사용할 채널을 지정할 때 사용합니다.</li></ul>",
             "required": false,
             "type": "string",
             "maxLength": 55,
             "x-portone-name": "채널 키",
-            "x-portone-description": "다수 채널에 대해 발급된 빌링키에 대해, 결제 채널을 특정하고 싶을 때 명시"
+            "x-portone-description": "발급된 빌링키가 없는 경우 빌링키를 발급 시 사용할 채널 지정, 이미 발급된 빌링키가 있고 해당 빌링키가 슈퍼 빌링키인 경우 특정 채널에서 발급된 빌링키를 지정"
           },
           {
             "name": "schedules",
@@ -7442,6 +7675,13 @@
           "application/json"
         ],
         "parameters": [
+          {
+            "name": "channel_key",
+            "in": "formData",
+            "description": "가상계좌 발급 시 사용할 채널의 채널키",
+            "required": true,
+            "type": "string"
+          },
           {
             "name": "merchant_uid",
             "in": "formData",
@@ -7694,21 +7934,6 @@
             "x-portone-name": "주문자 우편번호",
             "x-portone-description": "가상계좌 발급을 위한 결제건의 주문자 우편번호"
           },
-          {
-            "name": "pg",
-            "in": "formData",
-            "description": "PG사 구분자.<br>\n     관리자콘솔 API 방식 비인증 PG설정이 2개 이상인 경우 필수적으로 기재해야 하는 항목입니다.\n     동일 PG사에 두개의 MID 를 설정한 경우 아래 양식으로 기재 합니다.\n     <b>{PG사}.{PG상점아이디}</b>\n     <ul><li>나이스페이먼츠, KCP 2가지 PG설정이 되어있다면, pg 파라미터로 nice 또는 kcp로 구분 가능\n     </li><li>나이스페이먼츠로부터 2개 이상의 상점아이디를 발급받았다면, nice.MID1 또는 nice.MID2로 구분 가능</li></ul>\n     (단, **이니시스 경우 필수값임** `inicis.{상점아이디}` 형태로 지정)",
-            "required": false,
-            "type": "string",
-            "x-portone-name": "PG사 구분코드",
-            "x-portone-description": "가상계좌 발급 할 PG사 구분코드",
-            "x-portone-per-pg": {
-              "html5_inicis": {
-                "required": true,
-                "description": "<p><strong>inicis.{상점아이디}</strong> 형태로 지정 바랍니다.</p>\n"
-              }
-            }
-          },
           {
             "name": "notice_url",
             "in": "formData",
@@ -8251,7 +8476,7 @@
           "description": "빌링키 발급 시 이용한 포트원 채널의 테스트 채널 여부",
           "type": "boolean",
           "x-portone-name": "테스트 빌링키 여부",
-          "x-portone-description": "빌링키 발급 시 이용한 포트원 채널의 테스트 채널 여부\n\n(본 필드는 `2026년 1월 26일`부터 추가 예정입니다.)"
+          "x-portone-description": "빌링키 발급 시 이용한 포트원 채널의 테스트 채널 여부"
         },
         "customer_id": {
           "description": "구매자 ID",
@@ -9408,7 +9633,7 @@
           "description": "결제가 발생한 포트원 채널의 테스트 채널 여부",
           "type": "boolean",
           "x-portone-name": "테스트 결제 여부",
-          "x-portone-description": "결제가 발생한 포트원 채널의 테스트 채널 여부\n\n(본 필드는 `2026년 1월 26일`부터 추가 예정입니다.)"
+          "x-portone-description": "결제가 발생한 포트원 채널의 테스트 채널 여부"
         },
         "escrow": {
           "description": "에스크로결제 여부",