PortOne

PortOne Payment Sessions API

The Payment Sessions API from PortOne — 3 operation(s) for payment sessions.

GitHub OpenAPI

Operations 3

POST /payment-sessions 결제 세션 생성 #
GET /payment-sessions/{sessionId} 결제 세션 조회 #
POST /payment-sessions/{sessionId}/close 결제 세션 종료 #

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-payment-sessions-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-payment-sessions-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-payment-sessions-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: PortOne B2b Payment Sessions API
  version: 1.16.0
servers:
- url: https://api.portone.io
  description: 운영환경 서버
tags:
- name: Payment Sessions
paths:
  /payment-sessions:
    post:
      summary: 결제 세션 생성
      description: '결제 세션 생성


        결제 세션을 생성합니다. 호스티드 체크아웃 페이지가 생성되어 URL이 반환됩니다.'
      operationId: createPaymentSession
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreatePaymentSessionBody'
        required: true
      responses:
        '200':
          description: 성공 응답
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePaymentSessionResponse'
          x-portone-title: 성공 응답
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우

            * `MaxTtlExceededError`: 요청된 TTL이 정책 상한을 초과한 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePaymentSessionError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePaymentSessionError'
        '403':
          description: '* `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CreatePaymentSessionError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-category: paymentSession
      x-portone-title: 결제 세션 생성
      x-portone-description: 결제 세션을 생성합니다. 호스티드 체크아웃 페이지가 생성되어 URL이 반환됩니다.
      x-portone-error:
        $ref: '#/components/schemas/CreatePaymentSessionError'
      tags:
      - Payment Sessions
  /payment-sessions/{sessionId}:
    get:
      summary: 결제 세션 조회
      description: '결제 세션 조회


        결제 세션을 조회합니다. 인증 헤더 없이 웹 페이지에서도 접근 가능합니다.'
      operationId: getPaymentSession
      parameters:
      - name: sessionId
        in: path
        description: 결제 세션 아이디
        required: true
        schema:
          type: string
        x-portone-title: 결제 세션 아이디
      responses:
        '200':
          description: 결제 세션 조회 성공 응답
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PaymentSession'
          x-portone-title: 결제 세션 조회 성공 응답
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPaymentSessionError'
        '404':
          description: '* `SessionNotFoundError`: 결제 세션이 존재하지 않는 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPaymentSessionError'
        '410':
          description: '* `SessionExpiredError`: 결제 세션이 만료된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetPaymentSessionError'
      x-portone-category: paymentSession
      x-portone-title: 결제 세션 조회
      x-portone-description: 결제 세션을 조회합니다. 인증 헤더 없이 웹 페이지에서도 접근 가능합니다.
      x-portone-error:
        $ref: '#/components/schemas/GetPaymentSessionError'
      tags:
      - Payment Sessions
  /payment-sessions/{sessionId}/close:
    post:
      summary: 결제 세션 종료
      description: '결제 세션 종료


        결제 세션을 즉시 만료시킵니다. 이후 해당 세션으로는 결제 페이지에 접근할 수 없습니다.'
      operationId: closePaymentSession
      parameters:
      - name: sessionId
        in: path
        description: 결제 세션 아이디
        required: true
        schema:
          type: string
        x-portone-title: 결제 세션 아이디
      responses:
        '200':
          description: 성공 응답
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClosePaymentSessionResponse'
          x-portone-title: 성공 응답
        '400':
          description: '* `InvalidRequestError`: 요청된 입력 정보가 유효하지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClosePaymentSessionError'
        '401':
          description: '* `UnauthorizedError`: 인증 정보가 올바르지 않은 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClosePaymentSessionError'
        '403':
          description: '* `ForbiddenError`: 요청이 거절된 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClosePaymentSessionError'
        '404':
          description: '* `SessionNotFoundError`: 결제 세션이 존재하지 않는 경우'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ClosePaymentSessionError'
      security:
      - bearerJwt: []
      - portOne: []
      x-portone-category: paymentSession
      x-portone-title: 결제 세션 종료
      x-portone-description: 결제 세션을 즉시 만료시킵니다. 이후 해당 세션으로는 결제 페이지에 접근할 수 없습니다.
      x-portone-error:
        $ref: '#/components/schemas/ClosePaymentSessionError'
      tags:
      - Payment Sessions
