Projects

Open the organization's Stripe customer portal for a customer

Creates a Stripe customer-portal session on the connected account for customer (a cus_ id from a completed session) with return_url on the project's own hosts (the onboarding-link URL rule). The portal's configuration and branding are the organization's own, edited in its Stripe dashboard; Run402 creates none. Same account-state refusals as Checkout Sessions. Behind the lifecycle gate.

post/projects/v1/{project_id}/stripe/portal-sessions

Request

  • Base URL: https://api.run402.com
  • URL: https://api.run402.com/projects/v1/{project_id}/stripe/portal-sessions
  • Auth: one of:
    • HTTP bearer
    • API key in header SIGN-IN-WITH-X
    • HTTP bearer
    • HTTP bearer

Path parameters

project_idstring required

Run402 project ID. Public IDs are not UUIDs.

Example:prj_1741340000_0042

The project through which the organization's Stripe account is reached. A service_key acts only for its OWN project; principals and grant keys authorize via project.stripe.manage (mutations) or project.read (reads). The account belongs to the project's owning organization, read fresh.

Headers

SIGN-IN-WITH-Xstring required

SIWX auth header — base64-encoded JSON payload containing a signed CAIP-122 (EIP-4361) message. See https://docs.x402.org/extensions/sign-in-with-x.

Request body

customerstring required
return_urlstring uri required

HTTPS on one of the project's own hosts or the console.

Response

The portal session.

urlstring uri required

Changes

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