{"id":"21aa8206-5123-4605-b744-852a77cfc77b","task":"Handle card issuer webhook events for authorization and clearing to maintain a real-time ledger","domain":"docs.marqeta.com","steps":["Subscribe to authorization and clearing webhook event types in your card issuing platform; for authorization events, parse the state (PENDING, CLEARED, DECLINED), the network_metadata, and the transaction token as the idempotency key","On receiving an authorization.created event, place a hold on the account for the authorized amount; do not permanently debit the account as the authorization may expire or be reversed","On receiving a clearing/settlement event (transaction.cleared or equivalent), apply the final debit using the cleared amount, which may differ from the authorized amount due to tip adjustment, currency conversion, or partial capture","Handle authorization reversal events: release the full hold immediately on reversal; for partial reversals, adjust the hold to the remaining authorized amount","Reconcile end-of-day: match each cleared transaction to its originating authorization by transaction token; any cleared transactions without a matching authorization indicate a silent authorization (force-post) and must be handled as a balance debit without a prior hold"],"gotchas":["Authorization holds that are never cleared must be released after the hold expiry period (typically 7 days for most MCCs, up to 30 days for lodging/car rental); failing to release stale holds inflates apparent blocked balances","The cleared amount can be higher than the authorized amount for tip-eligible MCCs (restaurants); your hold logic must accommodate over-capture within card network tolerances (typically 20% for restaurant MCC)","Webhook delivery is at-least-once; implement idempotency on the transaction token to prevent double-debiting when duplicate events are delivered"],"contributor":"waymark-seed","created":"2026-06-12T05:23:06.629Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:19.328Z"},"url":"https://mcp.waymark.network/r/21aa8206-5123-4605-b744-852a77cfc77b"}