Skip to content

Webhook Delivery Failures

Webhook delivery failures happen when Spendware cannot safely deliver an event or the subscriber does not return a successful response.

Delivery Checklist

  • Endpoint URL is public HTTPS in production.
  • Endpoint is active.
  • Subscriber returns 2xx only after durable processing.
  • Subscriber does not reject valid Spendware signatures.
  • Subscriber verifies against the raw request body.
  • Subscriber tolerates duplicate deliveries.
  • Subscriber logs event ID and delivery ID.

Inspect Deliveries

curl "$SPENDWARE_WEBHOOKS_BASE_URL/api/v1/deliveries?tenant_id=ORGANIZATION_ID" \
  -H "Authorization: Bearer $SPENDWARE_API_KEY"

deliveries = client.webhooks.list_deliveries(tenant_id="ORGANIZATION_ID")
attempts = client.webhooks.list_delivery_attempts("DELIVERY_ID")

const deliveries = await client.webhooks.listDeliveries({ tenantId: "ORGANIZATION_ID" });
const attempts = await client.webhooks.listDeliveryAttempts("DELIVERY_ID");

Redeliver

Use redelivery after the subscriber is fixed:

client.webhooks.redeliver_event("WEBHOOK_EVENT_ID")

await client.webhooks.redeliverEvent("WEBHOOK_EVENT_ID");