bldinit Billing API
The billing API from bldinit — 7 operation(s) for billing.
The billing API from bldinit — 7 operation(s) for billing.
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-billing-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 Billing API
description: Asia-native MCP Gateway — Native pass-through, FastMCP, Paddle+Toss billing
version: '2026-04-27'
tags:
- name: Billing
paths:
/api/v1/billing/checkout:
post:
tags:
- Billing
summary: Start Checkout
operationId: start_checkout_api_v1_billing_checkout_post
parameters:
- 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
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/CheckoutBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties: true
title: Response Start Checkout Api V1 Billing Checkout Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/billing/plans:
get:
tags:
- Billing
summary: List Public Plans
description: 공개 가격표. ``is_public=TRUE`` 만 → suite_lean/internal 코드 자동 배제(페이월 보호).
operationId: list_public_plans_api_v1_billing_plans_get
responses:
'200':
description: Successful Response
content:
application/json:
schema:
additionalProperties: true
type: object
title: Response List Public Plans Api V1 Billing Plans Get
/api/v1/billing/plan:
get:
tags:
- Billing
summary: Get Org Plan
description: 'org 의 유효 플랜(``resolve_effective_plan``) + features[]. mw_ 키(``X-API-Key``) 인증.
suite 는 ``features`` 에 ``"rest"`` 포함 여부로 REST 사용 가능 판단(계약 §2.2/§5).'
operationId: get_org_plan_api_v1_billing_plan_get
parameters:
- 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:
type: object
additionalProperties: true
title: Response Get Org Plan Api V1 Billing Plan Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/billing/refund-request:
post:
tags:
- Billing
summary: File Refund Request
description: 'File a refund request (request→staff review; not an auto-refund).
Resolves the org''s latest paid invoice server-side — the user never names a
transaction. Staff action the request on /admin/ops/refunds.'
operationId: file_refund_request_api_v1_billing_refund_request_post
parameters:
- name: mcpweave_session
in: cookie
required: false
schema:
anyOf:
- type: string
- type: 'null'
title: Mcpweave Session
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/RefundRequestBody'
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties:
type: string
title: Response File Refund Request Api V1 Billing Refund Request Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/billing/portal:
post:
tags:
- Billing
summary: Create Portal Session
description: 'Mint a self-serve customer-portal URL (cancel / payment method / receipts).
MoR-native: the provider (Paddle) hosts the portal. We only resolve the
requesting org''s own customer id — never accepted from the client.'
operationId: create_portal_session_api_v1_billing_portal_post
parameters:
- 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:
type: object
additionalProperties:
type: string
title: Response Create Portal Session Api V1 Billing Portal Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/billing/me:
get:
tags:
- Billing
summary: Get My Billing
operationId: get_my_billing_api_v1_billing_me_get
parameters:
- 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:
type: object
additionalProperties: true
title: Response Get My Billing Api V1 Billing Me Get
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
/api/v1/billing/webhooks/{provider}:
post:
tags:
- Billing
summary: Receive Webhook
operationId: receive_webhook_api_v1_billing_webhooks__provider__post
parameters:
- name: provider
in: path
required: true
schema:
type: string
title: Provider
responses:
'200':
description: Successful Response
content:
application/json:
schema:
type: object
additionalProperties:
anyOf:
- type: string
- type: 'null'
title: Response Receive Webhook Api V1 Billing Webhooks Provider Post
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
CheckoutBody:
properties:
plan_code:
type: string
maxLength: 64
minLength: 1
title: Plan Code
billing_cycle:
type: string
pattern: ^(monthly)$
title: Billing Cycle
default: monthly
return_url:
type: string
maxLength: 2048
minLength: 1
title: Return Url
cancel_url:
type: string
maxLength: 2048
minLength: 1
title: Cancel Url
customer_email:
anyOf:
- type: string
maxLength: 255
minLength: 3
- type: 'null'
title: Customer Email
customer_country:
anyOf:
- type: string
maxLength: 2
minLength: 2
- type: 'null'
title: Customer Country
metadata:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Metadata
type: object
required:
- plan_code
- return_url
- cancel_url
title: CheckoutBody
RefundRequestBody:
properties:
reason:
type: string
maxLength: 2000
title: Reason
default: ''
type: object
title: RefundRequestBody
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError