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/json
application/json
application/json
curl -X POST "https://example.com/webhooks/string" \ -H "Content-Type: application/json" \ -d '{}'{
"code": 0,
"message": "string",
"data": {},
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"pagination": {
"page": 1,
"limit": 1,
"total": 0,
"has_next": true,
"has_prev": true,
"next_page": 0,
"prev_page": 0
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}{
"code": 0,
"message": "string",
"error": {
"code": "BAD_REQUEST",
"message": "string",
"fields": [
{
"field": "string",
"message": "string"
}
],
"meta": {},
"debug": {
"raw_error": "string",
"stack_trace": "string"
}
},
"timestamp": "2019-08-24T14:15:22Z",
"module": "string"
}