---
title: "Handle Stripe webhook events"
method: POST
path: "/v1/webhooks/stripe"
tags: ["webhooks"]
---

# Handle Stripe webhook events

`POST /v1/webhooks/stripe`

## Request

- Base URL: `https://api.getyourjob.pro` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getyourjob.pro/v1/webhooks/stripe`
- Auth: none declared

Endpoint for Stripe to send webhook events.
    
    Handles:
    - invoice.payment_succeeded - Updates subscription status
    - customer.subscription.deleted - Marks subscription as canceled
    - customer.subscription.updated - Updates subscription details
    
    **Important**: This endpoint verifies the Stripe signature to ensure
    the webhook is legitimate.

## Headers

- `Stripe-Signature` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/getyourjob/apis/matchingagent-api.md) · [All operations](https://skmtc.dev/getyourjob/apis/matchingagent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getyourjob/apis/matchingagent-api/revisions/3a2d9ceb7c84?raw)