TrieOH
PayssageAPIWebhooks

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.

POST/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

provider*string

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 '{}'
Empty
{
  "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"
}