Billing

Get a Stripe Checkout URL for the human to complete

Create a Stripe-hosted Checkout session for a named plan/interval and return its URL for the ACCOUNT OWNER to open and pay — the agent never takes payment. Reuses the dashboard's session-creation logic, including the already-subscribed guard and idempotency key. Requires the read scope (this endpoint returns a URL and mutates no agent-managed data; the irreversible act, payment, stays with the human — agent-channel §3.4).

post/api/v1/billing/checkout-url

Request

  • Base URL: https://volunteerreminder.com
  • URL: https://volunteerreminder.com/api/v1/billing/checkout-url
  • Auth: HTTP bearer

Request body

plan'basic' | 'deluxe' | 'pro' required

The plan to subscribe to (the public plan ids from GET /pricing).

interval'monthly' | 'annual'

Billing interval. Defaults to monthly.

Example request

{
  "plan": "deluxe",
  "interval": "monthly"
}

Response

A hosted Checkout URL for the human to complete payment.

checkout_urlstring required

A Stripe-hosted Checkout URL. Give this to the human to open and complete payment — the agent never takes payment itself.

planstring required
interval'monthly' | 'annual' required

Example response

{
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_test_...",
  "plan": "deluxe",
  "interval": "monthly"
}

Changes

No recorded changes to this operation across all 1 revision of this API.