---
title: "Stripe webhook handler"
method: POST
path: "/webhooks/stripe"
tags: ["Webhooks"]
---

# Stripe webhook handler

`POST /webhooks/stripe`

## Request

- Base URL: `https://api.proof.holdings`
- URL: `https://api.proof.holdings/webhooks/stripe`
- Auth: none declared

Receives billing events from Stripe (checkout.session.completed, customer.subscription.updated, invoice.payment_failed, etc.). Validates Stripe-Signature header.

## Response `200`

Webhook processed

- SuccessResponse: Generic success response
  - `success` boolean, required
  - `message` string

## Other responses

- `400`: Invalid webhook signature or payload

---

[API](https://skmtc.dev/proof/apis/proof-holdings-api.md) · [All operations](https://skmtc.dev/proof/apis/proof-holdings-api/llms.txt) · [OpenAPI document](https://skmtc.dev/proof/apis/proof-holdings-api/revisions/6b8d61ee354f?raw)