@cmarket/partner-sdk 33.0.0 → 33.1.0

package/api/partner-v2-api.ts

@@ -4,7 +4,7 @@
  * CMARKET V6 Partner API
  * 외부 ERP 연동용 RESTful API.  ## 버전별 인증 - **_/v2** — OAuth2 Bearer JWT (`client_credentials` 플로우). `/oauth/token` 에서 토큰 발급 후 `Authorization: Bearer <token>` 헤더. - **_/v1** — V5 충실 platform-auth. `X-Platform-Id`(cate_set.api_id) / `X-Platform-Secret`(cate_set.api_secret, MD5-hex) 헤더로 전송.  ## 권한 — 두 개의 독립된 축 `403` 을 만났다면 둘 중 어느 축에 걸린 것인지 먼저 구분할 것. - **스코프** = *무엇을 할 수 있나*. 토큰에 부여된 `bids:read`·`contracts:write` 등. 미보유 시 `…/insufficient-scope`. - **대행 범위** = *누구의 데이터를 다룰 수 있나*. API 키 설정이며 스코프로 표현되지 않는다. 범위 밖이면 스코프와 무관하게 403 이다.  대행 범위는 키마다 둘 중 하나로 설정된다 — **소속 그룹 전원**(기관 키. 사업처·부서 계정이 새로 생겨도 자동 포함) 또는 **지정 발주처 목록**(계약으로 합의된 목록). 범위를 넓혀야 하면 스코프가 아니라 키 설정 변경을 요청할 것.  ## 성공 응답 봉투 `/v2` 의 모든 2xx 본문은 `{ \"data\": … }` 입니다. 단일 리소스든 목록이든 같습니다. 목록처럼 부가 정보가 있는 응답은 `meta` 가 함께 실립니다 — 예: `{ \"data\": [...], \"meta\": { \"nextCursor\": \"…\" } }`. 부가 정보가 없으면 `meta` 키는 아예 나가지 않습니다(빈 객체를 싣지 않습니다).  봉투를 쓰지 않는 표면은 셋입니다. `/oauth/_*` 와 `/.well-known/_*` 는 각각 RFC 6749·RFC 8414·RFC 9728 이 최상위 필드를 규정하고, `/v1/_*` 은 동결된 레거시 표면이며, 파일 내용 응답은 본문이 JSON 이 아닙니다.  에러 응답에는 봉투를 씌우지 않습니다 — 아래 problem+json 이 단독으로 책임집니다.  ## 조건부 요청 (ETag) `/v2` 의 모든 `GET` 응답에 weak `ETag`(`W/\"…\"`)가 실립니다. 받은 값을 다음 요청의 `If-None-Match` 헤더로 되보내면, 내용이 그대로일 때 `304 Not Modified` 를 본문 없이 받습니다. 결과가 나기를 기다리며 같은 자원을 반복 조회하는 연동이라면 이 헤더 하나로 전송량이 사라집니다. 호출 횟수 자체를 줄이려면 웹훅을 사용하세요.  ## 에러 (RFC 9457 problem+json) 모든 에러 응답은 `application/problem+json`. 소비자는 **HTTP status + `type` URI** 로 분기한다. - `retryable`(boolean): 자동 재시도 안전 여부. `true`(429·5xx transient)면 backoff 후 재시도, `false`면 요청을 고쳐야 한다. - `traceId`: 요청 추적 id. `X-Correlation-Id` 응답 헤더와 같은 값입니다 — 문의할 때 이 값을 첨부하세요. - `correlationId`: `traceId` 와 같은 값의 옛 이름. 기존 연동 호환으로 함께 실립니다. 새 연동은 `traceId` 를 읽으세요. - `invalid-params`: 검증 실패(400 `…/validation-failed`) 시 위반 필드 경로 목록(RFC 9457 확장, 값 없음).  `type` 은 `https://problems.cmarket.io/partner/<slug>` 형태의 **안정 식별자**다. RFC 9457 §3.1.1 이 허용하는 대로 이 URI 는 **역참조(dereference)되지 않는다** — 브라우저로 열지 말고 문자열 비교로만 쓸 것. slug 목록과 의미는 각 엔드포인트의 응답 설명에 status 별로 명시돼 있다. 새 slug 은 추가될 수 있으므로, 모르는 slug 을 만나면 `type` 이 아니라 **HTTP status 로 폴백**하도록 구현할 것.  ### 멱등성 위반: 409 와 422 의 차이 - `409` `…/idempotency-key-conflict` — 같은 키의 **원 요청이 아직 처리 중**이다. 잠시 뒤 같은 키로 다시 부르면 그 결과를 받는다. - `422` `…/idempotency-key-reused` — 같은 키를 **다른 body** 로 보냈다. 재시도해도 영원히 같은 실패다. 새 키를 쓰거나 body 를 되돌릴 것.  ## Rate Limit 전역 **60 요청/분 per `client_id`**, 토큰 발급(`/oauth/token`)은 **5 요청/분**. 초과 시 `429`(`type: …/too-many-requests`). 쿼터는 두 가지 표기로 함께 나간다 — 신규 연동은 표준 필드를 쓸 것. - **표준**(`draft-ietf-httpapi-ratelimit-headers`, Structured Fields): `RateLimit-Policy: \"default\";q=60;w=60` (정책) · `RateLimit: \"default\";r=59;t=42` (잔량 r, 리셋까지 t 초) - **레거시**(관용): `X-RateLimit-Limit` / `X-RateLimit-Remaining` / `X-RateLimit-Reset`. 기존 연동 호환을 위해 유지한다.  `429` 에서는 `Retry-After`(초)가 우선한다. 대량 동기화(품목 단위 반복 등록 등)는 `Retry-After` 만큼 backoff 후 재시도할 것.  ## 추적 요청에 `X-Correlation-Id` 헤더를 실으면 그대로 echo 되고, 없으면 서버가 발급한다. 모든 응답(성공/에러)에 `X-Correlation-Id` 가 실린다.  ## 버전 수명(deprecation/sunset) - **_/v1** 은 레거시 V5 cutover 완료 시점까지 유지되는 충실 프록시입니다. 폐지 일정이 정해지면 /v1 응답에 헤더 세 개가 실립니다 — `Deprecation`(RFC 9745, `@<epoch초>`) · `Sunset`(RFC 8594, HTTP-date) · `Link`(RFC 8288, `rel=\"deprecation\"`/`rel=\"sunset\"` — 이전 안내 문서를 가리킵니다). 일정이 정해지기 전에는 셋 다 나가지 않습니다.   종료일이 지난 뒤의 호출은 `404` 가 아니라 **`410 Gone`** 과 `type: …/endpoint-sunset` 으로 거절됩니다. 둘의 뜻이 다릅니다 — `404` 는 \"그런 것이 있었는지 모르겠다\", `410` 은 \"있었고 의도적으로 없앴다\" 입니다. `410` 을 받으면 경로 오타를 의심하지 말고 /v2 로 이전하세요. - **_/v2** breaking 변경은 CHANGELOG SemVer(major bump)와 `Deprecation`/`Sunset` 헤더로 통지한다. 소비자는 이 헤더를 모니터링할 것.
  *
