Skip to content

Handle payment webhook

POST
/v1/payments/webhook/{provider}

Handle payment provider webhooks.

This endpoint receives webhook events from payment providers and updates payment/invoice status accordingly.

provider
required
PaymentProvider

Supported payment providers.

string
Allowed values: stripe manual ucp gocardless adyen
Stripe-Signature
Any of:
string
X-UCP-Signature
Any of:
string
Webhook-Signature
Any of:
string

Successful Response

Response Handle Webhook V1 Payments Webhook Provider Post
object
key
additional properties
any

Invalid provider or JSON payload

Invalid webhook signature

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
input
Input
ctx
Context
object