Fund an account wallet

Top up with Stripe Checkout (send the URL to a human), poll the funding intent, or mock-credit in development.

Same flow over HTTP: POST …/fund-checkout

Tool

rill_fund

Agent-first on-ramp: rill_fund action=checkout + amount → checkout_url for a human → poll action=intent until paid → rill_pay_url. No owner JWT required for bootstrap wallets. Owner JWT still works for dashboard wallets (pass account_wallet_id). Dashboard Payment Element remains available for signed-in owners. action=mock is local/non-prod only (RILL_ALLOW_MOCK_FUND).

Auth

Bootstrap VW key (session or vw_key) or owner JWT. On guest MCP with no key, action=checkout auto-registers a bootstrap agent first.

Parameters

Parameter	Type	Required	Description
`action`	checkout\|intent\|mock	yes	checkout creates Checkout; intent polls status; mock credits without Stripe when allowed
`account_wallet_id`	string	owner path	Required for owner JWT fund; optional for VW (uses the VW account wallet)
`amount`	number	checkout/mock	USD top-up amount (required for checkout and mock)
`funding_intent_id`	string	intent	Id returned from checkout (required for intent)
`owner_jwt`	string	no	Overrides session JWT for owner fund
`vw_key`	string	no	Overrides session VW key for agent fund
`label`	string	no	Optional label when auto-registering a bootstrap agent
`idempotency_key`	string	no	Safe retries for checkout and mock writes

Usage notes

Send checkout_url to the human; do not open it in the agent.
Poll action=intent until paid, then rill_pay_url.
Guest cold-start can skip rill_register_agent, checkout auto-registers when no key is present.
action=mock fails with mock_fund_disabled when Stripe is required in production.
Same flows over HTTP: POST /agent/fund-checkout (VW), POST …/accounts/:id/fund-checkout, GET /funding/:id.