---
title: "Receive a Stripe event"
method: POST
path: "/api/v1/billing/webhook"
---

# Receive a Stripe event

`POST /api/v1/billing/webhook`

## Request

- Base URL: `https://wcway.com`
- URL: `https://wcway.com/api/v1/billing/webhook`
- Auth: API key in header `Stripe-Signature`

For Stripe only. The Stripe-Signature header must carry a valid signature of the raw body. The handler reads the subscription from Stripe and does not trust the event body. A repeated event id changes nothing.

## Request body

- object

## Response `200`

The event is processed, or it was processed before.

- object
  - `received` unknown, required
  - `duplicate` unknown

## Other responses

- `400`: The signature or the event is invalid.
- `413`: The body is larger than 512 KB.
- `502`: Stripe did not answer. Stripe sends the event again.
- `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)