The SetupAttempt object

Core Resources

Setup Attempts

Attributes

idstring
Unique identifier for the object.

objectstring
String representing the object’s type. Objects of the same type share the same value.

applicationnullable stringExpandable
The value of application on the SetupIntent at the time of this confirmation.

attach_to_selfnullable boolean
If present, the SetupIntent’s payment method will be attached to the in-context Stripe Account.
It can only be used for this Stripe Account’s own money movement flows like InboundTransfer and OutboundTransfers. It cannot be set to true when setting up a PaymentMethod for a Customer, and defaults to false when attaching a PaymentMethod to a Customer.

createdtimestampretrievable with publishable key
Time at which the object was created. Measured in seconds since the Unix epoch.

customernullable stringExpandable
The value of customer on the SetupIntent at the time of this confirmation.

flow_directionsnullable array of enums
Indicates the directions of money movement for which this payment method is intended to be used.
Include inbound if you intend to use the payment method as the origin to pull funds from. Include outbound if you intend to use the payment method as the destination to send funds to. You can include both if you intend to use the payment method for both purposes.
Possible enum values
inbound
outbound

livemodebooleanretrievable with publishable key
Has the value true if the object exists in live mode or the value false if the object exists in test mode.

on_behalf_ofnullable stringExpandable
The value of on_behalf_of on the SetupIntent at the time of this confirmation.

payment_methodstringExpandableretrievable with publishable key
ID of the payment method used with this SetupAttempt.

payment_method_detailsobject

Details about the payment method at the time of SetupIntent confirmation.

payment_method_details.acss_debitobject
If this is a acss_debit payment method, this hash contains confirmation-specific information for the acss_debit payment method.

payment_method_details.amazon_payobject
If this is a amazon_pay payment method, this hash contains confirmation-specific information for the amazon_pay payment method.

payment_method_details.au_becs_debitobject
If this is a au_becs_debit payment method, this hash contains confirmation-specific information for the au_becs_debit payment method.

payment_method_details.bacs_debitobject
If this is a bacs_debit payment method, this hash contains confirmation-specific information for the bacs_debit payment method.

payment_method_details.bancontactobject
If this is a bancontact payment method, this hash contains confirmation-specific information for the bancontact payment method.
- payment_method_details.bancontact.bank_codenullable string
  Bank code of bank associated with the bank account.
- payment_method_details.bancontact.bank_namenullable string
  Name of the bank associated with the bank account.
- payment_method_details.bancontact.bicnullable string
  Bank Identifier Code of the bank associated with the bank account.
- payment_method_details.bancontact.generated_sepa_debitnullable stringExpandable
  The ID of the SEPA Direct Debit PaymentMethod which was generated by this SetupAttempt.
- payment_method_details.bancontact.generated_sepa_debit_mandatenullable stringExpandable
  The mandate for the SEPA Direct Debit PaymentMethod which was generated by this SetupAttempt.
- payment_method_details.bancontact.iban_last4nullable string
  Last four characters of the IBAN.
- payment_method_details.bancontact.preferred_languagenullable enum
  Preferred language of the Bancontact authorization page that the customer is redirected to. Can be one of en, de, fr, or nl
  Possible enum values
  de
  en
  fr
  nl
- payment_method_details.bancontact.verified_namenullable string
  Owner’s verified full name. Values are verified or provided by Bancontact directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.

payment_method_details.boletoobject
If this is a boleto payment method, this hash contains confirmation-specific information for the boleto payment method.

payment_method_details.cardobject

If this is a card payment method, this hash contains confirmation-specific information for the card payment method.

payment_method_details.card.brandnullable string
Card brand. Can be amex, diners, discover, eftpos_au, jcb, mastercard, unionpay, visa, or unknown.

payment_method_details.card.checksnullable object
Check results by Card networks on Card address and CVC at the time of authorization
- payment_method_details.card.checks.address_line1_checknullable string
  If a address line1 was provided, results of the check, one of pass, fail, unavailable, or unchecked.
- payment_method_details.card.checks.address_postal_code_checknullable string
  If a address postal code was provided, results of the check, one of pass, fail, unavailable, or unchecked.
- payment_method_details.card.checks.cvc_checknullable string
  If a CVC was provided, results of the check, one of pass, fail, unavailable, or unchecked.

payment_method_details.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.

payment_method_details.card.exp_monthnullable integer
Two-digit number representing the card’s expiration month.

payment_method_details.card.exp_yearnullable integer
Four-digit number representing the card’s expiration year.

payment_method_details.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.

payment_method_details.card.fundingnullable string
Card funding type. Can be credit, debit, prepaid, or unknown.

payment_method_details.card.last4nullable string
The last four digits of the card.

payment_method_details.card.networknullable string
Identifies which network this charge was processed on. Can be amex, cartes_bancaires, diners, discover, eftpos_au, interac, jcb, mastercard, unionpay, visa, or unknown.

payment_method_details.card.three_d_securenullable object

Populated if this authorization used 3D Secure authentication.

payment_method_details.card.three_d_secure.authentication_flownullable enum
For authenticated transactions: how the customer was authenticated by the issuing bank.
Possible enum values
challenge
The issuing bank authenticated the customer by presenting a traditional challenge window.
frictionless
The issuing bank authenticated the customer via the 3DS2 frictionless flow.

payment_method_details.card.three_d_secure.electronic_commerce_indicatornullable enum

The Electronic Commerce Indicator (ECI). A protocol-level field indicating what degree of authentication was performed.

Possible enum values

01

Mastercard variant: Attempt acknowledged.

02

Mastercard variant: Fully authenticated.

05

Fully authenticated. The customer likely proved their identity to the issuing bank.

06

Attempt acknowledged. The customer, or the entire issuing bank, is not set up for 3D Secure. Or the issuing bank is experiencing an outage.

Mastercard variant: Acquirer SCA exemption.

07

Mastercard variant: Fully authenticated recurring transaction.

