PortOne

PortOne Platform API

The Platform API from PortOne — 44 operation(s) for platform.

GitHub OpenAPI

Operations 66

GET /platform/account-transfers 이체 내역 다건 조회 #
POST /platform/additional-fee-policies/{id}/archive 추가 수수료 정책 보관 #
POST /platform/additional-fee-policies/{id}/recover 추가 수수료 정책 복원 #
GET /platform/additional-fee-policies/{id}/schedule #
PUT /platform/additional-fee-policies/{id}/schedule #
POST /platform/additional-fee-policies/{id}/schedule #
DELETE /platform/additional-fee-policies/{id}/schedule #
GET /platform/additional-fee-policies/{id} 추가 수수료 정책 조회 #
PATCH /platform/additional-fee-policies/{id} 추가 수수료 정책 수정 #
GET /platform/additional-fee-policies 추가 수수료 정책 다건 조회 #
POST /platform/additional-fee-policies 추가 수수료 정책 생성 #
GET /platform/bank-accounts/{bank}/{accountNumber}/holder 예금주 조회 #
GET /platform/bulk-account-transfers 일괄 이체 내역 다건 조회 #
GET /platform/bulk-payouts 일괄 지급 내역 다건 조회 #
GET /platform/companies/{businessRegistrationNumber}/state 사업자 조회 #
POST /platform/contracts/{id}/archive 계약 보관 #
POST /platform/contracts/{id}/recover 계약 복원 #
GET /platform/contracts/{id}/schedule #
PUT /platform/contracts/{id}/schedule #
POST /platform/contracts/{id}/schedule #
DELETE /platform/contracts/{id}/schedule #
GET /platform/contracts/{id} 계약 조회 #
PATCH /platform/contracts/{id} 계약 수정 #
GET /platform/contracts 계약 다건 조회 #
POST /platform/contracts 계약 생성 #
POST /platform/discount-share-policies/{id}/archive 할인 분담 정책 보관 #
POST /platform/discount-share-policies/{id}/recover 할인 분담 정책 복원 #
GET /platform/discount-share-policies/{id}/schedule #
PUT /platform/discount-share-policies/{id}/schedule #
POST /platform/discount-share-policies/{id}/schedule #
DELETE /platform/discount-share-policies/{id}/schedule #
GET /platform/discount-share-policies/{id} 할인 분담 정책 조회 #
PATCH /platform/discount-share-policies/{id} 할인 분담 정책 수정 #
GET /platform/discount-share-policies 할인 분담 정책 다건 조회 #
POST /platform/discount-share-policies 할인 분담 정책 생성 #
GET /platform/discount-share-policy-filter-options #
GET /platform/partner-filter-options #
POST /platform/partner-settlements/complete-payout 일괄 지급 완료 처리 #
POST /platform/partner-settlements/delete 정산내역 삭제 #
GET /platform/partner-settlements 정산 내역 다건 조회 #
POST /platform/partners/batch 파트너 다건 생성 #
POST /platform/partners/counterparty-connect/{id} 파트너 거래처 연동 #
POST /platform/partners/counterparty-connect 파트너 일괄 거래처 연동 #
POST /platform/partners/counterparty-disconnect/{id} 파트너 거래처 연동 해제 #
POST /platform/partners/counterparty-disconnect 파트너 일괄 거래처 연동 해제 #
POST /platform/partners/schedule #
POST /platform/partners/{id}/archive 파트너 보관 #
POST /platform/partners/{id}/recover 파트너 복원 #
GET /platform/partners/{id}/schedule #
PUT /platform/partners/{id}/schedule #
POST /platform/partners/{id}/schedule #
DELETE /platform/partners/{id}/schedule #
GET /platform/partners/{id} 파트너 조회 #
PATCH /platform/partners/{id} 파트너 수정 #
GET /platform/partners 파트너 다건 조회 #
POST /platform/partners 파트너 생성 #
GET /platform/payouts 지급 내역 다건 조회 #
GET /platform/setting 플랫폼 설정 조회 #
PATCH /platform/setting 플랫폼 설정 업데이트 #
GET /platform/transfer-summaries/sheet-file 정산 상세 내역 다운로드 #
GET /platform/transfer-summaries 정산건 다건 조회 #
POST /platform/transfers/manual 수기 정산건 생성 #
POST /platform/transfers/order-cancel 주문 취소 정산건 생성 #
POST /platform/transfers/order 주문 정산건 생성 #
GET /platform/transfers/{id} 정산건 조회 #
DELETE /platform/transfers/{id} 정산건 삭제 #

