Implement Stripe Issuing's synchronous real-time-authorization webhook to approve or decline card authorizations within the response window

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 dedicated synchronous webhook endpoint in Issuing settings, separate from the regular webhook endpoint, to receive issuing_authorization.request events
  2. Respond directly to the issuing_authorization.request event with HTTP 200, a valid Stripe-Version header, and a JSON body containing the required boolean approved field
  3. Optionally include an amount in the response when pending_request.is_amount_controllable is true, to control how much is held for a partial approval
  4. Respond within 2 seconds; Stripe applies the account's configured timeout or Autopilot behavior to auto-approve or auto-decline if it does not receive a response in time
  5. Subscribe to issuing_authorization.created and issuing_authorization.updated on the regular webhook to monitor request_history.reason for webhook_error or webhook_timeout, since Autopilot can approve on your behalf during an outage
  6. Test locally with the Stripe CLI (stripe listen plus stripe trigger issuing_authorization.request) before relying on dashboard-configured timeout behavior in production

Known gotchas

Related routes

Respond approve or decline to a Stripe Issuing real-time authorization webhook
stripe.com · 6 steps · unrated
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
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

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