WinCL

WinCL Order API

결제 전 주문 단계

GitHub OpenAPI

Operations 9

POST /api/v1/order 주문하기 #
POST /api/v1/order/one-dollar-product 1달러 랜덤 프로덕트 주문 #
GET /api/v1/order/payment/{orderId} 주문 확인 #
POST /api/v1/order/stripe/confirm 스트라이프 주문 확인 #
POST /api/v1/order/stripe/create-payment-intent Stripe Create payment-intent #
POST /api/v1/order/stripe/reserve Reserve 스트라이프 #
GET /api/v1/order/{id} 주문 내역 #
POST /api/v2/order/cancel PG 결제창 끄거나 취소 누를 시 (PG 공통) #
GET /api/v2/order/{orderId} 주문 내역 #

Documentation

📖
APIReference
https://api.wincl.io/v3/api-docs
📖
Authentication
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/authentication/wincl-authentication.yml

Specifications

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

Other Resources

🔗
Conventions
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/conventions/wincl-conventions.yml
🔗
ErrorCatalog
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/errors/wincl-error-codes.yml
🔗
Lifecycle
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/lifecycle/wincl-lifecycle.yml
🔗
Conformance
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/conformance/wincl-conformance.yml
🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/data-model/wincl-data-model.yml
🔗
AgenticAccess
https://raw.githubusercontent.com/api-evangelist/wincl/refs/heads/main/agentic-access/wincl-agentic-access.yml

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/wincl-order-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 form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

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

OpenAPI Specification

wincl-order-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Wincl Admin Order API
  version: '1.0'
  description: Admin Controller
servers:
- url: https://api.wincl.io:443
  description: Inferred Url
tags:
- name: Order
  description: 결제 전 주문 단계
paths:
  /api/v1/order:
    post:
      tags:
      - Order
      summary: 주문하기
      description: 상품을 주문한다.
      operationId: requestOrderUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderWebRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_OrderWebResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '904':
          description: INSUFFICIENT_PRODUCT_STOCK
        '921':
          description: SHOPPING_BASKET_IS_EMPTY
        '923':
          description: PRODUCT_STATUS_IS_NOT_ACTIVE
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/order/one-dollar-product:
    post:
      tags:
      - Order
      summary: 1달러 랜덤 프로덕트 주문
      operationId: orderOneDollarProductUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/OrderOneDollarProductWebRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_OrderWebResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '906':
          description: NON_PURCHASABLE_PRODUCT
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/order/payment/{orderId}:
    get:
      tags:
      - Order
      summary: 주문 확인
      operationId: selectPaymentUsingGET
      parameters:
      - name: orderId
        in: path
        description: orderId
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_ConfirmPaymentWebResponse'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '915':
          description: ITEM_NOT_FOUND
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/order/stripe/confirm:
    post:
      tags:
      - Order
      summary: 스트라이프 주문 확인
      operationId: confirmOrderUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StripeConfirmOrderWebRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_ConfirmPaymentWebResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '924':
          description: UNSUPPORTED_CURRENCY
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/order/stripe/create-payment-intent:
    post:
      tags:
      - Order
      summary: Stripe Create payment-intent
      operationId: createPaymentIntentUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StripeCreatePaymentIntentWebRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponseData_StripeCreatePaymentIntentWebResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '924':
          description: UNSUPPORTED_CURRENCY
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/order/stripe/reserve:
    post:
      tags:
      - Order
      summary: Reserve 스트라이프
      operationId: reserveStripeOrderUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/StripeReserveOrderWebRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '904':
          description: INSUFFICIENT_PRODUCT_STOCK
        '905':
          description: ALREADY_PROCESSED_ORDER
        '906':
          description: NON_PURCHASABLE_PRODUCT
        '924':
          description: UNSUPPORTED_CURRENCY
      security:
      - Bearer 토큰 값:
        - global
  /api/v1/order/{id}:
    get:
      tags:
      - Order
      summary: 주문 내역
      operationId: orderResultUsingGET
      parameters:
      - name: id
        in: path
        description: id
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_OrderHistoryWebResponse'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '924':
          description: UNSUPPORTED_CURRENCY
      security:
      - Bearer 토큰 값:
        - global
  /api/v2/order/cancel:
    post:
      tags:
      - Order
      summary: PG 결제창 끄거나 취소 누를 시 (PG 공통)
      description: order status 를 cancel 로 바꾸고 product amt unlock
      operationId: cancelOrderUsingPOST
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CancelOrderRequest'
      responses:
        '200':
          description: OK
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/WinclResponse'
        '201':
          description: Created
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '925':
          description: PAYMENT_IS_NOT_PROCESSING
      security:
      - Bearer 토큰 값:
        - global
  /api/v2/order/{orderId}:
    get:
      tags:
      - Order
      summary: 주문 내역
      operationId: getOrderSheetUsingGET
      parameters:
      - name: orderId
        in: path
        description: orderId
        required: true
        style: simple
        schema:
          type: string
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/WinclResponseData_GetOrderSheetResultData'
        '401':
          description: Unauthorized
        '403':
          description: Forbidden
        '404':
          description: Not Found
        '924':
          description: UNSUPPORTED_CURRENCY
      security:
      - Bearer 토큰 값:
        - global