- * The version of the OpenAPI document: 33.0.0
+ * The version of the OpenAPI document: 33.1.0
  * Contact: semo.io.kr@gmail.com
  *
  * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
@@ -154,8 +154,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["products:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -203,8 +203,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -252,8 +252,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["contracts:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -298,8 +298,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["contracts:write"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -341,8 +341,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["payments:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -362,10 +362,11 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-         * @summary 결제창 발행
+         * @summary 결제창 발행 (구 경로)
          * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
          * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto 
          * @param {*} [options] Override http request option.
+         * @deprecated
          * @throws {RequiredError}
          */
         createCardPaymentRequest: async (idempotencyKey: string, createCardPaymentRequestDto: CreateCardPaymentRequestDto, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
@@ -386,8 +387,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["payments:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -431,8 +432,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["contracts:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -476,8 +477,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -528,8 +529,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:write"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/problem+json';
 
@@ -608,8 +609,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -624,7 +625,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
-         * @summary 입찰 결과 조회
+         * @summary 공고 결과 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -646,8 +647,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -662,7 +663,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.  가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다.  **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
-         * @summary 입찰결과 정산정보 조회
+         * @summary 정산 정보 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -684,8 +685,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["invoices:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -723,8 +724,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["invoices:read"], configuration)
 
             if (paperCode !== undefined) {
                 localVarQueryParameter['paperCode'] = paperCode;
@@ -765,8 +766,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["files:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -803,8 +804,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["contracts:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json';
 
@@ -819,9 +820,10 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **필수 스코프:** `payments:write`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-         * @summary 공급사 카드결제 가능 여부
+         * @summary 공급사 카드결제 가능 여부 (구 경로)
          * @param {string} memberId 계약업체 회원 ID
          * @param {*} [options] Override http request option.
+         * @deprecated
          * @throws {RequiredError}
          */
         getSupplierCardPayable: async (memberId: string, options: RawAxiosRequestConfig = {}): Promise<RequestArgs> => {
@@ -841,8 +843,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["payments:write"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json';
 
@@ -879,8 +881,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["payments:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -917,8 +919,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -963,7 +965,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 가 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다.  **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다.  **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 — 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요.  **목록이 길어 URL 이 부담되면** `POST /v2/bid-results/query` 를 쓰세요. 응답은 같습니다.
-         * @summary 입찰 결과 배치 조회
+         * @summary 공고 결과 배치 조회
          * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -984,8 +986,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:read"], configuration)
 
             if (bidIds !== undefined) {
                 localVarQueryParameter['bidIds'] = bidIds;
@@ -1027,8 +1029,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:read"], configuration)
 
             if (limit !== undefined) {
                 localVarQueryParameter['limit'] = limit;
@@ -1087,8 +1089,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["contracts:read"], configuration)
 
             if (buyerId !== undefined) {
                 localVarQueryParameter['buyerId'] = buyerId;
@@ -1129,8 +1131,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["products:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -1167,8 +1169,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:read"], configuration)
 
             if (endpointId !== undefined) {
                 localVarQueryParameter['endpointId'] = endpointId;
@@ -1217,8 +1219,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:read"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -1261,8 +1263,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["awards:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1307,8 +1309,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:write"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -1351,8 +1353,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["contracts:write"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -1398,8 +1400,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["awards:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1419,7 +1421,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
-         * @summary 입찰 정보 전송(등록)
+         * @summary 공고 등록
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
          * @param {CreateBidRequestDto} createBidRequestDto 
          * @param {*} [options] Override http request option.
@@ -1443,8 +1445,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1488,8 +1490,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["contracts:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1537,8 +1539,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["awards:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1583,8 +1585,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:write"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -1627,8 +1629,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:write"], configuration)
 
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
 
@@ -1646,7 +1648,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
-         * @summary 입찰 공고 수정
+         * @summary 공고 수정
          * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} ifMatch 
          * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidId}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
@@ -1680,8 +1682,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["bids:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1741,8 +1743,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["webhooks:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1768,7 +1770,7 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
         },
         /**
          * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
-         * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+         * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
          * @param {UploadFileRequestDto} uploadFileRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1789,8 +1791,8 @@ export const PartnerV2ApiAxiosParamCreator = function (configuration?: Configura
             const localVarQueryParameter = {} as any;
 
             // authentication partner-oauth2 required
-            // http bearer authentication required
-            await setBearerAuthToObject(localVarHeaderParameter, configuration)
+            // oauth required
+            await setOAuthToObject(localVarHeaderParameter, "partner-oauth2", ["files:write"], configuration)
 
             localVarHeaderParameter['Content-Type'] = 'application/json';
             localVarHeaderParameter['Accept'] = 'application/json,application/problem+json';
@@ -1888,10 +1890,11 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-         * @summary 결제창 발행
+         * @summary 결제창 발행 (구 경로)
          * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
          * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto 
          * @param {*} [options] Override http request option.
+         * @deprecated
          * @throws {RequiredError}
          */
         async createCardPaymentRequest(idempotencyKey: string, createCardPaymentRequestDto: CreateCardPaymentRequestDto, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<CardPaymentRequestResponseDto>> {
@@ -1972,7 +1975,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
-         * @summary 입찰 결과 조회
+         * @summary 공고 결과 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -1985,7 +1988,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.  가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다.  **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
-         * @summary 입찰결과 정산정보 조회
+         * @summary 정산 정보 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2038,9 +2041,10 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **필수 스코프:** `payments:write`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-         * @summary 공급사 카드결제 가능 여부
+         * @summary 공급사 카드결제 가능 여부 (구 경로)
          * @param {string} memberId 계약업체 회원 ID
          * @param {*} [options] Override http request option.
+         * @deprecated
          * @throws {RequiredError}
          */
         async getSupplierCardPayable(memberId: string, options?: RawAxiosRequestConfig): Promise<(axios?: AxiosInstance, basePath?: string) => AxiosPromise<SupplierCardPayableResponseDto>> {
@@ -2089,7 +2093,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 가 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다.  **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다.  **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 — 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요.  **목록이 길어 URL 이 부담되면** `POST /v2/bid-results/query` 를 쓰세요. 응답은 같습니다.
-         * @summary 입찰 결과 배치 조회
+         * @summary 공고 결과 배치 조회
          * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2231,7 +2235,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
-         * @summary 입찰 정보 전송(등록)
+         * @summary 공고 등록
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
          * @param {CreateBidRequestDto} createBidRequestDto 
          * @param {*} [options] Override http request option.
@@ -2302,7 +2306,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
-         * @summary 입찰 공고 수정
+         * @summary 공고 수정
          * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} ifMatch 
          * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidId}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
@@ -2336,7 +2340,7 @@ export const PartnerV2ApiFp = function(configuration?: Configuration) {
         },
         /**
          * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
-         * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+         * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
          * @param {UploadFileRequestDto} uploadFileRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2415,10 +2419,11 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-         * @summary 결제창 발행
+         * @summary 결제창 발행 (구 경로)
          * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
          * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto 
          * @param {*} [options] Override http request option.
+         * @deprecated
          * @throws {RequiredError}
          */
         createCardPaymentRequest(idempotencyKey: string, createCardPaymentRequestDto: CreateCardPaymentRequestDto, options?: RawAxiosRequestConfig): AxiosPromise<CardPaymentRequestResponseDto> {
@@ -2481,7 +2486,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
-         * @summary 입찰 결과 조회
+         * @summary 공고 결과 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2491,7 +2496,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.  가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다.  **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
-         * @summary 입찰결과 정산정보 조회
+         * @summary 정산 정보 조회
          * @param {string} bidId 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2532,9 +2537,10 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **필수 스코프:** `payments:write`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-         * @summary 공급사 카드결제 가능 여부
+         * @summary 공급사 카드결제 가능 여부 (구 경로)
          * @param {string} memberId 계약업체 회원 ID
          * @param {*} [options] Override http request option.
+         * @deprecated
          * @throws {RequiredError}
          */
         getSupplierCardPayable(memberId: string, options?: RawAxiosRequestConfig): AxiosPromise<SupplierCardPayableResponseDto> {
@@ -2571,7 +2577,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 가 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다.  **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다.  **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 — 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요.  **목록이 길어 URL 이 부담되면** `POST /v2/bid-results/query` 를 쓰세요. 응답은 같습니다.
-         * @summary 입찰 결과 배치 조회
+         * @summary 공고 결과 배치 조회
          * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2683,7 +2689,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
-         * @summary 입찰 정보 전송(등록)
+         * @summary 공고 등록
          * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
          * @param {CreateBidRequestDto} createBidRequestDto 
          * @param {*} [options] Override http request option.
@@ -2739,7 +2745,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
-         * @summary 입찰 공고 수정
+         * @summary 공고 수정
          * @param {string} bidId 공고 식별자(등록 응답의 bidId).
          * @param {string} ifMatch 
          * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidId}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
@@ -2767,7 +2773,7 @@ export const PartnerV2ApiFactory = function (configuration?: Configuration, base
         },
         /**
          * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
-         * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+         * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
          * @param {UploadFileRequestDto} uploadFileRequestDto 
          * @param {*} [options] Override http request option.
          * @throws {RequiredError}
@@ -2846,10 +2852,11 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 발주기관이 특정 업체에게 카드로 지불하는 거래(결제창) 1건을 만듭니다.  **대금 흐름:** 카드 승인이 **그 업체의 가맹점**으로 나가므로 대금은 씨마켓을 거치지 않고 업체로 직행합니다.  **발행 직후 상태:** 자동 승인(APPROVED)되어 바로 결제 가능합니다.  **사용자 동선:** 응답의 `payUrl` 로 발주기관을 보내면 그 결제창 한 건만 걸러진 화면이 열립니다. 거기서 카드를 골라 결제합니다.  **사전 조건:** 계약업체가 씨마켓 회원이고 카드결제에 가입(가맹)돼 있어야 합니다 — `GET /v2/card-payment-requests/suppliers/{memberId}/card-payable` 로 미리 확인하세요. 미가입 업체로 발행하면 400 입니다.  **필수 스코프:** `payments:write`. 어느 발주기관을 대신할 수 있는지는 스코프가 아니라 API 키의 대행 범위 설정이 정합니다.  **멱등성:** `externalRef`(파트너 측 거래 식별자)가 멱등키입니다. 같은 값으로 재요청하면 새로 만들지 않고 기존 결제창을 돌려줍니다(`reused=true`). `Idempotency-Key` 헤더도 함께 사용하세요.  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-     * @summary 결제창 발행
+     * @summary 결제창 발행 (구 경로)
      * @param {string} idempotencyKey 재시도 안전을 위한 멱등 키.
      * @param {CreateCardPaymentRequestDto} createCardPaymentRequestDto 
      * @param {*} [options] Override http request option.
+     * @deprecated
      * @throws {RequiredError}
      */
     public createCardPaymentRequest(idempotencyKey: string, createCardPaymentRequestDto: CreateCardPaymentRequestDto, options?: RawAxiosRequestConfig) {
@@ -2918,7 +2925,7 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 공고의 응찰 참여 업체·순위·낙찰 여부를 조회한다. scope bids:read.
-     * @summary 입찰 결과 조회
+     * @summary 공고 결과 조회
      * @param {string} bidId 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -2929,7 +2936,7 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 낙찰 공급사의 사업자·계좌·공급가액/부가세·응찰 품목내역을 조회합니다. 대금 지급에 필요한 정보입니다.  가시성 마스킹과는 직교한 정산 데이터이며 읽기 전용입니다.  **필수 스코프:** `invoices:read` — 종전에는 `bids:read` 를 요구했습니다. 대금·계좌가 실리는 응답이라 공고 조회 권한과 분리했습니다. 이 엔드포인트를 쓰시던 키에는 `invoices:read` 를 추가로 부여받으셔야 합니다.
-     * @summary 입찰결과 정산정보 조회
+     * @summary 정산 정보 조회
      * @param {string} bidId 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -2974,9 +2981,10 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 계약업체가 카드결제로 대금을 받을 수 있는 상태인지 확인합니다(씨마켓 회원 + 카드결제 가맹).  **결제수단을 사용자에게 보여주기 전에** 호출하세요. 불가한 업체로 결제창을 만들면 만들어는 지지만 결제가 막혀, 사용자가 막다른 길에 갇힙니다.  **필수 스코프:** `payments:write`  ---  **응답 형태가 동결된 표면입니다.** 이미 연동 중인 시스템이 있어 응답 필드를 추가하거나 이름을 바꾸지 않습니다. 다른 `/v2` 엔드포인트와 달리 `{data,meta}` 봉투를 씌우지 않으므로 응답 본문이 곧 위 스키마입니다. 지금 연동하셔도 계속 동작합니다 — 다만 이 경로에 새 기능이 추가되지는 않습니다.  **대체 계획:** 이미 있습니다 — 같은 기능을 v2 응답 규약으로 제공하는 `POST /v2/card-payments` 와 `GET /v2/suppliers/{memberId}/card-payable` 를 신규 연동에 권합니다. 이 경로도 계속 동작하며 중단 일정은 없습니다.
-     * @summary 공급사 카드결제 가능 여부
+     * @summary 공급사 카드결제 가능 여부 (구 경로)
      * @param {string} memberId 계약업체 회원 ID
      * @param {*} [options] Override http request option.
+     * @deprecated
      * @throws {RequiredError}
      */
     public getSupplierCardPayable(memberId: string, options?: RawAxiosRequestConfig) {
@@ -3017,7 +3025,7 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 여러 공고의 응찰 결과를 한 번에 조회합니다. 스코프 `bids:read`.  **이 엔드포인트를 폴링에 쓰세요.** 공고 하나씩 조회하는 대신 최대 100건을 한 왕복으로 받습니다. 응답에는 `ETag` 가 실리므로, 다음 요청에 `If-None-Match` 로 되보내면 결과가 그대로일 때 `304` 를 본문 없이 받습니다 — 마감을 기다리는 동안의 전송량이 사라집니다.  **식별자 전달:** `?bidIds=A,B,C`(쉼표) 또는 `?bidIds=A&bidIds=B`(반복) 둘 다 됩니다.  **없는 공고는 응답에서 빠집니다.** 존재하지 않거나 대행 범위 밖인 식별자는 오류가 아니라 누락으로 처리됩니다 — 요청한 건수와 받은 건수가 다를 수 있으니 `bidId` 로 대조하세요.  **목록이 길어 URL 이 부담되면** `POST /v2/bid-results/query` 를 쓰세요. 응답은 같습니다.
-     * @summary 입찰 결과 배치 조회
+     * @summary 공고 결과 배치 조회
      * @param {string} bidIds 조회할 공고 식별자 목록. 발주기관 자체 구매번호(권장) 또는 c-market 공고번호. 구매번호는 키에 바인딩된 발주처 범위에서 최신 라운드 공고로 해소됩니다. 두 형식을 섞어 보내도 됩니다. 쉼표로 구분하거나 &#x60;bidIds&#x60; 를 반복해 전달합니다. 최대 100건.
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}
@@ -3139,7 +3147,7 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 입찰 정보 등록. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.
-     * @summary 입찰 정보 전송(등록)
+     * @summary 공고 등록
      * @param {string} idempotencyKey 멱등성 키(1~255자, [A-Za-z0-9_-]). 동일 키 + 동일 body 재전송 시 캐시 응답 반환.
      * @param {CreateBidRequestDto} createBidRequestDto 
      * @param {*} [options] Override http request option.
@@ -3200,7 +3208,7 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 등록된 공고의 내용을 수정합니다. 스코프 `bids:write` + `Idempotency-Key` 헤더 필수.  진행중/초안 상태의 공고만 수정할 수 있습니다.  **부수효과:** - 변경 내용이 반영되고 수정이력이 기록됩니다. - `hideEdit=true` 면 변경이력을 비공개 처리하고 노출 카운터 증가를 생략합니다.  **수정 제약:** - 낙찰방법(awardMethod)은 수정 불가(잠금). - 참여자가 있으면 입찰방식/면허/예산/품목 일부가 잠깁니다. - 마감/취소된 공고는 수정할 수 없습니다.  한 섹션을 수정하려면 해당 섹션의 필수 필드를 함께 보내야 합니다(부분 섹션은 거부됨).
-     * @summary 입찰 공고 수정
+     * @summary 공고 수정
      * @param {string} bidId 공고 식별자(등록 응답의 bidId).
      * @param {string} ifMatch 
      * @param {string} ifMatch2 수정하려는 공고의 ETag(필수). 직전 &#x60;GET /v2/bids/{bidId}&#x60; 응답의 &#x60;ETag&#x60; 헤더 값을 그대로 실어 보내세요. 누락하면 428, 그 사이 공고가 바뀌었으면 412 로 거절되며 아무것도 수정되지 않습니다.
@@ -3230,7 +3238,7 @@ export class PartnerV2Api extends BaseAPI {
 
     /**
      * 스코프 `files:write` + `Idempotency-Key` 헤더 필수. base64 또는 url 중 정확히 하나를 제출한다.
-     * @summary 입찰 첨부파일 업로드(base64 또는 url) → fileKey
+     * @summary 공고 첨부파일 업로드(base64 또는 url) → fileKey
      * @param {UploadFileRequestDto} uploadFileRequestDto 
      * @param {*} [options] Override http request option.
      * @throws {RequiredError}