Skip to main content
POST
/
v1
/
stripe
/
portal
Open customer portal
curl --request POST \
  --url https://api.example.com/v1/stripe/portal \
  --header 'Content-Type: application/json' \
  --data '
{
  "return_url": "<string>"
}
'
Opens the Stripe Customer Portal so the user can update payment methods, change plan, cancel, or download invoices, all on Stripe’s hosted UI.

​
Body

​
return_url
string
Where Stripe sends the user after they close the portal. Default: ${origin}/Settings.

​
Response

{ "url": "https://billing.stripe.com/p/session/..." }
The caller redirects to that URL same-tab.

​
Errors

StatusCodeMeaning
401unauthenticatedSign in required.
404no_subscriptionThe user has never had a Stripe customer (no subscription, no past pack purchase).
503billing_not_configuredSTRIPE_SECRET_KEY not set on this deploy.