payment_method_details.card.three_d_secure.resultnullable enum

Indicates the outcome of 3D Secure authentication.

Possible enum values

attempt_acknowledged

The issuing bank does not support 3D Secure, has not set up 3D Secure for the card, or is experiencing an outage. No authentication was performed, but the card network has provided proof of the attempt.

In most cases the attempt qualifies for liability shift and it is safe to make a charge.

authenticated

3D Secure authentication succeeded.

exempted

A 3D Secure exemption has been applied to this transaction. Exemption may be requested for a number of reasons including merchant initiation, low value, or low risk.

failed

The customer failed 3D Secure authentication.

not_supported

3D Secure authentication cannot be run on this card. Liability will generally not be shifted to the issuer.

processing_error

The issuing bank’s 3D Secure system is temporarily unavailable and the card network is unable to provide proof of the attempt. Liability will generally not be shifted to the issuer.

payment_method_details.card.three_d_secure.result_reasonnullable enum

Additional information about why 3D Secure succeeded or failed based on the result.

Possible enum values

abandoned

For failed. The transaction timed out: the cardholder dropped off before completing authentication.

bypassed

For processing_error. Stripe bypassed 3D Secure because the issuing bank’s web-facing server was returning errors or timeouts to customers in the challenge window.

canceled

For failed. The cardholder canceled authentication (where possible to identify).

card_not_enrolled

For not_supported. The issuing bank does not support 3D Secure or has not set up 3D Secure for the card, and the card network did not provide proof of the attempt.

This occurs when running 3D Secure on certain kinds of prepaid cards and in rare cases where the issuing bank is exempt from the requirement to support 3D Secure.

network_not_supported

For not_supported. Stripe does not support 3D Secure on this card network.

protocol_error

For processing_error. An invalid message was received from the card network or issuing bank. (Includes “downgrades” and similar errors).

rejected

For failed. The cardholder was redirected back from the issuing bank without completing authentication.

payment_method_details.card.three_d_secure.transaction_idnullable string
The 3D Secure 1 XID or 3D Secure 2 Directory Server Transaction ID (dsTransId) for this payment.

payment_method_details.card.three_d_secure.versionnullable enum
The version of 3D Secure that was used.

payment_method_details.card.walletnullable object
If this Card is part of a card wallet, this contains the details of the card wallet.
- payment_method_details.card.wallet.apple_paynullable object
  If this is a apple_pay card wallet, this hash contains details about the wallet.
  payment_method_details.card.wallet.apple_pay.typeenumPreview feature
  Type of the apple_pay transaction, one of apple_pay or apple_pay_later.
  Possible enum values
  apple_pay
  apple_pay_later
- payment_method_details.card.wallet.google_paynullable object
  If this is a google_pay card wallet, this hash contains details about the wallet.
- payment_method_details.card.wallet.typeenum
  The type of the card wallet, one of apple_pay, google_pay, or 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 values
  apple_pay
  google_pay
  link

payment_method_details.card_presentobject
If this is a card_present payment method, this hash contains confirmation-specific information for the card_present payment method.
- payment_method_details.card_present.generated_cardnullable stringExpandable
  The ID of the Card PaymentMethod which was generated by this SetupAttempt.
- payment_method_details.card_present.offlinenullable object
  Details about payments collected offline.
  payment_method_details.card_present.offline.stored_atnullable timestamp
  Time at which the payment was collected while offline
  payment_method_details.card_present.offline.typenullable enum
  The method used to process this payment method offline. Only deferred is allowed.
  Possible enum values
  deferred

payment_method_details.cashappobject
If this is a cashapp payment method, this hash contains confirmation-specific information for the cashapp payment method.

payment_method_details.idealobject
If this is a ideal payment method, this hash contains confirmation-specific information for the ideal payment method.
- payment_method_details.ideal.banknullable enum
  The customer’s bank. Can be one of abn_amro, asn_bank, bunq, handelsbanken, ing, knab, moneyou, n26, nn, rabobank, regiobank, revolut, sns_bank, triodos_bank, van_lanschot, or yoursafe.
  Possible enum values
  abn_amro
  asn_bank
  bunq
  handelsbanken
  ing
  knab
  moneyou
  n26
  nn
  rabobank
  Show 6 more
- payment_method_details.ideal.bicnullable enum
  The Bank Identifier Code of the customer’s bank.
  Possible enum values
  ABNANL2A
  ASNBNL21
  BITSNL2A
  BUNQNL2A
  FVLBNL22
  HANDNL2A
  INGBNL2A
  KNABNL2H
  MOYONL21
  NNBANL2G
  Show 7 more
- payment_method_details.ideal.generated_sepa_debitnullable stringExpandable
  The ID of the SEPA Direct Debit PaymentMethod which was generated by this SetupAttempt.
- payment_method_details.ideal.generated_sepa_debit_mandatenullable stringExpandable
  The mandate for the SEPA Direct Debit PaymentMethod which was generated by this SetupAttempt.
- payment_method_details.ideal.iban_last4nullable string
  Last four characters of the IBAN.
- payment_method_details.ideal.verified_namenullable string
  Owner’s verified full name. Values are verified or provided by iDEAL directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.

payment_method_details.kakao_payobject
If this is a kakao_pay payment method, this hash contains confirmation-specific information for the kakao_pay payment method.

payment_method_details.klarnaobject
If this is a klarna payment method, this hash contains confirmation-specific information for the klarna payment method.

payment_method_details.kr_cardobject
If this is a kr_card payment method, this hash contains confirmation-specific information for the kr_card payment method.

payment_method_details.linkobject
If this is a link payment method, this hash contains confirmation-specific information for the link payment method.

payment_method_details.nz_bank_accountobjectPreview feature
If this is a nz_bank_account payment method, this hash contains confirmation-specific information for the nz_bank_account payment method.

payment_method_details.paypalobject
If this is a paypal payment method, this hash contains confirmation-specific information for the paypal payment method.

