PaymentIntentNextActionThreeDSecureChallenge

  • Present the ACS challenge in a visible iframe/surface. If challenge.method is GET, iframe the URL; if POST, self-post params to the URL. Poll status_url until terminal.

    • challenge
      Type: object · ThreeDSHttpAction
      required
    • 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.

    • 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.