---
title: "Handle Stripe Webhook"
method: POST
path: "/api/v1/webhooks/stripe"
tags: ["Webhooks"]
---

# Handle Stripe Webhook

`POST /api/v1/webhooks/stripe`

## Request

- The document declares no server URL.
- Auth: none declared

Handle incoming Stripe webhook events.

This endpoint receives webhook events from Stripe for:
- checkout.session.completed: Successful one-time payments
- invoice.paid: Successful subscription/invoice payments
- invoice.payment_failed: Failed payment attempts

The endpoint:
1. Verifies the webhook signature to ensure authenticity
2. Processes the event based on its type
3. Stores changes in the database
4. Returns 200 only AFTER database commit (per user requirement)

Note: This endpoint is public but protected by Stripe signature verification.
Only requests signed with the correct webhook secret will be processed.

## Response `200`

Successful Response

- unknown

## Changes

- **2026-05-22** `6059f99c1875`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/changes/api/v1/webhooks/stripe/post.md)

---

[API](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway.md) - [All operations](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/morpheusais/apis/morpheus-api-gateway/revisions/6059f99c1875?raw)