payment_method_details.revolut_payobject
If this is a revolut_pay payment method, this hash contains confirmation-specific information for the revolut_pay payment method.

payment_method_details.sepa_debitobject
If this is a sepa_debit payment method, this hash contains confirmation-specific information for the sepa_debit payment method.

payment_method_details.sofortobject
If this is a sofort payment method, this hash contains confirmation-specific information for the sofort payment method.
- payment_method_details.sofort.bank_codenullable string
  Bank code of bank associated with the bank account.
- payment_method_details.sofort.bank_namenullable string
  Name of the bank associated with the bank account.
- payment_method_details.sofort.bicnullable string
  Bank Identifier Code of the bank associated with the bank account.
- payment_method_details.sofort.generated_sepa_debitnullable stringExpandable
  The ID of the SEPA Direct Debit PaymentMethod which was generated by this SetupAttempt.
- payment_method_details.sofort.generated_sepa_debit_mandatenullable stringExpandable
  The mandate for the SEPA Direct Debit PaymentMethod which was generated by this SetupAttempt.
- payment_method_details.sofort.iban_last4nullable string
  Last four characters of the IBAN.
- payment_method_details.sofort.preferred_languagenullable enum
  Preferred language of the Sofort authorization page that the customer is redirected to. Can be one of en, de, fr, or nl
  Possible enum values
  de
  en
  fr
  nl
- payment_method_details.sofort.verified_namenullable string
  Owner’s verified full name. Values are verified or provided by Sofort directly (if supported) at the time of authorization or settlement. They cannot be set or mutated.

payment_method_details.typestring
The type of the payment method used in the SetupIntent (e.g., card). An additional hash is included on payment_method_details with a name matching this value. It contains confirmation-specific information for the payment method.

payment_method_details.us_bank_accountobject
If this is a us_bank_account payment method, this hash contains confirmation-specific information for the us_bank_account payment method.

setup_errornullable object

The error encountered during this attempt to confirm the SetupIntent, if any.

setup_error.codenullable string
For some errors that could be handled programmatically, a short string indicating the error code reported.

setup_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.

setup_error.doc_urlnullable string
A URL to more information about the error code reported.

setup_error.messagenullable string
A human-readable message providing more details about the error. For card errors, these messages can be shown to your users.

setup_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.

setup_error.payment_methodnullable object

The PaymentMethod object for errors returned on a request involving a PaymentMethod.

setup_error.payment_method.idstring
Unique identifier for the object.

setup_error.payment_method.objectstring
String representing the object’s type. Objects of the same type share the same value.

setup_error.payment_method.acss_debitnullable object
If this is an acss_debit PaymentMethod, this hash contains details about the ACSS Debit payment method.
- setup_error.payment_method.acss_debit.bank_namenullable string
  Name of the bank associated with the bank account.
- setup_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.
- setup_error.payment_method.acss_debit.institution_numbernullable string
  Institution number of the bank account.
- setup_error.payment_method.acss_debit.last4nullable string
  Last four digits of the bank account number.
- setup_error.payment_method.acss_debit.transit_numbernullable string
  Transit number of the bank account.

setup_error.payment_method.affirmnullable object
If this is an affirm PaymentMethod, this hash contains details about the Affirm payment method.

setup_error.payment_method.afterpay_clearpaynullable object
If this is an AfterpayClearpay PaymentMethod, this hash contains details about the AfterpayClearpay payment method.

setup_error.payment_method.alipaynullable object
If this is an Alipay PaymentMethod, this hash contains details about the Alipay payment method.

setup_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 values

always

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_redisplay wasn’t set.

setup_error.payment_method.almanullable object
If this is a Alma PaymentMethod, this hash contains details about the Alma payment method.

setup_error.payment_method.amazon_paynullable object
If this is a AmazonPay PaymentMethod, this hash contains details about the AmazonPay payment method.

setup_error.payment_method.au_becs_debitnullable object
If this is an au_becs_debit PaymentMethod, this hash contains details about the bank account.
- setup_error.payment_method.au_becs_debit.bsb_numbernullable string
  Six-digit number identifying bank and branch associated with this bank account.
- setup_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.
- setup_error.payment_method.au_becs_debit.last4nullable string
  Last four digits of the bank account number.

setup_error.payment_method.bacs_debitnullable object
If this is a bacs_debit PaymentMethod, this hash contains details about the Bacs Direct Debit bank account.
- setup_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.
- setup_error.payment_method.bacs_debit.last4nullable string
  Last four digits of the bank account number.
- setup_error.payment_method.bacs_debit.sort_codenullable string
  Sort code of the bank account. (e.g., 10-20-30)

setup_error.payment_method.bancontactnullable object
If this is a bancontact PaymentMethod, this hash contains details about the Bancontact payment method.

setup_error.payment_method.billing_detailsobject
Billing information associated with the PaymentMethod that may be used or required by particular types of payment methods.
- setup_error.payment_method.billing_details.addressnullable object
  Billing address.
  setup_error.payment_method.billing_details.address.citynullable string
  City, district, suburb, town, or village.
  setup_error.payment_method.billing_details.address.countrynullable string
  Two-letter country code (ISO 3166-1 alpha-2).
  setup_error.payment_method.billing_details.address.line1nullable string
  Address line 1 (e.g., street, PO Box, or company name).
  setup_error.payment_method.billing_details.address.line2nullable string
  Address line 2 (e.g., apartment, suite, unit, or building).
  setup_error.payment_method.billing_details.address.postal_codenullable string
  ZIP or postal code.
  setup_error.payment_method.billing_details.address.statenullable string
  State, county, province, or region.
- setup_error.payment_method.billing_details.emailnullable string
  Email address.
- setup_error.payment_method.billing_details.namenullable string
  Full name.
- setup_error.payment_method.billing_details.phonenullable string
  Billing phone number (including extension).

setup_error.payment_method.bliknullable object
If this is a blik PaymentMethod, this hash contains details about the BLIK payment method.

