Receive a provider webhook
Ingestion endpoint called by the payment provider (e.g. MercadoPago) when a payment event occurs. Payssage verifies the provider signature, normalizes the event, stores it, and dispatches deliveries to every webhook endpoint on the event's wallet. Returns 200 even for expected-and-ignored cases (unknown event types, duplicate deliveries) so the provider does not retry; bad signatures return an error. Public — providers cannot send an Authorization header.
/webhooks/{provider}Ingestion endpoint called by the payment provider (e.g. MercadoPago) when a payment event occurs. Payssage verifies the provider signature, normalizes the event, stores it, and dispatches deliveries to every webhook endpoint on the event's wallet. Returns 200 even for expected-and-ignored cases (unknown event types, duplicate deliveries) so the provider does not retry; bad signatures return an error. Public — providers cannot send an Authorization header.
Path Parameters
Payment provider slug (e.g. mercadopago).
Request Body
application/json
Raw provider event payload.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/problem+json
application/problem+json
curl -X POST "https://example.com/webhooks/string" \ -H "Content-Type: application/json" \ -d '{}'{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 400,
"title": "Validation Failed"
}{
"detail": "string",
"instance": "../dictionary",
"errors": [
{
"field": "string",
"message": "string"
}
],
"type": "http://example.com",
"status": 404,
"title": "Not Found"
}