components:
  schemas:
    ConfirmPaymentWebResponse:
      title: ConfirmPaymentWebResponse
      type: object
      properties:
        amt_tot:
          type: number
          format: bigdecimal
        approval_amount:
          type: number
          format: bigdecimal
        currency:
          type: string
        error_code:
          type: string
        error_message:
          type: string
        method_of_payment:
          type: string
        price_tot:
          type: number
          format: bigdecimal
        purchaseIDs:
          type: array
          items:
            type: string
        success:
          type: boolean
    WinclResponse:
      title: WinclResponse
      type: object
      properties:
        code:
          type: string
        message:
          type: string
    StripeCreatePaymentIntentWebRequest:
      title: StripeCreatePaymentIntentWebRequest
      type: object
      properties:
        id_ord:
          type: string
    WinclResponseData_StripeCreatePaymentIntentWebResponse:
      title: WinclResponseData«StripeCreatePaymentIntentWebResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/StripeCreatePaymentIntentWebResponse'
        message:
          type: string
    CancelOrderRequest:
      title: CancelOrderRequest
      type: object
      properties:
        orderId:
          type: string
    WinclResponseData_ConfirmPaymentWebResponse:
      title: WinclResponseData«ConfirmPaymentWebResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/ConfirmPaymentWebResponse'
        message:
          type: string
    GetOrderSheetResultData:
      title: GetOrderSheetResultData
      type: object
      properties:
        currency:
          type: string
        orderId:
          type: string
        orderItems:
          type: array
          items:
            $ref: '#/components/schemas/GetOrderSheetItem'
        totalAmount:
          type: number
          format: bigdecimal
        totalPrice:
          type: number
          format: bigdecimal
    OrderOneDollarProductWebRequest:
      title: OrderOneDollarProductWebRequest
      type: object
      properties:
        currency:
          type: string
          enum:
          - KRW
          - USD
    OrderHistoryWebResponse:
      title: OrderHistoryWebResponse
      type: object
      properties:
        amt_tot:
          type: number
          format: bigdecimal
        currency:
          type: string
        id_ord:
          type: string
        price_tot:
          type: number
          format: bigdecimal
    WinclResponseData_GetOrderSheetResultData:
      title: WinclResponseData«GetOrderSheetResultData»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/GetOrderSheetResultData'
        message:
          type: string
    StripeConfirmOrderWebRequest:
      title: StripeConfirmOrderWebRequest
      type: object
      properties:
        payment_intent:
          type: string
    GetOrderSheetItem:
      title: GetOrderSheetItem
      type: object
      properties:
        creditAmount:
          type: number
          format: bigdecimal
        creditPrice:
          type: number
          format: bigdecimal
        orderItemId:
          type: string
        productName:
          type: string
    StripeReserveOrderWebRequest:
      title: StripeReserveOrderWebRequest
      type: object
      properties:
        id_ord:
          type: string
        payment_intent:
          type: string
    OrderWebRequest:
      title: OrderWebRequest
      type: object
      properties:
        currency:
          type: string
    StripeCreatePaymentIntentWebResponse:
      title: StripeCreatePaymentIntentWebResponse
      type: object
      properties:
        client_secret:
          type: string
        payment_intent:
          type: string
        price_tot_usd:
          type: number
          format: bigdecimal
    OrderWebResponse:
      title: OrderWebResponse
      type: object
      properties:
        id_ord:
          type: string
    WinclResponseData_OrderWebResponse:
      title: WinclResponseData«OrderWebResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/OrderWebResponse'
        message:
          type: string
    WinclResponseData_OrderHistoryWebResponse:
      title: WinclResponseData«OrderHistoryWebResponse»
      type: object
      properties:
        code:
          type: string
        data:
          $ref: '#/components/schemas/OrderHistoryWebResponse'
        message:
          type: string
  securitySchemes:
    Bearer:
      type: http
      scheme: bearer
      bearerFormat: JWT