NGO Webhook System for Real-Time Event Notifications

[Cedarich]

Complexity Score: 150

Description

Allow external NGO systems to receive real-time updates when specific events occur in Soter.

Requirements

• Implement a WebhookService to manage NGO-registered URLs.
• Trigger webhooks for events like: claim.verified, claim.disbursed, campaign.completed.
• Include signature headers (HMAC) for webhook security.
• Use BullMQ to handle webhook retries and failures.
• Add an endpoint for NGOs to manage their webhook subscriptions.

Tech Stack

• NestJS, BullMQ, HMAC signatures.

---

[Gozirimdev]

@Gozirimdev has applied to work on this issue as part of the Stellar Wave Program's 3rd wave.

Hey Maintainer , I am a full stack developer , I will love to work on your issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Gozirimdev to this issue.

[drips-wave]

Congratulations, @Gozirimdev! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on March 30, 2026.

🧑‍💻 @Gozirimdev: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.

Warning

When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.

🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.

🌊 Happy Wave 🌊

[drips-wave]

This issue has been marked as completed by a Drips Wave moderator for @Gozirimdev as part of the Stellar Wave Program's 3rd Wave 🥳

Moderator's reason: [Auto-assessed] PR #227 has been open for over 4 days with no maintainer objections, exceeding the 24-hour review window. The contribution is high-quality and comprehensively implements all requirements, including the BullMQ delivery system, HMAC signatures, and subscription management endpoints with unit tests.

😎 @Gozirimdev: You earned 150 Points for completing this issue! After the current Wave ends, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here.

🧑‍💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.

ℹ️ Note: This issue was marked complete via moderation. Points were issued even though the GitHub issue remains open.