PaymentIntentNextActionThreeDSecure
- Type: object · PaymentIntentNextActionThreeDSecureFrictionless
Provider-agnostic Three-D Secure next action. The
flowfield indicates whether no UI is needed (frictionless), a hidden device fingerprint (3DS Method) must run, or a visible challenge must be presented. All URLs are on your domain.flow DiscriminatorType: stringenumrequiredWhich 3DS flow to execute.
valuesfrictionless method challenge
- Type: string
idempotency _key requiredOptional key to correlate retries/refreshes on the same 3DS attempt.
- Type: stringFormat: uri
status _url requiredPoll this URL (your API) until the PaymentIntent leaves requires_action/processing.
- Type: object · ThreeDSHint
hint - Type: object · ThreeDSMessage
message - Type: string | nullFormat: uri
return _url Merchant's return URL (echoed back). Your 3DS return page should 302 here.

