bldinit Tossplace Rest API

The tossplace-rest API from bldinit — 11 operation(s) for tossplace-rest.

GitHub OpenAPI

Operations 11

GET /api/v1/tossplace/merchants/{merchantId} 매장 기본 정보 조회 #
GET /api/v1/tossplace/merchants/{merchantId}/order/orders 주문 목록 조회 (매출 집계) #
GET /api/v1/tossplace/merchants/{merchantId}/order/orders/{orderId} 주문 상세 조회 #
GET /api/v1/tossplace/merchants/{merchantId}/order/orders/by-ids 주문 ID 다건 조회 (max 25) #
GET /api/v1/tossplace/merchants/{merchantId}/payment/payments/{paymentId} 결제 상세 조회 #
GET /api/v1/tossplace/merchants/{merchantId}/payment/payments/by-order-id 주문번호 기준 결제 목록 조회 #
GET /api/v1/tossplace/merchants/{merchantId}/catalog/items/{itemId} 메뉴 (상품) 단건 조회 #
GET /api/v1/tossplace/merchants/{merchantId}/catalog/items 메뉴 전체 목록 #
GET /api/v1/tossplace/merchants/{merchantId}/catalog/items/search 메뉴 키워드 검색 #
GET /api/v1/tossplace/merchants/{merchantId}/catalog/categories 메뉴 카테고리 목록 #
GET /api/v1/tossplace/merchants/{merchantId}/catalog/options 메뉴 옵션 목록 #

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/mcpweave-com:mcpweave-com-tossplace-rest-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

mcpweave-com-tossplace-rest-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: mcpweave Tossplace Rest API
  description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
  version: '2026-04-27'
