Stripe · Schema
PostPaymentIntentsIntentRequest
CommerceFinancial ServicesFintechPaymentsT1StripeAgentic CommercePoint-of-SalePayment Processing
Properties
| Name | Type | Description |
|---|---|---|
| amount | integer | 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 ce |
| application_fee_amount | object | 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 wi |
| capture_method | string | Controls when the funds will be captured from the customer's account. |
| currency | string | 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). |
| customer | string | ID of the Customer this PaymentIntent belongs to, if one exists. Payment methods attached to other Customers cannot be used with this PaymentIntent. If present in combination with [setup_future_usage] |
| description | string | An arbitrary string attached to the object. Often useful for displaying to users. |
| expand | array | Specifies which fields in the response should be expanded. |
| metadata | object | 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. Individu |
| payment_method | string | 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. |
| payment_method_configuration | string | The ID of the payment method configuration to use with this PaymentIntent. |
| payment_method_data | object | If provided, this hash will be used to create a PaymentMethod. The new PaymentMethod will appear in the [payment_method](https://stripe.com/docs/api/payment_intents/object#payment_intent_object-paymen |
| payment_method_options | object | Payment-method-specific configuration for this PaymentIntent. |
| payment_method_types | array | 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 |
| receipt_email | object | 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:/ |
| setup_future_usage | string | Indicates that you intend to make future payments with this PaymentIntent's payment method. Providing this parameter will [attach the payment method](https://stripe.com/docs/payments/save-during-payme |
| shipping | object | Shipping information for this PaymentIntent. |
| statement_descriptor | string | 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 o |
| statement_descriptor_suffix | string | 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 comp |
| transfer_data | object | 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). |
| transfer_group | string | 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.co |
JSON Schema
{
"$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": [
""
],
# --- truncated at 32 KB (64 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/stripe/refs/heads/main/json-schema/stripe-post-payment-intents-intent-request-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/stripe-post-payment-intents-intent-request"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.