Skip to content

Implement an admin interface for replaying historical webhook payloads , enabling debugging and recovery from processing failures.#193

Merged
Mac-5 merged 3 commits intoSynapse-bridgez:developfrom
Mystery-CLI:webhook
Feb 26, 2026
Merged

Implement an admin interface for replaying historical webhook payloads , enabling debugging and recovery from processing failures.#193
Mac-5 merged 3 commits intoSynapse-bridgez:developfrom
Mystery-CLI:webhook

Conversation

@Mystery-CLI
Copy link
Copy Markdown

The webhook replay admin interface provides operators with the ability to reprocess historical webhook payloads that failed during initial processing. This system is critical for recovering from transient failures, testing bug fixes, and handling scenarios where processing logic has been updated after the original webhook was received.

The design builds upon the existing webhook processing infrastructure and audit logging system. It introduces three primary capabilities:

  1. Query Interface: List and filter failed webhook attempts with rich metadata
  2. Replay Operations: Execute single or batch replays with dry-run testing support
  3. Audit Trail: Comprehensive tracking of all replay attempts with operator attribution

The system respects idempotency constraints to prevent duplicate processing side effects while providing operators with override capabilities when necessary. All operations require admin authentication and are fully audited for compliance and debugging purposes.

Key Design Principles

  • Safety First: Dry-run mode and idempotency checks prevent accidental duplicate processing
  • Auditability: Every replay attempt is logged with operator identity and outcome
  • Performance: Batch operations support efficient recovery from widespread failures
  • Simplicity: Leverage existing transaction and audit log infrastructure

Architecture

System Context

The webhook replay system operates within the existing Synapse payment processing architecture:

closes #175

Mac-5 and others added 2 commits February 26, 2026 04:54
Documented changes made to CI/CD processes, including code formatting, migration fixes, and clippy fixes. Listed remaining issues and next steps for further improvements.
…s, enabling debugging and recovery from processing failures.
@Mac-5 Mac-5 changed the base branch from main to develop February 26, 2026 10:54
@Mac-5 Mac-5 self-requested a review February 26, 2026 11:44
@Mac-5 Mac-5 merged commit 5e2aee1 into Synapse-bridgez:develop Feb 26, 2026
0 of 5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Webhook Replay and Debugging Interface

3 participants