tags:
- name: tossplace-rest
paths:
  /api/v1/tossplace/merchants/{merchantId}:
    get:
      tags:
      - tossplace-rest
      summary: 매장 기본 정보 조회
      description: '토스플레이스 매장 (가맹점) 의 기본 정보 (id / name / businessNumber)

        를 조회합니다. 다른 mcpweave provider (이카운트·팝빌) 와 cross-

        reference 할 때 baseline 으로 사용. webhook 검증, 사장님 dashboard

        매장 식별에도 활용.


        ✅ Read-only (ADR-028 Cat A). confirmation token 면제.'
      operationId: tossplace_get_merchant
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/order/orders:
    get:
      tags:
      - tossplace-rest
      summary: 주문 목록 조회 (매출 집계)
      description: '매장의 주문 목록을 기간·상태·채널 필터로 조회합니다. 사장님 매일

        워크플로의 1순위 op:

        - "오늘 매출 합계 보여줘" — `from=오늘 00:00 / to=now`

        - "지난주 일별 매출" — `from=7d ago` 후 caller 가 createdAt 기준 group

        - "쿠팡이츠 주문만" — `sources=COUPANG_EATS`


        Pagination = page (1-base) + size (max 500) + sortOrder. ERP 일배

        sync 시 size=500 권장 (rate limit 절감).


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_list_orders
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: from_
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: 'From '
      - name: to
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: To
      - name: orderStates
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Orderstates
      - name: sources
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Sources
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/order/orders/{orderId}:
    get:
      tags:
      - tossplace-rest
      summary: 주문 상세 조회
      description: '특정 주문 ID 의 전체 detail (라인 아이템 / 결제 / 할인 / 배송 등)

        조회. 영수증 재발행 / 분쟁 처리 / 단건 매출 검증 시 사용.


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_get_order
      parameters:
      - name: orderId
        in: path
        required: true
        schema:
          type: string
          title: Orderid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/order/orders/by-ids:
    get:
      tags:
      - tossplace-rest
      summary: 주문 ID 다건 조회 (max 25)
      description: '주문번호 list (max 25) 를 받아 한 번에 detail 조회. ERP 동기화

        배치에서 webhook event 받은 주문번호들을 묶어 호출하는 패턴 권장

        (rate limit 절감).


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_get_orders_by_ids
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: ids
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Ids
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/payment/payments/{paymentId}:
    get:
      tags:
      - tossplace-rest
      summary: 결제 상세 조회
      description: '특정 결제 ID 의 detail. 카드사 (`cardDetails`) / 현금 (`cashDetails`)

        / 간편결제 (`easyPayDetails`) / 외부 결제 (`externalDetails`) 별

        sub-object 가 채워짐.


        대표 use case: "이 주문의 결제 카드사 어디였어?" — 정산 매핑 / 환불

        대상 식별. mcpweave Toss Payments (PG) 와 reconcile 시 baseline.


        ✅ Read-only (ADR-028 Cat A). 카드 BIN / 마지막 4자리 가 노출될 수

        있어 ADR-013 storage policy: body 미저장, event_id 만 로깅.'
      operationId: tossplace_get_payment
      parameters:
      - name: paymentId
        in: path
        required: true
        schema:
          type: string
          title: Paymentid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/payment/payments/by-order-id:
    get:
      tags:
      - tossplace-rest
      summary: 주문번호 기준 결제 목록 조회
      description: '한 주문 내 결제 목록. 분할결제 / 부분환불 시나리오에 다건 발생.


        대표 use case: "주문 ABC123 의 분할결제 / 부분환불 내역" — 손님이

        "절반은 카드, 절반은 현금" 으로 결제한 상황 추적.


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_list_payments_by_order_id
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: orderId
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Orderid
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/catalog/items/{itemId}:
    get:
      tags:
      - tossplace-rest
      summary: 메뉴 (상품) 단건 조회
      description: '특정 메뉴 / 상품의 detail (가격 / 옵션 ref / 카테고리 ref).

        영수증 재발행 시 메뉴명 lookup, 자체몰 동기화 시 verify 에 사용.


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_get_item
      parameters:
      - name: itemId
        in: path
        required: true
        schema:
          type: string
          title: Itemid
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/catalog/items:
    get:
      tags:
      - tossplace-rest
      summary: 메뉴 전체 목록
      description: '매장의 모든 메뉴 / 상품을 페이지네이션으로 조회. 자체몰(Cafe24)

        export 또는 ERP 마스터 등록 시나리오의 baseline.


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_list_items
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/catalog/items/search:
    get:
      tags:
      - tossplace-rest
      summary: 메뉴 키워드 검색
      description: '키워드 + 카테고리 필터로 메뉴 검색. "아메리카노" 같은 메뉴명

        partial match 또는 "음료" 카테고리 내 전체 등.


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_search_items
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: keyword
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Keyword
      - name: categoryId
        in: query
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Categoryid
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/catalog/categories:
    get:
      tags:
      - tossplace-rest
      summary: 메뉴 카테고리 목록
      description: '매장의 메뉴 카테고리 트리 (음료 / 디저트 / 식사 등). 자체몰

        category sync 시 baseline.


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_list_categories
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)
  /api/v1/tossplace/merchants/{merchantId}/catalog/options:
    get:
      tags:
      - tossplace-rest
      summary: 메뉴 옵션 목록
      description: '토핑 / 사이즈 / 온도 등 메뉴 옵션 마스터. "온도" 옵션 하위에

        "ICE / HOT" choice 가 들어있는 형태.


        ✅ Read-only (ADR-028 Cat A).'
      operationId: tossplace_list_options
      parameters:
      - name: connection_id
        in: query
        required: true
        schema:
          type: string
          description: mcpweave connection_id
          title: Connection Id
        description: mcpweave connection_id
      - name: X-API-Key
        in: header
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: X-Api-Key
      - name: mcpweave_session
        in: cookie
        required: false
        schema:
          anyOf:
          - type: string
          - type: 'null'
          title: Mcpweave Session
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        default:
          description: Native cafe24 response (200) or gateway error envelope (4xx/5xx)