{ "$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-request-schema.json", "title": "PostPaymentIntentsIntentRequest", "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/PostPaymentIntentsIntentRequest", "type": "object", "properties": { "amount": { "description": "Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the [smallest currency unit](https://stripe.com/docs/currencies#zero-decimal) (e.g., 100 cents to charge $1.00 or 100 to charge ¥100, a zero-decimal currency). The minimum amount is $0.50 US or [equivalent in charge currency](https://stripe.com/docs/currencies#minimum-and-maximum-charge-amounts). The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).", "type": "integer" }, "application_fee_amount": { "anyOf": [ { "type": "integer" }, { "enum": [ "" ], "type": "string" } ], "description": "The amount of the application fee (if any) that will be requested to be applied to the payment and transferred to the application owner's Stripe account. The amount of the application fee collected will be capped at the total payment amount. For more information, see the PaymentIntents [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts)." }, "capture_method": { "description": "Controls when the funds will be captured from the customer's account.", "enum": [ "automatic", "automatic_async", "manual" ], "type": "string" }, "currency": { "description": "Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies).", "type": "string" }, "customer": { "description": "ID of the Customer this PaymentIntent belongs to, if one exists.\n\nPayment methods attached to other Customers cannot be used with this PaymentIntent.\n\nIf present in combination with [setup_future_usage](https://stripe.com/docs/api#payment_intent_object-setup_future_usage), this PaymentIntent's payment method will be attached to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete.", "maxLength": 5000, "type": "string" }, "description": { "description": "An arbitrary string attached to the object. Often useful for displaying to users.", "maxLength": 1000, "type": "string" }, "expand": { "description": "Specifies which fields in the response should be expanded.", "items": { "maxLength": 5000, "type": "string" }, "type": "array" }, "metadata": { "anyOf": [ { "additionalProperties": { "type": "string" }, "type": "object" }, { "enum": [ "" ], "type": "string" } ], "description": "Set of [key-value pairs](https://stripe.com/docs/api/metadata) 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`." }, "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_configuration": { "description": "The ID of the payment method configuration to use with this PaymentIntent.", "maxLength": 100, "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, 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" }, "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)." }, "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." }, "statement_descriptor": { "description": "For card charges, use [statement_descriptor_suffix](https://stripe.com/docs/payments/account/statement-descriptors#dynamic). Otherwise, you can use this value as the complete description of a charge on your customers' statements. It must contain at least one letter and be 1–22 characters long.", "maxLength": 22, "type": "string" }, "statement_descriptor_suffix": { "description": "Provides information about a card payment that customers see on their statements. Concatenated with the prefix (shortened descriptor) or statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 22 characters for the concatenated descriptor.", "maxLength": 22, "type": "string" }, "transfer_data": { "description": "Use this parameter to automatically create a Transfer when the payment succeeds. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).", "properties": { "amount": { "type": "integer" } }, "title": "transfer_data_update_params", "type": "object" }, "transfer_group": { "description": "A string that identifies the resulting payment as part of a group. You can only provide `transfer_group` if it hasn't been set. Learn more about the [use case for connected accounts](https://stripe.com/docs/payments/connected-accounts).", "type": "string" } } }