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.

    • flow
      enum
      const:  
      challenge
      required

      Which 3DS flow to execute.

    • status_url
      Type: stringFormat: uri
      required

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

    • return_url
      Type: string | nullFormat: uri

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

    • message
      Type: ThreeDSMessage
      Properties: 1
    • hint
      Type: ThreeDSHint
      Properties: 3
    • idempotency_key
      Type: string
      required

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

    • challenge
      Type: ThreeDSHttpAction
      required
      Properties: 3