components:
  schemas:
    Currency:
      title: 통화
      description: 통화
      type: string
      enum:
      - KRW
      - USD
      - JPY
      - AED
      - AFN
      - ALL
      - AMD
      - ANG
      - AOA
      - ARS
      - AUD
      - AWG
      - AZN
      - BAM
      - BBD
      - BDT
      - BGN
      - BHD
      - BIF
      - BMD
      - BND
      - BOB
      - BOV
      - BRL
      - BSD
      - BTN
      - BWP
      - BYN
      - BZD
      - CAD
      - CDF
      - CHE
      - CHF
      - CHW
      - CLF
      - CLP
      - CNY
      - COP
      - COU
      - CRC
      - CUC
      - CUP
      - CVE
      - CZK
      - DJF
      - DKK
      - DOP
      - DZD
      - EGP
      - ERN
      - ETB
      - EUR
      - FJD
      - FKP
      - GBP
      - GEL
      - GHS
      - GIP
      - GMD
      - GNF
      - GTQ
      - GYD
      - HKD
      - HNL
      - HRK
      - HTG
      - HUF
      - IDR
      - ILS
      - INR
      - IQD
      - IRR
      - ISK
      - JMD
      - JOD
      - KES
      - KGS
      - KHR
      - KMF
      - KPW
      - KWD
      - KYD
      - KZT
      - LAK
      - LBP
      - LKR
      - LRD
      - LSL
      - LYD
      - MAD
      - MDL
      - MGA
      - MKD
      - MMK
      - MNT
      - MOP
      - MRU
      - MUR
      - MVR
      - MWK
      - MXN
      - MXV
      - MYR
      - MZN
      - NAD
      - NGN
      - NIO
      - NOK
      - NPR
      - NZD
      - OMR
      - PAB
      - PEN
      - PGK
      - PHP
      - PKR
      - PLN
      - PYG
      - QAR
      - RON
      - RSD
      - RUB
      - RWF
      - SAR
      - SBD
      - SCR
      - SDG
      - SEK
      - SGD
      - SHP
      - SLE
      - SLL
      - SOS
      - SRD
      - SSP
      - STN
      - SVC
      - SYP
      - SZL
      - THB
      - TJS
      - TMT
      - TND
      - TOP
      - TRY
      - TTD
      - TWD
      - TZS
      - UAH
      - UGX
      - USN
      - UYI
      - UYU
      - UYW
      - UZS
      - VED
      - VES
      - VND
      - VUV
      - WST
      - XAF
      - XAG
      - XAU
      - XBA
      - XBB
      - XBC
      - XBD
      - XCD
      - XDR
      - XOF
      - XPD
      - XPF
      - XPT
      - XSU
      - XTS
      - XUA
      - XXX
      - YER
      - ZAR
      - ZMW
      - ZWL
      x-portone-title: 통화
      x-portone-enum:
        OMR:
          title: Rial Omani
        CUC:
          title: Peso Convertible
        BBD:
          title: Barbados Dollar
        PLN:
          title: Zloty
        SVC:
          title: El Salvador Colon
        BMD:
          title: Bermudian Dollar
        TJS:
          title: Somoni
        TND:
          title: Tunisian Dinar
        GNF:
          title: Guinean Franc
        SDG:
          title: Sudanese Pound
        MRU:
          title: Ouguiya
        XBB:
          title: Bond Markets Unit European Monetary Unit (E.M.U.-6)
        PKR:
          title: Pakistan Rupee
        FKP:
          title: Falkland Islands Pound
        MUR:
          title: Mauritius Rupee
        XAF:
          title: CFA Franc BEAC
        SAR:
          title: Saudi Riyal
        CAD:
          title: Canadian Dollar
        HKD:
          title: Hong Kong Dollar
        PYG:
          title: Guarani
        MGA:
          title: Malagasy Ariary
        UYI:
          title: Uruguay Peso en Unidades Indexadas (UI)
        AUD:
          title: Australian Dollar
        AMD:
          title: Armenian Dram
        YER:
          title: Yemeni Rial
        CHE:
          title: WIR Euro
        MMK:
          title: Kyat
        SEK:
          title: Swedish Krona
        TRY:
          title: Turkish Lira
        XBC:
          title: Bond Markets Unit European Unit of Account 9 (E.U.A.-9)
        KES:
          title: Kenyan Shilling
        GEL:
          title: Lari
        GTQ:
          title: Quetzal
        TZS:
          title: Tanzanian Shilling
        CUP:
          title: Cuban Peso
        ALL:
          title: Lek
        ERN:
          title: Nakfa
        BRL:
          title: Brazilian Real
        UGX:
          title: Uganda Shilling
        XUA:
          title: ADB Unit of Account
        GIP:
          title: Gibraltar Pound
        MZN:
          title: Mozambique Metical
        KRW:
          title: 대한민국 원화
        JOD:
          title: Jordanian Dinar
        IQD:
          title: Iraqi Dinar
        VUV:
          title: Vatu
        XXX:
          title: The codes assigned for transactions where no currency is involved
        UZS:
          title: Uzbekistan Sum
        BOV:
          title: Mvdol
        UAH:
          title: Hryvnia
        PEN:
          title: Sol
        KMF:
          title: 'Comorian Franc '
        DOP:
          title: Dominican Peso
        BDT:
          title: Taka
        LKR:
          title: Sri Lanka Rupee
        FJD:
          title: Fiji Dollar
        LSL:
          title: Loti
        BSD:
          title: Bahamian Dollar
        SRD:
          title: Surinam Dollar
        XTS:
          title: Codes specifically reserved for testing purposes
        SHP:
          title: Saint Helena Pound
        LRD:
          title: Liberian Dollar
        QAR:
          title: Qatari Rial
        BND:
          title: Brunei Dollar
        CDF:
          title: Congolese Franc
        SLE:
          title: Leone
        USN:
          title: US Dollar (Next day)
        VES:
          title: Bolívar Soberano
        TMT:
          title: Turkmenistan New Manat
        CHW:
          title: WIR Franc
        BGN:
          title: Bulgarian Lev
        JMD:
          title: Jamaican Dollar
        SZL:
          title: Lilangeni
        CZK:
          title: Czech Koruna
        ZMW:
          title: Zambian Kwacha
        UYU:
          title: Peso Uruguayo
        NPR:
          title: Nepalese Rupee
        EGP:
          title: Egyptian Pound
        AZN:
          title: Azerbaijan Manat
        CLP:
          title: Chilean Peso
        MOP:
          title: Pataca
        SCR:
          title: Seychelles Rupee
        HTG:
          title: Gourde
        VND:
          title: Dong
        LAK:
          title: Lao Kip
        BTN:
          title: Ngultrum
        GBP:
          title: Pound Sterling
        SSP:
          title: South Sudanese Pound
        XPD:
          title: Palladium
        TWD:
          title: New Taiwan Dollar
        DZD:
          title: Algerian Dinar
        MXN:
          title: Mexican Peso
        XDR:
          title: SDR (Special Drawing Right)
        ZWL:
          title: Zimbabwe Dollar
        AWG:
          title: Aruban Florin
        THB:
          title: Baht
        ISK:
          title: Iceland Krona
        LBP:
          title: Lebanese Pound
        SGD:
          title: Singapore Dollar
        MWK:
          title: Malawi Kwacha
        KZT:
          title: Tenge
        CRC:
          title: Costa Rican Colon
        WST:
          title: Tala
        DJF:
          title: Djibouti Franc
        LYD:
          title: Libyan Dinar
        NGN:
          title: Naira
        BIF:
          title: Burundi Franc
        AED:
          title: UAE Dirham
        CHF:
          title: Swiss Franc
        RWF:
          title: Rwanda Franc
        XBD:
          title: Bond Markets Unit European Unit of Account 17 (E.U.A.-17)
        INR:
          title: Indian Rupee
        CLF:
          title: Unidad de Fomento
        XOF:
          title: CFA Franc BCEAO
        COU:
          title: Unidad de Valor Real
        MXV:
          title: Mexican Unidad de Inversion (UDI)
        PGK:
          title: Kina
        CNY:
          title: Yuan Renminbi
        SYP:
          title: Syrian Pound
        VED:
          title: Bolívar Soberano
        RON:
          title: Romanian Leu
        AFN:
          title: Afghani
        PHP:
          title: Philippine Peso
        MDL:
          title: Moldovan Leu
        KHR:
          title: Riel
        XPT:
          title: Platinum
        COP:
          title: Colombian Peso
        DKK:
          title: Danish Krone
        KYD:
          title: Cayman Islands Dollar
        XPF:
          title: CFP Franc
        GMD:
          title: Dalasi
        MVR:
          title: Rufiyaa
        STN:
          title: Dobra
        TTD:
          title: Trinidad and Tobago Dollar
        PAB:
          title: Balboa
        XAU:
          title: Gold
        XAG:
          title: Silver
        JPY:
          title: 일본 엔화
        TOP:
          title: Pa’anga
        BWP:
          title: Pula
        MKD:
          title: Denar
        ARS:
          title: Argentine Peso
        HUF:
          title: Forint
        MYR:
          title: Malaysian Ringgit
        USD:
          title: 미국 달러
        SLL:
          title: Leone
        MAD:
          title: Moroccan Dirham
        RUB:
          title: Russian Ruble
        MNT:
          title: Tugrik
        BOB:
          title: Boliviano
        GYD:
          title: Guyana Dollar
        SBD:
          title: Solomon Islands Dollar
        XBA:
          title: Bond Markets Unit European Composite Unit (EURCO)
        BHD:
          title: Bahraini Dinar
        HNL:
          title: Lempira
        UYW:
          title: Unidad Previsional
        NZD:
          title: New Zealand Dollar
        XCD:
          title: East Caribbean Dollar
        XSU:
          title: Sucre
        KGS:
          title: Som
        AOA:
          title: Kwanza
        BZD:
          title: Belize Dollar
        IDR:
          title: Rupiah
        SOS:
          title: Somali Shilling
        NIO:
          title: Cordoba Oro
        GHS:
          title: Ghana Cedi
        ANG:
          title: Netherlands Antillean Guilder
        RSD:
          title: Serbian Dinar
        ILS:
          title: New Israeli Sheqel
        NOK:
          title: Norwegian Krone
        KWD:
          title: Kuwaiti Dinar
        NAD:
          title: Namibia Dollar
        ETB:
          title: Ethiopian Birr
        BYN:
          title: Belarusian Ruble
        KPW:
          title: North Korean Won
        EUR:
          title: Euro
        CVE:
          title: Cabo Verde Escudo
        ZAR:
          title: Rand
        IRR:
          title: Iranian Rial
        HRK:
          title: Kuna (Replaced by EUR)
        BAM:
          title: Convertible Mark
    PaymentSessionColors:
      title: 체크아웃 페이지 색 설정
      description: 체크아웃 페이지 색 설정
      type: object
      properties:
        primary:
          type: string
          title: 주 색상
          description: CSS 색 문자열 형식
        primaryHover:
          type: string
          title: 호버 주 색상
          description: CSS 색 문자열 형식
        primaryLight:
          type: string
          title: 밝은 주 색상
          description: CSS 색 문자열 형식
      x-portone-title: 체크아웃 페이지 색 설정
    UnauthorizedError:
      title: 인증 정보가 올바르지 않은 경우
      description: 인증 정보가 올바르지 않은 경우
      type: object
      required:
      - type
      properties:
        type:
          type: string
        message:
          type: string
      x-portone-title: 인증 정보가 올바르지 않은 경우
      x-portone-status-code: 401
    PaymentSession:
      title: 결제 세션
      description: 결제 세션
      type: object
      required:
      - id
      - storeId
      - paymentId
      - profileKey
      - country
      - currency
      - totalAmount
      - orderName
      - createdAt
      - expiresAt
      properties:
        id:
          type: string
          title: 결제 세션 아이디
        storeId:
          type: string
          title: 상점 아이디
        paymentId:
          type: string
          title: 결제 건 아이디
        profileKey:
          type: string
          title: 프로필 키
        paymentMethod:
          $ref: '#/components/schemas/CheckoutPaymentMethod'
          title: 결제 수단 지정
          description: 지정한 경우, 정보 추가 입력이 필요하지 않은 경우에 주문서를 건너뛰고 결제로 바로 이동합니다.
        country:
          $ref: '#/components/schemas/Country'
          title: 국가
        currency:
          $ref: '#/components/schemas/Currency'
          title: 통화
        totalAmount:
          type: integer
          format: int64
          title: 전체 결제 금액
        orderName:
          type: string
          title: 주문명
        redirectUrl:
          type: string
          title: 결제 완료 후 리다이렉트 URL
          description: 지정하지 않으면 기본 결과 페이지가 표시됩니다.
        products:
          title: 주문 항목 목록
          type: array
          items:
            $ref: '#/components/schemas/PaymentSessionProduct'
          x-portone-title: 결제 세션 주문 항목
          properties:
            url:
              title: 판매 링크
            id:
              title: 항목 아이디
            nPayUid:
              title: 네이버페이 상품 식별자
            unitPrice:
              title: 상품 단가
            startDate:
              title: 제공 시작일
              description: 구독 등 제공 기간이 있는 상품의 경우 입력하세요.
            name:
              title: 상품 이름
            quantity:
              title: 상품 수량
            endDate:
              title: 제공 종료일
              description: 구독 등 제공 기간이 있는 상품의 경우 입력하세요.
            nPayCategoryId:
              title: 네이버페이 카테고리 아이디
            code:
              title: 상품 코드
            nPayCategoryType:
              title: 네이버페이 카테고리 타입
        customerName:
          type: string
          title: 구매자 이름
        customerEmail:
          type: string
          title: 구매자 이메일
        storeName:
          type: string
          title: 상점 이름
          description: 페이지 헤더 및 결제사 UI에 표시됩니다.
        agreements:
          title: 사용자 지정 약관 목록
          type: array
          items:
            $ref: '#/components/schemas/PaymentSessionAgreement'
          x-portone-title: 결제 세션 약관
          properties:
            name:
              title: 약관 이름
            url:
              title: 약관 URL
          description: 구매자가 모든 약관에 동의해야 결제 버튼이 활성화됩니다.
        orderImageUrl:
          type: string
          title: 주문 대표 이미지 URL
        customData:
          type: string
          title: 사용자 지정 데이터
          description: 결제 완료 후 결제 건 조회에서도 확인할 수 있습니다.
        colors:
          $ref: '#/components/schemas/PaymentSessionColors'
          title: 체크아웃 페이지 색 설정
        createdAt:
          type: string
          format: date-time
          title: 생성 시각
        expiresAt:
          type: string
          format: date-time
          title: 만료 시각
      x-portone-title: 결제 세션
    CreatePaymentSessionResponse:
      title: 결제 세션 생성 성공 응답
      description: 결제 세션 생성 성공 응답
      type: object
      required:
      - sessionId
      - url
      - expiresAt
      properties:
        sessionId:
          type: string
          title: 세션 아이디
        url:
          type: string
          title: 호스티드 체크아웃 페이지 URL
        expiresAt:
          type: string
          format: date-time
          title: 만료 시각
      x-portone-title: 결제 세션 생성 성공 응답
    ClosePaymentSessionResponse:
      title: 결제 세션 종료 성공 응답
      description: 결제 세션 종료 성공 응답
      type: object
      required:
      - closedAt
      properties:
        closedAt:
          type: string
          format: date-time
          title: 결제 세션 종료 시각
      x-portone-title: 결제 세션 종료 성공 응답
    GetPaymentSessionError:
      title: GetPaymentSessionError
      oneOf:
      - $ref: '#/components/schemas/InvalidRequestError'
      - $ref: '#/components/schemas/SessionExpiredError'
      - $ref: '#/components/schemas/SessionNotFoundError'
      discriminator:
        propertyName: type
        mapping:
          INVALID_REQUEST: '#/components/schemas/InvalidRequestError'
          SESSION_EXPIRED: '#/components/schemas/SessionExpiredError'
          SESSION_NOT_FOUND: '#/components/schemas/SessionNotFoundError'
    ForbiddenError:
      title: 요청이 거절된 경우
      description: 요청이 거절된 경우
      type: object
      required:
      - type
      properties:
        type:
          type: string
        message:
          type: string
      x-portone-title: 요청이 거절된 경우
      x-portone-status-code: 403
    InvalidRequestError:
      title: 요청된 입력 정보가 유효하지 않은 경우
      description: '요청된 입력 정보가 유효하지 않은 경우


        허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.'
      type: object
      required:
      - type
      properties:
        type:
          type: string
        message:
          type: string
      x-portone-title: 요청된 입력 정보가 유효하지 않은 경우
      x-portone-description: 허가되지 않은 값, 올바르지 않은 형식의 요청 등이 모두 해당됩니다.
      x-portone-status-code: 400
    CreatePaymentSessionBody:
      title: 결제 세션 생성 요청
      description: 결제 세션 생성 요청
      type: object
      required:
      - storeId
      - paymentId
      - profileKey
      - country
      - currency
      - totalAmount
      - orderName
      properties:
        storeId:
          type: string
          title: 상점 아이디
        paymentId:
          type: string
          title: 결제 건 아이디
        profileKey:
          type: string
          title: 프로필 키
        paymentMethod:
          $ref: '#/components/schemas/CheckoutPaymentMethod'
          title: 결제 수단 지정
          description: 지정한 경우, 정보 추가 입력이 필요하지 않은 경우에 주문서를 건너뛰고 결제로 바로 이동합니다.
        country:
          $ref: '#/components/schemas/Country'
          title: 국가
        currency:
          $ref: '#/components/schemas/Currency'
          title: 통화
        totalAmount:
          type: integer
          format: int64
          title: 전체 결제 금액
        orderName:
          type: string
          title: 주문명
        redirectUrl:
          type: string
          title: 결제 완료 후 리다이렉트 URL
          description: 지정하지 않으면 기본 결과 페이지가 표시됩니다.
        products:
          title: 주문 항목 목록
          type: array
          items:
            $ref: '#/components/schemas/PaymentSessionProduct'
          x-portone-title: 결제 세션 주문 항목
          properties:
            url:
              title: 판매 링크
            id:
              title: 항목 아이디
            nPayUid:
              title: 네이버페이 상품 식별자
            unitPrice:
              title: 상품 단가
            startDate:
              title: 제공 시작일
              description: 구독 등 제공 기간이 있는 상품의 경우 입력하세요.
            name:
              title: 상품 이름
            quantity:
              title: 상품 수량
            endDate:
              title: 제공 종료일
              description: 구독 등 제공 기간이 있는 상품의 경우 입력하세요.
            nPayCategoryId:
              title: 네이버페이 카테고리 아이디
            code:
              title: 상품 코드
            nPayCategoryType:
              title: 네이버페이 카테고리 타입
        customerName:
          type: string
          title: 구매자 이름
        customerEmail:
          type: string
          title: 구매자 이메일
        storeName:
          type: string
          title: 상점 이름
          description: 페이지 헤더 및 결제사 UI에 표시됩니다.
        agreements:
          title: 사용자 지정 약관 목록
          type: array
          items:
            $ref: '#/components/schemas/PaymentSessionAgreement'
          x-portone-title: 결제 세션 약관
          properties:
            name:
              title: 약관 이름
            url:
              title: 약관 URL
          description: 구매자가 모든 약관에 동의해야 결제 버튼이 활성화됩니다.
        orderImageUrl:
          type: string
          title: 주문 대표 이미지 URL
        customData:
          type: string
          title: 사용자 지정 데이터
          description: 결제 완료 후 결제 건 조회에서도 확인할 수 있습니다.
        colors:
          $ref: '#/components/schemas/PaymentSessionColors'
          title: 체크아웃 페이지 색 설정
        ttlSeconds:
          type: integer
          format: int64
          title: 세션 TTL (초)
      x-portone-title: 결제 세션 생성 요청
    PaymentSessionAgreement:
      title: 결제 세션 약관
      description: 결제 세션 약관
      type: object
      required:
      - name
      - url
      properties:
        name:
          type: string
          title: 약관 이름
        url:
          type: string
          title: 약관 URL
      x-portone-title: 결제 세션 약관
    CreatePaymentSessionError:
      title: CreatePaymentSessionError
      oneOf:
      - $ref: '#/components/schemas/ForbiddenError'
      - $ref: '#/components/schemas/InvalidRequestError'
      - $ref: '#/components/schemas/MaxTtlExceededError'
      - $ref: '#/components/schemas/UnauthorizedError'
      discriminator:
        propertyName: type
        mapping:
          FORBIDDEN: '#/components/schemas/ForbiddenError'
          INVALID_REQUEST: '#/components/schemas/InvalidRequestError'
          MAX_TTL_EXCEEDED: '#/components/schemas/MaxTtlExceededError'
          UNAUTHORIZED: '#/components/schemas/UnauthorizedError'
    ClosePaymentSessionError:
      title: ClosePaymentSessionError
      oneOf:
      - $ref: '#/components/schemas/ForbiddenError'
      - $ref: '#/components/schemas/InvalidRequestError'
      - $ref: '#/components/schemas/SessionNotFoundError'
      - $ref: '#/components/schemas/UnauthorizedError'
      discriminator:
        propertyName: type
        mapping:
          FORBIDDEN: '#/components/schemas/ForbiddenError'
          INVALID_REQUEST: '#/components/schemas/InvalidRequestError'
          SESSION_NOT_FOUND: '#/components/schemas/SessionNotFoundError'
          UNAUTHORIZED: '#/components/schemas/UnauthorizedError'
    SessionExpiredError:
      title: 결제 세션이 만료된 경우
      description: 결제 세션이 만료된 경우
      type: object
      required:
      - type
      properties:
        type:
          type: string
        message:
          type: string
      x-portone-title: 결제 세션이 만료된 경우
      x-portone-status-code: 410
    Country:
      title: 국가
      description: 국가
      type: string
      enum:
      - AD
      - AE
      - AF
      - AG
      - AI
      - AL
      - AM
      - AO
      - AQ
      - AR
      - AS
      - AT
      - AU
      - AW
      - AX
      - AZ
      - BA
      - BB
      - BD
      - BE
      - BF
      - BG
      - BH
      - BI
      - BJ
      - BL
      - BM
      - BN
      - BO
      - BQ
      - BR
      - BS
      - BT
      - BV
      - BW
      - BY
      - BZ
      - CA
      - CC
      - CD
      - CF
      - CG
      - CH
      - CI
      - CK
      - CL
      - CM
      - CN
      - CO
      - CR
      - CU
      - CV
      - CW
      - CX
      - CY
      - CZ
      - DE
      - DJ
      - DK
      - DM
      - DO
      - DZ
      - EC
      - EE
      - EG
      - EH
      - ER
      - ES
      - ET
      - FI
      - FJ
      - FK
      - FM
      - FO
      - FR
      - GA
      - GB
      - GD
      - GE
      - GF
      - GG
      - GH
      - GI
      - GL
      - GM
      - GN
      - GP
      - GQ
      - GR
      - GS
      - GT
      - GU
      - GW
      - GY
      - HK
      - HM
      - HN
      - HR
      - HT
      - HU
      - ID
      - IE
      - IL
      - IM
      - IN
      - IO
      - IQ
      - IR
      - IS
      - IT
      - JE
      - JM
      - JO
      - JP
      - KE
      - KG
      - KH
      - KI
      - KM
      - KN
      - KP
      - KR
      - KW
      - KY
      - KZ
      - LA
      - LB
      - LC
      - LI
      - LK
      - LR
      - LS
      - LT
      - LU
      - LV
      - LY
      - MA
      - MC
      - MD
      - ME
      - MF
      - MG
      - MH
      - MK
      - ML
      - MM
      - MN
      - MO
      - MP
      - MQ
      - MR
      - MS
      - MT
      - MU
      - MV
      - MW
      - MX
      - MY
      - MZ
      - NA
      - NC
      - NE
      - NF
      - NG
      - NI
      - NL
      - 'NO'
      - NP
      - NR
      - NU
      - NZ
      - OM
      - PA
      - PE
      - PF
      - PG
      - PH
      - PK
      - PL
      - PM
      - PN
      - PR
      - PS
      - PT
      - PW
      - PY
      - QA
      - RE
      - RO
      - RS
      - RU
      - RW
      - SA
      - SB
      - SC
      - SD
      - SE
      - SG
      - SH
      - SI
      - SJ
      - SK
      - SL
      - SM
      - SN
      - SO
      - SR
      - SS
      - ST
      - SV
      - SX
      - SY
      - SZ
      - TC
      - TD
      - TF
      - TG
      - TH
      - TJ
      - TK
      - TL
      - TM
      - TN
      - TO
      - TR
      - TT
      - TV
      - TW
      - TZ
      - UA
      - UG
      - UM
      - US
      - UY
      - UZ
      - VA
      - VC
      - VE
      - VG
      - VI
      - VN
      - VU
      - WF
      - WS
      - YE
      - YT
      - ZA
      - ZM
      - ZW
      x-portone-title: 국가
      x-portone-enum:
        CV:
          title: Cabo Verde
        MA:
          title: Morocco
        AO:
          title: Angola
        VN:
          title: Viet Nam
     

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