Start a paid plan checkout
Starts Starter or Pro checkout for weekly or monthly.
POST /api/v1/billing/checkout
OpenAPI operation createBillingCheckout. Authenticate with a Clerk session JWT (Authorization: Bearer {jwt}) or the verbafy_guest_session cookie. {jwt} is a Clerk session token after you sign in on the website. Verbafy does not issue that token and does not show it in Settings. For scripts and agents, sign in, create an API key at Settings → API keys, and call Remote MCP with Authorization: Bearer sk-…. Credential setup: Auth.md. Machine-readable contract: OpenAPI.
Request example
curl -X POST 'https://verbafy.io/api/v1/billing/checkout' \
-H 'Authorization: Bearer {jwt}' \
-H 'Content-Type: application/json' \
-d '{"plan":"starter","interval":"monthly"}'Responses
| Status | Description |
|---|---|
200 | Checkout URL |
400 | Validation or domain request error |
401 | Missing or invalid Clerk Bearer token or guest session |
Remote MCP at /api/v1/mcp is a companion wrap of this REST contract.
Convert a paid-plan trial
Ends a paid-plan trial on the same plan so the period becomes billed. POST /api/v1/billing/convert-trial on the Verbafy REST API.
Create a Stripe billing portal session
Returns a URL for plan and payment management. POST /api/v1/billing/portal on the Verbafy REST API. See the Verbafy OpenAPI contract for request and response