Workflow Run Failed
Primer notifies you with a WORKFLOW_RUN.FAILED webhook when a workflow run does not complete successfully.
This webhook is recommended if you use Capture or Cancel via Workflows. A workflow failure does not necessarily fail the payment or update the payment status, so this webhook is the signal you need to keep your own systems in sync when an automated capture or cancel does not succeed.
For payment workflows, the payload does not contain payment data — only the Payment ID in the triggerEventId field. Use the Payments API to retrieve the latest status and payment data for the payment linked to this ID.
Learn more about Workflow Run failed webhooks and how Primer handles webhooks.
Documentation Index
Fetch the complete documentation index at: https://primer.io/docs/llms.txt
Use this file to discover all available pages before exploring further.
Headers
An HMAC signature generated using the webhook payload and a shared signing secret. This is then converted to a base64 encoded string. Only present when webhook signing is enabled in the dashboard.
A secondary signature that is added when you have rotated your secret within the past 24 hours.
Body
The type of the webhook raised. WORKFLOW_RUN.FAILED for failed workflow runs. Additional types may be supported in the future.
WORKFLOW_RUN.FAILED The payload version for this eventType.
"1.0"
The date and time when the webhook event was sent.
"2024-02-21 15:36:16.167687"
The Primer Account ID of the account that owns the failed workflow run.
Details of the workflow that had a failed run.
Details of the workflow run that failed.
An optional ID passed with the trigger to identify the origin of the event that started the workflow. For payment workflows this is the payment ID; other triggers may not set an event ID, in which case this value will be null.
Response
Return a 200 status to indicate that the data was received successfully