setup_error.payment_method.boletonullable object
If this is a boleto PaymentMethod, this hash contains details about the Boleto payment method.
- setup_error.payment_method.boleto.tax_idstring
  Uniquely identifies the customer tax id (CNPJ or CPF)

setup_error.payment_method.cardnullable object

If this is a card PaymentMethod, this hash contains the user’s card details.

setup_error.payment_method.card.brandstring
Card brand. Can be amex, diners, discover, eftpos_au, jcb, mastercard, unionpay, visa, or unknown.

setup_error.payment_method.card.checksnullable object
Checks on Card address and CVC if provided.
- setup_error.payment_method.card.checks.address_line1_checknullable string
  If a address line1 was provided, results of the check, one of pass, fail, unavailable, or unchecked.
- setup_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, or unchecked.
- setup_error.payment_method.card.checks.cvc_checknullable string
  If a CVC was provided, results of the check, one of pass, fail, unavailable, or unchecked.

setup_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.

setup_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, or other and may contain more values in the future.

setup_error.payment_method.card.exp_monthinteger
Two-digit number representing the card’s expiration month.

setup_error.payment_method.card.exp_yearinteger
Four-digit number representing the card’s expiration year.

setup_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.

setup_error.payment_method.card.fundingstring
Card funding type. Can be credit, debit, prepaid, or unknown.

setup_error.payment_method.card.generated_fromnullable object

Details of the original PaymentMethod that created this object.

setup_error.payment_method.card.generated_from.chargenullable string
The charge that created this object.

setup_error.payment_method.card.generated_from.payment_method_detailsnullable object

Transaction-specific details of the payment method used in the payment.

setup_error.payment_method.card.generated_from.payment_method_details.card_presentnullable object

This hash contains the snapshot of the card_present transaction-specific details which generated this card payment method.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.amount_authorizednullable integer
The authorized amount

setup_error.payment_method.card.generated_from.payment_method_details.card_present.brandnullable string
Card brand. Can be amex, diners, discover, eftpos_au, jcb, mastercard, unionpay, visa, or unknown.

setup_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.

setup_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.

setup_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.

setup_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.

setup_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.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.emv_auth_datanullable string
Authorization response cryptogram.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.exp_monthinteger
Two-digit number representing the card’s expiration month.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.exp_yearinteger
Four-digit number representing the card’s expiration year.

setup_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.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.fundingnullable string
Card funding type. Can be credit, debit, prepaid, or unknown.

setup_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.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.incremental_authorization_supportedboolean
Whether this PaymentIntent is eligible for incremental authorizations. Request support using request_incremental_authorization_support.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.issuernullable string
The name of the card’s issuing bank.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.last4nullable string
The last four digits of the card.

setup_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, mastercard, unionpay, visa, or unknown.

setup_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. The first three digits of the Trace ID is the Financial Network Code, the next 6 digits is the Banknet Reference Number, and the last 4 digits represent the date (MM/DD). This field will be available for successful Visa, Mastercard, or American Express transactions and always null for other card brands.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.offlinenullable object
Details about payments collected offline.
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.offline.stored_atnullable timestamp
  Time at which the payment was collected while offline
- setup_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 values
  deferred

setup_error.payment_method.card.generated_from.payment_method_details.card_present.overcapture_supportedboolean
Defines whether the authorized amount can be over-captured or not

setup_error.payment_method.card.generated_from.payment_method_details.card_present.preferred_localesnullable array of strings
EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.

setup_error.payment_method.card.generated_from.payment_method_details.card_present.read_methodnullable enum

How card details were read in this transaction.

Possible enum values

contact_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.

setup_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.
- setup_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 values
  checking
  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
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.receipt.application_cryptogramnullable string
  EMV tag 9F26, cryptogram generated by the integrated circuit chip.
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.receipt.application_preferred_namenullable string
  Mnenomic of the Application Identifier.
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.receipt.authorization_codenullable string
  Identifier for this transaction.
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.receipt.authorization_response_codenullable string
  EMV tag 8A. A code returned by the card issuer.
- setup_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_pin, or signature.
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.receipt.dedicated_file_namenullable string
  EMV tag 84. Similar to the application identifier stored on the integrated circuit chip.
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.receipt.terminal_verification_resultsnullable string
  The outcome of a series of EMV functions performed by the card reader.
- setup_error.payment_method.card.generated_from.payment_method_details.card_present.receipt.transaction_status_informationnullable string
  An indication of various EMV functions performed during the transaction.

setup_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.

setup_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_pay, or unknown.

Possible enum values

apple_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.

setup_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. Always card_present.

setup_error.payment_method.card.generated_from.setup_attemptnullable stringExpandable
The ID of the SetupAttempt that generated this PaymentMethod, if any.

setup_error.payment_method.card.last4string
The last four digits of the card.

setup_error.payment_method.card.networksnullable object
Contains information about card networks that can be used to process the payment.
- setup_error.payment_method.card.networks.availablearray of strings
  All available networks for the card.
- setup_error.payment_method.card.networks.preferrednullable string
  The preferred network for co-branded cards. Can be cartes_bancaires, mastercard, visa or invalid_preference if requested network is not valid for the card.

setup_error.payment_method.card.three_d_secure_usagenullable object
Contains details on how this Card may be used for 3D Secure authentication.
- setup_error.payment_method.card.three_d_secure_usage.supportedboolean
  Whether 3D Secure is supported on this card.

setup_error.payment_method.card.walletnullable object
If this Card is part of a card wallet, this contains the details of the card wallet.
- setup_error.payment_method.card.wallet.amex_express_checkoutnullable object
  If this is a amex_express_checkout card wallet, this hash contains details about the wallet.
- setup_error.payment_method.card.wallet.apple_paynullable object
  If this is a apple_pay card wallet, this hash contains details about the wallet.
- setup_error.payment_method.card.wallet.dynamic_last4nullable string
  (For tokenized numbers only.) The last four digits of the device account number.