Documentation

📖
Documentation
https://developers.portone.io/api/rest-v2/payment
📖
APIReference
https://developers.portone.io/api/rest-v2
📖
Documentation
https://developers.portone.io/api/rest-v2/payment.billingKey
📖
Documentation
https://developers.portone.io/api/rest-v2/paymentSchedule
📖
Documentation
https://developers.portone.io/api/rest-v2/identityVerification
📖
Documentation
https://developers.portone.io/api/rest-v2/cashReceipt
📖
Documentation
https://developers.portone.io/api/rest-v2/b2b
📖
Documentation
https://developers.portone.io/api/rest-v2/platform
📖
Documentation
https://developers.portone.io/api/rest-v2/paymentSession

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/portone/refs/heads/main/openapi/portone-platform-api-openapi.yml

Other Resources

🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/portone/refs/heads/main/collections/portone.postman_collection.json

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/portone-platform-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

portone-platform-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: PortOne B2b Platform API
  version: 1.16.0
servers:
- url: https://api.portone.io
  description: 운영환경 서버
tags:
- name: Platform
paths:
  /platform/account-transfers:
    get:
      summary: 이체 내역 다건 조회
      description: '이체 내역 다건 조회


        여러 이체 내역을 조회합니다.'
      operationId: getPlatformAccountTransfers
      parameters:
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      - name: requestBody
        in: query
        required: false
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetAccountTransfersBody1'
      responses:
        '200':
          description: 성공 응답으로 조회된 이체 내역과 페이지 정보를 반환합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAccountTransfersResponse'
          x-portone-description: 성공 응답으로 조회된 이체 내역과 페이지 정보를 반환합니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAccountTransfersError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAccountTransfersError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAccountTransfersError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-category: platform.accountTransfer
      x-portone-title: 이체 내역 다건 조회
      x-portone-description: 여러 이체 내역을 조회합니다.
      x-portone-error:
        $ref: '#/components/schemas/GetPlatformAccountTransfersError'
      x-portone-unstable: true
      tags:
      - Platform
  /platform/additional-fee-policies/{id}/archive:
    post:
      summary: 추가 수수료 정책 보관
      description: '추가 수수료 정책 보관


        주어진 아이디에 대응되는 추가 수수료 정책을 보관합니다.'
      operationId: archivePlatformAdditionalFeePolicy
      parameters:
      - name: id
        in: path
        description: 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      responses:
        '200':
          description: 성공 응답으로 보관된 추가 수수료 정책 객체를 반환합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchivePlatformAdditionalFeePolicyResponse'
          x-portone-description: 성공 응답으로 보관된 추가 수수료 정책 객체를 반환합니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchivePlatformAdditionalFeePolicyError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchivePlatformAdditionalFeePolicyError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchivePlatformAdditionalFeePolicyError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchivePlatformAdditionalFeePolicyError'
        '409':
          description: '* `PlatformCannotArchiveScheduledAdditionalFeePolicyError`: 예약된 업데이트가 있는 추가 수수료 정책을 보관하려고 하는 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ArchivePlatformAdditionalFeePolicyError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-category: platform.policy
      x-portone-title: 추가 수수료 정책 보관
      x-portone-description: 주어진 아이디에 대응되는 추가 수수료 정책을 보관합니다.
      x-portone-error:
        $ref: '#/components/schemas/ArchivePlatformAdditionalFeePolicyError'
      tags:
      - Platform
  /platform/additional-fee-policies/{id}/recover:
    post:
      summary: 추가 수수료 정책 복원
      description: '추가 수수료 정책 복원


        주어진 아이디에 대응되는 추가 수수료 정책을 복원합니다.'
      operationId: recoverPlatformAdditionalFeePolicy
      parameters:
      - name: id
        in: path
        description: 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      responses:
        '200':
          description: 성공 응답으로 복원된 추가 수수료 정책 객체를 반환합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecoverPlatformAdditionalFeePolicyResponse'
          x-portone-description: 성공 응답으로 복원된 추가 수수료 정책 객체를 반환합니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecoverPlatformAdditionalFeePolicyError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecoverPlatformAdditionalFeePolicyError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecoverPlatformAdditionalFeePolicyError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RecoverPlatformAdditionalFeePolicyError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-category: platform.policy
      x-portone-title: 추가 수수료 정책 복원
      x-portone-description: 주어진 아이디에 대응되는 추가 수수료 정책을 복원합니다.
      x-portone-error:
        $ref: '#/components/schemas/RecoverPlatformAdditionalFeePolicyError'
      tags:
      - Platform
  /platform/additional-fee-policies/{id}/schedule:
    get:
      description: 주어진 아이디에 대응되는 추가 수수료 정책의 예약 업데이트를 조회합니다.
      operationId: getPlatformAdditionalFeePolicySchedule
      parameters:
      - name: id
        in: path
        description: 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      responses:
        '200':
          description: 성공 응답으로 예약된 추가 수수료 정책을 반환합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformAdditionalFeePolicy'
          x-portone-description: 성공 응답으로 예약된 추가 수수료 정책을 반환합니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyScheduleError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyScheduleError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyScheduleError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyScheduleError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-description: 주어진 아이디에 대응되는 추가 수수료 정책의 예약 업데이트를 조회합니다.
      x-portone-error:
        $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyScheduleError'
      x-portone-unstable: true
      tags:
      - Platform
    put:
      operationId: rescheduleAdditionalFeePolicy
      parameters:
      - name: id
        in: path
        description: 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ReschedulePlatformAdditionalFeePolicyBody'
        required: true
      responses:
        '200':
          description: 성공 응답으로 예약된 추가 수수료 정책이 반환됩니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ReschedulePlatformAdditionalFeePolicyResponse'
          x-portone-description: 성공 응답으로 예약된 추가 수수료 정책이 반환됩니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RescheduleAdditionalFeePolicyError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RescheduleAdditionalFeePolicyError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RescheduleAdditionalFeePolicyError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RescheduleAdditionalFeePolicyError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-error:
        $ref: '#/components/schemas/RescheduleAdditionalFeePolicyError'
      x-portone-unstable: true
      tags:
      - Platform
    post:
      description: 주어진 아이디에 대응되는 추가 수수료 정책에 업데이트를 예약합니다.
      operationId: scheduleAdditionalFeePolicy
      parameters:
      - name: id
        in: path
        description: 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SchedulePlatformAdditionalFeePolicyBody'
        required: true
      responses:
        '200':
          description: 성공 응답으로 예약된 추가 수수료 정책을 반환합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SchedulePlatformAdditionalFeePolicyResponse'
          x-portone-description: 성공 응답으로 예약된 추가 수수료 정책을 반환합니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleAdditionalFeePolicyError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleAdditionalFeePolicyError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleAdditionalFeePolicyError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleAdditionalFeePolicyError'
        '409':
          description: '* `PlatformAdditionalFeePolicyScheduleAlreadyExistsError`

            * `PlatformArchivedAdditionalFeePolicyError`: 보관된 추가 수수료 정책을 업데이트하려고 하는 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScheduleAdditionalFeePolicyError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-description: 주어진 아이디에 대응되는 추가 수수료 정책에 업데이트를 예약합니다.
      x-portone-error:
        $ref: '#/components/schemas/ScheduleAdditionalFeePolicyError'
      x-portone-unstable: true
      tags:
      - Platform
    delete:
      description: 주어진 아이디에 대응되는 추가 수수료 정책의 예약 업데이트를 취소합니다.
      operationId: cancelPlatformAdditionalFeePolicySchedule
      parameters:
      - name: id
        in: path
        description: 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      responses:
        '200':
          description: 성공 응답
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelPlatformAdditionalFeePolicyScheduleResponse'
          x-portone-title: 성공 응답
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelPlatformAdditionalFeePolicyScheduleError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelPlatformAdditionalFeePolicyScheduleError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelPlatformAdditionalFeePolicyScheduleError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CancelPlatformAdditionalFeePolicyScheduleError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-description: 주어진 아이디에 대응되는 추가 수수료 정책의 예약 업데이트를 취소합니다.
      x-portone-error:
        $ref: '#/components/schemas/CancelPlatformAdditionalFeePolicyScheduleError'
      x-portone-unstable: true
      tags:
      - Platform
  /platform/additional-fee-policies/{id}:
    get:
      summary: 추가 수수료 정책 조회
      description: '추가 수수료 정책 조회


        주어진 아이디에 대응되는 추가 수수료 정책을 조회합니다.'
      operationId: getPlatformAdditionalFeePolicy
      parameters:
      - name: id
        in: path
        description: 조회할 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 조회할 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      responses:
        '200':
          description: 성공 응답으로 추가 수수료 정책을 반환합니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PlatformAdditionalFeePolicy'
          x-portone-description: 성공 응답으로 추가 수수료 정책을 반환합니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-category: platform.policy
      x-portone-title: 추가 수수료 정책 조회
      x-portone-description: 주어진 아이디에 대응되는 추가 수수료 정책을 조회합니다.
      x-portone-error:
        $ref: '#/components/schemas/GetPlatformAdditionalFeePolicyError'
      tags:
      - Platform
    patch:
      summary: 추가 수수료 정책 수정
      description: '추가 수수료 정책 수정


        주어진 아이디에 대응되는 추가 수수료 정책을 업데이트합니다.'
      operationId: updatePlatformAdditionalFeePolicy
      parameters:
      - name: id
        in: path
        description: 업데이트할 추가 수수료 정책 아이디
        required: true
        schema:
          type: string
        x-portone-title: 업데이트할 추가 수수료 정책 아이디
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyBody'
        required: true
      responses:
        '200':
          description: 성공 응답으로 업데이트된 추가 수수료 정책이 반환됩니다.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyResponse'
          x-portone-description: 성공 응답으로 업데이트된 추가 수수료 정책이 반환됩니다.
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyError'
        '403':
          description: '* `PlatformNotEnabledError`: 플랫폼 기능이 활성화되지 않아 요청을 처리할 수 없는 경우

            * `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyError'
        '404':
          description: '* `PlatformAdditionalFeePolicyNotFoundError`'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyError'
        '409':
          description: '* `PlatformArchivedAdditionalFeePolicyError`: 보관된 추가 수수료 정책을 업데이트하려고 하는 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-category: platform.policy
      x-portone-title: 추가 수수료 정책 수정
      x-portone-description: 주어진 아이디에 대응되는 추가 수수료 정책을 업데이트합니다.
      x-portone-error:
        $ref: '#/components/schemas/UpdatePlatformAdditionalFeePolicyError'
      tags:
      - Platform
  /platform/additional-fee-policies:
    get:
      summary: 추가 수수료 정책 다건 조회
      description: '추가 수수료 정책 다건 조회


        여러 추가 수수료 정책을 조회합니다.'
      operationId: getPlatformAdditionalFeePolicies
      parameters:
      - name: test
        in: query
        description: '테스트 모드 여부


          테스트 모드 여부를 결정합니다. true 이면 테스트 모드로 실행됩니다. Request Body에도 isForTest가 있을 수 있으나, 둘 다 제공되면 Query Parameter의 test 값을 사용하고, Request Body의 isForTest는 무시됩니다. Query Parameter의 test와 Request Body의 isForTest에 모두 값이 제공되지 않으면 기본값인 false로 적용됩니다.'
        required: false
        schema:
          type: boolean
        x-portone-title: 테스트 모드 여부
        x-portone-description: 테스트 모드 여부를 결정합니다. true �

# --- truncated at 32 KB (577 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/portone/refs/heads/main/openapi/portone-platform-api-openapi.yml