💰 Finance & Fintech · Payments Engineering

Process payment webhooks reliably

Idempotent handlers, signature checks, and replay safety for provider callbacks.

intermediate~35 minFintech EngineersFinancial AnalystsRisk Teams

Steps

1Verify signatures first; reject before any parsing side effects
2Persist raw event immediately, acknowledge fast, process async
3Deduplicate on event ID; assume providers retry aggressively
4Handle out-of-order events via state machine per payment object
5Backfill job reconciles missed webhooks against provider API hourly
6Alert on processing lag and dead-letter depth, not just failures

Common Pitfalls

▲Business logic inside webhook handler timing out mid-write
▲Trusting event arrival order for status transitions

Commands

Install with skills CLI

$ npx skills add aniruddhaadak80/skills --skill payments-engineering-webhook-reliability-payments

Install globally

$ npx skills add aniruddhaadak80/skills --skill payments-engineering-webhook-reliability-payments -g

Tags

#webhooks#payments#reliability#finance-fintech#payments-engineering

Install this skill

$ npx skills add aniruddhaadak80/skills --skill payments-engineering-webhook-reliability-payments -a opencode

SKILL.md

# Process payment webhooks reliably

> Idempotent handlers, signature checks, and replay safety for provider callbacks.

## When to Use This Skill

Idempotent handlers, signature checks, and replay safety for provider callbacks.

## Steps

1. Verify signatures first; reject before any parsing side effects
2. Persist raw event immediately, acknowledge fast, process async
3. Deduplicate on event ID; assume providers retry aggressively
4. Handle out-of-order events via state machine per payment object
5. Backfill job reconciles missed webhooks against provider API hourly
6. Alert on processing lag and dead-letter depth, not just failures

## Common Pitfalls

- Business logic inside webhook handler timing out mid-write
- Trusting event arrival order for status transitions

View source on GitHub ↗

Immutable journal entries, balanced postings, and derived balances keeping money math provable.

💰 Finance & Fintech·~45m

Open →

Build daily reconciliation that catches driftintermediate

Three-way match between internal ledger, processor settlement, and bank statements.

💰 Finance & Fintech·~35m