PaymentIntentNextActionThreeDSecureBase

  • 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
    • scheme
      Type: string

      Card network hint (e.g., visa, mc).

    • timeout_ms
      Type: integer

      Suggested client watchdog for background steps.

    • version
      Type: string

      3DS protocol version (e.g., 2.1.0, 2.2.0).

  • message
    Type: object · ThreeDSMessage
    • allowed_origins
      Type: array string[]

      Origins allowed to send/receive front-channel postMessage with your 3DS return page.

  • return_url
    Type: string | nullFormat: uri

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