Checkout Card Options

  • request_three_d_secure
    Type: string enum

    Controls the requested 3D Secure behavior for card payments in this Checkout Session.

    any prefers frictionless authentication while allowing the issuer to challenge. challenge requests an interactive challenge. automatic is reserved for Paypercut's future rules engine and currently behaves as any in Hosted Checkout.

    When omitted, no explicit preference is stored on the Session. Ordinary payments use any, while a Checkout that saves the card for future use requests challenge.

    values
    • any

      Prefer frictionless authentication while allowing an issuer challenge.

    • automatic

      Currently behaves as any; reserved for future rules-driven behavior.

    • challenge

      Request an interactive 3D Secure challenge.