{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://raw.githubusercontent.com/api-evangelist/stripe/main/json-schema/stripe-post-payment-intents-intent-confirm-request-schema.json", "title": "PostPaymentIntentsIntentConfirmRequest", "x-generated": "2026-10-12", "x-method": "derived", "x-generator": "derive-json-schema.py", "x-source": "openapi/stripe-payment-intents-api-openapi.yml#/components/schemas/PostPaymentIntentsIntentConfirmRequest", "type": "object", "properties": { "capture_method": { "description": "Controls when the funds will be captured from the customer's account.", "enum": [ "automatic", "automatic_async", "manual" ], "type": "string" }, "client_secret": { "description": "The client secret of the PaymentIntent.", "maxLength": 5000, "type": "string" }, "error_on_requires_action": { "description": "Set to `true` to fail the payment attempt if the PaymentIntent transitions into `requires_action`. This parameter is intended for simpler integrations that do not handle customer actions, like [saving cards without authentication](https://stripe.com/docs/payments/save-card-without-authentication).", "type": "boolean" }, "expand": { "description": "Specifies which fields in the response should be expanded.", "items": { "maxLength": 5000, "type": "string" }, "type": "array" }, "mandate": { "description": "ID of the mandate that's used for this payment.", "maxLength": 5000, "type": "string" }, "mandate_data": { "anyOf": [ { "properties": { "customer_acceptance": { "properties": { "accepted_at": { "format": "unix-time", "type": "integer" }, "offline": { "properties": {}, "title": "offline_param", "type": "object" }, "online": { "properties": { "ip_address": { "type": "string" }, "user_agent": { "maxLength": 5000, "type": "string" } }, "required": [ "ip_address", "user_agent" ], "title": "online_param", "type": "object" }, "type": { "enum": [ "offline", "online" ], "maxLength": 5000, "type": "string" } }, "required": [ "type" ], "title": "customer_acceptance_param", "type": "object" } }, "required": [ "customer_acceptance" ], "title": "secret_key_param", "type": "object" }, { "enum": [ "" ], "type": "string" }, { "description": "This hash contains details about the Mandate to create", "properties": { "customer_acceptance": { "properties": { "online": { "properties": { "ip_address": { "type": "string" }, "user_agent": { "maxLength": 5000, "type": "string" } }, "title": "online_param", "type": "object" }, "type": { "enum": [ "online" ], "maxLength": 5000, "type": "string" } }, "required": [ "online", "type" ], "title": "customer_acceptance_param", "type": "object" } }, "required": [ "customer_acceptance" ], "title": "client_key_param", "type": "object" } ] }, "off_session": { "anyOf": [ { "type": "boolean" }, { "enum": [ "one_off", "recurring" ], "maxLength": 5000, "type": "string" } ], "description": "Set to `true` to indicate that the customer isn't in your checkout flow during this payment attempt and can't authenticate. Use this parameter in scenarios where you collect card details and [charge them later](https://stripe.com/docs/payments/cards/charging-saved-cards)." }, "payment_method": { "description": "ID of the payment method (a PaymentMethod, Card, or [compatible Source](https://stripe.com/docs/payments/payment-methods/transitioning#compatibility) object) to attach to this PaymentIntent.", "maxLength": 5000, "type": "string" }, "payment_method_data": { "description": "If provided, this hash will be used to create a PaymentMethod. The new PaymentMethod will appear\nin the [payment_method](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-payment_method)\nproperty on the PaymentIntent.", "properties": { "acss_debit": { "properties": { "account_number": { "maxLength": 5000, "type": "string" }, "institution_number": { "maxLength": 5000, "type": "string" }, "transit_number": { "maxLength": 5000, "type": "string" } }, "required": [ "account_number", "institution_number", "transit_number" ], "title": "payment_method_param", "type": "object" }, "affirm": { "properties": {}, "title": "param", "type": "object" }, "afterpay_clearpay": { "properties": {}, "title": "param", "type": "object" }, "alipay": { "properties": {}, "title": "param", "type": "object" }, "au_becs_debit": { "properties": { "account_number": { "maxLength": 5000, "type": "string" }, "bsb_number": { "maxLength": 5000, "type": "string" } }, "required": [ "account_number", "bsb_number" ], "title": "param", "type": "object" }, "bacs_debit": { "properties": { "account_number": { "maxLength": 5000, "type": "string" }, "sort_code": { "maxLength": 5000, "type": "string" } }, "title": "param", "type": "object" }, "bancontact": { "properties": {}, "title": "param", "type": "object" }, "billing_details": { "properties": { "address": { "anyOf": [ { "properties": { "city": { "maxLength": 5000, "type": "string" }, "country": { "maxLength": 5000, "type": "string" }, "line1": { "maxLength": 5000, "type": "string" }, "line2": { "maxLength": 5000, "type": "string" }, "postal_code": { "maxLength": 5000, "type": "string" }, "state": { "maxLength": 5000, "type": "string" } }, "title": "billing_details_address", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "email": { "anyOf": [ { "type": "string" }, { "enum": [ "" ], "type": "string" } ] }, "name": { "anyOf": [ { "maxLength": 5000, "type": "string" }, { "enum": [ "" ], "type": "string" } ] }, "phone": { "anyOf": [ { "maxLength": 5000, "type": "string" }, { "enum": [ "" ], "type": "string" } ] } }, "title": "billing_details_inner_params", "type": "object" }, "blik": { "properties": {}, "title": "param", "type": "object" }, "boleto": { "properties": { "tax_id": { "maxLength": 5000, "type": "string" } }, "required": [ "tax_id" ], "title": "param", "type": "object" }, "cashapp": { "properties": {}, "title": "param", "type": "object" }, "customer_balance": { "properties": {}, "title": "param", "type": "object" }, "eps": { "properties": { "bank": { "enum": [ "arzte_und_apotheker_bank", "austrian_anadi_bank_ag", "bank_austria", "bankhaus_carl_spangler", "bankhaus_schelhammer_und_schattera_ag", "bawag_psk_ag", "bks_bank_ag", "brull_kallmus_bank_ag", "btv_vier_lander_bank", "capital_bank_grawe_gruppe_ag", "deutsche_bank_ag", "dolomitenbank", "easybank_ag", "erste_bank_und_sparkassen", "hypo_alpeadriabank_international_ag", "hypo_bank_burgenland_aktiengesellschaft", "hypo_noe_lb_fur_niederosterreich_u_wien", "hypo_oberosterreich_salzburg_steiermark", "hypo_tirol_bank_ag", "hypo_vorarlberg_bank_ag", "marchfelder_bank", "oberbank_ag", "raiffeisen_bankengruppe_osterreich", "schoellerbank_ag", "sparda_bank_wien", "volksbank_gruppe", "volkskreditbank_ag", "vr_bank_braunau" ], "maxLength": 5000, "type": "string" } }, "title": "param", "type": "object" }, "fpx": { "properties": { "bank": { "enum": [ "affin_bank", "agrobank", "alliance_bank", "ambank", "bank_islam", "bank_muamalat", "bank_of_china", "bank_rakyat", "bsn", "cimb", "deutsche_bank", "hong_leong_bank", "hsbc", "kfh", "maybank2e", "maybank2u", "ocbc", "pb_enterprise", "public_bank", "rhb", "standard_chartered", "uob" ], "maxLength": 5000, "type": "string", "x-stripeBypassValidation": true } }, "required": [ "bank" ], "title": "param", "type": "object" }, "giropay": { "properties": {}, "title": "param", "type": "object" }, "grabpay": { "properties": {}, "title": "param", "type": "object" }, "ideal": { "properties": { "bank": { "enum": [ "abn_amro", "asn_bank", "bunq", "handelsbanken", "ing", "knab", "moneyou", "n26", "rabobank", "regiobank", "revolut", "sns_bank", "triodos_bank", "van_lanschot", "yoursafe" ], "maxLength": 5000, "type": "string" } }, "title": "param", "type": "object" }, "interac_present": { "properties": {}, "title": "param", "type": "object" }, "klarna": { "properties": { "dob": { "properties": { "day": { "type": "integer" }, "month": { "type": "integer" }, "year": { "type": "integer" } }, "required": [ "day", "month", "year" ], "title": "date_of_birth", "type": "object" } }, "title": "param", "type": "object" }, "konbini": { "properties": {}, "title": "param", "type": "object" }, "link": { "properties": {}, "title": "param", "type": "object" }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "oxxo": { "properties": {}, "title": "param", "type": "object" }, "p24": { "properties": { "bank": { "enum": [ "alior_bank", "bank_millennium", "bank_nowy_bfg_sa", "bank_pekao_sa", "banki_spbdzielcze", "blik", "bnp_paribas", "boz", "citi_handlowy", "credit_agricole", "envelobank", "etransfer_pocztowy24", "getin_bank", "ideabank", "ing", "inteligo", "mbank_mtransfer", "nest_przelew", "noble_pay", "pbac_z_ipko", "plus_bank", "santander_przelew24", "tmobile_usbugi_bankowe", "toyota_bank", "volkswagen_bank" ], "type": "string", "x-stripeBypassValidation": true } }, "title": "param", "type": "object" }, "paynow": { "properties": {}, "title": "param", "type": "object" }, "paypal": { "properties": {}, "title": "param", "type": "object" }, "pix": { "properties": {}, "title": "param", "type": "object" }, "promptpay": { "properties": {}, "title": "param", "type": "object" }, "radar_options": { "properties": { "session": { "maxLength": 5000, "type": "string" } }, "title": "radar_options", "type": "object" }, "revolut_pay": { "properties": {}, "title": "param", "type": "object" }, "sepa_debit": { "properties": { "iban": { "maxLength": 5000, "type": "string" } }, "required": [ "iban" ], "title": "param", "type": "object" }, "sofort": { "properties": { "country": { "enum": [ "AT", "BE", "DE", "ES", "IT", "NL" ], "type": "string" } }, "required": [ "country" ], "title": "param", "type": "object" }, "type": { "enum": [ "acss_debit", "affirm", "afterpay_clearpay", "alipay", "au_becs_debit", "bacs_debit", "bancontact", "blik", "boleto", "cashapp", "customer_balance", "eps", "fpx", "giropay", "grabpay", "ideal", "klarna", "konbini", "link", "oxxo", "p24", "paynow", "paypal", "pix", "promptpay", "revolut_pay", "sepa_debit", "sofort", "us_bank_account", "wechat_pay", "zip" ], "type": "string", "x-stripeBypassValidation": true }, "us_bank_account": { "properties": { "account_holder_type": { "enum": [ "company", "individual" ], "type": "string" }, "account_number": { "maxLength": 5000, "type": "string" }, "account_type": { "enum": [ "checking", "savings" ], "type": "string" }, "financial_connections_account": { "maxLength": 5000, "type": "string" }, "routing_number": { "maxLength": 5000, "type": "string" } }, "title": "payment_method_param", "type": "object" }, "wechat_pay": { "properties": {}, "title": "param", "type": "object" }, "zip": { "properties": {}, "title": "param", "type": "object" } }, "required": [ "type" ], "title": "payment_method_data_params", "type": "object" }, "payment_method_options": { "description": "Payment method-specific configuration for this PaymentIntent.", "properties": { "acss_debit": { "anyOf": [ { "properties": { "mandate_options": { "properties": { "custom_mandate_url": { "anyOf": [ { "type": "string" }, { "enum": [ "" ], "type": "string" } ] }, "interval_description": { "maxLength": 500, "type": "string" }, "payment_schedule": { "enum": [ "combined", "interval", "sporadic" ], "type": "string" }, "transaction_type": { "enum": [ "business", "personal" ], "type": "string" } }, "title": "payment_intent_payment_method_options_mandate_options_param", "type": "object" }, "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" }, "verification_method": { "enum": [ "automatic", "instant", "microdeposits" ], "type": "string", "x-stripeBypassValidation": true } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "affirm": { "anyOf": [ { "properties": { "capture_method": { "enum": [ "", "manual" ], "type": "string" }, "preferred_locale": { "maxLength": 30, "type": "string" }, "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "afterpay_clearpay": { "anyOf": [ { "properties": { "capture_method": { "enum": [ "", "manual" ], "type": "string" }, "reference": { "maxLength": 128, "type": "string" }, "setup_future_usage": { "enum": [ "none" ], "type": "string", "x-stripeBypassValidation": true } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "alipay": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "", "none", "off_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "au_becs_debit": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "bacs_debit": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "bancontact": { "anyOf": [ { "properties": { "preferred_language": { "enum": [ "de", "en", "fr", "nl" ], "type": "string" }, "setup_future_usage": { "enum": [ "", "none", "off_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "blik": { "anyOf": [ { "properties": { "code": { "maxLength": 5000, "type": "string" } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "boleto": { "anyOf": [ { "properties": { "expires_after_days": { "type": "integer" }, "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "card": { "anyOf": [ { "properties": { "capture_method": { "enum": [ "", "manual" ], "type": "string" }, "cvc_token": { "maxLength": 5000, "type": "string" }, "installments": { "properties": { "enabled": { "type": "boolean" }, "plan": { "anyOf": [ { "properties": { "count": { "type": "integer" }, "interval": { "enum": [ "month" ], "type": "string" }, "type": { "enum": [ "fixed_count" ], "type": "string" } }, "required": [ "count", "interval", "type" ], "title": "installment_plan", "type": "object" }, { "enum": [ "" ], "type": "string" } ] } }, "title": "installments_param", "type": "object" }, "mandate_options": { "properties": { "amount": { "type": "integer" }, "amount_type": { "enum": [ "fixed", "maximum" ], "type": "string" }, "description": { "maxLength": 200, "type": "string" }, "end_date": { "format": "unix-time", "type": "integer" }, "interval": { "enum": [ "day", "month", "sporadic", "week", "year" ], "type": "string" }, "interval_count": { "type": "integer" }, "reference": { "maxLength": 80, "type": "string" }, "start_date": { "format": "unix-time", "type": "integer" }, "supported_types": { "items": { "enum": [ "india" ], "type": "string" }, "type": "array" } }, "required": [ "amount", "amount_type", "interval", "reference", "start_date" ], "title": "mandate_options_param", "type": "object" }, "network": { "enum": [ "amex", "cartes_bancaires", "diners", "discover", "eftpos_au", "interac", "jcb", "mastercard", "unionpay", "unknown", "visa" ], "maxLength": 5000, "type": "string", "x-stripeBypassValidation": true }, "request_extended_authorization": { "enum": [ "if_available", "never" ], "type": "string" }, "request_incremental_authorization": { "enum": [ "if_available", "never" ], "type": "string" }, "request_multicapture": { "enum": [ "if_available", "never" ], "type": "string" }, "request_overcapture": { "enum": [ "if_available", "never" ], "type": "string" }, "request_three_d_secure": { "enum": [ "any", "automatic", "challenge" ], "type": "string", "x-stripeBypassValidation": true }, "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" }, "statement_descriptor_suffix_kana": { "anyOf": [ { "maxLength": 22, "type": "string" }, { "enum": [ "" ], "type": "string" } ] }, "statement_descriptor_suffix_kanji": { "anyOf": [ { "maxLength": 17, "type": "string" }, { "enum": [ "" ], "type": "string" } ] }, "three_d_secure": { "properties": { "ares_trans_status": { "enum": [ "A", "C", "I", "N", "R", "U", "Y" ], "type": "string" }, "cryptogram": { "maxLength": 5000, "type": "string" }, "electronic_commerce_indicator": { "enum": [ "01", "02", "05", "06", "07" ], "type": "string", "x-stripeBypassValidation": true }, "exemption_indicator": { "enum": [ "low_risk", "none" ], "type": "string" }, "network_options": { "properties": { "cartes_bancaires": { "properties": { "cb_avalgo": { "enum": [ "0", "1", "2", "3", "4", "A" ], "type": "string" }, "cb_exemption": { "maxLength": 4, "type": "string" }, "cb_score": { "type": "integer" } }, "required": [ "cb_avalgo" ], "title": "cartes_bancaires_network_options_param", "type": "object" } }, "title": "network_options_param", "type": "object" }, "requestor_challenge_indicator": { "maxLength": 2, "type": "string" }, "transaction_id": { "maxLength": 5000, "type": "string" }, "version": { "enum": [ "1.0.2", "2.1.0", "2.2.0" ], "type": "string", "x-stripeBypassValidation": true } }, "required": [ "cryptogram", "transaction_id", "version" ], "title": "payment_method_options_param", "type": "object" } }, "title": "payment_intent_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "card_present": { "anyOf": [ { "properties": { "request_extended_authorization": { "type": "boolean" }, "request_incremental_authorization_support": { "type": "boolean" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "cashapp": { "anyOf": [ { "properties": { "capture_method": { "enum": [ "", "manual" ], "type": "string" }, "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "customer_balance": { "anyOf": [ { "properties": { "bank_transfer": { "properties": { "eu_bank_transfer": { "properties": { "country": { "maxLength": 5000, "type": "string" } }, "required": [ "country" ], "title": "eu_bank_transfer_params", "type": "object" }, "requested_address_types": { "items": { "enum": [ "aba", "iban", "sepa", "sort_code", "spei", "swift", "zengin" ], "type": "string", "x-stripeBypassValidation": true }, "type": "array" }, "type": { "enum": [ "eu_bank_transfer", "gb_bank_transfer", "jp_bank_transfer", "mx_bank_transfer", "us_bank_transfer" ], "type": "string", "x-stripeBypassValidation": true } }, "required": [ "type" ], "title": "bank_transfer_param", "type": "object" }, "funding_type": { "enum": [ "bank_transfer" ], "type": "string" }, "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "eps": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "fpx": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "giropay": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "grabpay": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "ideal": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "", "none", "off_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "interac_present": { "anyOf": [ { "properties": {}, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "klarna": { "anyOf": [ { "properties": { "capture_method": { "enum": [ "", "manual" ], "type": "string" }, "preferred_locale": { "enum": [ "cs-CZ", "da-DK", "de-AT", "de-CH", "de-DE", "el-GR", "en-AT", "en-AU", "en-BE", "en-CA", "en-CH", "en-CZ", "en-DE", "en-DK", "en-ES", "en-FI", "en-FR", "en-GB", "en-GR", "en-IE", "en-IT", "en-NL", "en-NO", "en-NZ", "en-PL", "en-PT", "en-SE", "en-US", "es-ES", "es-US", "fi-FI", "fr-BE", "fr-CA", "fr-CH", "fr-FR", "it-CH", "it-IT", "nb-NO", "nl-BE", "nl-NL", "pl-PL", "pt-PT", "sv-FI", "sv-SE" ], "type": "string", "x-stripeBypassValidation": true }, "setup_future_usage": { "enum": [ "none" ], "type": "string", "x-stripeBypassValidation": true } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "konbini": { "anyOf": [ { "properties": { "confirmation_number": { "anyOf": [ { "maxLength": 11, "type": "string" }, { "enum": [ "" ], "type": "string" } ] }, "expires_after_days": { "anyOf": [ { "type": "integer" }, { "enum": [ "" ], "type": "string" } ] }, "expires_at": { "anyOf": [ { "format": "unix-time", "type": "integer" }, { "enum": [ "" ], "type": "string" } ] }, "product_description": { "anyOf": [ { "maxLength": 22, "type": "string" }, { "enum": [ "" ], "type": "string" } ] }, "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "link": { "anyOf": [ { "properties": { "capture_method": { "enum": [ "", "manual" ], "type": "string" }, "setup_future_usage": { "enum": [ "", "none", "off_session" ], "type": "string" } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "oxxo": { "anyOf": [ { "properties": { "expires_after_days": { "type": "integer" }, "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "p24": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" }, "tos_shown_and_accepted": { "type": "boolean" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "paynow": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "paypal": { "anyOf": [ { "properties": { "capture_method": { "enum": [ "", "manual" ], "type": "string" }, "preferred_locale": { "enum": [ "cs-CZ", "da-DK", "de-AT", "de-DE", "de-LU", "el-GR", "en-GB", "en-US", "es-ES", "fi-FI", "fr-BE", "fr-FR", "fr-LU", "hu-HU", "it-IT", "nl-BE", "nl-NL", "pl-PL", "pt-PT", "sk-SK", "sv-SE" ], "type": "string", "x-stripeBypassValidation": true }, "reference": { "maxLength": 127, "type": "string" }, "risk_correlation_id": { "maxLength": 32, "type": "string" }, "setup_future_usage": { "enum": [ "", "none", "off_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "pix": { "anyOf": [ { "properties": { "expires_after_seconds": { "type": "integer" }, "expires_at": { "format": "unix-time", "type": "integer" }, "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "promptpay": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "revolut_pay": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "", "none", "off_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "sepa_debit": { "anyOf": [ { "properties": { "mandate_options": { "properties": {}, "title": "payment_method_options_mandate_options_param", "type": "object" }, "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "sofort": { "anyOf": [ { "properties": { "preferred_language": { "enum": [ "", "de", "en", "es", "fr", "it", "nl", "pl" ], "type": "string" }, "setup_future_usage": { "enum": [ "", "none", "off_session" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "us_bank_account": { "anyOf": [ { "properties": { "financial_connections": { "properties": { "permissions": { "items": { "enum": [ "balances", "ownership", "payment_method", "transactions" ], "maxLength": 5000, "type": "string", "x-stripeBypassValidation": true }, "type": "array" }, "prefetch": { "items": { "enum": [ "balances", "transactions" ], "type": "string", "x-stripeBypassValidation": true }, "type": "array" }, "return_url": { "maxLength": 5000, "type": "string" } }, "title": "linked_account_options_param", "type": "object" }, "mandate_options": { "properties": { "collection_method": { "enum": [ "", "paper" ], "type": "string", "x-stripeBypassValidation": true } }, "title": "mandate_options_param", "type": "object" }, "networks": { "properties": { "requested": { "items": { "enum": [ "ach", "us_domestic_wire" ], "type": "string" }, "type": "array" } }, "title": "networks_options_param", "type": "object" }, "preferred_settlement_speed": { "enum": [ "", "fastest", "standard" ], "type": "string" }, "setup_future_usage": { "enum": [ "", "none", "off_session", "on_session" ], "type": "string" }, "verification_method": { "enum": [ "automatic", "instant", "microdeposits" ], "type": "string", "x-stripeBypassValidation": true } }, "title": "payment_intent_payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "wechat_pay": { "anyOf": [ { "properties": { "app_id": { "maxLength": 5000, "type": "string" }, "client": { "enum": [ "android", "ios", "web" ], "type": "string", "x-stripeBypassValidation": true }, "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "required": [ "client" ], "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] }, "zip": { "anyOf": [ { "properties": { "setup_future_usage": { "enum": [ "none" ], "type": "string" } }, "title": "payment_method_options_param", "type": "object" }, { "enum": [ "" ], "type": "string" } ] } }, "title": "payment_method_options_param", "type": "object" }, "payment_method_types": { "description": "The list of payment method types (for example, a card) that this PaymentIntent can use. Use `automatic_payment_methods` to manage payment methods from the [Stripe Dashboard](https://dashboard.stripe.com/settings/payment_methods).", "items": { "maxLength": 5000, "type": "string" }, "type": "array" }, "radar_options": { "description": "Options to configure Radar. Learn more about [Radar Sessions](https://stripe.com/docs/radar/radar-session).", "properties": { "session": { "maxLength": 5000, "type": "string" } }, "title": "radar_options_with_hidden_options", "type": "object" }, "receipt_email": { "anyOf": [ { "type": "string" }, { "enum": [ "" ], "type": "string" } ], "description": "Email address that the receipt for the resulting payment will be sent to. If `receipt_email` is specified for a payment in live mode, a receipt will be sent regardless of your [email settings](https://dashboard.stripe.com/account/emails)." }, "return_url": { "description": "The URL to redirect your customer back to after they authenticate or cancel their payment on the payment method's app or site.\nIf you'd prefer to redirect to a mobile application, you can alternatively supply an application URI scheme.\nThis parameter is only used for cards and other redirect-based payment methods.", "type": "string" }, "setup_future_usage": { "description": "Indicates that you intend to make future payments with this PaymentIntent's payment method.\n\nProviding this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payment) to the PaymentIntent's Customer, if present, after the PaymentIntent is confirmed and any required actions from the user are complete. If no Customer was provided, the payment method can still be [attached](https://stripe.com/docs/api/payment_methods/attach) to a Customer after the transaction completes.\n\nWhen processing card payments, Stripe also uses `setup_future_usage` to dynamically optimize your payment flow and comply with regional legislation and network rules, such as [SCA](https://stripe.com/docs/strong-customer-authentication).\n\nIf `setup_future_usage` is already set and you are performing a request using a publishable key, you may only update the value from `on_session` to `off_session`.", "enum": [ "", "off_session", "on_session" ], "type": "string" }, "shipping": { "anyOf": [ { "properties": { "address": { "properties": { "city": { "maxLength": 5000, "type": "string" }, "country": { "maxLength": 5000, "type": "string" }, "line1": { "maxLength": 5000, "type": "string" }, "line2": { "maxLength": 5000, "type": "string" }, "postal_code": { "maxLength": 5000, "type": "string" }, "state": { "maxLength": 5000, "type": "string" } }, "title": "optional_fields_address", "type": "object" }, "carrier": { "maxLength": 5000, "type": "string" }, "name": { "maxLength": 5000, "type": "string" }, "phone": { "maxLength": 5000, "type": "string" }, "tracking_number": { "maxLength": 5000, "type": "string" } }, "required": [ "address", "name" ], "title": "optional_fields_shipping", "type": "object" }, { "enum": [ "" ], "type": "string" } ], "description": "Shipping information for this PaymentIntent." }, "use_stripe_sdk": { "description": "Set to `true` when confirming server-side and using Stripe.js, iOS, or Android client-side SDKs to handle the next actions.", "type": "boolean" } } }