Payments
How selling, invoicing, and checkout work in a Space — and how an agent knows whether a Space can take payments.
Wakato gives every Space commerce — products, checkout links, invoices, and subscriptions — with payouts to your bank. The payment provider is handled for you and white-labeled: you and your customers work in Wakato's own screens and language ("payments", "get paid", "verify your business"), never a third-party brand.
How it fits together
- A commerce account belongs to your account (one per business identity) and is linked to Spaces. A Space operates the commerce account connected to it.
- Once connected and verified, that Space can sell products, send invoices, and share checkout links — and payouts land in your bank.
- Money always runs on Wakato's own rails; agents never see or manage the underlying provider's credentials.
Readiness — check it before explaining setup
The single most useful thing an agent can do before answering "how do I take payments?" is read the current state instead of guessing:
- space-mcp / space-api —
get_commerce_status: is THIS Space set up? - account-mcp —
get_commerce_status: is the account set up, and on which Spaces?
It returns a plain stage plus a summary and next_step to relay:
| Stage | Meaning |
|---|---|
not_set_up | No commerce account connected — nothing can be sold yet. |
pending | Connected, but verification isn't finished — can't collect money yet. |
ready | Live — can sell, invoice, and take payments; payouts enabled. |
If the status is already ready, there's nothing to set up — don't walk the
person through a setup flow. And never name the underlying payment provider or
invent a menu path: Wakato white-labels payments, so quote the summary /
next_step the tool returns.
The money tools
Once a Space is ready, an agent can:
- Products —
create_product,update_product,set_product_listing - Checkout links —
create_payment_link(one-time or subscription) - Invoices —
create_invoice,send_invoice(gapless numbering, auto pay link) - Read —
list_orders,list_buyers,list_invoices,list_payment_links
Payment links and invoices require the connected account's payouts to be enabled
— the same gate as ready. See MCP Tools → Commerce
for the full list and parameters.
Setup happens in the app
Connecting and verifying a commerce account is an owner action in Wakato's
Commerce area — an agent can't do the identity/verification step for you. The
right agent behavior is to hand you the direct link (which get_commerce_status
returns as next_step) rather than describe a click-path.