well_create_hosted_payment_link

io.github.WellApp-ai/well-mcp · Verify this server

Open a Stripe-hosted page for one of three card moments: `add_card` (a new card), `recollect_card` (a card group-3 of `well_list_payment_cards` saved by another person, which must be re-entered on this workspace's own Stripe customer before it can charge here), or `complete_authentication` (a bank's 3-D Secure check). Returns `url`, a link on checkout.stripe.com, billing.stripe.com, hooks.stripe.com or invoice.stripe.com; `expires_at`, when the page stops working; and `then`, the tool to call once the user is back (`well_list_payment_cards`). Hand the url to the widget or open it; never type it into the conversation, never ask for or relay what the page itself collects (a card number, an expiry, a security code), and never read it back from a tool result — this tool returns no card data by design, so there is none to relay. `complete_authentication` is refused with `authentication_unavailable` for now: Well holds no billing offer whose charge the page could finish. Give the bank-check link the payment receipt carries instead, or send the owner to the billing page. Only a workspace owner or admin opens a hosted payment link. `error_reason`: `missing_key` (`recollect_card` without `card_ref`, or `complete_authentication` without `offer_id`), `no_membership` (the caller has no active membership in the workspace, or no workspace is in context), `not_admin` (the caller is a member but not an owner or an admin), `authentication_unavailable` (see above), `billing_off` (billing is not active on this Well instance), `no_customer` (the workspace has no Stripe customer yet; send the owner to the billing page first), `failed` (Stripe did not return a session). When the token authorizes one workspace, call this directly — no workspace call is needed first. When it authorizes several, this read will not guess which one you mean: pass `workspace_id` on the call.