- setup_error.payment_method.card.wallet.google_paynullable object
  If this is a google_pay card wallet, this hash contains details about the wallet.
- setup_error.payment_method.card.wallet.linknullable object
  If this is a link card wallet, this hash contains details about the wallet.
- setup_error.payment_method.card.wallet.masterpassnullable object
  If this is a masterpass card wallet, this hash contains details about the wallet.
  setup_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.
  setup_error.payment_method.card.wallet.masterpass.billing_address.citynullable string
  City, district, suburb, town, or village.
  setup_error.payment_method.card.wallet.masterpass.billing_address.countrynullable string
  Two-letter country code (ISO 3166-1 alpha-2).
  setup_error.payment_method.card.wallet.masterpass.billing_address.line1nullable string
  Address line 1 (e.g., street, PO Box, or company name).
  setup_error.payment_method.card.wallet.masterpass.billing_address.line2nullable string
  Address line 2 (e.g., apartment, suite, unit, or building).
  setup_error.payment_method.card.wallet.masterpass.billing_address.postal_codenullable string
  ZIP or postal code.
  setup_error.payment_method.card.wallet.masterpass.billing_address.statenullable string
  State, county, province, or region.
  setup_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.
  setup_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.
  setup_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.
  setup_error.payment_method.card.wallet.masterpass.shipping_address.citynullable string
  City, district, suburb, town, or village.
  setup_error.payment_method.card.wallet.masterpass.shipping_address.countrynullable string
  Two-letter country code (ISO 3166-1 alpha-2).
  setup_error.payment_method.card.wallet.masterpass.shipping_address.line1nullable string
  Address line 1 (e.g., street, PO Box, or company name).
  setup_error.payment_method.card.wallet.masterpass.shipping_address.line2nullable string
  Address line 2 (e.g., apartment, suite, unit, or building).
  setup_error.payment_method.card.wallet.masterpass.shipping_address.postal_codenullable string
  ZIP or postal code.
  setup_error.payment_method.card.wallet.masterpass.shipping_address.statenullable string
  State, county, province, or region.
- setup_error.payment_method.card.wallet.samsung_paynullable object
  If this is a samsung_pay card wallet, this hash contains details about the wallet.
- setup_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_checkout, or 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 values
  amex_express_checkout
  apple_pay
  google_pay
  link
  masterpass
  samsung_pay
  visa_checkout
- setup_error.payment_method.card.wallet.visa_checkoutnullable object
  If this is a visa_checkout card wallet, this hash contains details about the wallet.
  setup_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.
  setup_error.payment_method.card.wallet.visa_checkout.billing_address.citynullable string
  City, district, suburb, town, or village.
  setup_error.payment_method.card.wallet.visa_checkout.billing_address.countrynullable string
  Two-letter country code (ISO 3166-1 alpha-2).
  setup_error.payment_method.card.wallet.visa_checkout.billing_address.line1nullable string
  Address line 1 (e.g., street, PO Box, or company name).
  setup_error.payment_method.card.wallet.visa_checkout.billing_address.line2nullable string
  Address line 2 (e.g., apartment, suite, unit, or building).
  setup_error.payment_method.card.wallet.visa_checkout.billing_address.postal_codenullable string
  ZIP or postal code.
  setup_error.payment_method.card.wallet.visa_checkout.billing_address.statenullable string
  State, county, province, or region.
  setup_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.
  setup_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.
  setup_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.
  setup_error.payment_method.card.wallet.visa_checkout.shipping_address.citynullable string
  City, district, suburb, town, or village.
  setup_error.payment_method.card.wallet.visa_checkout.shipping_address.countrynullable string
  Two-letter country code (ISO 3166-1 alpha-2).
  setup_error.payment_method.card.wallet.visa_checkout.shipping_address.line1nullable string
  Address line 1 (e.g., street, PO Box, or company name).
  setup_error.payment_method.card.wallet.visa_checkout.shipping_address.line2nullable string
  Address line 2 (e.g., apartment, suite, unit, or building).
  setup_error.payment_method.card.wallet.visa_checkout.shipping_address.postal_codenullable string
  ZIP or postal code.
  setup_error.payment_method.card.wallet.visa_checkout.shipping_address.statenullable string
  State, county, province, or region.

setup_error.payment_method.card_presentnullable object

If this is a card_present PaymentMethod, this hash contains details about the Card Present payment method.

setup_error.payment_method.card_present.brandnullable string
Card brand. Can be amex, diners, discover, eftpos_au, jcb, mastercard, unionpay, visa, or unknown.

setup_error.payment_method.card_present.brand_productnullable string
The product code that identifies the specific program or product associated with a card.

setup_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.

setup_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.

setup_error.payment_method.card_present.descriptionnullable string
A high-level description of the type of cards issued in this range.

setup_error.payment_method.card_present.exp_monthinteger
Two-digit number representing the card’s expiration month.

setup_error.payment_method.card_present.exp_yearinteger
Four-digit number representing the card’s expiration year.

setup_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.

setup_error.payment_method.card_present.fundingnullable string
Card funding type. Can be credit, debit, prepaid, or unknown.

setup_error.payment_method.card_present.issuernullable string
The name of the card’s issuing bank.

setup_error.payment_method.card_present.last4nullable string
The last four digits of the card.

setup_error.payment_method.card_present.networksnullable object
Contains information about card networks that can be used to process the payment.
- setup_error.payment_method.card_present.networks.availablearray of strings
  All available networks for the card.
- setup_error.payment_method.card_present.networks.preferrednullable string
  The preferred network for the card.

setup_error.payment_method.card_present.offlinenullable object
Details about payment methods collected offline.
- setup_error.payment_method.card_present.offline.stored_atnullable timestamp
  Time at which the payment was collected while offline
- setup_error.payment_method.card_present.offline.typenullable enum
  The method used to process this payment method offline. Only deferred is allowed.
  Possible enum values
  deferred

