IN PROGRESS
This site is under active development. The sandbox is coming soon.
This is an independent, unofficial personal learning project. It does not represent any bank, financial institution, or regulator.
Webhooks
When the status of an authorization, account, or payment changes, the platform pushes an event to the callback URL configured for your application.
Event structure
Section titled “Event structure”{ "event_id": "evt_01J9Z3K4", "event_type": "payment.status_changed", "occurred_at": "2026-10-26T08:30:00Z", "data": { "payment_id": "pay_2b7d9f", "status": "SETTLED" }}Verify the signature
Section titled “Verify the signature”Every request includes an X-Signature header containing an HMAC-SHA256 of the request body and your signing secret. Verify it before processing.
import { createHmac, timingSafeEqual } from 'node:crypto';
function verify(body, signature, secret) { const expected = createHmac('sha256', secret).update(body).digest('hex'); return ( expected.length === signature.length && timingSafeEqual(Buffer.from(expected), Buffer.from(signature)) );}Retry policy
Section titled “Retry policy”- Non-
2xxresponses are retried with exponential backoff, up to 5 attempts. - Handlers must be idempotent and deduplicate by
event_id. - Respond within 5 seconds; run long-running work asynchronously.