---
title: "Open the billing portal of a listing"
method: POST
path: "/api/v1/billing/portal"
---

# Open the billing portal of a listing

`POST /api/v1/billing/portal`

## Request

- Base URL: `https://wcway.com`
- URL: `https://wcway.com/api/v1/billing/portal`
- Auth: API key in cookie `__Host-wcway_session`

For the web page of this site only. It needs a signed-in account that holds a subscription. The portal shows invoices, the payment method, the plan and the cancellation.

## Request body

- object
  - `listing` string, required

## Response `200`

The Stripe portal address.

- object
  - `url` string, uri, required: The Stripe portal address.

## Other responses

- `400`: The body is invalid.
- `401`: No account is signed in.
- `403`: The request came from another origin.
- `404`: The account has no listing with this id.
- `409`: The claim is not approved, or no subscription exists.
- `429`: Rate limit reached. Wait Retry-After seconds.
- `502`: Stripe did not answer.
- `503`: Partner payments are not available.

---

[API](https://skmtc.dev/wcway/apis/wcway-api.md) · [All operations](https://skmtc.dev/wcway/apis/wcway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/wcway/apis/wcway-api/revisions/34f42e2ca0e8?raw)