setup_error.payment_method.card_present.preferred_localesnullable array of strings
EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.

setup_error.payment_method.card_present.read_methodnullable enum

How card details were read in this transaction.

Possible enum values

contact_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.

setup_error.payment_method.card_present.walletnullable object

If a mobile wallet was presented in the transaction, this contains the details of the mobile wallet.

setup_error.payment_method.card_present.wallet.typeenum

The type of mobile wallet, one of apple_pay, google_pay, samsung_pay, or unknown.

Possible enum values

apple_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.

setup_error.payment_method.cashappnullable object
If this is a cashapp PaymentMethod, this hash contains details about the Cash App Pay payment method.
- setup_error.payment_method.cashapp.buyer_idnullable string
  A unique and immutable identifier assigned by Cash App to every buyer.
- setup_error.payment_method.cashapp.cashtagnullable string
  A public identifier for buyers using Cash App.

setup_error.payment_method.createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.

setup_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.

setup_error.payment_method.customer_balancenullable object
If this is a customer_balance PaymentMethod, this hash contains details about the CustomerBalance payment method.

setup_error.payment_method.epsnullable object

If this is an eps PaymentMethod, this hash contains details about the EPS payment method.

setup_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_ag, or vr_bank_braunau.

Possible enum values

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

Show 18 more

setup_error.payment_method.fpxnullable object
If this is an fpx PaymentMethod, this hash contains details about the FPX payment method.
- setup_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_enterprise, or bank_of_china.
  Possible enum values
  affin_bank
  agrobank
  alliance_bank
  ambank
  bank_islam
  bank_muamalat
  bank_of_china
  bank_rakyat
  bsn
  cimb
  Show 12 more

setup_error.payment_method.giropaynullable object
If this is a giropay PaymentMethod, this hash contains details about the Giropay payment method.

setup_error.payment_method.grabpaynullable object
If this is a grabpay PaymentMethod, this hash contains details about the GrabPay payment method.

setup_error.payment_method.idealnullable object
If this is an ideal PaymentMethod, this hash contains details about the iDEAL payment method.
- setup_error.payment_method.ideal.banknullable enum
  The customer’s bank, if provided. Can be one of abn_amro, asn_bank, bunq, handelsbanken, ing, knab, moneyou, n26, nn, rabobank, regiobank, revolut, sns_bank, triodos_bank, van_lanschot, or yoursafe.
  Possible enum values
  abn_amro
  asn_bank
  bunq
  handelsbanken
  ing
  knab
  moneyou
  n26
  nn
  rabobank
  Show 6 more
- setup_error.payment_method.ideal.bicnullable enum
  The Bank Identifier Code of the customer’s bank, if the bank was provided.
  Possible enum values
  ABNANL2A
  ASNBNL21
  BITSNL2A
  BUNQNL2A
  FVLBNL22
  HANDNL2A
  INGBNL2A
  KNABNL2H
  MOYONL21
  NNBANL2G
  Show 7 more

setup_error.payment_method.interac_presentnullable objectPreview feature

If this is an interac_present PaymentMethod, this hash contains details about the Interac Present payment method.

setup_error.payment_method.interac_present.brandnullable string
Card brand. Can be interac, mastercard or visa.

setup_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.

setup_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.

setup_error.payment_method.interac_present.descriptionnullable string
A high-level description of the type of cards issued in this range.

setup_error.payment_method.interac_present.exp_monthinteger
Two-digit number representing the card’s expiration month.

setup_error.payment_method.interac_present.exp_yearinteger
Four-digit number representing the card’s expiration year.

setup_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.

setup_error.payment_method.interac_present.fundingnullable string
Card funding type. Can be credit, debit, prepaid, or unknown.

setup_error.payment_method.interac_present.issuernullable string
The name of the card’s issuing bank.

setup_error.payment_method.interac_present.last4nullable string
The last four digits of the card.

setup_error.payment_method.interac_present.networksnullable object
Contains information about card networks that can be used to process the payment.
- setup_error.payment_method.interac_present.networks.availablearray of strings
  All available networks for the card.
- setup_error.payment_method.interac_present.networks.preferrednullable string
  The preferred network for the card.

setup_error.payment_method.interac_present.preferred_localesnullable array of strings
EMV tag 5F2D. Preferred languages specified by the integrated circuit chip.

setup_error.payment_method.interac_present.read_methodnullable enum

How card details were read in this transaction.

Possible enum values

contact_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.

setup_error.payment_method.kakao_paynullable object
If this is a kakao_pay PaymentMethod, this hash contains details about the Kakao Pay payment method.

setup_error.payment_method.klarnanullable object
If this is a klarna PaymentMethod, this hash contains details about the Klarna payment method.
- setup_error.payment_method.klarna.dobnullable objectExpandable
  The customer’s date of birth, if provided.
  setup_error.payment_method.klarna.dob.daynullable integer
  The day of birth, between 1 and 31.
  setup_error.payment_method.klarna.dob.monthnullable integer
  The month of birth, between 1 and 12.
  setup_error.payment_method.klarna.dob.yearnullable integer
  The four-digit year of birth.

setup_error.payment_method.konbininullable object
If this is a konbini PaymentMethod, this hash contains details about the Konbini payment method.

setup_error.payment_method.kr_cardnullable object
If this is a kr_card PaymentMethod, this hash contains details about the Korean Card payment method.
- setup_error.payment_method.kr_card.brandnullable enum
  The local credit or debit card brand.
  Possible enum values
  bc
  BC
  citi
  Citi
  hana
  Hana
  hyundai
  Hyundai
  jeju
  Jeju
  jeonbuk
  Jeonbuk
  kakaobank
  Kakao Bank
  kbank
  KBank
  kdbbank
  KDB Bank
  kookmin
  Kookmin
  Show 12 more
- setup_error.payment_method.kr_card.last4nullable string
  The last four digits of the card. This may not be present for American Express cards.

