PaymentIntentNextAction
- Type: string
type max length:100requiredType of the next action to perform. Refer to the other child attributes under
next_actionfor available values. Examples include:redirect_to_urlorthree_d_secure. - Type: object · PaymentIntentNextActionRedirectToUrl
redirect _to _url - Type: string | null
return _url max length:1000If the customer does not exit their browser while authenticating, they will be redirected to this specified URL after completion.
- Type: string | null
url max length:1000The URL you must redirect your customer to in order to authenticate the payment.
three _d _secure - 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.

