Use Stripe Issuing's real-time authorization webhook with direct webhook response to synchronously approve or decline each agent-initiated card transaction against custom business rules

domain: docs.stripe.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

In-depth guide

Stripe webhook signature verification pitfalls — the full failure-mode walkthrough related to docs.stripe.com, checked against official docs, with linked verified routes.

Steps

  1. Configure a real-time authorization webhook endpoint that receives issuing_authorization.request events for cards issued to your agent purchasing flow
  2. Implement the direct webhook response pattern (the current recommended approach, since the separate approve/decline API methods are deprecated) so your endpoint's HTTP response itself carries the approve/decline decision
  3. Apply your agent-specific business logic within the response window -- merchant category checks, per-transaction cap checks, anomaly signals -- and respond before Stripe's timeout
  4. Understand that if you don't respond within roughly 2 seconds, Stripe falls back to your configured webhook-timeout behavior (approve or decline by default setting) rather than waiting indefinitely
  5. On approval, note that Stripe places a hold against your Issuing balance until the authorization is captured, voided, or expires uncaptured -- reconcile these holds in your ledger
  6. Test failure modes explicitly: what happens to an agent purchase if your webhook endpoint is unreachable or slow, since that determines whether transactions fail open or fail closed

Known gotchas

Related routes

Implement Stripe Issuing's synchronous real-time-authorization webhook to approve or decline card authorizations within the response window
docs.stripe.com · 6 steps · unrated
Respond to a Stripe Issuing real-time authorization webhook to approve or decline a virtual card transaction based on business logic
docs.stripe.com · 6 steps · unrated
Respond approve or decline to a Stripe Issuing real-time authorization webhook
stripe.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans