---
title: "Stripe Webhook"
method: POST
path: "/payments/webhook"
tags: ["payments"]
---

# Stripe Webhook

`POST /payments/webhook`

## Request

- Base URL: `https://api.oxlo.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.oxlo.ai/payments/webhook`
- Auth: none declared

Handle Stripe webhook events.

Events handled:
- customer.subscription.updated - Plan changes, status updates
- customer.subscription.deleted - Subscription canceled
- invoice.paid - Payment successful
- invoice.payment_failed - Payment failed

## Headers

- `Stripe-Signature` string

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxlo/apis/oxlo-backend.md) - [All operations](https://skmtc.dev/oxlo/apis/oxlo-backend/llms.txt) - [OpenAPI document](https://skmtc.dev/oxlo/apis/oxlo-backend/revisions/bc2ecdc94f31?raw)