PaymentIntentNextActionThreeDSecureMethod

  • Run the 3DS Method (device fingerprint) in a hidden iframe by POSTing to method.url. Then poll status_url. Typically completes within ~10 seconds.

    • flow
      Type: stringenum
      required

      Which 3DS flow to execute.

      values
      • frictionless
      • method
      • challenge
    • idempotency_key
      Type: string
      required

      Optional key to correlate retries/refreshes on the same 3DS attempt.

    • method
      Type: object · ThreeDSHttpAction
      required
    • status_url
      Type: stringFormat: uri
      required

      Poll this URL (your API) until the PaymentIntent leaves requires_action/processing.

    • hint
      Type: object · ThreeDSHint
    • message
      Type: object · ThreeDSMessage
    • return_url
      Type: string | nullFormat: uri

      Merchant's return URL (echoed back). Your 3DS return page should 302 here.