setup_error.payment_method.linknullable object
If this is an Link PaymentMethod, this hash contains details about the Link payment method.
- setup_error.payment_method.link.emailnullable string
  Account owner’s email address.

setup_error.payment_method.livemodeboolean
Has the value true if the object exists in live mode or the value false if the object exists in test mode.

setup_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.

setup_error.payment_method.mobilepaynullable object
If this is a mobilepay PaymentMethod, this hash contains details about the MobilePay payment method.

setup_error.payment_method.multibanconullable object
If this is a multibanco PaymentMethod, this hash contains details about the Multibanco payment method.

setup_error.payment_method.naver_paynullable object
If this is a naver_pay PaymentMethod, this hash contains details about the Naver Pay payment method.
- setup_error.payment_method.naver_pay.fundingenum
  Whether to fund this transaction with Naver Pay points or a card.
  Possible enum values
  card
  Use a card to fund this transaction.
  points
  Use Naver Pay points to fund this transaction.

setup_error.payment_method.nz_bank_accountnullable objectPreview feature
If this is an nz_bank_account PaymentMethod, this hash contains details about the nz_bank_account payment method.
- setup_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.
- setup_error.payment_method.nz_bank_account.bank_codestring
  The numeric code for the bank account’s bank.
- setup_error.payment_method.nz_bank_account.bank_namestring
  The name of the bank.
- setup_error.payment_method.nz_bank_account.branch_codestring
  The numeric code for the bank account’s bank branch.
- setup_error.payment_method.nz_bank_account.last4string
  Last four digits of the bank account number.
- setup_error.payment_method.nz_bank_account.suffixnullable string
  The suffix of the bank account number.

setup_error.payment_method.oxxonullable object
If this is an oxxo PaymentMethod, this hash contains details about the OXXO payment method.

setup_error.payment_method.p24nullable object
If this is a p24 PaymentMethod, this hash contains details about the P24 payment method.
- setup_error.payment_method.p24.banknullable enum
  The customer’s bank, if provided.

setup_error.payment_method.payconullable object
If this is a payco PaymentMethod, this hash contains details about the PAYCO payment method.

setup_error.payment_method.paynownullable object
If this is a paynow PaymentMethod, this hash contains details about the PayNow payment method.

setup_error.payment_method.paypalnullable object
If this is a paypal PaymentMethod, this hash contains details about the PayPal payment method.
- setup_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.
- setup_error.payment_method.paypal.payer_idnullable string
  PayPal account PayerID. This identifier uniquely identifies the PayPal customer.

setup_error.payment_method.pixnullable object
If this is a pix PaymentMethod, this hash contains details about the Pix payment method.

setup_error.payment_method.promptpaynullable object
If this is a promptpay PaymentMethod, this hash contains details about the PromptPay payment method.

setup_error.payment_method.radar_optionsnullable object
Options to configure Radar. See Radar Session for more information.
- setup_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.

setup_error.payment_method.revolut_paynullable object
If this is a Revolut Pay PaymentMethod, this hash contains details about the Revolut Pay payment method.

setup_error.payment_method.samsung_paynullable object
If this is a samsung_pay PaymentMethod, this hash contains details about the SamsungPay payment method.

setup_error.payment_method.sepa_debitnullable object
If this is a sepa_debit PaymentMethod, this hash contains details about the SEPA debit bank account.
- setup_error.payment_method.sepa_debit.bank_codenullable string
  Bank code of bank associated with the bank account.
- setup_error.payment_method.sepa_debit.branch_codenullable string
  Branch code of bank associated with the bank account.
- setup_error.payment_method.sepa_debit.countrynullable string
  Two-letter ISO code representing the country the bank account is located in.
- setup_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.
- setup_error.payment_method.sepa_debit.generated_fromnullable object
  Information about the object that generated this PaymentMethod.
  setup_error.payment_method.sepa_debit.generated_from.chargenullable stringExpandable
  The ID of the Charge that generated this PaymentMethod, if any.
  setup_error.payment_method.sepa_debit.generated_from.setup_attemptnullable stringExpandable
  The ID of the SetupAttempt that generated this PaymentMethod, if any.
- setup_error.payment_method.sepa_debit.last4nullable string
  Last four characters of the IBAN.

setup_error.payment_method.sofortnullable object
If this is a sofort PaymentMethod, this hash contains details about the SOFORT payment method.
- setup_error.payment_method.sofort.countrynullable string
  Two-letter ISO code representing the country the bank account is located in.

setup_error.payment_method.swishnullable object
If this is a swish PaymentMethod, this hash contains details about the Swish payment method.

setup_error.payment_method.twintnullable object
If this is a TWINT PaymentMethod, this hash contains details about the TWINT payment method.

setup_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 values

acss_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.

blik

BLIK is a single-use payment method common in Poland.

Show 36 more

setup_error.payment_method.us_bank_accountnullable object

If this is an us_bank_account PaymentMethod, this hash contains details about the US bank account payment method.

setup_error.payment_method.us_bank_account.account_holder_typenullable enum
Account holder type: individual or company.
Possible enum values
company
Account belongs to a company
individual
Account belongs to an individual

setup_error.payment_method.us_bank_account.account_typenullable enum
Account type: checkings or savings. Defaults to checking if omitted.
Possible enum values
checking
Bank account type is checking
savings
Bank account type is savings

setup_error.payment_method.us_bank_account.bank_namenullable string
The name of the bank.

setup_error.payment_method.us_bank_account.financial_connections_accountnullable string
The ID of the Financial Connections Account used to create the payment method.

setup_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.

setup_error.payment_method.us_bank_account.last4nullable string
Last four digits of the bank account number.

setup_error.payment_method.us_bank_account.networksnullable object
Contains information about US bank account networks that can be used.
- setup_error.payment_method.us_bank_account.networks.preferrednullable string
  The preferred network.
- setup_error.payment_method.us_bank_account.networks.supportedarray of enums
  All supported networks.
  Possible enum values
  ach
  us_domestic_wire

