POST /v1/setup_intents

Default value: "application/x-www-form-urlencoded"

An arbitrary string attached to the object. Often useful for displaying to users.

Set to true to attempt to confirm this SetupIntent immediately. This parameter defaults to false. If a card is the attached payment method, you can provide a return_url in case further authentication is necessary.

ID of the ConfirmationToken used to confirm this SetupIntent.

If the provided ConfirmationToken contains properties that are also being provided in this request, such as payment_method, then the values in this request will take precedence.

Specifies which fields in the response should be expanded.

Set to true when confirming server-side and using Stripe.js, iOS, or Android client-side SDKs to handle the next actions.

Set of key-value pairs that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to metadata.

When you enable this parameter, this SetupIntent accepts payment methods that you enable in the Dashboard and that are compatible with its other parameters.

Possible values:

• "never"
• "always"

This hash contains details about the mandate to create. This parameter can only be used with confirm=true.

ID of the payment method (a PaymentMethod, Card, or saved Source object) to attach to this SetupIntent.

Payment method-specific configuration for this SetupIntent.

Possible values:

• "diners"
• "unionpay"
• "girocard"
• "visa"
• "jcb"
• "cartes_bancaires"
• "link"
• "amex"
• "discover"
• "interac"
• "eftpos_au"
• "unknown"
• "mastercard"

Possible values:

• "fixed"
• "maximum"

Possible values:

• "month"
• "day"
• "sporadic"
• "week"
• "year"

Possible values:

• "C"
• "R"
• "A"
• "N"
• "I"
• "Y"
• "U"

Possible values:

• "07"
• "06"
• "05"
• "02"
• "01"

Possible values:

• "2.1.0"
• "2.2.0"
• "1.0.2"

Possible values:

• "4"
• "3"
• "2"
• "1"
• "A"
• "0"

Possible values:

• "any"
• "challenge"
• "automatic"

Possible values:

• "month"
• "day"
• "week"
• "year"

Possible values:

• "fr-CH"
• "nl-BE"
• "en-FR"
• "en-GR"
• "en-IT"
• "en-NZ"
• "fr-FR"
• "nb-NO"
• "de-DE"
• "en-CH"
• "en-PT"
• "pl-PL"
• "es-US"
• "en-CA"
• "en-RO"
• "sv-FI"
• "en-US"
• "en-IE"
• "en-CZ"
• "ro-RO"
• "fr-CA"
• "en-AT"
• "pt-PT"
• "fr-BE"
• "en-SE"
• "es-ES"
• "en-ES"
• "it-CH"
• "el-GR"
• "nl-NL"
• "fi-FI"
• "da-DK"
• "en-DK"
• "en-BE"
• "en-FI"
• "sv-SE"
• "de-CH"
• "en-NO"
• "en-DE"
• "it-IT"
• "en-NL"
• "en-GB"
• "en-PL"
• "de-AT"
• "en-AU"
• "cs-CZ"

Possible values:

• ""
• "paper"

Possible values:

• "microdeposits"
• "automatic"
• "instant"

Possible values:

• "interval"
• "sporadic"
• "combined"

Possible values:

• "business"
• "personal"

Possible values:

• "microdeposits"
• "automatic"
• "instant"

Possible values:

• "cad"
• "usd"

The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site. To redirect to a mobile application, you can alternatively supply an application URI scheme. This parameter can only be used with confirm=true.

The Stripe account ID created for this SetupIntent.

Indicates how the payment method is intended to be used in the future. If not provided, this value defaults to off_session.

Possible values:

• "off_session"
• "on_session"

ID of the Customer this SetupIntent belongs to, if one exists.

If present, the SetupIntent's payment method will be attached to the Customer on successful setup. Payment methods attached to other Customers cannot be used with this SetupIntent.

When included, this hash creates a PaymentMethod that is set as the payment_method value in the SetupIntent.

Possible values:

• "ES"
• "NL"
• "IT"
• "AT"
• "BE"
• "DE"

Possible values:

