Attributes
- idstringretrievable with publishable key
Unique identifier for the object.
- amountintegerretrievable with publishable key
Amount intended to be collected by this PaymentIntent. A positive integer representing how much to charge in the smallest currency unit (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. The amount value supports up to eight digits (e.g., a value of 99999999 for a USD charge of $999,999.99).
- automatic_
payment_ methodsnullable objectretrievable with publishable key Settings to configure compatible payment methods from the Stripe Dashboard
- automatic_payment_methods.
allow_ redirectsnullable enum Controls whether this PaymentIntent will accept redirect-based payment methods.
Redirect-based payment methods may require your customer to be redirected to a payment method’s app or site for authentication or additional steps. To confirm this PaymentIntent, you may be required to provide a
return_
to redirect customers back to your site after they authenticate or complete the payment.url Possible enum valuesalways
(Default) This PaymentIntent will accept redirect-based payment methods.
return_
may be required to confirm this PaymentIntent.url never
This PaymentIntent will not accept redirect-based payment methods. Payment methods that require redirect will be filtered.
return_
will not be required to confirm this PaymentIntent.url - automatic_payment_methods.
enabledboolean Automatically calculates compatible payment methods
- client_
secretnullable stringretrievable with publishable key The client secret of this PaymentIntent. Used for client-side retrieval using a publishable key.
The client secret can be used to complete a payment from your frontend. It should not be stored, logged, or exposed to anyone other than the customer. Make sure that you have TLS enabled on any page that includes the client secret.
Refer to our docs to accept a payment and learn about how
client_
should be handled.secret - currencyenumretrievable with publishable key
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- customernullable stringExpandable
ID of the Customer this PaymentIntent belongs to, if one exists.
Payment methods attached to other Customers cannot be used with this PaymentIntent.
If setup_future_usage is set and this PaymentIntent’s payment method is not
card_
, then the payment method attaches to the Customer after the PaymentIntent has been confirmed and any required actions from the user are complete. If the payment method ispresent card_
and isn’t a digital wallet, then a generated_card payment method representing the card is created and attached to the Customer instead.present - descriptionnullable stringretrievable with publishable key
An arbitrary string attached to the object. Often useful for displaying to users.
- last_
payment_ errornullable objectretrievable with publishable key The payment error encountered in the previous PaymentIntent confirmation. It will be cleared if the PaymentIntent is later updated for any reason.
- last_payment_error.
advice_ codenullable string For card errors resulting from a card issuer decline, a short string indicating how to proceed with an error if they provide one.
- last_payment_error.
chargenullable string For card errors, the ID of the failed charge.
- last_payment_error.
codenullable string For some errors that could be handled programmatically, a short string indicating the error code reported.
- last_payment_error.
decline_ codenullable string For card errors resulting from a card issuer decline, a short string indicating the card issuer’s reason for the decline if they provide one.
- last_payment_error.
doc_ urlnullable string A URL to more information about the error code reported.
- last_payment_error.
messagenullable string A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.
- last_payment_error.
network_ advice_ codenullable string For card errors resulting from a card issuer decline, a 2 digit code which indicates the advice given to merchant by the card network on how to proceed with an error.
- last_payment_error.
network_ decline_ codenullable string For payments declined by the network, an alphanumeric code which indicates the reason the payment failed.
- last_payment_error.
paramnullable string If the error is parameter-specific, the parameter related to the error. For example, you can use this to display a message near the correct form field.
- last_payment_error.
payment_ methodnullable object The PaymentMethod object for errors returned on a request involving a PaymentMethod.
- last_payment_error.
payment_method. idstring Unique identifier for the object.
- last_payment_error.
payment_method. objectstring String representing the object’s type. Objects of the same type share the same value.
- last_payment_error.
payment_method. acss_ debitnullable object If this is an
acss_
PaymentMethod, this hash contains details about the ACSS Debit payment method.debit - last_payment_error.
payment_method. acss_debit. bank_ namenullable string Name of the bank associated with the bank account.
- last_payment_error.
payment_method. acss_debit. fingerprintnullable string Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
- last_payment_error.
payment_method. acss_debit. institution_ numbernullable string Institution number of the bank account.
- last_payment_error.
payment_method. acss_debit. last4nullable string Last four digits of the bank account number.
- last_payment_error.
payment_method. acss_debit. transit_ numbernullable string Transit number of the bank account.
- last_payment_error.
payment_method. affirmnullable object If this is an
affirm
PaymentMethod, this hash contains details about the Affirm payment method. - last_payment_error.
payment_method. afterpay_ clearpaynullable object If this is an
AfterpayClearpay
PaymentMethod, this hash contains details about the AfterpayClearpay payment method. - last_payment_error.
payment_method. alipaynullable object If this is an
Alipay
PaymentMethod, this hash contains details about the Alipay payment method. - last_payment_error.
payment_method. allow_ redisplaynullable enum This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to “unspecified”.
Possible enum valuesalways
Use
always
to indicate that this payment method can always be shown to a customer in a checkout flow.limited
Use
limited
to indicate that this payment method can’t always be shown to a customer in a checkout flow. For example, it can only be shown in the context of a specific subscription.unspecified
This is the default value for payment methods where
allow_
wasn’t set.redisplay - last_payment_error.
payment_method. almanullable object If this is a Alma PaymentMethod, this hash contains details about the Alma payment method.
- last_payment_error.
payment_method. amazon_ paynullable object If this is a AmazonPay PaymentMethod, this hash contains details about the AmazonPay payment method.
- last_payment_error.
payment_method. au_ becs_ debitnullable object If this is an
au_
PaymentMethod, this hash contains details about the bank account.becs_ debit - last_payment_error.
payment_method. au_becs_debit. bsb_ numbernullable string Six-digit number identifying bank and branch associated with this bank account.
- last_payment_error.
payment_method. au_becs_debit. fingerprintnullable string Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
- last_payment_error.
payment_method. au_becs_debit. last4nullable string Last four digits of the bank account number.
- last_payment_error.
payment_method. bacs_ debitnullable object If this is a
bacs_
PaymentMethod, this hash contains details about the Bacs Direct Debit bank account.debit - last_payment_error.
payment_method. bacs_debit. fingerprintnullable string Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
- last_payment_error.
payment_method. bacs_debit. last4nullable string Last four digits of the bank account number.
- last_payment_error.
payment_method. bacs_debit. sort_ codenullable string Sort code of the bank account. (e.g.,
10-20-30
)
- last_payment_error.
payment_method. bancontactnullable object If this is a
bancontact
PaymentMethod, this hash contains details about the Bancontact payment method. - last_payment_error.
payment_method. billienullable object If this is a
billie
PaymentMethod, this hash contains details about the Billie payment method. - last_payment_error.
payment_method. billing_ detailsobject Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
- last_payment_error.
payment_method. billing_details. addressnullable object Billing address.
- last_payment_error.
payment_method. billing_details. address. citynullable string City, district, suburb, town, or village.
- last_payment_error.
payment_method. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- last_payment_error.
payment_method. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- last_payment_error.
payment_method. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- last_payment_error.
payment_method. billing_details. address. postal_ codenullable string ZIP or postal code.
- last_payment_error.
payment_method. billing_details. address. statenullable string State, county, province, or region.
- last_payment_error.
payment_method. billing_details. emailnullable string Email address.
- last_payment_error.
payment_method. billing_details. namenullable string Full name.
- last_payment_error.
payment_method. billing_details. phonenullable string Billing phone number (including extension).
- last_payment_error.
payment_method. billing_details. tax_ idnullable string Taxpayer identification number. Used only for transactions between LATAM buyers and non-LATAM sellers.
- last_payment_error.
payment_method. bliknullable object If this is a
blik
PaymentMethod, this hash contains details about the BLIK payment method. - last_payment_error.
payment_method. boletonullable object If this is a
boleto
PaymentMethod, this hash contains details about the Boleto payment method.- last_payment_error.
payment_method. boleto. tax_ idstring Uniquely identifies the customer tax id (CNPJ or CPF)
- last_payment_error.
payment_method. cardnullable object If this is a
card
PaymentMethod, this hash contains the user’s card details.- last_payment_error.
payment_method. card. brandstring Card brand. Can be
amex
,cartes_
,bancaires diners
,discover
,eftpos_
,au jcb
,link
,mastercard
,unionpay
,visa
orunknown
. - last_payment_error.
payment_method. card. checksnullable object Checks on Card address and CVC if provided.
- last_payment_error.
payment_method. card. checks. address_ line1_ checknullable string If a address line1 was provided, results of the check, one of
pass
,fail
,unavailable
, orunchecked
. - last_payment_error.
payment_method. card. checks. address_ postal_ code_ checknullable string If a address postal code was provided, results of the check, one of
pass
,fail
,unavailable
, orunchecked
. - last_payment_error.
payment_method. card. checks. cvc_ checknullable string If a CVC was provided, results of the check, one of
pass
,fail
,unavailable
, orunchecked
.
- last_payment_error.
payment_method. card. countrynullable string Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you’ve collected.
- last_payment_error.
payment_method. card. display_ brandnullable string The brand to use when displaying the card, this accounts for customer’s brand choice on dual-branded cards. Can be
american_
,express cartes_
,bancaires diners_
,club discover
,eftpos_
,australia interac
,jcb
,mastercard
,union_
,pay visa
, orother
and may contain more values in the future. - last_payment_error.
payment_method. card. exp_ monthinteger Two-digit number representing the card’s expiration month.
- last_payment_error.
payment_method. card. exp_ yearinteger Four-digit number representing the card’s expiration year.
- last_payment_error.
payment_method. card. fingerprintnullable string Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card—one for India and one for the rest of the world.
- last_payment_error.
payment_method. card. fundingstring Card funding type. Can be
credit
,debit
,prepaid
, orunknown
. - last_payment_error.
payment_method. card. generated_ fromnullable object Details of the original PaymentMethod that created this object.
- last_payment_error.
payment_method. card. generated_from. chargenullable string The charge that created this object.
- last_payment_error.
payment_method. card. generated_from. payment_ method_ detailsnullable object Transaction-specific details of the payment method used in the payment.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_ presentnullable object This hash contains the snapshot of the
card_
transaction-specific details which generated thispresent card
payment method.- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. nullable integer The authorized amount
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. brandnullable string Card brand. Can be
amex
,cartes_
,bancaires diners
,discover
,eftpos_
,au jcb
,link
,mastercard
,unionpay
,visa
orunknown
. - last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. brand_ productnullable string The product code that identifies the specific program or product associated with a card.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. capture_ beforenullable timestamp When using manual capture, a future timestamp after which the charge will be automatically refunded if uncaptured.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. cardholder_ namenullable string The cardholder name as read from the card, in ISO 7813 format. May include alphanumeric characters, special characters and first/last name separator (
/
). In some cases, the cardholder name may not be available depending on how the issuer has configured the card. Cardholder name is typically not available on swipe or contactless payments, such as those made with Apple Pay and Google Pay. - last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. countrynullable string Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you’ve collected.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. descriptionnullable string A high-level description of the type of cards issued in this range.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. emv_ auth_ datanullable string Authorization response cryptogram.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. exp_ monthinteger Two-digit number representing the card’s expiration month.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. exp_ yearinteger Four-digit number representing the card’s expiration year.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. fingerprintnullable string Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card—one for India and one for the rest of the world.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. fundingnullable string Card funding type. Can be
credit
,debit
,prepaid
, orunknown
. - last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. generated_ cardnullable string ID of a card PaymentMethod generated from the card_present PaymentMethod that may be attached to a Customer for future transactions. Only present if it was possible to generate a card PaymentMethod.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. boolean Whether this PaymentIntent is eligible for incremental authorizations. Request support using request_incremental_authorization_support.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. issuernullable string The name of the card’s issuing bank.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. last4nullable string The last four digits of the card.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. networknullable string Identifies which network this charge was processed on. Can be
amex
,cartes_
,bancaires diners
,discover
,eftpos_
,au interac
,jcb
,link
,mastercard
,unionpay
,visa
, orunknown
. - last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. network_ transaction_ idnullable string This is used by the financial networks to identify a transaction. Visa calls this the Transaction ID, Mastercard calls this the Trace ID, and American Express calls this the Acquirer Reference Data. This value will be present if it is returned by the financial network in the authorization response, and null otherwise.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. offlinenullable object Details about payments collected offline.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. offline. stored_ atnullable timestamp Time at which the payment was collected while offline
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. offline. typenullable enum The method used to process this payment method offline. Only deferred is allowed.
Possible enum valuesdeferred
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. overcapture_ supportedboolean Defines whether the authorized amount can be over-captured or not
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. preferred_ localesnullable array of strings The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card’s chip.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. read_ methodnullable enum How card details were read in this transaction.
Possible enum valuescontact_
emv Inserting a chip card into the card reader.
contactless_
emv Tapping a contactless-enabled chip card or mobile wallet.
contactless_
magstripe_ mode Older standard for contactless payments that emulated a magnetic stripe read.
magnetic_
stripe_ fallback When inserting a chip card fails three times in a row, fallback to a magnetic stripe read.
magnetic_
stripe_ track2 Swiping a card using the magnetic stripe reader.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receiptnullable object A collection of fields required to be displayed on receipts. Only required for EMV transactions.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. account_ typenullable enum The type of account being debited or credited
Possible enum valueschecking
A checking account, as when using a debit card
credit
A credit account, as when using a credit card
prepaid
A prepaid account, as when using a debit gift card
unknown
An unknown account
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. application_ cryptogramnullable string The Application Cryptogram, a unique value generated by the card to authenticate the transaction with issuers.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. application_ preferred_ namenullable string The Application Identifier (AID) on the card used to determine which networks are eligible to process the transaction. Referenced from EMV tag 9F12, data encoded on the card’s chip.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. nullable string Identifier for this transaction.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. nullable string EMV tag 8A. A code returned by the card issuer.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. cardholder_ verification_ methodnullable string Describes the method used by the cardholder to verify ownership of the card. One of the following:
approval
,failure
,none
,offline_
,pin offline_
,pin_ and_ signature online_
, orpin signature
. - last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. dedicated_ file_ namenullable string Similar to the application_preferred_name, identifying the applications (AIDs) available on the card. Referenced from EMV tag 84.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. terminal_ verification_ resultsnullable string A 5-byte string that records the checks and validations that occur between the card and the terminal. These checks determine how the terminal processes the transaction and what risk tolerance is acceptable. Referenced from EMV Tag 95.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. receipt. transaction_ status_ informationnullable string An indication of which steps were completed during the card read process. Referenced from EMV Tag 9B.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. walletnullable object If a mobile wallet was presented in the transaction, this contains the details of the mobile wallet.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. card_present. wallet. typeenum The type of mobile wallet, one of
apple_
,pay google_
,pay samsung_
, orpay unknown
.Possible enum valuesapple_
pay Apple Pay is a mobile payment service by Apple.
google_
pay Google Pay is a mobile payment service by Google.
samsung_
pay Samsung Pay is a mobile payment service by Samsung Electronics.
unknown
The wallet provider is unknown.
- last_payment_error.
payment_method. card. generated_from. payment_method_details. typestring The type of payment method transaction-specific details from the transaction that generated this
card
payment method. Alwayscard_
.present
- last_payment_error.
payment_method. card. generated_from. setup_ attemptnullable stringExpandable The ID of the SetupAttempt that generated this PaymentMethod, if any.
- last_payment_error.
payment_method. card. last4string The last four digits of the card.
- last_payment_error.
payment_method. card. networksnullable object Contains information about card networks that can be used to process the payment.
- last_payment_error.
payment_method. card. networks. availablearray of strings All networks available for selection via payment_method_options.card.network.
- last_payment_error.
payment_method. card. networks. preferrednullable string The preferred network for co-branded cards. Can be
cartes_
,bancaires mastercard
,visa
orinvalid_
if requested network is not valid for the card.preference
- last_payment_error.
payment_method. card. regulated_ statusnullable enum Status of a card based on the card issuer.
Possible enum valuesregulated
The card falls under a regulated account range.
unregulated
The card does not fall under a regulated account range.
- last_payment_error.
payment_method. card. three_ d_ secure_ usagenullable object Contains details on how this Card may be used for 3D Secure authentication.
- last_payment_error.
payment_method. card. three_d_secure_usage. supportedboolean Whether 3D Secure is supported on this card.
- last_payment_error.
payment_method. card. walletnullable object If this Card is part of a card wallet, this contains the details of the card wallet.
- last_payment_error.
payment_method. card. wallet. amex_ express_ checkoutnullable object If this is a
amex_
card wallet, this hash contains details about the wallet.express_ checkout - last_payment_error.
payment_method. card. wallet. apple_ paynullable object If this is a
apple_
card wallet, this hash contains details about the wallet.pay - last_payment_error.
payment_method. card. wallet. dynamic_ last4nullable string (For tokenized numbers only.) The last four digits of the device account number.
- last_payment_error.
payment_method. card. wallet. google_ paynullable object If this is a
google_
card wallet, this hash contains details about the wallet.pay - last_payment_error.
payment_method. card. wallet. linknullable object If this is a
link
card wallet, this hash contains details about the wallet. - last_payment_error.
payment_method. card. wallet. masterpassnullable object If this is a
masterpass
card wallet, this hash contains details about the wallet.- last_payment_error.
payment_method. card. wallet. masterpass. billing_ addressnullable object Owner’s verified billing address. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. masterpass. billing_address. citynullable string City, district, suburb, town, or village.
- last_payment_error.
payment_method. card. wallet. masterpass. billing_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- last_payment_error.
payment_method. card. wallet. masterpass. billing_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- last_payment_error.
payment_method. card. wallet. masterpass. billing_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- last_payment_error.
payment_method. card. wallet. masterpass. billing_address. postal_ codenullable string ZIP or postal code.
- last_payment_error.
payment_method. card. wallet. masterpass. billing_address. statenullable string State, county, province, or region.
- last_payment_error.
payment_method. card. wallet. masterpass. emailnullable string Owner’s verified email. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. masterpass. namenullable string Owner’s verified full name. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. masterpass. shipping_ addressnullable object Owner’s verified shipping address. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. masterpass. shipping_address. citynullable string City, district, suburb, town, or village.
- last_payment_error.
payment_method. card. wallet. masterpass. shipping_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- last_payment_error.
payment_method. card. wallet. masterpass. shipping_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- last_payment_error.
payment_method. card. wallet. masterpass. shipping_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- last_payment_error.
payment_method. card. wallet. masterpass. shipping_address. postal_ codenullable string ZIP or postal code.
- last_payment_error.
payment_method. card. wallet. masterpass. shipping_address. statenullable string State, county, province, or region.
- last_payment_error.
payment_method. card. wallet. samsung_ paynullable object If this is a
samsung_
card wallet, this hash contains details about the wallet.pay - last_payment_error.
payment_method. card. wallet. typeenum The type of the card wallet, one of
amex_
,express_ checkout apple_
,pay google_
,pay masterpass
,samsung_
,pay visa_
, orcheckout link
. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type.Possible enum valuesamex_
express_ checkout apple_
pay google_
pay link
masterpass
samsung_
pay visa_
checkout - last_payment_error.
payment_method. card. wallet. visa_ checkoutnullable object If this is a
visa_
card wallet, this hash contains details about the wallet.checkout - last_payment_error.
payment_method. card. wallet. visa_checkout. billing_ addressnullable object Owner’s verified billing address. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. visa_checkout. billing_address. citynullable string City, district, suburb, town, or village.
- last_payment_error.
payment_method. card. wallet. visa_checkout. billing_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- last_payment_error.
payment_method. card. wallet. visa_checkout. billing_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- last_payment_error.
payment_method. card. wallet. visa_checkout. billing_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- last_payment_error.
payment_method. card. wallet. visa_checkout. billing_address. postal_ codenullable string ZIP or postal code.
- last_payment_error.
payment_method. card. wallet. visa_checkout. billing_address. statenullable string State, county, province, or region.
- last_payment_error.
payment_method. card. wallet. visa_checkout. emailnullable string Owner’s verified email. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. visa_checkout. namenullable string Owner’s verified full name. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. visa_checkout. shipping_ addressnullable object Owner’s verified shipping address. Values are verified or provided by the wallet directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. card. wallet. visa_checkout. shipping_address. citynullable string City, district, suburb, town, or village.
- last_payment_error.
payment_method. card. wallet. visa_checkout. shipping_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- last_payment_error.
payment_method. card. wallet. visa_checkout. shipping_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- last_payment_error.
payment_method. card. wallet. visa_checkout. shipping_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- last_payment_error.
payment_method. card. wallet. visa_checkout. shipping_address. postal_ codenullable string ZIP or postal code.
- last_payment_error.
payment_method. card. wallet. visa_checkout. shipping_address. statenullable string State, county, province, or region.
- last_payment_error.
payment_method. card_ presentnullable object If this is a
card_
PaymentMethod, this hash contains details about the Card Present payment method.present - last_payment_error.
payment_method. card_present. brandnullable string Card brand. Can be
amex
,cartes_
,bancaires diners
,discover
,eftpos_
,au jcb
,link
,mastercard
,unionpay
,visa
orunknown
. - last_payment_error.
payment_method. card_present. brand_ productnullable string The product code that identifies the specific program or product associated with a card.
- last_payment_error.
payment_method. card_present. cardholder_ namenullable string The cardholder name as read from the card, in ISO 7813 format. May include alphanumeric characters, special characters and first/last name separator (
/
). In some cases, the cardholder name may not be available depending on how the issuer has configured the card. Cardholder name is typically not available on swipe or contactless payments, such as those made with Apple Pay and Google Pay. - last_payment_error.
payment_method. card_present. countrynullable string Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you’ve collected.
- last_payment_error.
payment_method. card_present. descriptionnullable string A high-level description of the type of cards issued in this range.
- last_payment_error.
payment_method. card_present. exp_ monthinteger Two-digit number representing the card’s expiration month.
- last_payment_error.
payment_method. card_present. exp_ yearinteger Four-digit number representing the card’s expiration year.
- last_payment_error.
payment_method. card_present. fingerprintnullable string Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card—one for India and one for the rest of the world.
- last_payment_error.
payment_method. card_present. fundingnullable string Card funding type. Can be
credit
,debit
,prepaid
, orunknown
. - last_payment_error.
payment_method. card_present. issuernullable string The name of the card’s issuing bank.
- last_payment_error.
payment_method. card_present. last4nullable string The last four digits of the card.
- last_payment_error.
payment_method. card_present. networksnullable object Contains information about card networks that can be used to process the payment.
- last_payment_error.
payment_method. card_present. networks. availablearray of strings All networks available for selection via payment_method_options.card.network.
- last_payment_error.
payment_method. card_present. networks. preferrednullable string The preferred network for the card.
- last_payment_error.
payment_method. card_present. offlinenullable object Details about payment methods collected offline.
- last_payment_error.
payment_method. card_present. offline. stored_ atnullable timestamp Time at which the payment was collected while offline
- last_payment_error.
payment_method. card_present. offline. typenullable enum The method used to process this payment method offline. Only deferred is allowed.
Possible enum valuesdeferred
- last_payment_error.
payment_method. card_present. preferred_ localesnullable array of strings The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card’s chip.
- last_payment_error.
payment_method. card_present. read_ methodnullable enum How card details were read in this transaction.
Possible enum valuescontact_
emv Inserting a chip card into the card reader.
contactless_
emv Tapping a contactless-enabled chip card or mobile wallet.
contactless_
magstripe_ mode Older standard for contactless payments that emulated a magnetic stripe read.
magnetic_
stripe_ fallback When inserting a chip card fails three times in a row, fallback to a magnetic stripe read.
magnetic_
stripe_ track2 Swiping a card using the magnetic stripe reader.
- last_payment_error.
payment_method. card_present. walletnullable object If a mobile wallet was presented in the transaction, this contains the details of the mobile wallet.
- last_payment_error.
payment_method. card_present. wallet. typeenum The type of mobile wallet, one of
apple_
,pay google_
,pay samsung_
, orpay unknown
.Possible enum valuesapple_
pay Apple Pay is a mobile payment service by Apple.
google_
pay Google Pay is a mobile payment service by Google.
samsung_
pay Samsung Pay is a mobile payment service by Samsung Electronics.
unknown
The wallet provider is unknown.
- last_payment_error.
payment_method. cashappnullable object If this is a
cashapp
PaymentMethod, this hash contains details about the Cash App Pay payment method.- last_payment_error.
payment_method. cashapp. buyer_ idnullable string A unique and immutable identifier assigned by Cash App to every buyer.
- last_payment_error.
payment_method. cashapp. cashtagnullable string A public identifier for buyers using Cash App.
- last_payment_error.
payment_method. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- last_payment_error.
payment_method. cryptonullable object If this is a Crypto PaymentMethod, this hash contains details about the Crypto payment method.
- last_payment_error.
payment_method. customernullable stringExpandable The ID of the Customer to which this PaymentMethod is saved. This will not be set when the PaymentMethod has not been saved to a Customer.
- last_payment_error.
payment_method. customer_ balancenullable object If this is a
customer_
PaymentMethod, this hash contains details about the CustomerBalance payment method.balance - last_payment_error.
payment_method. epsnullable object If this is an
eps
PaymentMethod, this hash contains details about the EPS payment method.- last_payment_error.
payment_method. eps. banknullable enum The customer’s bank. Should be one of
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_
,noe_ lb_ fur_ niederosterreich_ u_ wien hypo_
,oberosterreich_ salzburg_ steiermark hypo_
,tirol_ bank_ ag hypo_
,vorarlberg_ bank_ ag hypo_
,bank_ burgenland_ aktiengesellschaft marchfelder_
,bank oberbank_
,ag raiffeisen_
,bankengruppe_ osterreich schoellerbank_
,ag sparda_
,bank_ wien volksbank_
,gruppe volkskreditbank_
, orag vr_
.bank_ braunau Possible enum valuesarzte_
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 Show 18 more
- last_payment_error.
payment_method. fpxnullable object If this is an
fpx
PaymentMethod, this hash contains details about the FPX payment method.- last_payment_error.
payment_method. fpx. bankenum The customer’s bank, if provided. Can be one of
affin_
,bank agrobank
,alliance_
,bank ambank
,bank_
,islam bank_
,muamalat bank_
,rakyat bsn
,cimb
,hong_
,leong_ bank hsbc
,kfh
,maybank2u
,ocbc
,public_
,bank rhb
,standard_
,chartered uob
,deutsche_
,bank maybank2e
,pb_
, orenterprise bank_
.of_ china Possible enum valuesaffin_
bank agrobank
alliance_
bank ambank
bank_
islam bank_
muamalat bank_
of_ china bank_
rakyat bsn
cimb
Show 12 more
- last_payment_error.
payment_method. giropaynullable object If this is a
giropay
PaymentMethod, this hash contains details about the Giropay payment method. - last_payment_error.
payment_method. grabpaynullable object If this is a
grabpay
PaymentMethod, this hash contains details about the GrabPay payment method. - last_payment_error.
payment_method. idealnullable object If this is an
ideal
PaymentMethod, this hash contains details about the iDEAL payment method.- last_payment_error.
payment_method. ideal. banknullable enum The customer’s bank, if provided. Can be one of
abn_
,amro asn_
,bank bunq
,buut
,handelsbanken
,ing
,knab
,moneyou
,n26
,nn
,rabobank
,regiobank
,revolut
,sns_
,bank triodos_
,bank van_
, orlanschot yoursafe
.Possible enum valuesabn_
amro asn_
bank bunq
buut
handelsbanken
ing
knab
moneyou
n26
nn
Show 7 more - last_payment_error.
payment_method. ideal. bicnullable enum The Bank Identifier Code of the customer’s bank, if the bank was provided.
Possible enum valuesABNANL2A
ASNBNL21
BITSNL2A
BUNQNL2A
BUUTNL2A
FVLBNL22
HANDNL2A
INGBNL2A
KNABNL2H
MOYONL21
Show 8 more
- last_payment_error.
payment_method. interac_ presentnullable objectPreview feature If this is an
interac_
PaymentMethod, this hash contains details about the Interac Present payment method.present - last_payment_error.
payment_method. interac_present. brandnullable string Card brand. Can be
interac
,mastercard
orvisa
. - last_payment_error.
payment_method. interac_present. cardholder_ namenullable string The cardholder name as read from the card, in ISO 7813 format. May include alphanumeric characters, special characters and first/last name separator (
/
). In some cases, the cardholder name may not be available depending on how the issuer has configured the card. Cardholder name is typically not available on swipe or contactless payments, such as those made with Apple Pay and Google Pay. - last_payment_error.
payment_method. interac_present. countrynullable string Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you’ve collected.
- last_payment_error.
payment_method. interac_present. descriptionnullable string A high-level description of the type of cards issued in this range.
- last_payment_error.
payment_method. interac_present. exp_ monthinteger Two-digit number representing the card’s expiration month.
- last_payment_error.
payment_method. interac_present. exp_ yearinteger Four-digit number representing the card’s expiration year.
- last_payment_error.
payment_method. interac_present. fingerprintnullable string Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card—one for India and one for the rest of the world.
- last_payment_error.
payment_method. interac_present. fundingnullable string Card funding type. Can be
credit
,debit
,prepaid
, orunknown
. - last_payment_error.
payment_method. interac_present. issuernullable string The name of the card’s issuing bank.
- last_payment_error.
payment_method. interac_present. last4nullable string The last four digits of the card.
- last_payment_error.
payment_method. interac_present. networksnullable object Contains information about card networks that can be used to process the payment.
- last_payment_error.
payment_method. interac_present. networks. availablearray of strings All networks available for selection via payment_method_options.card.network.
- last_payment_error.
payment_method. interac_present. networks. preferrednullable string The preferred network for the card.
- last_payment_error.
payment_method. interac_present. preferred_ localesnullable array of strings The languages that the issuing bank recommends using for localizing any customer-facing text, as read from the card. Referenced from EMV tag 5F2D, data encoded on the card’s chip.
- last_payment_error.
payment_method. interac_present. read_ methodnullable enum How card details were read in this transaction.
Possible enum valuescontact_
emv Inserting a chip card into the card reader.
contactless_
emv Tapping a contactless-enabled chip card or mobile wallet.
contactless_
magstripe_ mode Older standard for contactless payments that emulated a magnetic stripe read.
magnetic_
stripe_ fallback When inserting a chip card fails three times in a row, fallback to a magnetic stripe read.
magnetic_
stripe_ track2 Swiping a card using the magnetic stripe reader.
- last_payment_error.
payment_method. kakao_ paynullable object If this is a
kakao_
PaymentMethod, this hash contains details about the Kakao Pay payment method.pay - last_payment_error.
payment_method. klarnanullable object If this is a
klarna
PaymentMethod, this hash contains details about the Klarna payment method.- last_payment_error.
payment_method. klarna. dobnullable objectExpandable The customer’s date of birth, if provided.
- last_payment_error.
payment_method. klarna. dob. daynullable integer The day of birth, between 1 and 31.
- last_payment_error.
payment_method. klarna. dob. monthnullable integer The month of birth, between 1 and 12.
- last_payment_error.
payment_method. klarna. dob. yearnullable integer The four-digit year of birth.
- last_payment_error.
payment_method. konbininullable object If this is a
konbini
PaymentMethod, this hash contains details about the Konbini payment method. - last_payment_error.
payment_method. kr_ cardnullable object If this is a
kr_
PaymentMethod, this hash contains details about the Korean Card payment method.card - last_payment_error.
payment_method. kr_card. brandnullable enum The local credit or debit card brand.
Possible enum valuesbc
BC
citi
Citi
hana
Hana
hyundai
Hyundai
jeju
Jeju
jeonbuk
Jeonbuk
kakaobank
Kakao Bank
kbank
KBank
kdbbank
KDB Bank
kookmin
Kookmin
Show 12 more - last_payment_error.
payment_method. kr_card. last4nullable string The last four digits of the card. This may not be present for American Express cards.
- last_payment_error.
payment_method. linknullable object If this is an
Link
PaymentMethod, this hash contains details about the Link payment method.- last_payment_error.
payment_method. link. emailnullable string Account owner’s email address.
- last_payment_error.
payment_method. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - last_payment_error.
payment_method. metadatanullable object 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.
- last_payment_error.
payment_method. mobilepaynullable object If this is a
mobilepay
PaymentMethod, this hash contains details about the MobilePay payment method. - last_payment_error.
payment_method. multibanconullable object If this is a
multibanco
PaymentMethod, this hash contains details about the Multibanco payment method. - last_payment_error.
payment_method. nullable object If this is a
naver_
PaymentMethod, this hash contains details about the Naver Pay payment method.pay - last_payment_error.
payment_method. naver_pay. nullable string Uniquely identifies this particular Naver Pay account. You can use this attribute to check whether two Naver Pay accounts are the same.
- last_payment_error.
payment_method. naver_pay. enum Whether to fund this transaction with Naver Pay points or a card.
Possible enum valuescard
Use a card to fund this transaction.
points
Use Naver Pay points to fund this transaction.
- last_payment_error.
payment_method. nz_ bank_ accountnullable object If this is an nz_bank_account PaymentMethod, this hash contains details about the nz_bank_account payment method.
- last_payment_error.
payment_method. nz_bank_account. account_ holder_ namenullable string The name on the bank account. Only present if the account holder name is different from the name of the authorized signatory collected in the PaymentMethod’s billing details.
- last_payment_error.
payment_method. nz_bank_account. bank_ codestring The numeric code for the bank account’s bank.
- last_payment_error.
payment_method. nz_bank_account. bank_ namestring The name of the bank.
- last_payment_error.
payment_method. nz_bank_account. branch_ codestring The numeric code for the bank account’s bank branch.
- last_payment_error.
payment_method. nz_bank_account. last4string Last four digits of the bank account number.
- last_payment_error.
payment_method. nz_bank_account. suffixnullable string The suffix of the bank account number.
- last_payment_error.
payment_method. oxxonullable object If this is an
oxxo
PaymentMethod, this hash contains details about the OXXO payment method. - last_payment_error.
payment_method. p24nullable object If this is a
p24
PaymentMethod, this hash contains details about the P24 payment method.- last_payment_error.
payment_method. p24. banknullable enum The customer’s bank, if provided.
- last_payment_error.
payment_method. pay_ by_ banknullable object If this is a
pay_
PaymentMethod, this hash contains details about the PayByBank payment method.by_ bank - last_payment_error.
payment_method. payconullable object If this is a
payco
PaymentMethod, this hash contains details about the PAYCO payment method. - last_payment_error.
payment_method. paynownullable object If this is a
paynow
PaymentMethod, this hash contains details about the PayNow payment method. - last_payment_error.
payment_method. paypalnullable object If this is a
paypal
PaymentMethod, this hash contains details about the PayPal payment method.- last_payment_error.
payment_method. paypal. countrynullable string Two-letter ISO code representing the buyer’s country. Values are provided by PayPal directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. paypal. payer_ emailnullable string Owner’s email. Values are provided by PayPal directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.
- last_payment_error.
payment_method. paypal. payer_ idnullable string PayPal account PayerID. This identifier uniquely identifies the PayPal customer.
- last_payment_error.
payment_method. pixnullable object If this is a
pix
PaymentMethod, this hash contains details about the Pix payment method. - last_payment_error.
payment_method. promptpaynullable object If this is a
promptpay
PaymentMethod, this hash contains details about the PromptPay payment method. - last_payment_error.
payment_method. radar_ optionsnullable object Options to configure Radar. See Radar Session for more information.
- last_payment_error.
payment_method. radar_options. sessionnullable string A Radar Session is a snapshot of the browser metadata and device details that help Radar make more accurate predictions on your payments.
- last_payment_error.
payment_method. revolut_ paynullable object If this is a
revolut_
PaymentMethod, this hash contains details about the Revolut Pay payment method.pay - last_payment_error.
payment_method. samsung_ paynullable object If this is a
samsung_
PaymentMethod, this hash contains details about the SamsungPay payment method.pay - last_payment_error.
payment_method. satispaynullable object If this is a
satispay
PaymentMethod, this hash contains details about the Satispay payment method. - last_payment_error.
payment_method. sepa_ debitnullable object If this is a
sepa_
PaymentMethod, this hash contains details about the SEPA debit bank account.debit - last_payment_error.
payment_method. sepa_debit. bank_ codenullable string Bank code of bank associated with the bank account.
- last_payment_error.
payment_method. sepa_debit. branch_ codenullable string Branch code of bank associated with the bank account.
- last_payment_error.
payment_method. sepa_debit. countrynullable string Two-letter ISO code representing the country the bank account is located in.
- last_payment_error.
payment_method. sepa_debit. fingerprintnullable string Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
- last_payment_error.
payment_method. sepa_debit. generated_ fromnullable object Information about the object that generated this PaymentMethod.
- last_payment_error.
payment_method. sepa_debit. generated_from. chargenullable stringExpandable The ID of the Charge that generated this PaymentMethod, if any.
- last_payment_error.
payment_method. sepa_debit. generated_from. setup_ attemptnullable stringExpandable The ID of the SetupAttempt that generated this PaymentMethod, if any.
- last_payment_error.
payment_method. sepa_debit. last4nullable string Last four characters of the IBAN.
- last_payment_error.
payment_method. sofortnullable object If this is a
sofort
PaymentMethod, this hash contains details about the SOFORT payment method.- last_payment_error.
payment_method. sofort. countrynullable string Two-letter ISO code representing the country the bank account is located in.
- last_payment_error.
payment_method. swishnullable object If this is a
swish
PaymentMethod, this hash contains details about the Swish payment method. - last_payment_error.
payment_method. twintnullable object If this is a TWINT PaymentMethod, this hash contains details about the TWINT payment method.
- last_payment_error.
payment_method. typeenum The type of the PaymentMethod. An additional hash is included on the PaymentMethod with a name matching this value. It contains additional information specific to the PaymentMethod type.
Possible enum valuesacss_
debit Pre-authorized debit payments are used to debit Canadian bank accounts through the Automated Clearing Settlement System (ACSS).
affirm
Affirm is a buy now, pay later payment method in the US.
afterpay_
clearpay Afterpay / Clearpay is a buy now, pay later payment method used in Australia, Canada, France, New Zealand, Spain, the UK, and the US.
alipay
Alipay is a digital wallet payment method used in China.
alma
Alma is a Buy Now, Pay Later payment method that lets customers pay in 2, 3, or 4 installments.
amazon_
pay Amazon Pay is a Wallet payment method that lets hundreds of millions of Amazon customers pay their way, every day.
au_
becs_ debit BECS Direct Debit is used to debit Australian bank accounts through the Bulk Electronic Clearing System (BECS).
bacs_
debit Bacs Direct Debit is used to debit UK bank accounts.
bancontact
Bancontact is a bank redirect payment method used in Belgium.
billie
Billie is a payment method.
Show 40 more - last_payment_error.
payment_method. us_ bank_ accountnullable object If this is an
us_
PaymentMethod, this hash contains details about the US bank account payment method.bank_ account - last_payment_error.
payment_method. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompany
Account belongs to a company
individual
Account belongs to an individual
- last_payment_error.
payment_method. us_bank_account. account_ typenullable enum Account type: checkings or savings. Defaults to checking if omitted.
Possible enum valueschecking
Bank account type is checking
savings
Bank account type is savings
- last_payment_error.
payment_method. us_bank_account. bank_ namenullable string The name of the bank.
- last_payment_error.
payment_method. us_bank_account. financial_ connections_ accountnullable string The ID of the Financial Connections Account used to create the payment method.
- last_payment_error.
payment_method. us_bank_account. fingerprintnullable string Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.
- last_payment_error.
payment_method. us_bank_account. last4nullable string Last four digits of the bank account number.
- last_payment_error.
payment_method. us_bank_account. networksnullable object Contains information about US bank account networks that can be used.
- last_payment_error.
payment_method. us_bank_account. networks. preferrednullable string The preferred network.
- last_payment_error.
payment_method. us_bank_account. networks. supportedarray of enums All supported networks.
Possible enum valuesach
us_
domestic_ wire
- last_payment_error.
payment_method. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- last_payment_error.
payment_method. us_bank_account. status_ detailsnullable object Contains information about the future reusability of this PaymentMethod.
- last_payment_error.
payment_method. us_bank_account. status_details. blockednullable object Contains more information about the underlying block. This field will only be rendered if the PaymentMethod is blocked.
- last_payment_error.
payment_method. us_bank_account. status_details. blocked. network_ codenullable enum The ACH network code that resulted in this block.
Possible enum valuesR02
Account Closed
R03
No Account, Unable to Locate Account
R04
Invalid Account Number Structure
R05
Unauthorized Debit to Consumer Account Using Corporate SEC Code
R07
Authorization Revoked By Consumer
R08
Payment Stopped
R10
Customer Advises Originator is Not Known to Receiver and/or Originator is Not Authorized by Receiver to Debit Receiver’s Account
R11
Customer Advises Entry Not in Accordance with the Terms of Authorization
R16
Account Frozen, Entry Returned Per OFAC Instructions
R20
Non-Transaction Account
Show 2 more - last_payment_error.
payment_method. us_bank_account. status_details. blocked. reasonnullable enum The reason why this PaymentMethod’s fingerprint has been blocked
Possible enum valuesbank_
account_ closed Bank account has been closed.
bank_
account_ frozen Bank account has been frozen.
bank_
account_ invalid_ details Bank account details are incorrect. Please check the account number, routing number, account holder name, and account type.
bank_
account_ restricted Bank account does not support debits.
bank_
account_ unusable Bank account has been blocked by Stripe. Please contact Support.
debit_
not_ authorized Customer has disputed a previous payment with their bank. If the
network_
is R29, please confirm that Stripe’s Company IDs are allowlisted before attempting additional payments.code
- last_payment_error.
payment_method. wechat_ paynullable object If this is an
wechat_
PaymentMethod, this hash contains details about the wechat_pay payment method.pay - last_payment_error.
payment_method. zipnullable object If this is a
zip
PaymentMethod, this hash contains details about the Zip payment method.
- last_payment_error.
payment_ method_ typenullable string If the error is specific to the type of payment method, the payment method type that had a problem. This field is only populated for invoice-related errors.
- last_payment_error.
sourcenullable object The source object for errors returned on a request involving a source.
- last_payment_error.
source. idstring Unique identifier for the object.
- last_payment_error.
source. objectstring String representing the object’s type. Objects of the same type share the same value.
- last_payment_error.
source. accountnullable stringExpandableAvailable conditionally The account this card belongs to. Only applicable on Accounts (not customers or recipients) This property is only available when returned as an External Account where controller.is_controller is
true
. - last_payment_error.
source. address_ citynullable string City/District/Suburb/Town/Village.
- last_payment_error.
source. address_ countrynullable string Billing address country, if provided when creating card.
- last_payment_error.
source. address_ line1nullable string Address line 1 (Street address/PO Box/Company name).
- last_payment_error.
source. address_ line1_ checknullable string If
address_
was provided, results of the check:line1 pass
,fail
,unavailable
, orunchecked
. - last_payment_error.
source. address_ line2nullable string Address line 2 (Apartment/Suite/Unit/Building).
- last_payment_error.
source. address_ statenullable string State/County/Province/Region.
- last_payment_error.
source. address_ zipnullable string ZIP or postal code.
- last_payment_error.
source. address_ zip_ checknullable string If
address_
was provided, results of the check:zip pass
,fail
,unavailable
, orunchecked
. - last_payment_error.
source. allow_ redisplaynullable enum This field indicates whether this payment method can be shown again to its customer in a checkout flow. Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow. The field defaults to “unspecified”.
Possible enum valuesalways
Use
always
to indicate that this payment method can always be shown to a customer in a checkout flow.limited
Use
limited
to indicate that this payment method can’t always be shown to a customer in a checkout flow. For example, it can only be shown in the context of a specific subscription.unspecified
This is the default value for payment methods where
allow_
wasn’t set.redisplay - last_payment_error.
source. available_ payout_ methodsnullable array of enums A set of available payout methods for this card. Only values from this set should be passed as the
method
when creating a payout.Possible enum valuesinstant
standard
- last_payment_error.
source. brandstring Card brand. Can be
American Express
,Diners Club
,Discover
,Eftpos Australia
,Girocard
,JCB
,MasterCard
,UnionPay
,Visa
, orUnknown
. - last_payment_error.
source. countrynullable string Two-letter ISO code representing the country of the card. You could use this attribute to get a sense of the international breakdown of cards you’ve collected.
- last_payment_error.
source. currencynullable enumAvailable conditionally Three-letter ISO code for currency in lowercase. Must be a supported currency. Only applicable on accounts (not customers or recipients). The card can be used as a transfer destination for funds in this currency. This property is only available when returned as an External Account where controller.is_controller is
true
. - last_payment_error.
source. customernullable stringExpandable The customer that this card belongs to. This attribute will not be in the card object if the card belongs to an account or recipient instead.
- last_payment_error.
source. cvc_ checknullable string If a CVC was provided, results of the check:
pass
,fail
,unavailable
, orunchecked
. A result of unchecked indicates that CVC was provided but hasn’t been checked yet. Checks are typically performed when attaching a card to a Customer object, or when creating a charge. For more details, see Check if a card is valid without a charge. - last_payment_error.
source. dynamic_ last4nullable string (For tokenized numbers only.) The last four digits of the device account number.
- last_payment_error.
source. exp_ monthinteger Two-digit number representing the card’s expiration month.
- last_payment_error.
source. exp_ yearinteger Four-digit number representing the card’s expiration year.
- last_payment_error.
source. fingerprintnullable string Uniquely identifies this particular card number. You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example. For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card—one for India and one for the rest of the world.
- last_payment_error.
source. fundingstring Card funding type. Can be
credit
,debit
,prepaid
, orunknown
. - last_payment_error.
source. iinnullable string Issuer identification number of the card.
- last_payment_error.
source. last4string The last four digits of the card.
- last_payment_error.
source. metadatanullable object 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.
- last_payment_error.
source. namenullable string Cardholder name.
- last_payment_error.
source. regulated_ statusnullable enum Status of a card based on the card issuer.
Possible enum valuesregulated
The card falls under a regulated account range.
unregulated
The card does not fall under a regulated account range.
- last_payment_error.
source. tokenization_ methodnullable string If the card number is tokenized, this is the method that was used. Can be
android_
(includes Google Pay),pay apple_
,pay masterpass
,visa_
, or null.checkout - last_payment_error.
source. walletnullable objectPreview feature If this Card is part of a card wallet, this contains the details of the card wallet.
- last_payment_error.
source. wallet. apple_ paynullable object If this is a
apple_
card wallet, this hash contains details about the wallet.pay - last_payment_error.
source. wallet. typeenum The type of the card wallet, one of
apple_
orpay link
. An additional hash is included on the Wallet subhash with a name matching this value. It contains additional information specific to the card wallet type.Possible enum valuesapple_
pay link
- last_payment_error.
typeenum The type of error returned. One of
api_
,error card_
,error idempotency_
, orerror invalid_
request_ error Possible enum valuesapi_
error card_
error idempotency_
error invalid_
request_ error
- latest_
chargenullable stringExpandable ID of the latest Charge object created by this PaymentIntent. This property is
null
until PaymentIntent confirmation is attempted. - metadataobject
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. Learn more about storing information in metadata.
- next_
actionnullable objectretrievable with publishable key If present, this property tells you what actions you need to take in order for your customer to fulfill a payment using the provided source.
- next_action.
alipay_ handle_ redirectnullable object Contains instructions for authenticating a payment by redirecting your customer to Alipay App or website.
- next_action.
alipay_handle_redirect. native_ datanullable string The native data to be used with Alipay SDK you must redirect your customer to in order to authenticate the payment in an Android App.
- next_action.
alipay_handle_redirect. native_ urlnullable string The native URL you must redirect your customer to in order to authenticate the payment in an iOS App.
- next_action.
alipay_handle_redirect. return_ urlnullable string If the customer does not exit their browser while authenticating, they will be redirected to this specified URL after completion.
- next_action.
alipay_handle_redirect. urlnullable string The URL you must redirect your customer to in order to authenticate the payment.
- next_action.
boleto_ display_ detailsnullable object Contains Boleto details necessary for the customer to complete the payment.
- next_action.
boleto_display_details. expires_ atnullable timestamp The timestamp after which the boleto expires.
- next_action.
boleto_display_details. hosted_ voucher_ urlnullable string The URL to the hosted boleto voucher page, which allows customers to view the boleto voucher.
- next_action.
boleto_display_details. numbernullable string The boleto number.
- next_action.
boleto_display_details. pdfnullable string The URL to the downloadable boleto voucher PDF.
- next_action.
card_ await_ notificationnullable object Contains instructions for processing off session recurring payments with Indian issued cards.
- next_action.
card_await_notification. charge_ attempt_ atnullable timestamp The time that payment will be attempted. If customer approval is required, they need to provide approval before this time.
- next_action.
card_await_notification. customer_ approval_ requirednullable boolean For payments greater than INR 15000, the customer must provide explicit approval of the payment with their bank. For payments of lower amount, no customer action is required.
- next_action.
cashapp_ handle_ redirect_ or_ display_ qr_ codenullable object The field that contains Cash App Pay QR code info
- next_action.
cashapp_handle_redirect_or_display_qr_code. hosted_ instructions_ urlstring The URL to the hosted Cash App Pay instructions page, which allows customers to view the QR code, and supports QR code refreshing on expiration.
- next_action.
cashapp_handle_redirect_or_display_qr_code. mobile_ auth_ urlstring The url for mobile redirect based auth
- next_action.
cashapp_handle_redirect_or_display_qr_code. qr_ codeobject The field that contains CashApp QR code info
- next_action.
cashapp_handle_redirect_or_display_qr_code. qr_code. expires_ attimestamp The date (unix timestamp) when the QR code expires.
- next_action.
cashapp_handle_redirect_or_display_qr_code. qr_code. image_ url_ pngstring The image_url_png string used to render QR code
- next_action.
cashapp_handle_redirect_or_display_qr_code. qr_code. image_ url_ svgstring The image_url_svg string used to render QR code
- next_action.
display_ bank_ transfer_ instructionsnullable object Contains the bank transfer details necessary for the customer to complete the payment.
- next_action.
display_bank_transfer_instructions. amount_ remainingnullable integer The remaining amount that needs to be transferred to complete the payment.
- next_action.
display_bank_transfer_instructions. currencynullable enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- next_action.
display_bank_transfer_instructions. financial_ addressesnullable array of objects A list of financial addresses that can be used to fund the customer balance
- next_action.
display_bank_transfer_instructions. financial_addresses. abanullable object An account and routing number US FinancialAddress
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_ holder_ addressobject The account holder’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_holder_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_holder_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_holder_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_holder_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_holder_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_holder_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_ holder_ namestring The account holder name
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_ numberstring The ABA account number
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. account_ typestring The account type
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_ addressobject The bank’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. bank_ namestring The bank name
- next_action.
display_bank_transfer_instructions. financial_addresses. aba. routing_ numberstring The ABA routing number
- next_action.
display_bank_transfer_instructions. financial_addresses. ibannullable object An IBAN-based FinancialAddress
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_ holder_ addressobject The account holder’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_holder_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_holder_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_holder_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_holder_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_holder_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_holder_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. account_ holder_ namestring The name of the person or business that owns the bank account
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bank_ addressobject The bank’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bank_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bank_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bank_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bank_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bank_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bank_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. bicstring The BIC/SWIFT code of the account.
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. countrystring Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. iban. ibanstring The IBAN of the account.
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_ codenullable object An account number and sort code-based FinancialAddress
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_ holder_ addressobject The account holder’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_holder_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_holder_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_holder_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_holder_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_holder_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_holder_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_ holder_ namestring The name of the person or business that owns the bank account
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. account_ numberstring The account number
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. bank_ addressobject The bank’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. bank_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. bank_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. bank_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. bank_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. bank_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. bank_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. sort_code. sort_ codestring The six-digit sort code
- next_action.
display_bank_transfer_instructions. financial_addresses. speinullable object A SPEI-based FinancialAddress
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_ holder_ addressobject The account holder’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_holder_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_holder_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_holder_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_holder_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_holder_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_holder_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. account_ holder_ namestring The account holder name
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_ addressobject The bank’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_ codestring The three-digit bank code
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. bank_ namestring The short banking institution name
- next_action.
display_bank_transfer_instructions. financial_addresses. spei. clabestring The CLABE number
- next_action.
display_bank_transfer_instructions. financial_addresses. supported_ networksnullable array of enums The payment networks supported by this FinancialAddress
- next_action.
display_bank_transfer_instructions. financial_addresses. swiftnullable object An account and swift code FinancialAddress
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_ holder_ addressobject The account holder’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_holder_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_holder_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_holder_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_holder_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_holder_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_holder_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_ holder_ namestring The account holder name
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_ numberstring The account number
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. account_ typestring The account type
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_ addressobject The bank’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. bank_ namestring The bank name
- next_action.
display_bank_transfer_instructions. financial_addresses. swift. swift_ codestring The SWIFT code
- next_action.
display_bank_transfer_instructions. financial_addresses. typeenum The type of financial address
- next_action.
display_bank_transfer_instructions. financial_addresses. zenginnullable object A Zengin-based FinancialAddress
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_ holder_ addressobject The account holder’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_holder_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_holder_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_holder_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_holder_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_holder_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_holder_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_ holder_ namenullable string The account holder name
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_ numbernullable string The account number
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. account_ typenullable string The bank account type. In Japan, this can only be
futsu
ortoza
. - next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_ addressobject The bank’s physical address
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_address. citynullable string City, district, suburb, town, or village.
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_address. postal_ codenullable string ZIP or postal code.
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_address. statenullable string State, county, province, or region.
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_ codenullable string The bank code of the account
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. bank_ namenullable string The bank name of the account
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. branch_ codenullable string The branch code of the account
- next_action.
display_bank_transfer_instructions. financial_addresses. zengin. branch_ namenullable string The branch name of the account
- next_action.
display_bank_transfer_instructions. hosted_ instructions_ urlnullable string A link to a hosted page that guides your customer through completing the transfer.
- next_action.
display_bank_transfer_instructions. referencenullable string A string identifying this payment. Instruct your customer to include this code in the reference or memo field of their bank transfer.
- next_action.
display_bank_transfer_instructions. typeenum Type of bank transfer
Possible enum valueseu_
bank_ transfer A bank transfer of type eu_bank_transfer
gb_
bank_ transfer A bank transfer of type gb_bank_transfer
jp_
bank_ transfer A bank transfer of type jp_bank_transfer
mx_
bank_ transfer A bank transfer of type mx_bank_transfer
us_
bank_ transfer A bank transfer of type us_bank_transfer
- next_action.
konbini_ display_ detailsnullable object Contains Konbini details necessary for the customer to complete the payment.
- next_action.
konbini_display_details. expires_ attimestamp The timestamp at which the pending Konbini payment expires.
- next_action.
konbini_display_details. hosted_ voucher_ urlnullable string The URL for the Konbini payment instructions page, which allows customers to view and print a Konbini voucher.
- next_action.
konbini_display_details. storesobject Payment instruction details grouped by convenience store chain.
- next_action.
konbini_display_details. stores. familymartnullable object FamilyMart instruction details.
- next_action.
konbini_display_details. stores. familymart. confirmation_ numbernullable string The confirmation number.
- next_action.
konbini_display_details. stores. familymart. payment_ codestring The payment code.
- next_action.
konbini_display_details. stores. lawsonnullable object Lawson instruction details.
- next_action.
konbini_display_details. stores. lawson. confirmation_ numbernullable string The confirmation number.
- next_action.
konbini_display_details. stores. lawson. payment_ codestring The payment code.
- next_action.
konbini_display_details. stores. ministopnullable object Ministop instruction details.
- next_action.
konbini_display_details. stores. ministop. confirmation_ numbernullable string The confirmation number.
- next_action.
konbini_display_details. stores. ministop. payment_ codestring The payment code.
- next_action.
konbini_display_details. stores. seicomartnullable object Seicomart instruction details.
- next_action.
konbini_display_details. stores. seicomart. confirmation_ numbernullable string The confirmation number.
- next_action.
konbini_display_details. stores. seicomart. payment_ codestring The payment code.
- next_action.
multibanco_ display_ detailsnullable object Contains Multibanco details necessary for the customer to complete the payment.
- next_action.
multibanco_display_details. entitynullable string Entity number associated with this Multibanco payment.
- next_action.
multibanco_display_details. expires_ atnullable timestamp The timestamp at which the Multibanco voucher expires.
- next_action.
multibanco_display_details. hosted_ voucher_ urlnullable string The URL for the hosted Multibanco voucher page, which allows customers to view a Multibanco voucher.
- next_action.
multibanco_display_details. referencenullable string Reference number associated with this Multibanco payment.
- next_action.
oxxo_ display_ detailsnullable object Contains OXXO details necessary for the customer to complete the payment.
- next_action.
oxxo_display_details. expires_ afternullable timestamp The timestamp after which the OXXO voucher expires.
- next_action.
oxxo_display_details. hosted_ voucher_ urlnullable string The URL for the hosted OXXO voucher page, which allows customers to view and print an OXXO voucher.
- next_action.
oxxo_display_details. numbernullable string OXXO reference number.
- next_action.
paynow_ display_ qr_ codenullable object The field that contains PayNow QR code info
- next_action.
paynow_display_qr_code. datastring The raw data string used to generate QR code, it should be used together with QR code library.
- next_action.
paynow_display_qr_code. hosted_ instructions_ urlnullable string The URL to the hosted PayNow instructions page, which allows customers to view the PayNow QR code.
- next_action.
paynow_display_qr_code. image_ url_ pngstring The image_url_png string used to render QR code
- next_action.
paynow_display_qr_code. image_ url_ svgstring The image_url_svg string used to render QR code
- next_action.
pix_ display_ qr_ codenullable objectPreview feature The field that contains Pix QR code info
- next_action.
pix_display_qr_code. datastringPreview feature The raw data string used to generate QR code, it should be used together with QR code library.
- next_action.
pix_display_qr_code. expires_ atintegerPreview feature The date (unix timestamp) when the PIX expires.
- next_action.
pix_display_qr_code. hosted_ instructions_ urlstringPreview feature The URL to the hosted pix instructions page, which allows customers to view the pix QR code.
- next_action.
pix_display_qr_code. image_ url_ pngstringPreview feature The image_url_png string used to render png QR code
- next_action.
pix_display_qr_code. image_ url_ svgstringPreview feature The image_url_svg string used to render svg QR code
- next_action.
promptpay_ display_ qr_ codenullable object The field that contains PromptPay QR code info
- next_action.
promptpay_display_qr_code. datastring The raw data string used to generate QR code, it should be used together with QR code library.
- next_action.
promptpay_display_qr_code. hosted_ instructions_ urlstring The URL to the hosted PromptPay instructions page, which allows customers to view the PromptPay QR code.
- next_action.
promptpay_display_qr_code. image_ url_ pngstring The PNG path used to render the QR code, can be used as the source in an HTML img tag
- next_action.
promptpay_display_qr_code. image_ url_ svgstring The SVG path used to render the QR code, can be used as the source in an HTML img tag
- next_action.
redirect_ to_ urlnullable object Contains instructions for authenticating a payment by redirecting your customer to another page or application.
- next_action.
redirect_to_url. return_ urlnullable string If the customer does not exit their browser while authenticating, they will be redirected to this specified URL after completion.
- next_action.
redirect_to_url. urlnullable string The URL you must redirect your customer to in order to authenticate the payment.
- next_action.
swish_ handle_ redirect_ or_ display_ qr_ codenullable object The field that contains Swish QR code and mobile redirect info
- next_action.
swish_handle_redirect_or_display_qr_code. hosted_ instructions_ urlstring The URL to the hosted Swish instructions page, which allows customers to view the QR code.
- next_action.
swish_handle_redirect_or_display_qr_code. qr_ codeobject The field that contains Swish QR code info
- next_action.
swish_handle_redirect_or_display_qr_code. qr_code. datastring The raw data string used to generate QR code, it should be used together with QR code library.
- next_action.
swish_handle_redirect_or_display_qr_code. qr_code. image_ url_ pngstring The image_url_png string used to render QR code
- next_action.
swish_handle_redirect_or_display_qr_code. qr_code. image_ url_ svgstring The image_url_svg string used to render QR code
- next_action.
typestring Type of the next action to perform. Refer to the other child attributes under
next_
for available values. Examples include:action redirect_
,to_ url use_
,stripe_ sdk alipay_
,handle_ redirect oxxo_
, ordisplay_ details verify_
.with_ microdeposits - next_action.
use_ stripe_ sdknullable object When confirming a PaymentIntent with Stripe.js, Stripe.js depends on the contents of this dictionary to invoke authentication flows. The shape of the contents is subject to change and is only intended to be used by Stripe.js.
- next_action.
verify_ with_ microdepositsnullable object Contains details describing microdeposits verification flow.
- next_action.
verify_with_microdeposits. arrival_ datetimestamp The timestamp when the microdeposits are expected to land.
- next_action.
verify_with_microdeposits. hosted_ verification_ urlstring The URL for the hosted verification page, which allows customers to verify their bank account.
- next_action.
verify_with_microdeposits. microdeposit_ typenullable enum The type of the microdeposit sent to the customer. Used to distinguish between different verification methods.
- next_action.
wechat_ pay_ display_ qr_ codenullable object The field that contains WeChat Pay QR code info
- next_action.
wechat_pay_display_qr_code. datastring The data being used to generate QR code
- next_action.
wechat_pay_display_qr_code. hosted_ instructions_ urlstring The URL to the hosted WeChat Pay instructions page, which allows customers to view the WeChat Pay QR code.
- next_action.
wechat_pay_display_qr_code. image_ data_ urlstring The base64 image data for a pre-generated QR code
- next_action.
wechat_pay_display_qr_code. image_ url_ pngstring The image_url_png string used to render QR code
- next_action.
wechat_pay_display_qr_code. image_ url_ svgstring The image_url_svg string used to render QR code
- next_action.
wechat_ pay_ redirect_ to_ android_ appnullable object Info required for android app to app redirect
- next_action.
wechat_pay_redirect_to_android_app. app_ idstring app_id is the APP ID registered on WeChat open platform
- next_action.
wechat_pay_redirect_to_android_app. nonce_ strstring nonce_str is a random string
- next_action.
wechat_pay_redirect_to_android_app. packagestring package is static value
- next_action.
wechat_pay_redirect_to_android_app. partner_ idstring an unique merchant ID assigned by WeChat Pay
- next_action.
wechat_pay_redirect_to_android_app. prepay_ idstring an unique trading ID assigned by WeChat Pay
- next_action.
wechat_pay_redirect_to_android_app. signstring A signature
- next_action.
wechat_pay_redirect_to_android_app. timestampstring Specifies the current time in epoch format
- next_action.
wechat_ pay_ redirect_ to_ ios_ appnullable object Info required for iOS app to app redirect
- next_action.
wechat_pay_redirect_to_ios_app. native_ urlstring An universal link that redirect to WeChat Pay app
- payment_
methodnullable stringExpandableretrievable with publishable key ID of the payment method used in this PaymentIntent.
- receipt_
emailnullable stringretrievable with publishable key Email address that the receipt for the resulting payment will be sent to. If
receipt_
is specified for a payment in live mode, a receipt will be sent regardless of your email settings.email - setup_
future_ usagenullable enumretrievable with publishable key Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesoff_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - shippingnullable objectretrievable with publishable key
Shipping information for this PaymentIntent.
- shipping.
addressobject Shipping address.
- shipping.
address. citynullable string City, district, suburb, town, or village.
- shipping.
address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- shipping.
address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- shipping.
address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- shipping.
address. postal_ codenullable string ZIP or postal code.
- shipping.
address. statenullable string State, county, province, or region.
- shipping.
carriernullable string The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
- shipping.
namestring Recipient name.
- shipping.
phonenullable string Recipient phone (including extension).
- shipping.
tracking_ numbernullable string The tracking number for a physical product, obtained from the delivery service. If multiple tracking numbers were generated for this purchase, please separate them with commas.
- statement_
descriptornullable string Text that appears on the customer’s statement as the statement descriptor for a non-card charge. This value overrides the account’s default statement descriptor. For information about requirements, including the 22-character limit, see the Statement Descriptor docs.
Setting this value for a card charge returns an error. For card charges, set the statement_descriptor_suffix instead.
- statement_
descriptor_ suffixnullable string Provides information about a card charge. Concatenated to the account’s statement descriptor prefix to form the complete statement descriptor that appears on the customer’s statement.
- statusenumretrievable with publishable key
Status of this PaymentIntent, one of
requires_
,payment_ method requires_
,confirmation requires_
,action processing
,requires_
,capture canceled
, orsucceeded
. Read more about each PaymentIntent status.Possible enum valuescanceled
processing
requires_
action requires_
capture requires_
confirmation requires_
payment_ method succeeded
More attributes
- objectstringretrievable with publishable key
String representing the object’s type. Objects of the same type share the same value.
- amount_
capturableinteger Amount that can be captured from this PaymentIntent.
- amount_
detailsnullable object Provides industry-specific information about the amount.
- amount_details.
tipnullable object Portion of the amount that corresponds to a tip.
- amount_details.
tip. amountnullable integer Portion of the amount that corresponds to a tip.
- amount_
receivedinteger Amount that this PaymentIntent collects.
- applicationnullable stringExpandableConnect only
ID of the Connect application that created the PaymentIntent.
- application_
fee_ amountnullable integerConnect only 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 amount captured. For more information, see the PaymentIntents use case for connected accounts.
- canceled_
atnullable timestampretrievable with publishable key Populated when
status
iscanceled
, this is the time at which the PaymentIntent was canceled. Measured in seconds since the Unix epoch. - cancellation_
reasonnullable enumretrievable with publishable key Reason for cancellation of this PaymentIntent, either user-provided (
duplicate
,fraudulent
,requested_
, orby_ customer abandoned
) or generated by Stripe internally (failed_
,invoice void_
,invoice automatic
, orexpired
).Possible enum valuesabandoned
automatic
duplicate
expired
failed_
invoice fraudulent
requested_
by_ customer void_
invoice - capture_
methodenumretrievable with publishable key Controls when the funds will be captured from the customer’s account.
Possible enum valuesautomatic
Stripe automatically captures funds when the customer authorizes the payment.
automatic_
async (Default) Stripe asynchronously captures funds when the customer authorizes the payment. Recommended over
capture_
due to improved latency. Read the integration guide for more information.method=automatic manual
Place a hold on the funds when the customer authorizes the payment, but don’t capture the funds until later. (Not all payment methods support this.)
- confirmation_
methodenumretrievable with publishable key Describes whether we can confirm this PaymentIntent automatically, or if it requires customer action to confirm the payment.
Possible enum valuesautomatic
(Default) PaymentIntent can be confirmed using a publishable key. After
next_
s are handled, no additional confirmation is required to complete the payment.action manual
All payment attempts must be made using a secret key. The PaymentIntent returns to the
requires_
state after handlingconfirmation next_
s, and requires your server to initiate each payment attempt with an explicit confirmation.action - createdtimestampretrievable with publishable key
Time at which the object was created. Measured in seconds since the Unix epoch.
- excluded_
payment_ method_ typesnullable array of enums The list of payment method types to exclude from use with this payment.
Possible enum valuesacss_
debit Pre-authorized debit payments are used to debit Canadian bank accounts through the Automated Clearing Settlement System (ACSS).
affirm
Affirm is a buy now, pay later payment method in the US.
afterpay_
clearpay Afterpay / Clearpay is a buy now, pay later payment method used in Australia, Canada, France, New Zealand, Spain, the UK, and the US.
alipay
Alipay is a digital wallet payment method used in China.
alma
Alma is a Buy Now, Pay Later payment method that lets customers pay in 2, 3, or 4 installments.
amazon_
pay Amazon Pay is a Wallet payment method that lets hundreds of millions of Amazon customers pay their way, every day.
au_
becs_ debit BECS Direct Debit is used to debit Australian bank accounts through the Bulk Electronic Clearing System (BECS).
bacs_
debit Bacs Direct Debit is used to debit UK bank accounts.
bancontact
Bancontact is a bank redirect payment method used in Belgium.
billie
Billie is a payment method.
Show 39 more - livemodebooleanretrievable with publishable key
Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - on_
behalf_ ofnullable stringExpandableConnect only The account (if any) for which the funds of the PaymentIntent are intended. See the PaymentIntents use case for connected accounts for details.
- payment_
method_ configuration_ detailsnullable object Information about the payment method configuration used for this PaymentIntent.
- payment_method_configuration_details.
idstring ID of the payment method configuration used.
- payment_method_configuration_details.
parentnullable string ID of the parent payment method configuration used.
- payment_
method_ optionsnullable object Payment-method-specific configuration for this PaymentIntent.
- payment_method_options.
acss_ debitnullable object If the PaymentIntent’s payment_method_types includes
acss_
, this hash contains the configurations that will be applied to each payment attempt of that type.debit - payment_method_options.
acss_debit. mandate_ optionsnullable object Additional fields for Mandate creation
- payment_method_options.
acss_debit. mandate_options. custom_ mandate_ urlnullable string A URL for custom mandate text
- payment_method_options.
acss_debit. mandate_options. interval_ descriptionnullable string Description of the interval. Only required if the ‘payment_schedule’ parameter is ‘interval’ or ‘combined’.
- payment_method_options.
acss_debit. mandate_options. payment_ schedulenullable enum Payment schedule for the mandate.
Possible enum valuescombined
Payments can be initiated at a pre-defined interval or sporadically
interval
Payments are initiated at a regular pre-defined interval
sporadic
Payments are initiated sporadically
- payment_method_options.
acss_debit. mandate_options. transaction_ typenullable enum Transaction type of the mandate.
Possible enum valuesbusiness
Transactions are made for business reasons
personal
Transactions are made for personal reasons
- payment_method_options.
acss_debit. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - payment_method_options.
acss_debit. target_ datenullable string Controls when Stripe will attempt to debit the funds from the customer’s account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
- payment_method_options.
acss_debit. verification_ methodnullable enum Bank account verification method.
Possible enum valuesautomatic
Instant verification with fallback to microdeposits.
instant
Instant verification.
microdeposits
Verification using microdeposits.
- payment_method_options.
affirmnullable object If the PaymentIntent’s payment_method_types includes
affirm
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
affirm. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
affirm. preferred_ localenullable string Preferred language of the Affirm authorization page that the customer is redirected to.
- payment_method_options.
affirm. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
afterpay_ clearpaynullable object If the PaymentIntent’s payment_method_types includes
afterpay_
, this hash contains the configurations that will be applied to each payment attempt of that type.clearpay - payment_method_options.
afterpay_clearpay. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
afterpay_clearpay. referencenullable string An internal identifier or reference that this payment corresponds to. You must limit the identifier to 128 characters, and it can only contain letters, numbers, underscores, backslashes, and dashes. This field differs from the statement descriptor and item name.
- payment_method_options.
afterpay_clearpay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
alipaynullable object If the PaymentIntent’s payment_method_types includes
alipay
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
alipay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
almanullable object If the PaymentIntent’s payment_method_types includes
alma
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
alma. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method
- payment_method_options.
amazon_ paynullable object If the PaymentIntent’s payment_method_types includes
amazon_
, this hash contains the configurations that will be applied to each payment attempt of that type.pay - payment_method_options.
amazon_pay. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
amazon_pay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
au_ becs_ debitnullable object If the PaymentIntent’s payment_method_types includes
au_
, this hash contains the configurations that will be applied to each payment attempt of that type.becs_ debit - payment_method_options.
au_becs_debit. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - payment_method_options.
au_becs_debit. target_ datenullable string Controls when Stripe will attempt to debit the funds from the customer’s account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
- payment_method_options.
bacs_ debitnullable object If the PaymentIntent’s payment_method_types includes
bacs_
, this hash contains the configurations that will be applied to each payment attempt of that type.debit - payment_method_options.
bacs_debit. mandate_ optionsnullable object Additional fields for Mandate creation
- payment_method_options.
bacs_debit. mandate_options. reference_ prefixnullable stringPreview feature Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: ‘/’, ‘_’, ‘-’, ‘&’, ‘.’. Cannot begin with ‘DDIC’ or ‘STRIPE’.
- payment_method_options.
bacs_debit. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - payment_method_options.
bacs_debit. target_ datenullable string Controls when Stripe will attempt to debit the funds from the customer’s account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
- payment_method_options.
bancontactnullable object If the PaymentIntent’s payment_method_types includes
bancontact
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
bancontact. preferred_ languageenum Preferred language of the Bancontact authorization page that the customer is redirected to.
Possible enum valuesde
en
fr
nl
- payment_method_options.
bancontact. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
billienullable object If the PaymentIntent’s payment_method_types includes
billie
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
billie. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method
- payment_method_options.
bliknullable object If the PaymentIntent’s payment_method_types includes
blik
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
blik. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
boletonullable object If the PaymentIntent’s payment_method_types includes
boleto
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
boleto. expires_ after_ daysinteger The number of calendar days before a Boleto voucher expires. For example, if you create a Boleto voucher on Monday and you set expires_after_days to 2, the Boleto voucher will expire on Wednesday at 23:59 America/Sao_Paulo time.
- payment_method_options.
boleto. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session
- payment_method_options.
cardnullable object If the PaymentIntent’s payment_method_types includes
card
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
card. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
card. installmentsnullable object Installment details for this payment.
For more information, see the installments integration guide.
- payment_method_options.
card. installments. available_ plansnullable array of objects Installment plans that may be selected for this PaymentIntent.
- payment_method_options.
card. installments. available_plans. countnullable integer For
fixed_
installment plans, this is the number of installment payments your customer will make to their credit card.count - payment_method_options.
card. installments. available_plans. intervalnullable enum For
fixed_
installment plans, this is the interval between installment payments your customer will make to their credit card. One ofcount month
.Possible enum valuesmonth
- payment_method_options.
card. installments. available_plans. typeenum Type of installment plan, one of
fixed_
,count bonus
, orrevolving
.Possible enum valuesbonus
An installment plan used in Japan, where the customer defers payment to a later date that aligns with their salary bonus.
fixed_
count An installment plan where the number of installment payments is fixed and known at the time of purchase.
revolving
An installment plan used in Japan, where the customer pays a certain amount each month, and the remaining balance rolls over to the next month.
- payment_method_options.
card. installments. enabledboolean Whether Installments are enabled for this PaymentIntent.
- payment_method_options.
card. installments. plannullable object Installment plan selected for this PaymentIntent.
- payment_method_options.
card. installments. plan. countnullable integer For
fixed_
installment plans, this is the number of installment payments your customer will make to their credit card.count - payment_method_options.
card. installments. plan. intervalnullable enum For
fixed_
installment plans, this is the interval between installment payments your customer will make to their credit card. One ofcount month
.Possible enum valuesmonth
- payment_method_options.
card. installments. plan. typeenum Type of installment plan, one of
fixed_
,count bonus
, orrevolving
.Possible enum valuesbonus
An installment plan used in Japan, where the customer defers payment to a later date that aligns with their salary bonus.
fixed_
count An installment plan where the number of installment payments is fixed and known at the time of purchase.
revolving
An installment plan used in Japan, where the customer pays a certain amount each month, and the remaining balance rolls over to the next month.
- payment_method_options.
card. mandate_ optionsnullable object Configuration options for setting up an eMandate for cards issued in India.
- payment_method_options.
card. mandate_options. amountinteger Amount to be charged for future payments.
- payment_method_options.
card. mandate_options. amount_ typeenum One of
fixed
ormaximum
. Iffixed
, theamount
param refers to the exact amount to be charged in future payments. Ifmaximum
, the amount charged can be up to the value passed for theamount
param.Possible enum valuesfixed
maximum
- payment_method_options.
card. mandate_options. descriptionnullable string A description of the mandate or subscription that is meant to be displayed to the customer.
- payment_method_options.
card. mandate_options. end_ datenullable timestamp End date of the mandate or subscription. If not provided, the mandate will be active until canceled. If provided, end date should be after start date.
- payment_method_options.
card. mandate_options. intervalenum Specifies payment frequency. One of
day
,week
,month
,year
, orsporadic
.Possible enum valuesday
month
sporadic
week
year
- payment_method_options.
card. mandate_options. interval_ countnullable integer The number of intervals between payments. For example,
interval=month
andinterval_
indicates one payment every three months. Maximum of one year interval allowed (1 year, 12 months, or 52 weeks). This parameter is optional whencount=3 interval=sporadic
. - payment_method_options.
card. mandate_options. referencestring Unique identifier for the mandate or subscription.
- payment_method_options.
card. mandate_options. start_ datetimestamp Start date of the mandate or subscription. Start date should not be lesser than yesterday.
- payment_method_options.
card. mandate_options. supported_ typesnullable array of enums Specifies the type of mandates supported. Possible values are
india
.Possible enum valuesindia
- payment_method_options.
card. networknullable enum Selected network to process this payment intent on. Depends on the available networks of the card attached to the payment intent. Can be only set confirm-time.
Possible enum valuesamex
cartes_
bancaires diners
discover
eftpos_
au girocard
interac
jcb
link
mastercard
Show 3 more - payment_method_options.
card. nullable enum Request ability to capture beyond the standard authorization validity window for this PaymentIntent.
Possible enum valuesif_
available Use
if_
if you want to extend the capture window when eligible for extended authorization.available never
Use
never
if you don’t want to extend the capture window. - payment_method_options.
card. nullable enum Request ability to increment the authorization for this PaymentIntent.
Possible enum valuesif_
available Use
if_
if you want to increment the authorization on the PaymentIntent when eligible.available never
Use
never
if you don’t want to increment the authorization on the PaymentIntent. - payment_method_options.
card. request_ multicapturenullable enum Request ability to make multiple captures for this PaymentIntent.
Possible enum valuesif_
available Use
if_
if you want to use multicapture when eligible.available never
Use
never
if you don’t want to use multicapture. - payment_method_options.
card. request_ overcapturenullable enum Request ability to overcapture for this PaymentIntent.
Possible enum valuesif_
available Use
if_
if you want to overcapture the payment when eligible.available never
Use
never
if you don’t want to overcapture the payment. - payment_method_options.
card. request_ three_ d_ securenullable enumadvanced We strongly recommend that you rely on our SCA Engine to automatically prompt your customers for authentication based on risk level and other requirements. However, if you wish to request 3D Secure based on logic from your own fraud engine, provide this option. If not provided, this value defaults to
automatic
. Read our guide on manually requesting 3D Secure for more information on how this configuration interacts with Radar and our SCA Engine.Possible enum valuesany
Use
any
to manually request 3DS with a preference for africtionless
flow, increasing the likelihood of the authentication being completed without any additional input from the customer. 3DS will always be attempted if it is supported for the card, but Stripe can’t guarantee your preference because the issuer determines the ultimate authentication flow. To learn more about 3DS flows, read our guide.automatic
(Default) Our SCA Engine automatically prompts your customers for authentication based on risk level and other requirements.
challenge
Use
challenge
to request 3DS with a preference for achallenge
flow, where the customer must respond to a prompt for active authentication. Stripe can’t guarantee your preference because the issuer determines the ultimate authentication flow. To learn more about 3DS flows, read our guide. - payment_method_options.
card. require_ cvc_ recollectionnullable boolean When enabled, using a card that is attached to a customer will require the CVC to be provided again (i.e. using the cvc_token parameter).
- payment_method_options.
card. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - payment_method_options.
card. statement_ descriptor_ suffix_ kananullable string Provides information about a card payment that customers see on their statements. Concatenated with the Kana prefix (shortened Kana descriptor) or Kana statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 22 characters. On card statements, the concatenation of both prefix and suffix (including separators) will appear truncated to 22 characters.
- payment_method_options.
card. statement_ descriptor_ suffix_ kanjinullable string Provides information about a card payment that customers see on their statements. Concatenated with the Kanji prefix (shortened Kanji descriptor) or Kanji statement descriptor that’s set on the account to form the complete statement descriptor. Maximum 17 characters. On card statements, the concatenation of both prefix and suffix (including separators) will appear truncated to 17 characters.
- payment_method_options.
card_ presentnullable object If the PaymentIntent’s payment_method_types includes
card_
, this hash contains the configurations that will be applied to each payment attempt of that type.present - payment_method_options.
card_present. capture_ methodnullable enumPreview feature Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method manual_
preferred Use
manual_
if you preferpreferred manual
capture_method but support falling back toautomatic
based on the presented payment method. - payment_method_options.
card_present. nullable boolean Request ability to capture this payment beyond the standard authorization validity window
- payment_method_options.
card_present. nullable boolean Request ability to increment this PaymentIntent if the combination of MCC and card brand is eligible. Check incremental_authorization_supported in the Confirm response to verify support.
- payment_method_options.
card_present. routingnullable object Network routing priority on co-branded EMV cards supporting domestic debit and international card schemes.
- payment_method_options.
card_present. routing. requested_ prioritynullable enum Requested routing priority
Possible enum valuesdomestic
Prioritize domestic debit network routing on payment method collection
international
Prioritize international network routing on payment method collection
- payment_method_options.
cashappnullable object If the PaymentIntent’s payment_method_types includes
cashapp
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
cashapp. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
cashapp. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session
- payment_method_options.
cryptonullable object If the PaymentIntent’s payment_method_types includes
crypto
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
crypto. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
customer_ balancenullable object If the PaymentIntent’s payment_method_types includes
customer_
, this hash contains the configurations that will be applied to each payment attempt of that type.balance - payment_method_options.
customer_balance. bank_ transfernullable object Configuration for the bank transfer funding type, if the
funding_
is set totype bank_
.transfer - payment_method_options.
customer_balance. bank_transfer. eu_ bank_ transfernullable object Configuration for eu_bank_transfer
- payment_method_options.
customer_balance. bank_transfer. eu_bank_transfer. countryenum The desired country code of the bank account information. Permitted values include:
BE
,DE
,ES
,FR
,IE
, orNL
.Possible enum valuesBE
DE
ES
FR
IE
NL
- payment_method_options.
customer_balance. bank_transfer. requested_ address_ typesnullable array of enums List of address types that should be returned in the financial_addresses response. If not specified, all valid types will be returned.
Permitted values include:
sort_
,code zengin
,iban
, orspei
.Possible enum valuesaba
aba bank account address type
iban
iban bank account address type
sepa
sepa bank account address type
sort_
code sort_code bank account address type
spei
spei bank account address type
swift
swift bank account address type
zengin
zengin bank account address type
- payment_method_options.
customer_balance. bank_transfer. typenullable enum The bank transfer type that this PaymentIntent is allowed to use for funding Permitted values include:
eu_
,bank_ transfer gb_
,bank_ transfer jp_
,bank_ transfer mx_
, orbank_ transfer us_
.bank_ transfer Possible enum valueseu_
bank_ transfer A bank transfer of type eu_bank_transfer
gb_
bank_ transfer A bank transfer of type gb_bank_transfer
jp_
bank_ transfer A bank transfer of type jp_bank_transfer
mx_
bank_ transfer A bank transfer of type mx_bank_transfer
us_
bank_ transfer A bank transfer of type us_bank_transfer
- payment_method_options.
customer_balance. funding_ typenullable enum The funding method type to be used when there are not enough funds in the customer balance. Permitted values include:
bank_
.transfer Possible enum valuesbank_
transfer - payment_method_options.
customer_balance. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
epsnullable object If the PaymentIntent’s payment_method_types includes
eps
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
eps. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
fpxnullable object If the PaymentIntent’s payment_method_types includes
fpx
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
fpx. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
giropaynullable object If the PaymentIntent’s payment_method_types includes
giropay
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
giropay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
grabpaynullable object If the PaymentIntent’s payment_method_types includes
grabpay
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
grabpay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
idealnullable object If the PaymentIntent’s payment_method_types includes
ideal
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
ideal. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
interac_ presentnullable objectPreview feature If the PaymentIntent’s payment_method_types includes
interac_
, this hash contains the configurations that will be applied to each payment attempt of that type.present - payment_method_options.
kakao_ paynullable object If the PaymentIntent’s payment_method_types includes
kakao_
, this hash contains the configurations that will be applied to each payment attempt of that type.pay - payment_method_options.
kakao_pay. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
kakao_pay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
klarnanullable object If the PaymentIntent’s payment_method_types includes
klarna
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
klarna. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
klarna. preferred_ localenullable string Preferred locale of the Klarna checkout page that the customer is redirected to.
- payment_method_options.
klarna. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session
- payment_method_options.
konbininullable object If the PaymentIntent’s payment_method_types includes
konbini
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
konbini. confirmation_ numbernullable string An optional 10 to 11 digit numeric-only string determining the confirmation code at applicable convenience stores.
- payment_method_options.
konbini. expires_ after_ daysnullable integer The number of calendar days (between 1 and 60) after which Konbini payment instructions will expire. For example, if a PaymentIntent is confirmed with Konbini and
expires_
set to 2 on Monday JST, the instructions will expire on Wednesday 23:59:59 JST.after_ days - payment_method_options.
konbini. expires_ atnullable timestamp The timestamp at which the Konbini payment instructions will expire. Only one of
expires_
orafter_ days expires_
may be set.at - payment_method_options.
konbini. product_ descriptionnullable string A product descriptor of up to 22 characters, which will appear to customers at the convenience store.
- payment_method_options.
konbini. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
kr_ cardnullable object If the PaymentIntent’s payment_method_types includes
kr_
, this hash contains the configurations that will be applied to each payment attempt of that type.card - payment_method_options.
kr_card. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
kr_card. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
linknullable object If the PaymentIntent’s payment_method_types includes
link
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
link. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
link. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
mobilepaynullable object If the PaymentIntent’s payment_method_types includes
mobilepay
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
mobilepay. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
mobilepay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
multibanconullable object If the PaymentIntent’s payment_method_types includes
multibanco
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
multibanco. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
nullable object If the PaymentIntent’s payment_method_types includes
naver_
, this hash contains the configurations that will be applied to each payment attempt of that type.pay - payment_method_options.
naver_pay. nullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
naver_pay. nullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
nz_ bank_ accountnullable object If the PaymentIntent’s payment_method_types includes
nz_
, this hash contains the configurations that will be applied to each payment attempt of that type.bank_ account - payment_method_options.
nz_bank_account. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - payment_method_options.
nz_bank_account. target_ datenullable string Controls when Stripe will attempt to debit the funds from the customer’s account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
- payment_method_options.
oxxonullable object If the PaymentIntent’s payment_method_types includes
oxxo
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
oxxo. expires_ after_ daysinteger The number of calendar days before an OXXO invoice expires. For example, if you create an OXXO invoice on Monday and you set expires_after_days to 2, the OXXO invoice will expire on Wednesday at 23:59 America/Mexico_City time.
- payment_method_options.
oxxo. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
p24nullable object If the PaymentIntent’s payment_method_types includes
p24
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
p24. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
pay_ by_ banknullable object If the PaymentIntent’s payment_method_types includes
pay_
, this hash contains the configurations that will be applied to each payment attempt of that type.by_ bank - payment_method_options.
payconullable object If the PaymentIntent’s payment_method_types includes
payco
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
payco. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method
- payment_method_options.
paynownullable object If the PaymentIntent’s payment_method_types includes
paynow
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
paynow. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
paypalnullable object If the PaymentIntent’s payment_method_types includes
paypal
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
paypal. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
paypal. preferred_ localenullable string Preferred locale of the PayPal checkout page that the customer is redirected to.
- payment_method_options.
paypal. referencenullable string A reference of the PayPal transaction visible to customer which is mapped to PayPal’s invoice ID. This must be a globally unique ID if you have configured in your PayPal settings to block multiple payments per invoice ID.
- payment_method_options.
paypal. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
pixnullable object If the PaymentIntent’s payment_method_types includes
pix
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
pix. amount_ includes_ iofnullable enum Determines if the amount includes the IOF tax.
Possible enum valuesalways
The IOF tax is included in the amount.
never
The IOF tax is not included in the amount.
- payment_method_options.
pix. expires_ after_ secondsnullable integer The number of seconds (between 10 and 1209600) after which Pix payment will expire.
- payment_method_options.
pix. expires_ atnullable integer The timestamp at which the Pix expires.
- payment_method_options.
pix. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
promptpaynullable object If the PaymentIntent’s payment_method_types includes
promptpay
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
promptpay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
revolut_ paynullable object If the PaymentIntent’s payment_method_types includes
revolut_
, this hash contains the configurations that will be applied to each payment attempt of that type.pay - payment_method_options.
revolut_pay. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method - payment_method_options.
revolut_pay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
samsung_ paynullable object If the PaymentIntent’s payment_method_types includes
samsung_
, this hash contains the configurations that will be applied to each payment attempt of that type.pay - payment_method_options.
samsung_pay. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method
- payment_method_options.
satispaynullable object If the PaymentIntent’s payment_method_types includes
satispay
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
satispay. capture_ methodnullable enum Controls when the funds will be captured from the customer’s account.
Possible enum valuesmanual
Use
manual
if you intend to place the funds on hold and want to override the top-levelcapture_
value for this payment method.method
- payment_method_options.
sepa_ debitnullable object If the PaymentIntent’s payment_method_types includes
sepa_
, this hash contains the configurations that will be applied to each payment attempt of that type.debit - payment_method_options.
sepa_debit. mandate_ optionsnullable object Additional fields for Mandate creation
- payment_method_options.
sepa_debit. mandate_options. reference_ prefixnullable stringPreview feature Prefix used to generate the Mandate reference. Must be at most 12 characters long. Must consist of only uppercase letters, numbers, spaces, or the following special characters: ‘/’, ‘_’, ‘-’, ‘&’, ‘.’. Cannot begin with ‘STRIPE’.
- payment_method_options.
sepa_debit. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - payment_method_options.
sepa_debit. target_ datenullable string Controls when Stripe will attempt to debit the funds from the customer’s account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
- payment_method_options.
sofortnullable object If the PaymentIntent’s payment_method_types includes
sofort
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
sofort. preferred_ languagenullable enum Preferred language of the SOFORT authorization page that the customer is redirected to.
Possible enum valuesde
en
es
fr
it
nl
pl
- payment_method_options.
sofort. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session
- payment_method_options.
swishnullable object If the PaymentIntent’s payment_method_types includes
swish
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
swish. referencenullable string A reference for this payment to be displayed in the Swish app.
- payment_method_options.
swish. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
twintnullable object If the PaymentIntent’s payment_method_types includes
twint
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
twint. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
us_ bank_ accountnullable object If the PaymentIntent’s payment_method_types includes
us_
, this hash contains the configurations that will be applied to each payment attempt of that type.bank_ account - payment_method_options.
us_bank_account. financial_ connectionsnullable object Additional fields for Financial Connections Session creation
- payment_method_options.
us_bank_account. financial_connections. filtersnullable object Filter the list of accounts that are allowed to be linked.
- payment_method_options.
us_bank_account. financial_connections. filters. account_ subcategoriesnullable array of enums The account subcategories to use to filter for possible accounts to link. Valid subcategories are
checking
andsavings
.Possible enum valueschecking
Bank account subcategory is checking
savings
Bank account subcategory is savings
- payment_method_options.
us_bank_account. financial_connections. permissionsnullable array of enums The list of permissions to request. The
payment_
permission must be included.method Possible enum valuesbalances
Allows accessing balance data from the account.
ownership
Allows accessing ownership data from the account.
payment_
method Allows the creation of a payment method from the account.
transactions
Allows accessing transactions data from the account.
- payment_method_options.
us_bank_account. financial_connections. prefetchnullable array of enums Data features requested to be retrieved upon account creation.
Possible enum valuesbalances
Requests to prefetch balance data on accounts collected in this session.
ownership
Requests to prefetch ownership data on accounts collected in this session.
transactions
Requests to prefetch transaction data on accounts collected in this session.
- payment_method_options.
us_bank_account. financial_connections. return_ urlnullable string For webview integrations only. Upon completing OAuth login in the native browser, the user will be redirected to this URL to return to your app.
- payment_method_options.
us_bank_account. mandate_ optionsnullable object Additional fields for Mandate creation
- payment_method_options.
us_bank_account. mandate_options. collection_ methodnullable enum Mandate collection method
Possible enum valuespaper
Mandate customer acceptance was collected using a paper document
- payment_method_options.
us_bank_account. preferred_ settlement_ speednullable enum Preferred transaction settlement speed
- payment_method_options.
us_bank_account. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage off_
session Use
off_
if your customer may or may not be present in your checkout flow.session on_
session Use
on_
if you intend to only reuse the payment method when your customer is present in your checkout flow.session - payment_method_options.
us_bank_account. target_ datenullable string Controls when Stripe will attempt to debit the funds from the customer’s account. The date must be a string in YYYY-MM-DD format. The date must be in the future and between 3 and 15 calendar days from now.
- payment_method_options.
us_bank_account. verification_ methodnullable enum Bank account verification method.
Possible enum valuesautomatic
Instant verification with fallback to microdeposits.
instant
Instant verification only.
microdeposits
Verification using microdeposits. Cannot be used with Stripe Checkout, Hosted Invoices, or Payment Element.
- payment_method_options.
wechat_ paynullable object If the PaymentIntent’s payment_method_types includes
wechat_
, this hash contains the configurations that will be applied to each payment attempt of that type.pay - payment_method_options.
wechat_pay. app_ idnullable string The app ID registered with WeChat Pay. Only required when client is ios or android.
- payment_method_options.
wechat_pay. clientnullable enum The client type that the end customer will pay from
Possible enum valuesandroid
The end customer will pay from an Android app
ios
The end customer will pay from an iOS app
web
The end customer will pay from web browser
- payment_method_options.
wechat_pay. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_method_options.
zipnullable object If the PaymentIntent’s payment_method_types includes
zip
, this hash contains the configurations that will be applied to each payment attempt of that type.- payment_method_options.
zip. setup_ future_ usagenullable enum Indicates that you intend to make future payments with this PaymentIntent’s payment method.
If you provide a Customer with the PaymentIntent, you can use this parameter to attach the payment method to the Customer after the PaymentIntent is confirmed and the customer completes any required actions. If you don’t provide a Customer, you can still attach the payment method to a Customer after the transaction completes.
If the payment method is
card_
and isn’t a digital wallet, Stripe creates and attaches a generated_card payment method representing the card to the Customer instead.present When processing card payments, Stripe uses
setup_
to help you comply with regional legislation and network rules, such as SCA.future_ usage Possible enum valuesnone
Use
none
if you do not intend to reuse this payment method and want to override the top-levelsetup_
value for this payment method.future_ usage
- payment_
method_ typesarray of stringsretrievable with publishable key The list of payment method types (e.g. card) that this PaymentIntent is allowed to use. A comprehensive list of valid payment method types can be found here.
- presentment_
detailsnullable object A hash containing information about the currency presentation to the customer, including the displayed currency and amount used for conversion from the integration currency.
- presentment_details.
presentment_ amountinteger Amount intended to be collected by this payment, denominated in
presentment_
.currency - presentment_details.
presentment_ currencystring Currency presented to the customer during payment.
- processingnullable objectretrievable with publishable key
If present, this property tells you about the processing state of the payment.
- processing.
cardnullable object If the PaymentIntent’s payment_method_types includes
card
, this hash contains the details on theprocessing
state of the payment.- processing.
card. customer_ notificationnullable object For recurring payments of Indian cards, this hash contains details on whether customer approval is required, and until when the payment will be in
processing
state- processing.
card. customer_notification. approval_ requestednullable boolean Whether customer approval has been requested for this payment. For payments greater than INR 15000 or mandate amount, the customer must provide explicit approval of the payment with their bank.
- processing.
card. customer_notification. completes_ atnullable timestamp If customer approval is required, they need to provide approval before this time.
- processing.
typeenum Type of the payment method for which payment is in
processing
state, one ofcard
.Possible enum valuescard
- reviewnullable stringExpandable
ID of the review associated with this PaymentIntent, if any.
- transfer_
datanullable objectConnect only The data that automatically creates a Transfer after the payment finalizes. Learn more about the use case for connected accounts.
- transfer_data.
amountnullable integer The amount transferred to the destination account. This transfer will occur automatically after the payment succeeds. If no amount is specified, by default the entire payment amount is transferred to the destination account. The amount must be less than or equal to the amount, and must be a positive integer representing how much to transfer in the smallest currency unit (e.g., 100 cents to charge $1.00).
- transfer_data.
destinationstringExpandable The account (if any) that the payment is attributed to for tax reporting, and where funds from the payment are transferred to after payment success.
- transfer_
groupnullable stringConnect only A string that identifies the resulting payment as part of a group. Learn more about the use case for connected accounts.
{ "id": "pi_3MtwBwLkdIwHu7ix28a3tqPa", "object": "payment_intent", "amount": 2000, "amount_capturable": 0, "amount_details": { "tip": {} }, "amount_received": 0, "application": null, "application_fee_amount": null, "automatic_payment_methods": { "enabled": true }, "canceled_at": null, "cancellation_reason": null, "capture_method": "automatic", "client_secret": "pi_3MtwBwLkdIwHu7ix28a3tqPa_secret_YrKJUKribcBjcG8HVhfZluoGH", "confirmation_method": "automatic", "created": 1680800504, "currency": "usd", "customer": null, "description": null, "last_payment_error": null, "latest_charge": null, "livemode": false, "metadata": {}, "next_action": null, "on_behalf_of": null, "payment_method": null, "payment_method_options": { "card": { "installments": null, "mandate_options": null, "network": null, "request_three_d_secure": "automatic" }, "link": { "persistent_token": null } }, "payment_method_types": [ "card", "link" ], "processing": null, "receipt_email": null, "review": null, "setup_future_usage": null, "shipping": null, "source": null, "statement_descriptor": null, "statement_descriptor_suffix": null, "status": "requires_payment_method", "transfer_data": null, "transfer_group": null}