setup_error.payment_method.us_bank_account.routing_numbernullable string
Routing number of the bank account.

setup_error.payment_method.us_bank_account.status_detailsnullable object

Contains information about the future reusability of this PaymentMethod.

setup_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.

setup_error.payment_method.us_bank_account.status_details.blocked.network_codenullable enum

The ACH network code that resulted in this block.

Possible enum values

R02

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

setup_error.payment_method.us_bank_account.status_details.blocked.reasonnullable enum

The reason why this PaymentMethod’s fingerprint has been blocked

Possible enum values

bank_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_code is R29, please confirm that Stripe’s Company IDs are allowlisted before attempting additional payments.

setup_error.payment_method.wechat_paynullable object
If this is an wechat_pay PaymentMethod, this hash contains details about the wechat_pay payment method.

setup_error.payment_method.zipnullable object
If this is a zip PaymentMethod, this hash contains details about the Zip payment method.

setup_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.

setup_error.typeenum
The type of error returned. One of api_error, card_error, idempotency_error, or invalid_request_error
Possible enum values
api_error
card_error
idempotency_error
invalid_request_error

setup_intentstringExpandable
ID of the SetupIntent that this attempt belongs to.

statusstring
Status of this SetupAttempt, one of requires_confirmation, requires_action, processing, succeeded, failed, or abandoned.

usagestring
The value of usage on the SetupIntent at the time of this confirmation, one of off_session or on_session.

The SetupAttempt object

{
  "id": "setatt_1ErTsH2eZvKYlo2CI7ukcoF7",
  "object": "setup_attempt",
  "application": null,
  "created": 1562004309,
  "customer": null,
  "flow_directions": null,
  "livemode": false,
  "on_behalf_of": null,
  "payment_method": "pm_1ErTsG2eZvKYlo2CH0DNen59",
  "payment_method_details": {
    "card": {
      "three_d_secure": null
    },
    "type": "card"
  },
  "setup_error": null,
  "setup_intent": "seti_1ErTsG2eZvKYlo2CKaT8MITz",
  "status": "succeeded",
  "usage": "off_session"
}

The SetupAttempt object

Attributes

idstring

objectstring

applicationnullable stringExpandable

attach_to_selfnullable boolean

createdtimestampretrievable with publishable key

customernullable stringExpandable

flow_directionsnullable array of enums

livemodebooleanretrievable with publishable key

on_behalf_ofnullable stringExpandable

payment_methodstringExpandableretrievable with publishable key

payment_method_detailsobject

payment_method_details.acss_debitobject

payment_method_details.amazon_payobject

payment_method_details.au_becs_debitobject

payment_method_details.bacs_debitobject

payment_method_details.bancontactobject

payment_method_details.bancontact.bank_codenullable string

payment_method_details.bancontact.bank_namenullable string

payment_method_details.bancontact.bicnullable string

payment_method_details.bancontact.generated_sepa_debitnullable stringExpandable

payment_method_details.bancontact.generated_sepa_debit_mandatenullable stringExpandable

payment_method_details.bancontact.iban_last4nullable string

payment_method_details.bancontact.preferred_languagenullable enum

payment_method_details.bancontact.verified_namenullable string

payment_method_details.boletoobject

payment_method_details.cardobject

payment_method_details.card.brandnullable string

payment_method_details.card.checksnullable object

payment_method_details.card.checks.address_line1_checknullable string

payment_method_details.card.checks.address_postal_code_checknullable string

payment_method_details.card.checks.cvc_checknullable string

payment_method_details.card.countrynullable string

payment_method_details.card.exp_monthnullable integer

payment_method_details.card.exp_yearnullable integer

payment_method_details.card.fingerprintnullable string

payment_method_details.card.fundingnullable string

payment_method_details.card.last4nullable string

payment_method_details.card.networknullable string

payment_method_details.card.three_d_securenullable object

payment_method_details.card.three_d_secure.authentication_flownullable enum

payment_method_details.card.three_d_secure.electronic_commerce_indicatornullable enum

payment_method_details.card.three_d_secure.resultnullable enum

payment_method_details.card.three_d_secure.result_reasonnullable enum

payment_method_details.card.three_d_secure.transaction_idnullable string

payment_method_details.card.three_d_secure.versionnullable enum

payment_method_details.card.walletnullable object

payment_method_details.card.wallet.apple_paynullable object

payment_method_details.card.wallet.apple_pay.typeenumPreview feature

payment_method_details.card.wallet.google_paynullable object

payment_method_details.card.wallet.typeenum

payment_method_details.card_presentobject

payment_method_details.card_present.generated_cardnullable stringExpandable

payment_method_details.card_present.offlinenullable object

payment_method_details.card_present.offline.stored_atnullable timestamp

payment_method_details.card_present.offline.typenullable enum

payment_method_details.cashappobject

payment_method_details.idealobject

payment_method_details.ideal.banknullable enum

payment_method_details.ideal.bicnullable enum

payment_method_details.ideal.generated_sepa_debitnullable stringExpandable

payment_method_details.ideal.generated_sepa_debit_mandatenullable stringExpandable

payment_method_details.ideal.iban_last4nullable string

payment_method_details.ideal.verified_namenullable string

payment_method_details.kakao_payobject

payment_method_details.klarnaobject

payment_method_details.kr_cardobject

payment_method_details.linkobject

payment_method_details.nz_bank_accountobjectPreview feature

payment_method_details.paypalobject

payment_method_details.revolut_payobject

payment_method_details.sepa_debitobject

payment_method_details.sofortobject

payment_method_details.sofort.bank_codenullable string

payment_method_details.sofort.bank_namenullable string

payment_method_details.sofort.bicnullable string

payment_method_details.sofort.generated_sepa_debitnullable stringExpandable

payment_method_details.sofort.generated_sepa_debit_mandatenullable stringExpandable

payment_method_details.sofort.iban_last4nullable string