Billing portal/createBillingPortalSession

Create a billing portal session

Planned

Planned. This contract is published ahead of the build. It is not callable yet — treat it as the shape to design against, not a live endpoint.

Open a hosted portal where a customer manages their own billing.

POST/v1/billing-portal/sessions

Mint a short-lived URL to a kepa-hosted page where the customer updates their card and downloads invoices, then returns to `returnUrl`. No card data touches your site.

Request body

application/json

customerIdstringRequired

Example "cus_123"

returnUrlstringRequired

Example "https://shop.example/account"

Response

application/json

urlstring

Example "https://billing.kepapay.co/session/bps_9c2a"

expiresAtstring · ISO 8601

Example "2026-04-09T09:14:22Z"

createBillingPortalSession