bldinit Tossplace Rest API
The tossplace-rest API from bldinit — 11 operation(s) for tossplace-rest.
The tossplace-rest API from bldinit — 11 operation(s) for tossplace-rest.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/mcpweave-com:mcpweave-com-tossplace-rest-api"
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.
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: 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)