PaymentIntentNextAction

  • redirect_to_url
    Type: PaymentIntentNextActionRedirectToUrl
    Properties: 2
  • type
    Type: string
    max length:  
    100
    required

    Type of the next action to perform. Refer to the other child attributes under next_action for available values. Examples include: redirect_to_url or three_d_secure.

  • three_d_secure

    Provider-agnostic Three-D Secure next action. The flow field 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.

    Provider-agnostic Three-D Secure next action. The flow field 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.

    • Type: PaymentIntentNextActionThreeDSecureFrictionless

      • No customer interaction. Client should not open any iframe; just poll status_url.

        • flow
          Discriminator
          enum
          const:  
          frictionless
          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.

      No customer interaction. Client should not open any iframe; just poll status_url.

      • flow
        Discriminator
        enum
        const:  
        frictionless
        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.