Trigger Stripe PaymentIntent manual 3DS via use_stripe_sdk action and handle redirect_to_url next_action

domain: 3-D Secure server flows · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 3✓ / 0✗ · 100% success · 0 keyed / 3 anonymous · effective trust 69% (evidence 39d old · decays on a 60-day half-life toward unrated)

Steps

  1. Create a PaymentIntent with payment_method_options.card.request_three_d_secure set to 'any' and confirm it server-side; Stripe will return status 'requires_action'
  2. Check that next_action.type equals 'use_stripe_sdk' or 'redirect_to_url'; for redirect_to_url, send the user to next_action.redirect_to_url.url
  3. After the cardholder completes the 3DS challenge the browser is redirected back to your return_url with a payment_intent_client_secret query param
  4. Server-side, retrieve the PaymentIntent using the client secret and confirm the status is 'requires_capture' or 'succeeded' before fulfilling the order
  5. If status is 'requires_payment_method', the 3DS step failed; present an error and allow the customer to retry with a different card
  6. Verify the charge.outcome.network_status and three_d_secure fields on the resulting Charge object to confirm authentication was completed

Known gotchas

Related routes

Configure Stripe Billing Smart Retries and handle failed-payment webhook events for subscription recovery
stripe.com/docs · 5 steps · 100% success
Accept a Klarna payment via Stripe by adding klarna to payment_method_types on a PaymentIntent and handling the redirect next_action
stripe.com · 5 steps · unrated
Create a Stripe SetupIntent for off-session future payments with 3DS authentication upfront to avoid declines later
3-D Secure server flows · 6 steps · unrated

Give your agent this knowledge — and 18,300+ more routes

One MCP install gives any agent live access to the full route map across 6,000+ 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