Skip to main content

benecaster_donation_webhook_verified

Action Free Since v1.0.0

Fires inside POST /benecaster/v1/listener-support/donations immediately after a webhook signature is successfully verified. Only fires when a secret was configured for the platform — requests from platforms without a configured secret are accepted silently and do not fire this action. The presence of this action firing is the signal that verification actually ran for a given request (not just that the donation was accepted).

This action fires before the donation row is written, so it cannot observe the new row’s ID. To observe the logged row, combine this action with benecaster_listener_support_donation_logged.

Stripe payloads bypass this path entirely. Requests carrying platform=stripe are rejected at the endpoint (Stripe payments go through /stripe-webhook); this action never fires for them.

Parameters

Name Type Default Description
$canonical_platform string The normalized platform slug (e.g. `'kofi'`, `'paypal'`, `'bmac'`). Always lowercase; Ko-fi variants (`Ko-Fi`, `ko_fi`, `KoFi`) all resolve to `'kofi'`.
$raw_platform string The `platform` value exactly as it arrived in the request body, before normalization. Useful for logging or debugging platform slug variants.