• "p24"
• "pay_by_bank"
• "blik"
• "crypto"
• "amazon_pay"
• "boleto"
• "bacs_debit"
• "giropay"
• "eps"
• "paynow"
• "pix"
• "fpx"
• "promptpay"
• "zip"
• "alipay"
• "naver_pay"
• "revolut_pay"
• "billie"
• "klarna"
• "bancontact"
• "kr_card"
• "swish"
• "paypal"
• "samsung_pay"
• "sofort"
• "nz_bank_account"
• "au_becs_debit"
• "kakao_pay"
• "konbini"
• "acss_debit"
• "link"
• "alma"
• "satispay"
• "payco"
• "sepa_debit"
• "us_bank_account"
• "oxxo"
• "cashapp"
• "affirm"
• "twint"
• "afterpay_clearpay"
• "customer_balance"
• "grabpay"
• "multibanco"
• "ideal"
• "wechat_pay"
• "mobilepay"

Possible values:

• "vr_bank_braunau"
• "hypo_bank_burgenland_aktiengesellschaft"
• "bank_austria"
• "austrian_anadi_bank_ag"
• "volkskreditbank_ag"
• "bankhaus_carl_spangler"
• "bawag_psk_ag"
• "bankhaus_schelhammer_und_schattera_ag"
• "capital_bank_grawe_gruppe_ag"
• "raiffeisen_bankengruppe_osterreich"
• "btv_vier_lander_bank"
• "dolomitenbank"
• "erste_bank_und_sparkassen"
• "hypo_alpeadriabank_international_ag"
• "schoellerbank_ag"
• "marchfelder_bank"
• "volksbank_gruppe"
• "hypo_vorarlberg_bank_ag"
• "bks_bank_ag"
• "hypo_oberosterreich_salzburg_steiermark"
• "easybank_ag"
• "deutsche_bank_ag"
• "sparda_bank_wien"
• "hypo_tirol_bank_ag"
• "arzte_und_apotheker_bank"
• "brull_kallmus_bank_ag"
• "oberbank_ag"
• "hypo_noe_lb_fur_niederosterreich_u_wien"

Possible values:

• "company"
• "individual"

Possible values:

• "checking"
• "savings"

Possible values:

• "banki_spbdzielcze"
• "credit_agricole"
• "bank_millennium"
• "inteligo"
• "plus_bank"
• "bank_nowy_bfg_sa"
• "citi_handlowy"
• "blik"
• "getin_bank"
• "velobank"
• "bank_pekao_sa"
• "boz"
• "ideabank"
• "volkswagen_bank"
• "alior_bank"
• "bnp_paribas"
• "tmobile_usbugi_bankowe"
• "toyota_bank"
• "mbank_mtransfer"
• "santander_przelew24"
• "etransfer_pocztowy24"
• "envelobank"
• "nest_przelew"
• "ing"
• "noble_pay"
• "pbac_z_ipko"

Possible values:

• "limited"
• "unspecified"
• "always"

Possible values:

• "knab"
• "n26"
• "rabobank"
• "sns_bank"
• "triodos_bank"
• "bunq"
• "buut"
• "van_lanschot"
• "nn"
• "ing"
• "abn_amro"
• "asn_bank"
• "handelsbanken"
• "revolut"
• "moneyou"
• "regiobank"
• "yoursafe"

Possible values:

• "card"
• "points"

Possible values:

• "bank_rakyat"
• "hsbc"
• "hong_leong_bank"
• "ocbc"
• "kfh"
• "public_bank"
• "alliance_bank"
• "maybank2u"
• "uob"
• "agrobank"
• "bsn"
• "deutsche_bank"
• "cimb"
• "rhb"
• "ambank"
• "standard_chartered"
• "affin_bank"
• "bank_islam"
• "pb_enterprise"
• "maybank2e"
• "bank_of_china"
• "bank_muamalat"

If present, the SetupIntent's payment method will be attached to the in-context Stripe Account.

It can only be used for this Stripe Account’s own money movement flows like InboundTransfer and OutboundTransfers. It cannot be set to true when setting up a PaymentMethod for a Customer, and defaults to false when attaching a PaymentMethod to a Customer.

The ID of the payment method configuration to use with this SetupIntent.

Indicates the directions of money movement for which this payment method is intended to be used.

Include inbound if you intend to use the payment method as the origin to pull funds from. Include outbound if you intend to use the payment method as the destination to send funds to. You can include both if you intend to use the payment method for both purposes.

The list of payment method types (for example, card) that this SetupIntent can use. If you don't provide this, Stripe will dynamically show relevant payment methods from your payment method settings. A list of valid payment method types can be found here.

If you populate this hash, this SetupIntent generates a single_use mandate after successful completion.

Single-use mandates are only valid for the following payment methods: acss_debit, alipay, au_becs_debit, bacs_debit, bancontact, boleto, ideal, link, sepa_debit, and us_bank_account.