Attributes
- idstring
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- balance_
impactobject The current impact of the TransactionEntry on the FinancialAccount’s balance.
- balance_impact.
cashinteger The change made to funds the user can spend right now.
- balance_impact.
inbound_ pendinginteger The change made to funds that are not spendable yet, but will become available at a later time.
- balance_impact.
outbound_ pendinginteger The change made to funds in the account, but not spendable because they are being held for pending outbound flows.
- createdtimestamp
Time at which the object was created. Measured in seconds since the Unix epoch.
- currencyenum
Three-letter ISO currency code, in lowercase. Must be a supported currency.
- effective_
attimestamp When the TransactionEntry will impact the FinancialAccount’s balance.
- financial_
accountstring The FinancialAccount associated with this object.
- flownullable string
Token of the flow associated with the TransactionEntry.
- flow_
detailsnullable objectExpandable Details of the flow associated with the TransactionEntry.
- flow_details.
credit_ reversalnullable object The CreditReversal object associated with the Transaction. Set if
type=credit_.reversal - flow_details.
credit_reversal. idstring Unique identifier for the object.
- flow_details.
credit_reversal. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
credit_reversal. amountinteger Amount (in cents) transferred.
- flow_details.
credit_reversal. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
credit_reversal. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
credit_reversal. financial_ accountstring The FinancialAccount to reverse funds from.
- flow_details.
credit_reversal. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
credit_reversal. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
credit_reversal. 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.
- flow_details.
credit_reversal. networkenum The rails used to reverse the funds.
- flow_details.
credit_reversal. received_ creditstring The ReceivedCredit being reversed.
- flow_details.
credit_reversal. statusenum Status of the CreditReversal
Possible enum valuescanceledThe CreditReversal has been canceled before it has been sent to the network and no funds have left the account. (Currently not supported).
postedThe CreditReversal has been sent to the network and funds have left the account (with the Transaction posting)
processingThe CreditReversal starting state. Funds are “held” by a pending Transaction (but they are still part of the current balance).
- flow_details.
credit_reversal. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
credit_reversal. status_transitions. posted_ atnullable timestamp Timestamp describing when the CreditReversal changed status to
posted
- flow_details.
credit_reversal. transactionnullable stringExpandable The Transaction associated with this object.
- flow_details.
debit_ reversalnullable object The DebitReversal object associated with the Transaction. Set if
type=debit_.reversal - flow_details.
debit_reversal. idstring Unique identifier for the object.
- flow_details.
debit_reversal. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
debit_reversal. amountinteger Amount (in cents) transferred.
- flow_details.
debit_reversal. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
debit_reversal. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
debit_reversal. financial_ accountnullable string The FinancialAccount to reverse funds from.
- flow_details.
debit_reversal. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
debit_reversal. linked_ flowsnullable object Other flows linked to a DebitReversal.
- flow_details.
debit_reversal. linked_flows. issuing_ disputenullable string Set if there is an Issuing dispute associated with the DebitReversal.
- flow_details.
debit_reversal. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
debit_reversal. 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.
- flow_details.
debit_reversal. networkenum The rails used to reverse the funds.
- flow_details.
debit_reversal. received_ debitstring The ReceivedDebit being reversed.
- flow_details.
debit_reversal. statusenum Status of the DebitReversal
Possible enum valuesfailedThe network has resolved the DebitReversal against the user.
processingThe DebitReversal starting state.
succeededThe network has resolved the DebitReversal in the users favour. A crediting Transaction is created.
- flow_details.
debit_reversal. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
debit_reversal. status_transitions. completed_ atnullable timestamp Timestamp describing when the DebitReversal changed status to
completed.
- flow_details.
debit_reversal. transactionnullable stringExpandable The Transaction associated with this object.
- flow_details.
inbound_ transfernullable object The InboundTransfer object associated with the Transaction. Set if
type=inbound_.transfer - flow_details.
inbound_transfer. idstring Unique identifier for the object.
- flow_details.
inbound_transfer. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
inbound_transfer. amountinteger Amount (in cents) transferred.
- flow_details.
inbound_transfer. cancelableboolean Returns
trueif the InboundTransfer is able to be canceled. - flow_details.
inbound_transfer. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
inbound_transfer. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
inbound_transfer. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
inbound_transfer. failure_ detailsnullable object Details about this InboundTransfer’s failure. Only set when status is
failed.- flow_details.
inbound_transfer. failure_details. codeenum Reason for the failure.
Possible enum valuesaccount_closed The bank account has been closed.
account_frozen The bank account has been frozen.
bank_account_ restricted The bank account has restrictions on either the type or number of transfers allowed. This normally indicates that the bank account is a savings or other non-checking account.
bank_ownership_ changed The bank account is no longer valid because its branch has changed ownership.
debit_not_ authorized Debit transactions are not approved on the bank account.
incorrect_account_ holder_ address The bank notified us that the bank account holder address on file is incorrect.
incorrect_account_ holder_ name The bank notified us that the bank account holder name on file is incorrect.
incorrect_account_ holder_ tax_ id The bank notified us that the bank account holder tax ID on file is incorrect.
insufficient_funds The bank account has insufficient funds to cover the debit transaction.
invalid_account_ number The bank account details on file are probably incorrect. The routing number seems correct, but the account number is invalid.
Show 3 more
- flow_details.
inbound_transfer. financial_ accountstring The FinancialAccount that received the funds.
- flow_details.
inbound_transfer. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
inbound_transfer. linked_ flowsobject Other flows linked to a InboundTransfer.
- flow_details.
inbound_transfer. linked_flows. received_ debitnullable string If funds for this flow were returned after the flow went to the
succeededstate, this field contains a reference to the ReceivedDebit return.
- flow_details.
inbound_transfer. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
inbound_transfer. 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.
- flow_details.
inbound_transfer. origin_ payment_ methodnullable string The origin payment method to be debited for an InboundTransfer.
- flow_details.
inbound_transfer. origin_ payment_ method_ detailsnullable object Details about the PaymentMethod for an InboundTransfer.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_ detailsobject Contact details for the person or business referenced by the PaymentMethod.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. addressobject Billing address.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. address. line1nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. address. line2nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. emailnullable string Email address.
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. namenullable string Full name.
- flow_details.
inbound_transfer. origin_payment_method_details. typeenum The type of the payment method used in the InboundTransfer.
Possible enum valuesus_bank_ account US Bank Account
- flow_details.
inbound_transfer. origin_payment_method_details. us_ bank_ accountnullable object Optional fields for
us_.bank_ account - flow_details.
inbound_transfer. origin_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompanyAccount belongs to a company
individualAccount belongs to an individual
- flow_details.
inbound_transfer. origin_payment_method_details. us_bank_account. account_ typenullable enum Account type: checkings or savings. Defaults to checking if omitted.
Possible enum valuescheckingBank account type is checking
savingsBank account type is savings
- flow_details.
inbound_transfer. origin_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- flow_details.
inbound_transfer. origin_payment_method_details. 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.
- flow_details.
inbound_transfer. origin_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- flow_details.
inbound_transfer. origin_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- flow_details.
inbound_transfer. origin_payment_method_details. us_bank_account. networkenum The network rails used. See the docs to learn more about money movement timelines for each network type.
- flow_details.
inbound_transfer. origin_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- flow_details.
inbound_transfer. returnednullable boolean Returns
trueif the funds for an InboundTransfer were returned after the InboundTransfer went to thesucceededstate. - flow_details.
inbound_transfer. statement_ descriptorstring Statement descriptor shown when funds are debited from the source. Not all payment networks support
statement_.descriptor - flow_details.
inbound_transfer. statusenum Status of the InboundTransfer:
processing,succeeded,failed, andcanceled. An InboundTransfer isprocessingif it is created and pending. The status changes tosucceededonce the funds have been “confirmed” and atransactionis created and posted. The status changes tofailedif the transfer fails. - flow_details.
inbound_transfer. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
inbound_transfer. status_transitions. failed_ atnullable timestamp Timestamp describing when an InboundTransfer changed status to
failed. - flow_details.
inbound_transfer. status_transitions. succeeded_ atnullable timestamp Timestamp describing when an InboundTransfer changed status to
succeeded.
- flow_details.
inbound_transfer. transactionnullable stringExpandable The Transaction associated with this object.
- flow_details.
nullable object The Issuing authorization object associated with the Transaction. Set if
type=issuing_.authorization - flow_details.
issuing_authorization. string Unique identifier for the object.
- flow_details.
issuing_authorization. string String representing the object’s type. Objects of the same type share the same value.
- flow_details.
issuing_authorization. integer The total amount that was authorized or rejected. This amount is in
currencyand in the smallest currency unit.amountshould be the same asmerchant_, unlessamount currencyandmerchant_are different.currency - flow_details.
issuing_authorization. nullable object Detailed breakdown of amount components. These amounts are denominated in
currencyand in the smallest currency unit.- flow_details.
issuing_authorization. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- flow_details.
issuing_authorization. amount_details. nullable integer The amount of cash requested by the cardholder.
- flow_details.
issuing_authorization. boolean Whether the authorization has been approved.
- flow_details.
issuing_authorization. enum How the card details were provided.
Possible enum valueschipThe card was physically present and inserted into a chip-enabled terminal. The transaction is cryptographically secured.
contactlessThe card was tapped on a contactless-enabled terminal. If a digital wallet copy of the card was used, the
walletfield will be present.keyed_in The card number was manually entered into a terminal.
onlineThe card was used in a card-not-present scenario, such as a transaction initiated at an online e-commerce checkout.
swipeThe card was physically swiped in a terminal.
- flow_details.
issuing_authorization. array of objects List of balance transactions associated with this authorization.
- flow_details.
issuing_authorization. balance_transactions. string Unique identifier for the object.
- flow_details.
issuing_authorization. balance_transactions. string String representing the object’s type. Objects of the same type share the same value.
- flow_details.
issuing_authorization. balance_transactions. integer Gross amount of this transaction (in cents). A positive value represents funds charged to another party, and a negative value represents funds sent to another party.
- flow_details.
issuing_authorization. balance_transactions. timestamp The date that the transaction’s net funds become available in the Stripe balance.
- flow_details.
issuing_authorization. balance_transactions. enumPreview feature The balance that this transaction impacts.
Possible enum valuesissuingBalance Transactions that affect your Issuing balance
paymentsBalance Transactions that affect your Payments balance
refund_and_ dispute_ prefunding Balance Transactions that affect your Refund and Dispute Prefunding balance
- flow_details.
issuing_authorization. balance_transactions. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
issuing_authorization. balance_transactions. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
issuing_authorization. balance_transactions. nullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
issuing_authorization. balance_transactions. nullable float If applicable, this transaction uses an exchange rate. If money converts from currency A to currency B, then the
amountin currency A, multipled by theexchange_, equals therate amountin currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent’samountis1000andcurrencyiseur. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction’samountis1234, itscurrencyisusd, and theexchange_israte 1..234 - flow_details.
issuing_authorization. balance_transactions. integer Fees (in cents) paid for this transaction. Represented as a positive integer when assessed.
- flow_details.
issuing_authorization. balance_transactions. array of objects Detailed breakdown of fees (in cents) paid for this transaction.
- flow_details.
issuing_authorization. balance_transactions. fee_details. integer Amount of the fee, in cents.
- flow_details.
issuing_authorization. balance_transactions. fee_details. nullable string ID of the Connect application that earned the fee.
- flow_details.
issuing_authorization. balance_transactions. fee_details. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
issuing_authorization. balance_transactions. fee_details. nullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
issuing_authorization. balance_transactions. fee_details. string Type of the fee, one of:
application_,fee payment_,method_ passthrough_ fee stripe_orfee tax.
- flow_details.
issuing_authorization. balance_transactions. integer Net impact to a Stripe balance (in cents). A positive value represents incrementing a Stripe balance, and a negative value decrementing a Stripe balance. You can calculate the net impact of a transaction on a balance by
amount-fee - flow_details.
issuing_authorization. balance_transactions. string Learn more about how reporting categories can help you understand balance transactions from an accounting perspective.
- flow_details.
issuing_authorization. balance_transactions. nullable stringExpandable This transaction relates to the Stripe object.
- flow_details.
issuing_authorization. balance_transactions. string The transaction’s net funds status in the Stripe balance, which are either
availableorpending. - flow_details.
issuing_authorization. balance_transactions. enum Transaction type:
adjustment,advance,advance_,funding anticipation_,repayment application_,fee application_,fee_ refund charge,climate_,order_ purchase climate_,order_ refund connect_,collection_ transfer contribution,issuing_,authorization_ hold issuing_,authorization_ release issuing_,dispute issuing_,transaction obligation_,outbound obligation_,reversal_ inbound payment,payment_,failure_ refund payment_,network_ reserve_ hold payment_,network_ reserve_ release payment_,refund payment_,reversal payment_,unreconciled payout,payout_,cancel payout_,failure payout_,minimum_ balance_ hold payout_,minimum_ balance_ release refund,refund_,failure reserve_,transaction reserved_,funds stripe_,fee stripe_,fx_ fee stripe_,balance_ payment_ debit stripe_,balance_ payment_ debit_ reversal tax_,fee topup,topup_,reversal transfer,transfer_,cancel transfer_, orfailure transfer_. Learn more about balance transaction types and what they represent. To classify transactions for accounting purposes, considerrefund reporting_instead.category Possible enum valuesadjustmentadvanceadvance_funding anticipation_repayment application_fee application_fee_ refund chargeclimate_order_ purchase climate_order_ refund connect_collection_ transfer Show 34 more
- flow_details.
issuing_authorization. object Card associated with this authorization.
- flow_details.
issuing_authorization. card. string Unique identifier for the object.
- flow_details.
issuing_authorization. card. string String representing the object’s type. Objects of the same type share the same value.
- flow_details.
issuing_authorization. card. string The brand of the card.
- flow_details.
issuing_authorization. card. nullable enum The reason why the card was canceled.
Possible enum valuesdesign_rejected The design of this card was rejected by Stripe for violating our partner guidelines.
lostThe card was lost.
stolenThe card was stolen.
- flow_details.
issuing_authorization. card. object The Cardholder object to which the card belongs.
- flow_details.
issuing_authorization. card. cardholder. string Unique identifier for the object.
- flow_details.
issuing_authorization. card. cardholder. string String representing the object’s type. Objects of the same type share the same value.
- flow_details.
issuing_authorization. card. cardholder. object The cardholder’s billing information.
- flow_details.
issuing_authorization. card. cardholder. billing. object The cardholder’s billing address.
- flow_details.
issuing_authorization. card. cardholder. billing. address. nullable string City, district, suburb, town, or village.
- flow_details.
issuing_authorization. card. cardholder. billing. address. nullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
issuing_authorization. card. cardholder. billing. address. nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
issuing_authorization. card. cardholder. billing. address. nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
issuing_authorization. card. cardholder. billing. address. nullable string ZIP or postal code.
- flow_details.
issuing_authorization. card. cardholder. billing. address. nullable string State, county, province, or region.
- flow_details.
issuing_authorization. card. cardholder. nullable object Additional information about a
companycardholder.- flow_details.
issuing_authorization. card. cardholder. company. boolean Whether the company’s business ID number was provided.
- flow_details.
issuing_authorization. card. cardholder. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
issuing_authorization. card. cardholder. nullable string The cardholder’s email address.
- flow_details.
issuing_authorization. card. cardholder. nullable object Additional information about an
individualcardholder.- flow_details.
issuing_authorization. card. cardholder. individual. nullable object Information related to the card_issuing program for this cardholder.
- flow_details.
issuing_authorization. card. cardholder. individual. card_issuing. nullable object Information about cardholder acceptance of Celtic Authorized User Terms. Required for cards backed by a Celtic program.
- flow_details.
issuing_authorization. card. cardholder. individual. card_issuing. user_terms_acceptance. nullable timestamp The Unix timestamp marking when the cardholder accepted the Authorized User Terms.
- flow_details.
issuing_authorization. card. cardholder. individual. card_issuing. user_terms_acceptance. nullable string The IP address from which the cardholder accepted the Authorized User Terms.
- flow_details.
issuing_authorization. card. cardholder. individual. card_issuing. user_terms_acceptance. nullable string The user agent of the browser from which the cardholder accepted the Authorized User Terms.
- flow_details.
issuing_authorization. card. cardholder. individual. nullable object The date of birth of this cardholder.
- flow_details.
issuing_authorization. card. cardholder. individual. dob. nullable integer The day of birth, between 1 and 31.
- flow_details.
issuing_authorization. card. cardholder. individual. dob. nullable integer The month of birth, between 1 and 12.
- flow_details.
issuing_authorization. card. cardholder. individual. dob. nullable integer The four-digit year of birth.
- flow_details.
issuing_authorization. card. cardholder. individual. nullable string The first name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.
- flow_details.
issuing_authorization. card. cardholder. individual. nullable string The last name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.
- flow_details.
issuing_authorization. card. cardholder. individual. nullable object Government-issued ID document for this cardholder.
- flow_details.
issuing_authorization. card. cardholder. individual. verification. nullable object An identifying document, either a passport or local ID card.
- flow_details.
issuing_authorization. card. cardholder. individual. verification. document. nullable stringExpandable The back of a document returned by a file upload with a
purposevalue ofidentity_.document - flow_details.
issuing_authorization. card. cardholder. individual. verification. document. nullable stringExpandable The front of a document returned by a file upload with a
purposevalue ofidentity_.document
- flow_details.
issuing_authorization. card. cardholder. boolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
issuing_authorization. card. cardholder. 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.
- flow_details.
issuing_authorization. card. cardholder. string The cardholder’s name. This will be printed on cards issued to them.
- flow_details.
issuing_authorization. card. cardholder. nullable string The cardholder’s phone number. This is required for all cardholders who will be creating EU cards. See the 3D Secure documentation for more details.
- flow_details.
issuing_authorization. card. cardholder. nullable array of enums The cardholder’s preferred locales (languages), ordered by preference. Locales can be
de,en,es,fr, orit. This changes the language of the 3D Secure flow and one-time password messages sent to the cardholder. - flow_details.
issuing_authorization. card. cardholder. object Information about verification requirements for the cardholder.
- flow_details.
issuing_authorization. card. cardholder. requirements. nullable enum If
disabled_is present, all cards will decline authorizations withreason cardholder_reason.verification_ required Possible enum valueslistedAccount might be on a prohibited persons or companies list. The
past_field contains information that you need to provide before the cardholder can approve authorizations.due rejected.listed Cardholder is rejected because they are on a third-party prohibited persons or companies list (such as financial services provider or government). Their status will be
blocked.requirements.past_ due Cardholder has outstanding requirements. The
past_field contains information that you need to provide before the cardholder can activate cards.due under_review This cardholder has raised additional review. Stripe will make a decision and update the
disabled_field.reason - flow_details.
issuing_authorization. card. cardholder. requirements. nullable array of enums Array of fields that need to be collected in order to verify and re-enable the cardholder.
Possible enum valuescompany.tax_ id The cardholder’s business number (Tax ID).
individual.card_ issuing. user_ terms_ acceptance. date The Unix timestamp marking when the Cardholder accepted their Authorized User Terms. Required for Celtic Spend Card users.
individual.card_ issuing. user_ terms_ acceptance. ip The IP address from which the Cardholder accepted their Authorized User Terms. Required for Celtic Spend Card users.
individual.dob. day The cardholder’s date of birth’s day.
individual.dob. month The cardholder’s date of birth’s month.
individual.dob. year The cardholder’s date of birth’s year.
individual.first_ name The cardholder’s legal first name.
individual.last_ name The cardholder’s legal last name.
individual.verification. document The front and back of a government-issued form of identification.
- flow_details.
issuing_authorization. card. cardholder. nullable object Rules that control spending across this cardholder’s cards. Refer to our documentation for more details.
- flow_details.
issuing_authorization. card. cardholder. spending_controls. nullable array of enums Array of strings containing categories of authorizations to allow. All other categories will be blocked. Cannot be set with
blocked_.categories Possible enum valuesac_refrigeration_ repair accounting_bookkeeping_ services advertising_services agricultural_cooperative airlines_air_ carriers airports_flying_ fields ambulance_services amusement_parks_ carnivals antique_reproductions antique_shops Show 285 more - flow_details.
issuing_authorization. card. cardholder. spending_controls. nullable array of strings Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.
US). Cannot be set withblocked_. Provide an empty value to unset this control.merchant_ countries - flow_details.
issuing_authorization. card. cardholder. spending_controls. nullable array of enums Array of strings containing categories of authorizations to decline. All other categories will be allowed. Cannot be set with
allowed_.categories Possible enum valuesac_refrigeration_ repair accounting_bookkeeping_ services advertising_services agricultural_cooperative airlines_air_ carriers airports_flying_ fields ambulance_services amusement_parks_ carnivals antique_reproductions antique_shops Show 285 more - flow_details.
issuing_authorization. card. cardholder. spending_controls. nullable array of strings Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.
US). Cannot be set withallowed_. Provide an empty value to unset this control.merchant_ countries - flow_details.
issuing_authorization. card. cardholder. spending_controls. nullable array of objects Limit spending with amount-based rules that apply across this cardholder’s cards.
- flow_details.
issuing_authorization. card. cardholder. spending_controls. spending_limits. integer Maximum amount allowed to spend per interval. This amount is in the card’s currency and in the smallest currency unit.
- flow_details.
issuing_authorization. card. cardholder. spending_controls. spending_limits. nullable array of enums Array of strings containing categories this limit applies to. Omitting this field will apply the limit to all categories.
Possible enum valuesac_refrigeration_ repair accounting_bookkeeping_ services advertising_services agricultural_cooperative airlines_air_ carriers airports_flying_ fields ambulance_services amusement_parks_ carnivals antique_reproductions antique_shops Show 285 more - flow_details.
issuing_authorization. card. cardholder. spending_controls. spending_limits. enum Interval (or event) to which the amount applies.
Possible enum valuesall_time Limit applies to all transactions.
dailyLimit applies to a day, starting at midnight UTC.
monthlyLimit applies to a month, starting on the 1st at midnight UTC.
per_authorization Limit applies to each authorization.
weeklyLimit applies to a week, starting on Sunday at midnight UTC.
yearlyLimit applies to a year, starting on January 1st at midnight UTC.
- flow_details.
issuing_authorization. card. cardholder. spending_controls. nullable enum Currency of the amounts within
spending_.limits
- flow_details.
issuing_authorization. card. cardholder. enum Specifies whether to permit authorizations on this cardholder’s cards.
Possible enum valuesactiveCards attached to this cardholder can approve authorizations.
blockedCards attached to this cardholder will decline all authorizations with the
cardholder_reason. This status is non-reversible.blocked inactiveCards attached to this cardholder will decline all authorizations with the
cardholder_reason.inactive - flow_details.
issuing_authorization. card. cardholder. enum One of
individualorcompany. See Choose a cardholder type for more details.Possible enum valuescompanyThe cardholder is a company or business entity, and additional information includes their tax ID. This option may not be available if your use case only supports individual cardholders.
individualThe cardholder is a person, and additional information includes first and last name, date of birth, etc. If you’re issuing Celtic Spend Cards, then Individual cardholders must accept Authorized User Terms prior to activating their card.
- flow_details.
issuing_authorization. card. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
issuing_authorization. card. enum Three-letter ISO currency code, in lowercase. Supported currencies are
usdin the US,eurin the EU, andgbpin the UK. - flow_details.
issuing_authorization. card. nullable stringExpandable The card’s CVC. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with the
expandparameter. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint. - flow_details.
issuing_authorization. card. integer The expiration month of the card.
- flow_details.
issuing_authorization. card. integer The expiration year of the card.
- flow_details.
issuing_authorization. card. string The last 4 digits of the card number.
- flow_details.
issuing_authorization. card. boolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
issuing_authorization. card. 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.
- flow_details.
issuing_authorization. card. nullable stringExpandable The full unredacted card number. For security reasons, this is only available for virtual cards, and will be omitted unless you explicitly request it with the
expandparameter. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint. - flow_details.
issuing_authorization. card. nullable stringExpandable The personalization design object belonging to this card.
- flow_details.
issuing_authorization. card. nullable stringExpandable The latest card that replaces this card, if any.
- flow_details.
issuing_authorization. card. nullable stringExpandable The card this card replaces, if any.
- flow_details.
issuing_authorization. card. nullable enum The reason why the previous card needed to be replaced.
Possible enum valuesdamagedThe physical card has been damaged and cannot be used at terminals. This reason is only valid for cards of type
physical.expiredThe expiration date has passed or is imminent.
lostThe card was lost. This status is only valid if the card it replaces is marked as lost.
stolenThe card was stolen. This status is only valid if the card it replaces is marked as stolen.
- flow_details.
issuing_authorization. card. nullable string Text separate from cardholder name, printed on the card.
- flow_details.
issuing_authorization. card. nullable object Where and how the card will be shipped.
- flow_details.
issuing_authorization. card. shipping. object Shipping address.
- flow_details.
issuing_authorization. card. shipping. address. nullable string City, district, suburb, town, or village.
- flow_details.
issuing_authorization. card. shipping. address. nullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
issuing_authorization. card. shipping. address. nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
issuing_authorization. card. shipping. address. nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
issuing_authorization. card. shipping. address. nullable string ZIP or postal code.
- flow_details.
issuing_authorization. card. shipping. address. nullable string State, county, province, or region.
- flow_details.
issuing_authorization. card. shipping. nullable object Address validation details for the shipment.
- flow_details.
issuing_authorization. card. shipping. address_validation. enum The address validation capabilities to use.
Possible enum valuesdisabledThe card will be shipped without validating or normalizing the shipping address.
normalization_only The card will be shipped with the normalized address without validation. Undeliverable addresses won’t be blocked.
validation_and_ normalization The card will be shipped with the normalized, validated address. Undeliverable addresses will be blocked.
- flow_details.
issuing_authorization. card. shipping. address_validation. nullable object The normalized shipping address.
- flow_details.
issuing_authorization. card. shipping. address_validation. normalized_address. nullable string City, district, suburb, town, or village.
- flow_details.
issuing_authorization. card. shipping. address_validation. normalized_address. nullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
issuing_authorization. card. shipping. address_validation. normalized_address. nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
issuing_authorization. card. shipping. address_validation. normalized_address. nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
issuing_authorization. card. shipping. address_validation. normalized_address. nullable string ZIP or postal code.
- flow_details.
issuing_authorization. card. shipping. address_validation. normalized_address. nullable string State, county, province, or region.
- flow_details.
issuing_authorization. card. shipping. address_validation. nullable enum The validation result for the shipping address.
Possible enum valuesindeterminateThe deliverability of the card’s shipping address could not be determined.
likely_deliverable The card’s shipping address is likely deliverable.
likely_undeliverable The card’s shipping address is likely undeliverable as submitted.
- flow_details.
issuing_authorization. card. shipping. nullable enum The delivery company that shipped a card.
Possible enum valuesdhlDHL
fedexFedEx
royal_mail Royal Mail
uspsUSPS
- flow_details.
issuing_authorization. card. shipping. nullable object Additional information that may be required for clearing customs.
- flow_details.
issuing_authorization. card. shipping. customs. nullable string A registration number used for customs in Europe. See https://www.gov.uk/eori for the UK and https://ec.europa.eu/taxation_customs/business/customs-procedures-import-and-export/customs-procedures/economic-operators-registration-and-identification-number-eori_en for the EU.
- flow_details.
issuing_authorization. card. shipping. nullable timestamp A unix timestamp representing a best estimate of when the card will be delivered.
- flow_details.
issuing_authorization. card. shipping. string Recipient name.
- flow_details.
issuing_authorization. card. shipping. nullable string The phone number of the receiver of the shipment. Our courier partners will use this number to contact you in the event of card delivery issues. For individual shipments to the EU/UK, if this field is empty, we will provide them with the phone number provided when the cardholder was initially created.
- flow_details.
issuing_authorization. card. shipping. nullable boolean Whether a signature is required for card delivery. This feature is only supported for US users. Standard shipping service does not support signature on delivery. The default value for standard shipping service is false and for express and priority services is true.
- flow_details.
issuing_authorization. card. shipping. enum Shipment service, such as
standardorexpress.Possible enum valuesexpressCards arrive in 4 business days.
priorityCards arrive in 2-3 business days.
standardCards arrive in 5-8 business days.
- flow_details.
issuing_authorization. card. shipping. nullable enum The delivery status of the card.
Possible enum valuescanceledThe card was canceled before being shipped.
deliveredThe card has been delivered to its destination.
failureThe card failed to be delivered but was not returned.
pendingThe card is being prepared and has not yet shipped.
returnedThe card failed to be delivered and was returned to the sender.
shippedThe card has been shipped. If the card’s shipping carrier does not support tracking, this will be the card’s final status.
submittedThe card has been submitted to the printer for shipment.
- flow_details.
issuing_authorization. card. shipping. nullable string A tracking number for a card shipment.
- flow_details.
issuing_authorization. card. shipping. nullable string A link to the shipping carrier’s site where you can view detailed information about a card shipment.
- flow_details.
issuing_authorization. card. shipping. enum Packaging options.
Possible enum valuesbulkCards are grouped and mailed together.
individualCards are sent individually in an envelope.
- flow_details.
issuing_authorization. card. object Rules that control spending for this card. Refer to our documentation for more details.
- flow_details.
issuing_authorization. card. spending_controls. nullable array of enums Array of strings containing categories of authorizations to allow. All other categories will be blocked. Cannot be set with
blocked_.categories Possible enum valuesac_refrigeration_ repair accounting_bookkeeping_ services advertising_services agricultural_cooperative airlines_air_ carriers airports_flying_ fields ambulance_services amusement_parks_ carnivals antique_reproductions antique_shops Show 285 more - flow_details.
issuing_authorization. card. spending_controls. nullable array of strings Array of strings containing representing countries from which authorizations will be allowed. Authorizations from merchants in all other countries will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.
US). Cannot be set withblocked_. Provide an empty value to unset this control.merchant_ countries - flow_details.
issuing_authorization. card. spending_controls. nullable array of enums Array of strings containing categories of authorizations to decline. All other categories will be allowed. Cannot be set with
allowed_.categories Possible enum valuesac_refrigeration_ repair accounting_bookkeeping_ services advertising_services agricultural_cooperative airlines_air_ carriers airports_flying_ fields ambulance_services amusement_parks_ carnivals antique_reproductions antique_shops Show 285 more - flow_details.
issuing_authorization. card. spending_controls. nullable array of strings Array of strings containing representing countries from which authorizations will be declined. Country codes should be ISO 3166 alpha-2 country codes (e.g.
US). Cannot be set withallowed_. Provide an empty value to unset this control.merchant_ countries - flow_details.
issuing_authorization. card. spending_controls. nullable array of objects Limit spending with amount-based rules that apply across any cards this card replaced (i.e., its
replacement_card and that card’sfor replacement_card, up the chain).for - flow_details.
issuing_authorization. card. spending_controls. spending_limits. integer Maximum amount allowed to spend per interval. This amount is in the card’s currency and in the smallest currency unit.
- flow_details.
issuing_authorization. card. spending_controls. spending_limits. nullable array of enums Array of strings containing categories this limit applies to. Omitting this field will apply the limit to all categories.
Possible enum valuesac_refrigeration_ repair accounting_bookkeeping_ services advertising_services agricultural_cooperative airlines_air_ carriers airports_flying_ fields ambulance_services amusement_parks_ carnivals antique_reproductions antique_shops Show 285 more - flow_details.
issuing_authorization. card. spending_controls. spending_limits. enum Interval (or event) to which the amount applies.
Possible enum valuesall_time Limit applies to all transactions.
dailyLimit applies to a day, starting at midnight UTC.
monthlyLimit applies to a month, starting on the 1st at midnight UTC.
per_authorization Limit applies to each authorization.
weeklyLimit applies to a week, starting on Sunday at midnight UTC.
yearlyLimit applies to a year, starting on January 1st at midnight UTC.
- flow_details.
issuing_authorization. card. spending_controls. nullable enum Currency of the amounts within
spending_. Always the same as the currency of the card.limits
- flow_details.
issuing_authorization. card. enum Whether authorizations can be approved on this card. May be blocked from activating cards depending on past-due Cardholder requirements. Defaults to
inactive.Possible enum valuesactiveThe card can approve authorizations. If the card is linked to a cardholder with past-due requirements, you may be unable to change the card’s status to ‘active’.
canceledThe card will decline authorizations with the
card_reason. This status is permanent.canceled inactiveThe card will decline authorizations with the
card_reason.inactive - flow_details.
issuing_authorization. card. enum The type of the card.
Possible enum valuesphysicalA physical card will be printed and shipped. It can be used at physical terminals.
virtualNo physical card will be printed. The card can be used online and can be added to digital wallets.
- flow_details.
issuing_authorization. card. nullable object Information relating to digital wallets (like Apple Pay and Google Pay).
- flow_details.
issuing_authorization. card. wallets. object Apple Pay Details
- flow_details.
issuing_authorization. card. wallets. apple_pay. boolean Apple Pay Eligibility
- flow_details.
issuing_authorization. card. wallets. apple_pay. nullable enum Reason the card is ineligible for Apple Pay
Possible enum valuesmissing_agreement Apple Pay is not enabled for your account.
missing_cardholder_ contact Cardholder phone number or email required.
unsupported_region Apple Pay is not supported in the cardholder’s country.
- flow_details.
issuing_authorization. card. wallets. object Google Pay Details
- flow_details.
issuing_authorization. card. wallets. google_pay. boolean Google Pay Eligibility
- flow_details.
issuing_authorization. card. wallets. google_pay. nullable enum Reason the card is ineligible for Google Pay
Possible enum valuesmissing_agreement Google Pay is not enabled for your account.
missing_cardholder_ contact Cardholder phone number or email required.
unsupported_region Google Pay is not supported in the cardholder’s country.
- flow_details.
issuing_authorization. card. wallets. nullable string Unique identifier for a card used with digital wallets
- flow_details.
issuing_authorization. nullable stringExpandable The cardholder to whom this authorization belongs.
- flow_details.
issuing_authorization. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
issuing_authorization. enum The currency of the cardholder. This currency can be different from the currency presented at authorization and the
merchant_field on this authorization. Three-letter ISO currency code, in lowercase. Must be a supported currency.currency - flow_details.
issuing_authorization. nullable object Fleet-specific information for authorizations using Fleet cards.
- flow_details.
issuing_authorization. fleet. nullable object Answers to prompts presented to the cardholder at the point of sale. Prompted fields vary depending on the configuration of your physical fleet cards. Typical points of sale support only numeric entry.
- flow_details.
issuing_authorization. fleet. cardholder_prompt_data. nullable string [Deprecated] An alphanumeric ID, though typical point of sales only support numeric entry. The card program can be configured to prompt for a vehicle ID, driver ID, or generic ID.
- flow_details.
issuing_authorization. fleet. cardholder_prompt_data. nullable string Driver ID.
- flow_details.
issuing_authorization. fleet. cardholder_prompt_data. nullable integer Odometer reading.
- flow_details.
issuing_authorization. fleet. cardholder_prompt_data. nullable string An alphanumeric ID. This field is used when a vehicle ID, driver ID, or generic ID is entered by the cardholder, but the merchant or card network did not specify the prompt type.
- flow_details.
issuing_authorization. fleet. cardholder_prompt_data. nullable string User ID.
- flow_details.
issuing_authorization. fleet. cardholder_prompt_data. nullable string Vehicle number.
- flow_details.
issuing_authorization. fleet. nullable enum The type of purchase.
Possible enum valuesfuel_and_ non_ fuel_ purchase Fuel and non-fuel purchase.
fuel_purchase Fuel-only purchase.
non_fuel_ purchase Non-fuel purchase.
- flow_details.
issuing_authorization. fleet. nullable object More information about the total amount. Typically this information is received from the merchant after the authorization has been approved and the fuel dispensed. This information is not guaranteed to be accurate as some merchants may provide unreliable data.
- flow_details.
issuing_authorization. fleet. reported_breakdown. nullable object Breakdown of fuel portion of the purchase.
- flow_details.
issuing_authorization. fleet. reported_breakdown. fuel. nullable decimal string Gross fuel amount that should equal Fuel Quantity multiplied by Fuel Unit Cost, inclusive of taxes.
- flow_details.
issuing_authorization. fleet. reported_breakdown. nullable object Breakdown of non-fuel portion of the purchase.
- flow_details.
issuing_authorization. fleet. reported_breakdown. non_fuel. nullable decimal string Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
- flow_details.
issuing_authorization. fleet. reported_breakdown. nullable object Information about tax included in this transaction.
- flow_details.
issuing_authorization. fleet. reported_breakdown. tax. nullable decimal string Amount of state or provincial Sales Tax included in the transaction amount.
nullif not reported by merchant or not subject to tax. - flow_details.
issuing_authorization. fleet. reported_breakdown. tax. nullable decimal string Amount of national Sales Tax or VAT included in the transaction amount.
nullif not reported by merchant or not subject to tax.
- flow_details.
issuing_authorization. fleet. nullable enum The type of fuel service.
Possible enum valuesfull_service Full-service fuel station purchase.
non_fuel_ transaction Non-fuel transaction.
self_service Self-service fuel station purchase.
- flow_details.
issuing_authorization. nullable array of objectsExpandable Fraud challenges sent to the cardholder, if this authorization was declined for fraud risk reasons.
- flow_details.
issuing_authorization. fraud_challenges. enum The method by which the fraud challenge was delivered to the cardholder.
Possible enum valuessmsSMS sent to the cardholder’s phone number.
- flow_details.
issuing_authorization. fraud_challenges. enum The status of the fraud challenge.
Possible enum valuesexpiredThe cardholder did not respond to the challenge within 12 hours of it being sent, and it has expired. Any further response to the challenge will be ignored.
pendingThe challenge has been sent to the cardholder or is about to be sent.
rejectedThe cardholder responded to the challenge indicating that the authorization was fraudulent, and that similar authorizations should continue to be declined.
undeliverableA challenge has been requested to be sent, but the cardholder is unable to receive it.
verifiedThe cardholder responded to the challenge indicating that the authorization was not fraudulent, and that similar authorizations should be approved.
- flow_details.
issuing_authorization. fraud_challenges. nullable enum If the challenge is not deliverable, the reason why.
Possible enum valuesno_phone_ number SMS fraud challenges cannot be delivered to this cardholder because they have no
phone_.number unsupported_phone_ number SMS fraud challenges cannot be delivered to this cardholder because their
phone_is not supportednumber
- flow_details.
issuing_authorization. nullable object Information about fuel that was purchased with this transaction. Typically this information is received from the merchant after the authorization has been approved and the fuel dispensed.
- flow_details.
issuing_authorization. fuel. nullable string Conexxus Payment System Product Code identifying the primary fuel product purchased.
- flow_details.
issuing_authorization. fuel. nullable decimal string The quantity of
units of fuel that was dispensed, represented as a decimal string with at most 12 decimal places. - flow_details.
issuing_authorization. fuel. nullable enum The type of fuel that was purchased.
Possible enum valuesdieselDiesel.
otherOther.
unleaded_plus Unleaded plus.
unleaded_regular Unleaded regular.
unleaded_super Unleaded super.
- flow_details.
issuing_authorization. fuel. nullable enum The units for
quantity_.decimal Possible enum valuescharging_minute Charging minute.
imperial_gallon Imperial gallon.
kilogramKilogram.
kilowatt_hour Kilowatt-hour.
literLiter.
otherOther.
poundPound.
us_gallon US gallon.
- flow_details.
issuing_authorization. fuel. nullable decimal string The cost in cents per each unit of fuel, represented as a decimal string with at most 12 decimal places.
- flow_details.
issuing_authorization. boolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
issuing_authorization. integer The total amount that was authorized or rejected. This amount is in the
merchant_and in the smallest currency unit.currency merchant_should be the same asamount amount, unlessmerchant_andcurrency currencyare different. - flow_details.
issuing_authorization. enum The local currency that was presented to the cardholder for the authorization. This currency can be different from the cardholder currency and the
currencyfield on this authorization. Three-letter ISO currency code, in lowercase. Must be a supported currency. - flow_details.
issuing_authorization. object Details about the seller (grocery store, e-commerce website, etc.) where the card authorization happened.
- flow_details.
issuing_authorization. merchant_data. string A categorization of the seller’s type of business. See our merchant categories guide for a list of possible values.
- flow_details.
issuing_authorization. merchant_data. string The merchant category code for the seller’s business
- flow_details.
issuing_authorization. merchant_data. nullable string City where the seller is located
- flow_details.
issuing_authorization. merchant_data. nullable string Country where the seller is located
- flow_details.
issuing_authorization. merchant_data. nullable string Name of the seller
- flow_details.
issuing_authorization. merchant_data. string Identifier assigned to the seller by the card network. Different card networks may assign different network_id fields to the same merchant.
- flow_details.
issuing_authorization. merchant_data. nullable string Postal code where the seller is located
- flow_details.
issuing_authorization. merchant_data. nullable string State where the seller is located
- flow_details.
issuing_authorization. merchant_data. nullable string The seller’s tax identification number. Currently populated for French merchants only.
- flow_details.
issuing_authorization. merchant_data. nullable string An ID assigned by the seller to the location of the sale.
- flow_details.
issuing_authorization. merchant_data. nullable string URL provided by the merchant on a 3DS request
- flow_details.
issuing_authorization. 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.
- flow_details.
issuing_authorization. nullable object Details about the authorization, such as identifiers, set by the card network.
- flow_details.
issuing_authorization. network_data. nullable string Identifier assigned to the acquirer by the card network. Sometimes this value is not provided by the network; in this case, the value will be
null. - flow_details.
issuing_authorization. network_data. nullable string The System Trace Audit Number (STAN) is a 6-digit identifier assigned by the acquirer. Prefer
network_if present, unless you have special requirements.data. transaction_ id - flow_details.
issuing_authorization. network_data. nullable string Unique identifier for the authorization assigned by the card network used to match subsequent messages, disputes, and transactions.
- flow_details.
issuing_authorization. nullable object The pending authorization request. This field will only be non-null during an
issuing_webhook.authorization. request - flow_details.
issuing_authorization. pending_request. integer The additional amount Stripe will hold if the authorization is approved, in the card’s currency and in the smallest currency unit.
- flow_details.
issuing_authorization. pending_request. nullable object Detailed breakdown of amount components. These amounts are denominated in
currencyand in the smallest currency unit.- flow_details.
issuing_authorization. pending_request. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- flow_details.
issuing_authorization. pending_request. amount_details. nullable integer The amount of cash requested by the cardholder.
- flow_details.
issuing_authorization. pending_request. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
issuing_authorization. pending_request. boolean If set
true, you may provide amount to control how much to hold for the authorization. - flow_details.
issuing_authorization. pending_request. integer The amount the merchant is requesting to be authorized in the
merchant_. The amount is in the smallest currency unit.currency - flow_details.
issuing_authorization. pending_request. enum The local currency the merchant is requesting to authorize.
- flow_details.
issuing_authorization. pending_request. nullable integer The card network’s estimate of the likelihood that an authorization is fraudulent. Takes on values between 1 and 99.
- flow_details.
issuing_authorization. array of objects History of every time a
pending_authorization was approved/declined, either by you directly or by Stripe (e.g. based on your spending_controls). If the merchant changes the authorization by performing an incremental authorization, you can look at this field to see the previous requests for the authorization. This field can be helpful in determining why a given authorization was approved/declined.request - flow_details.
issuing_authorization. request_history. integer The
pending_at the time of the request, presented in your card’s currency and in the smallest currency unit. Stripe held this amount from your account to fund the authorization if the request was approved.request. amount - flow_details.
issuing_authorization. request_history. nullable object Detailed breakdown of amount components. These amounts are denominated in
currencyand in the smallest currency unit.- flow_details.
issuing_authorization. request_history. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- flow_details.
issuing_authorization. request_history. amount_details. nullable integer The amount of cash requested by the cardholder.
- flow_details.
issuing_authorization. request_history. boolean Whether this request was approved.
- flow_details.
issuing_authorization. request_history. nullable string A code created by Stripe which is shared with the merchant to validate the authorization. This field will be populated if the authorization message was approved. The code typically starts with the letter “S”, followed by a six-digit number. For example, “S498162”. Please note that the code is not guaranteed to be unique across authorizations.
- flow_details.
issuing_authorization. request_history. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
issuing_authorization. request_history. string Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
issuing_authorization. request_history. integer The
pending_at the time of the request, presented in therequest. merchant_ amount merchant_and in the smallest currency unit.currency - flow_details.
issuing_authorization. request_history. string The currency that was collected by the merchant and presented to the cardholder for the authorization. Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
issuing_authorization. request_history. nullable integer The card network’s estimate of the likelihood that an authorization is fraudulent. Takes on values between 1 and 99.
- flow_details.
issuing_authorization. request_history. enum When an authorization is approved or declined by you or by Stripe, this field provides additional detail on the reason for the outcome.
Possible enum valuesaccount_disabled The authorization request was declined because your account is disabled. For more information, please contact us at support-issuing@stripe.com. Replaces the deprecated account_inactive and account_compliance_disabled enums.
card_active The authorization was approved according to your Issuing default settings. Authorization outcome was not driven by real-time auth webhook or spending controls as neither were configured.
card_canceled The authorization request was declined because the card was canceled.
card_expired The authorization request was declined because the card has expired. Documentation for replacing an expired card can be found here.
card_inactive The authorization request was declined because the card was inactive. To activate the card, refer to our documentation.
cardholder_blocked The authorization request was declined because the cardholder is blocked.
cardholder_inactive The authorization request was declined because the cardholder was inactive. You can activate the cardholder in the dashboard or via the API update endpoint.
cardholder_verification_ required The authorization was not approved because the cardholder still required verification. More details can be found by querying the API and obtaining the requirements field of the Cardholder object.
insecure_authorization_ method The authorization request was declined because an insecure authorization method was used. The authorization may be retried by inserting the chip into the terminal and/or entering the PIN at the point of sale.
insufficient_funds The authorization request was declined because your account had insufficient funds. Documentation for topping up your Issuing Balance can be found here.
Show 10 more - flow_details.
issuing_authorization. request_history. nullable string If the
request_ishistory. reason webhook_because the direct webhook response is invalid (for example, parsing errors or missing parameters), we surface a more detailed error message via this field.error - flow_details.
issuing_authorization. request_history. nullable timestamp Time when the card network received an authorization request from the acquirer in UTC. Referred to by networks as transmission time.
- flow_details.
issuing_authorization. enum The current status of the authorization in its lifecycle.
Possible enum valuesclosedThe authorization was declined or captured through one or more transactions.
expiredThe authorization was expired without capture.
pendingThe authorization was created and is awaiting approval or was approved and is awaiting capture.
reversedThe authorization was reversed by the merchant.
- flow_details.
issuing_authorization. nullable stringPreview featureExpandable Token object used for this authorization. If a network token was not used for this authorization, this field will be null.
- flow_details.
issuing_authorization. array of objects List of transactions associated with this authorization.
- flow_details.
issuing_authorization. transactions. string Unique identifier for the object.
- flow_details.
issuing_authorization. transactions. string String representing the object’s type. Objects of the same type share the same value.
- flow_details.
issuing_authorization. transactions. integer The transaction amount, which will be reflected in your balance. This amount is in your currency and in the smallest currency unit.
- flow_details.
issuing_authorization. transactions. nullable object Detailed breakdown of amount components. These amounts are denominated in
currencyand in the smallest currency unit.- flow_details.
issuing_authorization. transactions. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- flow_details.
issuing_authorization. transactions. amount_details. nullable integer The amount of cash requested by the cardholder.
- flow_details.
issuing_authorization. transactions. nullable stringExpandable The
Authorizationobject that led to this transaction. - flow_details.
issuing_authorization. transactions. nullable stringExpandable ID of the balance transaction associated with this transaction.
- flow_details.
issuing_authorization. transactions. stringExpandable The card used to make this transaction.
- flow_details.
issuing_authorization. transactions. nullable stringExpandable The cardholder to whom this transaction belongs.
- flow_details.
issuing_authorization. transactions. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
issuing_authorization. transactions. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
issuing_authorization. transactions. nullable stringExpandable If you’ve disputed the transaction, the ID of the dispute.
- flow_details.
issuing_authorization. transactions. boolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
issuing_authorization. transactions. integer The amount that the merchant will receive, denominated in
merchant_and in the smallest currency unit. It will be different fromcurrency amountif the merchant is taking payment in a different currency. - flow_details.
issuing_authorization. transactions. enum The currency with which the merchant is taking payment.
- flow_details.
issuing_authorization. transactions. object Details about the seller (grocery store, e-commerce website, etc.) involved in this transaction.
- flow_details.
issuing_authorization. transactions. merchant_data. string A categorization of the seller’s type of business. See our merchant categories guide for a list of possible values.
- flow_details.
issuing_authorization. transactions. merchant_data. string The merchant category code for the seller’s business
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string City where the seller is located
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string Country where the seller is located
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string Name of the seller
- flow_details.
issuing_authorization. transactions. merchant_data. string Identifier assigned to the seller by the card network. Different card networks may assign different network_id fields to the same merchant.
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string Postal code where the seller is located
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string State where the seller is located
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string The seller’s tax identification number. Currently populated for French merchants only.
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string An ID assigned by the seller to the location of the sale.
- flow_details.
issuing_authorization. transactions. merchant_data. nullable string URL provided by the merchant on a 3DS request
- flow_details.
issuing_authorization. transactions. 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.
- flow_details.
issuing_authorization. transactions. nullable object Details about the transaction, such as processing dates, set by the card network.
- flow_details.
issuing_authorization. transactions. network_data. nullable string A code created by Stripe which is shared with the merchant to validate the authorization. This field will be populated if the authorization message was approved. The code typically starts with the letter “S”, followed by a six-digit number. For example, “S498162”. Please note that the code is not guaranteed to be unique across authorizations.
- flow_details.
issuing_authorization. transactions. network_data. nullable string The date the transaction was processed by the card network. This can be different from the date the seller recorded the transaction depending on when the acquirer submits the transaction to the network.
- flow_details.
issuing_authorization. transactions. network_data. nullable string Unique identifier for the authorization assigned by the card network used to match subsequent messages, disputes, and transactions.
- flow_details.
issuing_authorization. transactions. nullable objectExpandable Additional purchase information that is optionally provided by the merchant.
- flow_details.
issuing_authorization. transactions. purchase_details. nullable object Fleet-specific information for transactions using Fleet cards.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. nullable object Answers to prompts presented to cardholder at point of sale.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable string Driver ID.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable integer Odometer reading.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable string An alphanumeric ID. This field is used when a vehicle ID, driver ID, or generic ID is entered by the cardholder, but the merchant or card network did not specify the prompt type.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable string User ID.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable string Vehicle number.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. nullable string The type of purchase. One of
fuel_,purchase non_, orfuel_ purchase fuel_.and_ non_ fuel_ purchase - flow_details.
issuing_authorization. transactions. purchase_details. fleet. nullable object More information about the total amount. This information is not guaranteed to be accurate as some merchants may provide unreliable data.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. nullable object Breakdown of fuel portion of the purchase.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. fuel. nullable decimal string Gross fuel amount that should equal Fuel Volume multipled by Fuel Unit Cost, inclusive of taxes.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. nullable object Breakdown of non-fuel portion of the purchase.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. non_fuel. nullable decimal string Gross non-fuel amount that should equal the sum of the line items, inclusive of taxes.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. nullable object Information about tax included in this transaction.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. tax. nullable decimal string Amount of state or provincial Sales Tax included in the transaction amount. Null if not reported by merchant or not subject to tax.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. tax. nullable decimal string Amount of national Sales Tax or VAT included in the transaction amount. Null if not reported by merchant or not subject to tax.
- flow_details.
issuing_authorization. transactions. purchase_details. fleet. nullable string The type of fuel service. One of
non_,fuel_ transaction full_, orservice self_.service
- flow_details.
issuing_authorization. transactions. purchase_details. nullable object Information about the flight that was purchased with this transaction.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. nullable integer The time that the flight departed.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. nullable string The name of the passenger.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. nullable boolean Whether the ticket is refundable.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. nullable array of objects The legs of the trip.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. segments. nullable string The three-letter IATA airport code of the flight’s destination.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. segments. nullable string The airline carrier code.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. segments. nullable string The three-letter IATA airport code that the flight departed from.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. segments. nullable string The flight number.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. segments. nullable string The flight’s service class.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. segments. nullable boolean Whether a stopover is allowed on this flight.
- flow_details.
issuing_authorization. transactions. purchase_details. flight. nullable string The travel agency that issued the ticket.
- flow_details.
issuing_authorization. transactions. purchase_details. nullable object Information about fuel that was purchased with this transaction.
- flow_details.
issuing_authorization. transactions. purchase_details. fuel. nullable string Conexxus Payment System Product Code identifying the primary fuel product purchased.
- flow_details.
issuing_authorization. transactions. purchase_details. fuel. nullable decimal string The quantity of
units of fuel that was dispensed, represented as a decimal string with at most 12 decimal places. - flow_details.
issuing_authorization. transactions. purchase_details. fuel. string The type of fuel that was purchased. One of
diesel,unleaded_,plus unleaded_,regular unleaded_, orsuper other. - flow_details.
issuing_authorization. transactions. purchase_details. fuel. string The units for
quantity_. One ofdecimal charging_,minute imperial_,gallon kilogram,kilowatt_,hour liter,pound,us_, orgallon other. - flow_details.
issuing_authorization. transactions. purchase_details. fuel. decimal string The cost in cents per each unit of fuel, represented as a decimal string with at most 12 decimal places.
- flow_details.
issuing_authorization. transactions. purchase_details. nullable object Information about lodging that was purchased with this transaction.
- flow_details.
issuing_authorization. transactions. purchase_details. lodging. nullable integer The time of checking into the lodging.
- flow_details.
issuing_authorization. transactions. purchase_details. lodging. nullable integer The number of nights stayed at the lodging.
- flow_details.
issuing_authorization. transactions. purchase_details. nullable array of objects The line items in the purchase.
- flow_details.
issuing_authorization. transactions. purchase_details. receipt. nullable string The description of the item. The maximum length of this field is 26 characters.
- flow_details.
issuing_authorization. transactions. purchase_details. receipt. nullable float The quantity of the item.
- flow_details.
issuing_authorization. transactions. purchase_details. receipt. nullable integer The total for this line item in cents.
- flow_details.
issuing_authorization. transactions. purchase_details. receipt. nullable integer The unit cost of the item in cents.
- flow_details.
issuing_authorization. transactions. purchase_details. nullable string A merchant-specific order number.
- flow_details.
issuing_authorization. transactions. nullable stringPreview featureExpandable Token object used for this transaction. If a network token was not used for this transaction, this field will be null.
- flow_details.
issuing_authorization. transactions. enum The nature of the transaction.
Possible enum valuescaptureFunds were captured by the acquirer.
amountwill be negative because funds are moving out of your balance. Not all captures will be linked to an authorization, as acquirers can force capture in some cases.refundAn acquirer initiated a refund. This transaction might not be linked to an original capture, for example credits are original transactions.
amountwill be positive for refunds and negative for refund reversals (very rare). - flow_details.
issuing_authorization. transactions. nullable enum The digital wallet used for this transaction. One of
apple_,pay google_, orpay samsung_.pay
- flow_details.
issuing_authorization. object Verifications that Stripe performed on information that the cardholder provided to the merchant.
- flow_details.
issuing_authorization. verification_data. enum Whether the cardholder provided an address first line and if it matched the cardholder’s
billing..address. line1 Possible enum valuesmatchVerification succeeded, values matched.
mismatchVerification failed, values didn’t match.
not_provided Verification was not performed because no value was provided.
- flow_details.
issuing_authorization. verification_data. enum Whether the cardholder provided a postal code and if it matched the cardholder’s
billing..address. postal_ code Possible enum valuesmatchVerification succeeded, values matched.
mismatchVerification failed, values didn’t match.
not_provided Verification was not performed because no value was provided.
- flow_details.
issuing_authorization. verification_data. nullable object The exemption applied to this authorization.
- flow_details.
issuing_authorization. verification_data. authentication_exemption. enum The entity that requested the exemption, either the acquiring merchant or the Issuing user.
Possible enum valuesacquirerAcquiring merchant.
issuerIssuing user.
- flow_details.
issuing_authorization. verification_data. authentication_exemption. enum The specific exemption claimed for this authorization.
Possible enum valueslow_value_ transaction Specifies an exemption for some low-value authorizations.
transaction_risk_ analysis Specifies an exemption for low-risk authorizations, determined using real-time risk analysis.
unknownSpecifies an unknown exemption type.
- flow_details.
issuing_authorization. verification_data. enum Whether the cardholder provided a CVC and if it matched Stripe’s record.
Possible enum valuesmatchVerification succeeded, values matched.
mismatchVerification failed, values didn’t match.
not_provided Verification was not performed because no value was provided.
- flow_details.
issuing_authorization. verification_data. enum Whether the cardholder provided an expiry date and if it matched Stripe’s record.
Possible enum valuesmatchVerification succeeded, values matched.
mismatchVerification failed, values didn’t match.
not_provided Verification was not performed because no value was provided.
- flow_details.
issuing_authorization. verification_data. nullable string The postal code submitted as part of the authorization used for postal code verification.
- flow_details.
issuing_authorization. verification_data. nullable object 3D Secure details.
- flow_details.
issuing_authorization. verification_data. three_d_secure. enum The outcome of the 3D Secure authentication request.
Possible enum valuesattempt_acknowledged The merchant attempted to authenticate the authorization, but the cardholder is not enrolled or was unable to reach Stripe.
authenticatedAuthentication successful.
failedAuthentication failed.
requiredThe authorization was declined because regulatory requirements mandated an authentication for this transaction but it wasn’t submitted correctly by the merchant, and they didn’t claim an applicable exemption. Check out our 3DS documentation if you want to learn more.
- flow_details.
issuing_authorization. nullable boolean Whether the authorization bypassed fraud risk checks because the cardholder has previously completed a fraud challenge on a similar high-risk authorization from the same merchant.
- flow_details.
issuing_authorization. nullable string The digital wallet used for this transaction. One of
apple_,pay google_, orpay samsung_. Will populate aspay nullwhen no digital wallet was utilized.
- flow_details.
outbound_ paymentnullable object The OutboundPayment object associated with the Transaction. Set if
type=outbound_.payment - flow_details.
outbound_payment. idstring Unique identifier for the object.
- flow_details.
outbound_payment. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
outbound_payment. amountinteger Amount (in cents) transferred.
- flow_details.
outbound_payment. cancelableboolean Returns
trueif the object can be canceled, andfalseotherwise. - flow_details.
outbound_payment. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
outbound_payment. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
outbound_payment. customernullable string ID of the customer to whom an OutboundPayment is sent.
- flow_details.
outbound_payment. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
outbound_payment. destination_ payment_ methodnullable string The PaymentMethod via which an OutboundPayment is sent. This field can be empty if the OutboundPayment was created using
destination_.payment_ method_ data - flow_details.
outbound_payment. destination_ payment_ method_ detailsnullable object Details about the PaymentMethod for an OutboundPayment.
- flow_details.
outbound_payment. destination_payment_method_details. billing_ detailsobject Contact details for the person or business receiving the OutboundPayment.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. addressobject Billing address.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. address. line1nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. address. line2nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. emailnullable string Email address.
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. namenullable string Full name.
- flow_details.
outbound_payment. destination_payment_method_details. financial_ accountnullable object Details about the
financial_.account - flow_details.
outbound_payment. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- flow_details.
outbound_payment. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- flow_details.
outbound_payment. destination_payment_method_details. typeenum The type of the payment method used in the OutboundPayment.
Possible enum valuesfinancial_account us_bank_ account - flow_details.
outbound_payment. destination_payment_method_details. us_ bank_ accountnullable object Details about the
us_.bank_ account - flow_details.
outbound_payment. destination_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompanyAccount belongs to a company
individualAccount belongs to an individual
- flow_details.
outbound_payment. destination_payment_method_details. us_bank_account. account_ typenullable enum Account type: checkings or savings. Defaults to checking if omitted.
Possible enum valuescheckingBank account type is checking
savingsBank account type is savings
- flow_details.
outbound_payment. destination_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- flow_details.
outbound_payment. destination_payment_method_details. 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.
- flow_details.
outbound_payment. destination_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- flow_details.
outbound_payment. destination_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- flow_details.
outbound_payment. destination_payment_method_details. us_bank_account. networkenum The network rails used. See the docs to learn more about money movement timelines for each network type.
Possible enum valuesachACH network
us_domestic_ wire US domestic wire network
- flow_details.
outbound_payment. destination_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- flow_details.
outbound_payment. end_ user_ detailsnullable object Details about the end user.
- flow_details.
outbound_payment. end_user_details. ip_ addressnullable string IP address of the user initiating the OutboundPayment. Set if
presentis set totrue. IP address collection is required for risk and compliance reasons. This will be used to help determine if the OutboundPayment is authorized or should be blocked. - flow_details.
outbound_payment. end_user_details. presentboolean trueif the OutboundPayment creation request is being made on behalf of an end user by a platform. Otherwise,false.
- flow_details.
outbound_payment. expected_ arrival_ datetimestamp The date when funds are expected to arrive in the destination account.
- flow_details.
outbound_payment. financial_ accountstring The FinancialAccount that funds were pulled from.
- flow_details.
outbound_payment. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
outbound_payment. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
outbound_payment. 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.
- flow_details.
outbound_payment. returned_ detailsnullable object Details about a returned OutboundPayment. Only set when the status is
returned.- flow_details.
outbound_payment. returned_details. codeenum Reason for the return.
Possible enum valuesaccount_closed The destination has been closed.
account_frozen The destination has been frozen.
bank_account_ restricted The destination bank account has restrictions on either the type or number of transfers allowed. This normally indicates that the bank account is a savings or other non-checking account.
bank_ownership_ changed The destination bank account is no longer valid because its branch has changed ownership.
declinedThe destination has declined this OutboundPayment.
incorrect_account_ holder_ name The destination bank notified us that the bank account holder name on file is incorrect.
invalid_account_ number The destination bank account details on file are probably incorrect. The routing number seems correct, but the account number is invalid.
invalid_currency The destination was unable to process this OutboundPayment because of its currency.
no_account The destination bank account details on file are probably incorrect. No bank account exists with these details.
otherThe destination could not process this OutboundPayment.
- flow_details.
outbound_payment. returned_details. transactionstringExpandable The Transaction associated with this object.
- flow_details.
outbound_payment. statement_ descriptorstring The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer).
- flow_details.
outbound_payment. statusenum Current status of the OutboundPayment:
processing,failed,posted,returned,canceled. An OutboundPayment isprocessingif it has been created and is pending. The status changes topostedonce the OutboundPayment has been “confirmed” and funds have left the account, or tofailedorcanceled. If an OutboundPayment fails to arrive at its destination, its status will change toreturned. - flow_details.
outbound_payment. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
outbound_payment. status_transitions. canceled_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
canceled. - flow_details.
outbound_payment. status_transitions. failed_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
failed. - flow_details.
outbound_payment. status_transitions. posted_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
posted. - flow_details.
outbound_payment. status_transitions. returned_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
returned.
- flow_details.
outbound_payment. tracking_ detailsnullable object Details about network-specific tracking information if available.
- flow_details.
outbound_payment. tracking_details. achnullable object ACH network tracking details.
- flow_details.
outbound_payment. tracking_details. ach. trace_ idstring ACH trace ID of the OutboundPayment for payments sent over the
achnetwork.
- flow_details.
outbound_payment. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesachus_domestic_ wire - flow_details.
outbound_payment. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- flow_details.
outbound_payment. tracking_details. us_domestic_wire. chipsnullable string CHIPS System Sequence Number (SSN) of the OutboundPayment for payments sent over the
us_network.domestic_ wire - flow_details.
outbound_payment. tracking_details. us_domestic_wire. imadnullable string IMAD of the OutboundPayment for payments sent over the
us_network.domestic_ wire - flow_details.
outbound_payment. tracking_details. us_domestic_wire. omadnullable string OMAD of the OutboundPayment for payments sent over the
us_network.domestic_ wire
- flow_details.
outbound_payment. transactionstringExpandable The Transaction associated with this object.
- flow_details.
outbound_ transfernullable object The OutboundTransfer object associated with the Transaction. Set if
type=outbound_.transfer - flow_details.
outbound_transfer. idstring Unique identifier for the object.
- flow_details.
outbound_transfer. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
outbound_transfer. amountinteger Amount (in cents) transferred.
- flow_details.
outbound_transfer. cancelableboolean Returns
trueif the object can be canceled, andfalseotherwise. - flow_details.
outbound_transfer. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
outbound_transfer. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
outbound_transfer. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
outbound_transfer. destination_ payment_ methodnullable string The PaymentMethod used as the payment instrument for an OutboundTransfer.
- flow_details.
outbound_transfer. destination_ payment_ method_ detailsobject Details about the PaymentMethod for an OutboundTransfer
- flow_details.
outbound_transfer. destination_payment_method_details. billing_ detailsobject Contact details for the person or business receiving the OutboundTransfer.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. addressobject Billing address.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. address. line1nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. address. line2nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. emailnullable string Email address.
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. namenullable string Full name.
- flow_details.
outbound_transfer. destination_payment_method_details. financial_ accountnullable objectPreview feature Details about the
financial_.account - flow_details.
outbound_transfer. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- flow_details.
outbound_transfer. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- flow_details.
outbound_transfer. destination_payment_method_details. typeenum The type of the payment method used in the OutboundTransfer.
- flow_details.
outbound_transfer. destination_payment_method_details. us_ bank_ accountnullable object Details about the
us_.bank_ account - flow_details.
outbound_transfer. destination_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompanyAccount belongs to a company
individualAccount belongs to an individual
- flow_details.
outbound_transfer. destination_payment_method_details. us_bank_account. account_ typenullable enum Account type: checkings or savings. Defaults to checking if omitted.
Possible enum valuescheckingBank account type is checking
savingsBank account type is savings
- flow_details.
outbound_transfer. destination_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- flow_details.
outbound_transfer. destination_payment_method_details. 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.
- flow_details.
outbound_transfer. destination_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- flow_details.
outbound_transfer. destination_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- flow_details.
outbound_transfer. destination_payment_method_details. us_bank_account. networkenum The network rails used. See the docs to learn more about money movement timelines for each network type.
Possible enum valuesachACH network
us_domestic_ wire US domestic wire network
- flow_details.
outbound_transfer. destination_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- flow_details.
outbound_transfer. expected_ arrival_ datetimestamp The date when funds are expected to arrive in the destination account.
- flow_details.
outbound_transfer. financial_ accountstring The FinancialAccount that funds were pulled from.
- flow_details.
outbound_transfer. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
outbound_transfer. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
outbound_transfer. 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.
- flow_details.
outbound_transfer. returned_ detailsnullable object Details about a returned OutboundTransfer. Only set when the status is
returned.- flow_details.
outbound_transfer. returned_details. codeenum Reason for the return.
Possible enum valuesaccount_closed The destination has been closed.
account_frozen The destination has been frozen.
bank_account_ restricted The destination bank account has restrictions on either the type or number of transfers allowed. This normally indicates that the bank account is a savings or other non-checking account.
bank_ownership_ changed The destination bank account is no longer valid because its branch has changed ownership.
declinedThe destination has declined this OutboundTransfer.
incorrect_account_ holder_ name The destination bank notified us that the bank account holder name on file is incorrect.
invalid_account_ number The destination bank account details on file are probably incorrect. The routing number seems correct, but the account number is invalid.
invalid_currency The destination was unable to process this OutboundTransfer because of its currency.
no_account The destination bank account details on file are probably incorrect. No bank account exists with these details.
otherThe destination could not process this OutboundTransfer.
- flow_details.
outbound_transfer. returned_details. transactionstringExpandable The Transaction associated with this object.
- flow_details.
outbound_transfer. statement_ descriptorstring Information about the OutboundTransfer to be sent to the recipient account.
- flow_details.
outbound_transfer. statusenum Current status of the OutboundTransfer:
processing,failed,canceled,posted,returned. An OutboundTransfer isprocessingif it has been created and is pending. The status changes topostedonce the OutboundTransfer has been “confirmed” and funds have left the account, or tofailedorcanceled. If an OutboundTransfer fails to arrive at its destination, its status will change toreturned. - flow_details.
outbound_transfer. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
outbound_transfer. status_transitions. canceled_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
canceled - flow_details.
outbound_transfer. status_transitions. failed_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
failed - flow_details.
outbound_transfer. status_transitions. posted_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
posted - flow_details.
outbound_transfer. status_transitions. returned_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
returned
- flow_details.
outbound_transfer. tracking_ detailsnullable object Details about network-specific tracking information if available.
- flow_details.
outbound_transfer. tracking_details. achnullable object ACH network tracking details.
- flow_details.
outbound_transfer. tracking_details. ach. trace_ idstring ACH trace ID of the OutboundTransfer for transfers sent over the
achnetwork.
- flow_details.
outbound_transfer. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesachus_domestic_ wire - flow_details.
outbound_transfer. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- flow_details.
outbound_transfer. tracking_details. us_domestic_wire. chipsnullable string CHIPS System Sequence Number (SSN) of the OutboundTransfer for transfers sent over the
us_network.domestic_ wire - flow_details.
outbound_transfer. tracking_details. us_domestic_wire. imadnullable string IMAD of the OutboundTransfer for transfers sent over the
us_network.domestic_ wire - flow_details.
outbound_transfer. tracking_details. us_domestic_wire. omadnullable string OMAD of the OutboundTransfer for transfers sent over the
us_network.domestic_ wire
- flow_details.
outbound_transfer. transactionstringExpandable The Transaction associated with this object.
- flow_details.
received_ creditnullable object The ReceivedCredit object associated with the Transaction. Set if
type=received_.credit - flow_details.
received_credit. idstring Unique identifier for the object.
- flow_details.
received_credit. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
received_credit. amountinteger Amount (in cents) transferred.
- flow_details.
received_credit. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
received_credit. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
received_credit. descriptionstring An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
received_credit. failure_ codenullable enum Reason for the failure. A ReceivedCredit might fail because the receiving FinancialAccount is closed or frozen.
Possible enum valuesaccount_closed Funds can’t be sent to a closed FinancialAccount.
account_frozen Funds can’t be sent to a frozen FinancialAccount.
international_transaction International transactions can’t be sent to FinancialAccount.
otherFunds can’t be sent to FinancialAccount for other reasons.
- flow_details.
received_credit. financial_ accountnullable string The FinancialAccount that received the funds.
- flow_details.
received_credit. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
received_credit. initiating_ payment_ method_ detailsobject Details about the PaymentMethod used to send a ReceivedCredit.
- flow_details.
received_credit. initiating_payment_method_details. balancenullable enum Set when
typeisbalance.Possible enum valuespaymentsThe Stripe payments balance.
- flow_details.
received_credit. initiating_payment_method_details. billing_ detailsobject The contact details of the person or business referenced by the received payment method details.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. addressobject Billing address.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
received_credit. initiating_payment_method_details. billing_details. address. line1nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. address. line2nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. emailnullable string Email address.
- flow_details.
received_credit. initiating_payment_method_details. billing_details. namenullable string Full name.
- flow_details.
received_credit. initiating_payment_method_details. financial_ accountnullable object Set when
typeisfinancial_. This is a FinancialAccount ID.account - flow_details.
received_credit. initiating_payment_method_details. financial_account. idstring The FinancialAccount ID.
- flow_details.
received_credit. initiating_payment_method_details. financial_account. networkenum The rails the ReceivedCredit was sent over. A FinancialAccount can only send funds over
stripe.
- flow_details.
received_credit. initiating_payment_method_details. issuing_ cardnullable string Set when
typeisissuing_. This is an Issuing Card ID.card - flow_details.
received_credit. initiating_payment_method_details. typeenum Polymorphic type matching the originating money movement’s source. This can be an external account, a Stripe balance, or a FinancialAccount.
- flow_details.
received_credit. initiating_payment_method_details. us_ bank_ accountnullable object Set when
typeisus_.bank_ account - flow_details.
received_credit. initiating_payment_method_details. us_bank_account. bank_ namenullable string Bank name.
- flow_details.
received_credit. initiating_payment_method_details. us_bank_account. last4nullable string The last four digits of the bank account number.
- flow_details.
received_credit. initiating_payment_method_details. us_bank_account. routing_ numbernullable string The routing number for the bank account.
- flow_details.
received_credit. linked_ flowsobject Other flows linked to a ReceivedCredit.
- flow_details.
received_credit. linked_flows. credit_ reversalnullable string The CreditReversal created as a result of this ReceivedCredit being reversed.
- flow_details.
received_credit. linked_flows. nullable string Set if the ReceivedCredit was created due to an Issuing Authorization object.
- flow_details.
received_credit. linked_flows. issuing_ transactionnullable string Set if the ReceivedCredit is also viewable as an Issuing transaction object.
- flow_details.
received_credit. linked_flows. source_ flownullable string ID of the source flow. Set if
networkisstripeand the source flow is visible to the user. Examples of source flows include OutboundPayments, payouts, or CreditReversals. - flow_details.
received_credit. linked_flows. source_ flow_ detailsnullable objectExpandable The expandable object of the source flow.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_ reversalnullable object Details about a CreditReversal.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. idstring Unique identifier for the object.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. amountinteger Amount (in cents) transferred.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. financial_ accountstring The FinancialAccount to reverse funds from.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. 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.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. networkenum The rails used to reverse the funds.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. received_ creditstring The ReceivedCredit being reversed.
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. statusenum Status of the CreditReversal
Possible enum valuescanceledThe CreditReversal has been canceled before it has been sent to the network and no funds have left the account. (Currently not supported).
postedThe CreditReversal has been sent to the network and funds have left the account (with the Transaction posting)
processingThe CreditReversal starting state. Funds are “held” by a pending Transaction (but they are still part of the current balance).
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. status_transitions. posted_ atnullable timestamp Timestamp describing when the CreditReversal changed status to
posted
- flow_details.
received_credit. linked_flows. source_flow_details. credit_reversal. transactionnullable stringExpandable The Transaction associated with this object.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_ paymentnullable object Details about an OutboundPayment.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. idstring Unique identifier for the object.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. amountinteger Amount (in cents) transferred.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. cancelableboolean Returns
trueif the object can be canceled, andfalseotherwise. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. customernullable string ID of the customer to whom an OutboundPayment is sent.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_ payment_ methodnullable string The PaymentMethod via which an OutboundPayment is sent. This field can be empty if the OutboundPayment was created using
destination_.payment_ method_ data - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_ payment_ method_ detailsnullable object Details about the PaymentMethod for an OutboundPayment.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_ detailsobject Contact details for the person or business receiving the OutboundPayment.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. addressobject Billing address.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. line1nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. line2nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. emailnullable string Email address.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. namenullable string Full name.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. financial_ accountnullable object Details about the
financial_.account - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. typeenum The type of the payment method used in the OutboundPayment.
Possible enum valuesfinancial_account us_bank_ account - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_ bank_ accountnullable object Details about the
us_.bank_ account - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompanyAccount belongs to a company
individualAccount belongs to an individual
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_bank_account. account_ typenullable enum Account type: checkings or savings. Defaults to checking if omitted.
Possible enum valuescheckingBank account type is checking
savingsBank account type is savings
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. 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.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_bank_account. networkenum The network rails used. See the docs to learn more about money movement timelines for each network type.
Possible enum valuesachACH network
us_domestic_ wire US domestic wire network
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. end_ user_ detailsnullable object Details about the end user.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. end_user_details. ip_ addressnullable string IP address of the user initiating the OutboundPayment. Set if
presentis set totrue. IP address collection is required for risk and compliance reasons. This will be used to help determine if the OutboundPayment is authorized or should be blocked. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. end_user_details. presentboolean trueif the OutboundPayment creation request is being made on behalf of an end user by a platform. Otherwise,false.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. expected_ arrival_ datetimestamp The date when funds are expected to arrive in the destination account.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. financial_ accountstring The FinancialAccount that funds were pulled from.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. 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.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. returned_ detailsnullable object Details about a returned OutboundPayment. Only set when the status is
returned.- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. returned_details. codeenum Reason for the return.
Possible enum valuesaccount_closed The destination has been closed.
account_frozen The destination has been frozen.
bank_account_ restricted The destination bank account has restrictions on either the type or number of transfers allowed. This normally indicates that the bank account is a savings or other non-checking account.
bank_ownership_ changed The destination bank account is no longer valid because its branch has changed ownership.
declinedThe destination has declined this OutboundPayment.
incorrect_account_ holder_ name The destination bank notified us that the bank account holder name on file is incorrect.
invalid_account_ number The destination bank account details on file are probably incorrect. The routing number seems correct, but the account number is invalid.
invalid_currency The destination was unable to process this OutboundPayment because of its currency.
no_account The destination bank account details on file are probably incorrect. No bank account exists with these details.
otherThe destination could not process this OutboundPayment.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. returned_details. transactionstringExpandable The Transaction associated with this object.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. statement_ descriptorstring The description that appears on the receiving end for an OutboundPayment (for example, bank statement for external bank transfer).
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. statusenum Current status of the OutboundPayment:
processing,failed,posted,returned,canceled. An OutboundPayment isprocessingif it has been created and is pending. The status changes topostedonce the OutboundPayment has been “confirmed” and funds have left the account, or tofailedorcanceled. If an OutboundPayment fails to arrive at its destination, its status will change toreturned. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. status_transitions. canceled_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
canceled. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. status_transitions. failed_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
failed. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. status_transitions. posted_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
posted. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. status_transitions. returned_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
returned.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_ detailsnullable object Details about network-specific tracking information if available.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. achnullable object ACH network tracking details.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. ach. trace_ idstring ACH trace ID of the OutboundPayment for payments sent over the
achnetwork.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesachus_domestic_ wire - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. us_domestic_wire. chipsnullable string CHIPS System Sequence Number (SSN) of the OutboundPayment for payments sent over the
us_network.domestic_ wire - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. us_domestic_wire. imadnullable string IMAD of the OutboundPayment for payments sent over the
us_network.domestic_ wire - flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. us_domestic_wire. omadnullable string OMAD of the OutboundPayment for payments sent over the
us_network.domestic_ wire
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_payment. transactionstringExpandable The Transaction associated with this object.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_ transfernullable objectPreview feature Details about an OutboundTransfer.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. idstring Unique identifier for the object.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. amountinteger Amount (in cents) transferred.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. cancelableboolean Returns
trueif the object can be canceled, andfalseotherwise. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_ payment_ methodnullable string The PaymentMethod used as the payment instrument for an OutboundTransfer.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_ payment_ method_ detailsobject Details about the PaymentMethod for an OutboundTransfer
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_ detailsobject Contact details for the person or business receiving the OutboundTransfer.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. addressobject Billing address.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. line1nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. line2nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. emailnullable string Email address.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. namenullable string Full name.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. financial_ accountnullable objectPreview feature Details about the
financial_.account - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. typeenum The type of the payment method used in the OutboundTransfer.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_ bank_ accountnullable object Details about the
us_.bank_ account - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompanyAccount belongs to a company
individualAccount belongs to an individual
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. account_ typenullable enum Account type: checkings or savings. Defaults to checking if omitted.
Possible enum valuescheckingBank account type is checking
savingsBank account type is savings
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. 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.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. networkenum The network rails used. See the docs to learn more about money movement timelines for each network type.
Possible enum valuesachACH network
us_domestic_ wire US domestic wire network
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. expected_ arrival_ datetimestamp The date when funds are expected to arrive in the destination account.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. financial_ accountstring The FinancialAccount that funds were pulled from.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. 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.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. returned_ detailsnullable object Details about a returned OutboundTransfer. Only set when the status is
returned.- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. returned_details. codeenum Reason for the return.
Possible enum valuesaccount_closed The destination has been closed.
account_frozen The destination has been frozen.
bank_account_ restricted The destination bank account has restrictions on either the type or number of transfers allowed. This normally indicates that the bank account is a savings or other non-checking account.
bank_ownership_ changed The destination bank account is no longer valid because its branch has changed ownership.
declinedThe destination has declined this OutboundTransfer.
incorrect_account_ holder_ name The destination bank notified us that the bank account holder name on file is incorrect.
invalid_account_ number The destination bank account details on file are probably incorrect. The routing number seems correct, but the account number is invalid.
invalid_currency The destination was unable to process this OutboundTransfer because of its currency.
no_account The destination bank account details on file are probably incorrect. No bank account exists with these details.
otherThe destination could not process this OutboundTransfer.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. returned_details. transactionstringExpandable The Transaction associated with this object.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. statement_ descriptorstring Information about the OutboundTransfer to be sent to the recipient account.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. statusenum Current status of the OutboundTransfer:
processing,failed,canceled,posted,returned. An OutboundTransfer isprocessingif it has been created and is pending. The status changes topostedonce the OutboundTransfer has been “confirmed” and funds have left the account, or tofailedorcanceled. If an OutboundTransfer fails to arrive at its destination, its status will change toreturned. - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status.- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. status_transitions. canceled_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
canceled - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. status_transitions. failed_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
failed - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. status_transitions. posted_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
posted - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. status_transitions. returned_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
returned
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_ detailsnullable object Details about network-specific tracking information if available.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. achnullable object ACH network tracking details.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. ach. trace_ idstring ACH trace ID of the OutboundTransfer for transfers sent over the
achnetwork.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesachus_domestic_ wire - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. us_domestic_wire. chipsnullable string CHIPS System Sequence Number (SSN) of the OutboundTransfer for transfers sent over the
us_network.domestic_ wire - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. us_domestic_wire. imadnullable string IMAD of the OutboundTransfer for transfers sent over the
us_network.domestic_ wire - flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. us_domestic_wire. omadnullable string OMAD of the OutboundTransfer for transfers sent over the
us_network.domestic_ wire
- flow_details.
received_credit. linked_flows. source_flow_details. outbound_transfer. transactionstringExpandable The Transaction associated with this object.
- flow_details.
received_credit. linked_flows. source_flow_details. payoutnullable object Details about a Payout.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. idstring Unique identifier for the object.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. amountinteger The amount (in cents) that transfers to your bank account or debit card.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. application_ feenullable stringExpandableConnect only The application fee (if any) for the payout. See the Connect documentation for details.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. application_ fee_ amountnullable integerConnect only The amount of the application fee (if any) requested for the payout. See the Connect documentation for details.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. arrival_ datetimestamp Date that you can expect the payout to arrive in the bank. This factors in delays to account for weekends or bank holidays.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. automaticboolean Returns
trueif the payout is created by an automated payout schedule andfalseif it’s requested manually. - flow_details.
received_credit. linked_flows. source_flow_details. payout. balance_ transactionnullable stringExpandable ID of the balance transaction that describes the impact of this payout on your account balance.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. destinationnullable stringExpandable ID of the bank account or card the payout is sent to.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. failure_ balance_ transactionnullable stringExpandable If the payout fails or cancels, this is the ID of the balance transaction that reverses the initial balance transaction and returns the funds from the failed payout back in your balance.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. failure_ codenullable string Error code that provides a reason for a payout failure, if available. View our list of failure codes.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. failure_ messagenullable string Message that provides the reason for a payout failure, if available.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
received_credit. linked_flows. source_flow_details. payout. 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.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. methodstring The method used to send this payout, which can be
standardorinstant.instantis supported for payouts to debit cards and bank accounts in certain countries. Learn more about bank support for Instant Payouts. - flow_details.
received_credit. linked_flows. source_flow_details. payout. original_ payoutnullable stringExpandable If the payout reverses another, this is the ID of the original payout.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. payout_ methodnullable string ID of the v2 FinancialAccount the funds are sent to.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. reconciliation_ statusenum If
completed, you can use the Balance Transactions API to list all balance transactions that are paid out in this payout.Possible enum valuescompletedThe Balance Transactions paid out in this payout. You can query it with the Balance Transactions API.
in_progress You can query the Balance Transactions paid out in this payout soon.
not_applicable We don’t support listing Balance Transactions for this payout. We only support this for standard automatic payouts.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. reversed_ bynullable stringExpandable If the payout reverses, this is the ID of the payout that reverses this payout.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. source_ typestring The source balance this payout came from, which can be one of the following:
card,fpx, orbank_.account - flow_details.
received_credit. linked_flows. source_flow_details. payout. statement_ descriptornullable string Extra information about a payout that displays on the user’s bank statement.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. statusstring Current status of the payout:
paid,pending,in_,transit canceledorfailed. A payout ispendinguntil it’s submitted to the bank, when it becomesin_. The status changes totransit paidif the transaction succeeds, or tofailedorcanceled(within 5 business days). Some payouts that fail might initially show aspaid, then change tofailed. - flow_details.
received_credit. linked_flows. source_flow_details. payout. trace_ idnullable object A value that generates from the beneficiary’s bank that allows users to track payouts with their bank. Banks might call this a “reference number” or something similar.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. trace_id. statusstring Possible values are
pending,supported, andunsupported. Whenpayout.isstatus pendingorin_, this will betransit pending. When the payout transitions topaid,failed, orcanceled, this status will becomesupportedorunsupportedshortly after in most cases. In some cases, this may appear aspendingfor up to 10 days afterarrival_until transitioning todate supportedorunsupported. - flow_details.
received_credit. linked_flows. source_flow_details. payout. trace_id. valuenullable string The trace ID value if
trace_isid. status supported, otherwisenil.
- flow_details.
received_credit. linked_flows. source_flow_details. payout. typeenum Can be
bank_oraccount card.
- flow_details.
received_credit. linked_flows. source_flow_details. typeenum The type of the source flow that originated the ReceivedCredit.
Possible enum valuescredit_reversal ReceivedCredits that were reversed and have associated CreditReversals.
otherReceivedCredits created from other source flow.
outbound_payment ReceivedCredits created from OutboundPayments.
outbound_transfer ReceivedCredits created from OutboundPayments.
payoutReceivedCredits created from Payouts.
- flow_details.
received_credit. linked_flows. source_ flow_ typenullable string The type of flow that originated the ReceivedCredit (for example,
outbound_).payment
- flow_details.
received_credit. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
received_credit. networkenum The rails used to send the funds.
Possible enum valuesachcardstripeus_domestic_ wire - flow_details.
received_credit. reversal_ detailsnullable object Details describing when a ReceivedCredit may be reversed.
- flow_details.
received_credit. reversal_details. deadlinenullable timestamp Time before which a ReceivedCredit can be reversed.
- flow_details.
received_credit. reversal_details. restricted_ reasonnullable enum Set if a ReceivedCredit cannot be reversed.
Possible enum valuesalready_reversed A ReceivedCredit that’s already reversed has this
restricted_. It may have a deadline populated in some cases.reason deadline_passed A ReceivedCredit which used to be reversible until the timestamp in
deadline, but is no longer reversible. ACH ReceivedCredits are only reversible for some time after they’re created.network_restricted Network constraints prevent Stripe from allowing reversal on some ReceivedCredits, such as a ReceivedCredit from a wire transfer.
otherA ReceivedCredit that was reversed because of another reason.
source_flow_ restricted Stripe restricts users from reversing a Stripe network ReceivedCredit.
- flow_details.
received_credit. statusenum Status of the ReceivedCredit. ReceivedCredits are created either
succeeded(approved) orfailed(declined). If a ReceivedCredit is declined, the failure reason can be found in thefailure_field.code Possible enum valuesfailedThe ReceivedCredit was declined, and no Transaction was created.
succeededThe ReceivedCredit was approved.
- flow_details.
received_credit. transactionnullable stringExpandable The Transaction associated with this object.
- flow_details.
received_ debitnullable object The ReceivedDebit object associated with the Transaction. Set if
type=received_.debit - flow_details.
received_debit. idstring Unique identifier for the object.
- flow_details.
received_debit. objectstring String representing the object’s type. Objects of the same type share the same value.
- flow_details.
received_debit. amountinteger Amount (in cents) transferred.
- flow_details.
received_debit. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- flow_details.
received_debit. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- flow_details.
received_debit. descriptionstring An arbitrary string attached to the object. Often useful for displaying to users.
- flow_details.
received_debit. failure_ codenullable enum Reason for the failure. A ReceivedDebit might fail because the FinancialAccount doesn’t have sufficient funds, is closed, or is frozen.
Possible enum valuesaccount_closed Funds can’t be pulled from a closed FinancialAccount.
account_frozen Funds can’t be pulled from a frozen FinancialAccount.
insufficient_funds The FinancialAccount doesn’t have a sufficient balance.
international_transaction International transactions can’t pull funds from the FinancialAccount.
otherFunds can’t be pulled from the FinancialAccount for other reasons.
- flow_details.
received_debit. financial_ accountnullable string The FinancialAccount that funds were pulled from.
- flow_details.
received_debit. hosted_ regulatory_ receipt_ urlnullable string A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.
- flow_details.
received_debit. initiating_ payment_ method_ detailsobject Details about how a ReceivedDebit was created.
- flow_details.
received_debit. initiating_payment_method_details. balancenullable enum Set when
typeisbalance.Possible enum valuespaymentsThe Stripe payments balance.
- flow_details.
received_debit. initiating_payment_method_details. billing_ detailsobject The contact details of the person or business referenced by the received payment method details.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. addressobject Billing address.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- flow_details.
received_debit. initiating_payment_method_details. billing_details. address. line1nullable string Address line 1, such as the street, PO Box, or company name.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. address. line2nullable string Address line 2, such as the apartment, suite, unit, or building.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. emailnullable string Email address.
- flow_details.
received_debit. initiating_payment_method_details. billing_details. namenullable string Full name.
- flow_details.
received_debit. initiating_payment_method_details. financial_ accountnullable object Set when
typeisfinancial_. This is a FinancialAccount ID.account - flow_details.
received_debit. initiating_payment_method_details. financial_account. idstring The FinancialAccount ID.
- flow_details.
received_debit. initiating_payment_method_details. financial_account. networkenum The rails the ReceivedCredit was sent over. A FinancialAccount can only send funds over
stripe.
- flow_details.
received_debit. initiating_payment_method_details. issuing_ cardnullable string Set when
typeisissuing_. This is an Issuing Card ID.card - flow_details.
received_debit. initiating_payment_method_details. typeenum Polymorphic type matching the originating money movement’s source. This can be an external account, a Stripe balance, or a FinancialAccount.
- flow_details.
received_debit. initiating_payment_method_details. us_ bank_ accountnullable object Set when
typeisus_.bank_ account - flow_details.
received_debit. initiating_payment_method_details. us_bank_account. bank_ namenullable string Bank name.
- flow_details.
received_debit. initiating_payment_method_details. us_bank_account. last4nullable string The last four digits of the bank account number.
- flow_details.
received_debit. initiating_payment_method_details. us_bank_account. routing_ numbernullable string The routing number for the bank account.
- flow_details.
received_debit. linked_ flowsobject Other flows linked to a ReceivedDebit.
- flow_details.
received_debit. linked_flows. debit_ reversalnullable string The DebitReversal created as a result of this ReceivedDebit being reversed.
- flow_details.
received_debit. linked_flows. inbound_ transfernullable string Set if the ReceivedDebit is associated with an InboundTransfer’s return of funds.
- flow_details.
received_debit. linked_flows. nullable string Set if the ReceivedDebit was created due to an Issuing Authorization object.
- flow_details.
received_debit. linked_flows. issuing_ transactionnullable string Set if the ReceivedDebit is also viewable as an Issuing Dispute object.
- flow_details.
received_debit. linked_flows. payoutnullable string Set if the ReceivedDebit was created due to a Payout object.
- flow_details.
received_debit. livemodeboolean Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - flow_details.
received_debit. networkenum The network used for the ReceivedDebit.
- flow_details.
received_debit. reversal_ detailsnullable object Details describing when a ReceivedDebit might be reversed.
- flow_details.
received_debit. reversal_details. deadlinenullable timestamp Time before which a ReceivedDebit can be reversed.
- flow_details.
received_debit. reversal_details. restricted_ reasonnullable enum Set if a ReceivedDebit can’t be reversed.
Possible enum valuesalready_reversed A ReceivedDebit that’s already reversed has this
restricted_. It may have areason deadlinepopulated.deadline_passed A ReceivedDebit that used to be reversible until the timestamp in
deadline, but is no longer reversible. ACH ReceivedDebits are only reversible for some time after they’re created.network_restricted Network constraints prevent Stripe from allowing reversal on some ReceivedDebits.
otherA ReceivedDebit that was reversed because of another reason.
source_flow_ restricted A ReceivedDebit that can’t be reversed because its
source_is not reversible.flow
- flow_details.
received_debit. statusenum Status of the ReceivedDebit. ReceivedDebits are created with a status of either
succeeded(approved) orfailed(declined). The failure reason can be found under thefailure_.code Possible enum valuesfailedThe ReceivedDebit was declined, and no Transaction was created.
succeededThe ReceivedDebit was approved.
- flow_details.
received_debit. transactionnullable stringExpandable The Transaction associated with this object.
- flow_details.
typeenum Type of the flow that created the Transaction. Set to the same value as
flow_.type Possible enum valuescredit_reversal The Transaction is associated with a CreditReversal.
debit_reversal The Transaction is associated with a DebitReversal.
inbound_transfer The Transaction is associated with an InboundTransfer.
issuing_authorization The Transaction is associated with an Issuing authorization.
otherThe Transaction is associated with some other money movement not listed above.
outbound_payment The Transaction is associated with an OutboundPayment.
outbound_transfer The Transaction is associated with an OutboundTransfer.
received_credit The Transaction is associated with a ReceivedCredit.
received_debit The Transaction is associated with a ReceivedDebit.
- flow_
typeenum Type of the flow associated with the TransactionEntry.
Possible enum valuescredit_reversal The Transaction is associated with a CreditReversal.
debit_reversal The Transaction is associated with a DebitReversal.
inbound_transfer The Transaction is associated with an InboundTransfer.
issuing_authorization The Transaction is associated with an Issuing authorization.
otherThe Transaction is associated with some other money movement not listed above.
outbound_payment The Transaction is associated with an OutboundPayment.
outbound_transfer The Transaction is associated with an OutboundTransfer.
received_credit The Transaction is associated with a ReceivedCredit.
received_debit The Transaction is associated with a ReceivedDebit.
- livemodeboolean
Has the value
trueif the object exists in live mode or the valuefalseif the object exists in test mode. - transactionstringExpandable
The Transaction associated with this object.
- typeenum
The specific money movement that generated the TransactionEntry.
Possible enum valuescredit_reversal The TransactionEntry was generated by a CreditReversal.
credit_reversal_ posting The TransactionEntry was generated by a posted CreditReversal.
debit_reversal The TransactionEntry was generated by a DebitReversal.
inbound_transfer The TransactionEntry was generated by an InboundTransfer.
inbound_transfer_ return The TransactionEntry was generated by an InboundTransferReturn.
issuing_authorization_ hold The TransactionEntry was generated by an Issuing authorization hold.
issuing_authorization_ release The TransactionEntry was generated by an Issuing authorization release.
otherThe TransactionEntry was generated by some other money movement.
outbound_payment The TransactionEntry was generated by an OutboundPayment.
outbound_payment_ cancellation The TransactionEntry was generated by a cancelled OutboundPayment.
Show 10 more
{ "id": "trxne_1MtkgV2eZvKYlo2CmofEnIwJ", "object": "treasury.transaction_entry", "balance_impact": { "cash": 0, "inbound_pending": 0, "outbound_pending": -1000 }, "created": 1680756271, "currency": "usd", "effective_at": 1680756271, "financial_account": "fa_1MtkgV2eZvKYlo2CdxyvnHeQ", "flow": "obt_1MtkgV2eZvKYlo2CCxhXVFLB", "flow_type": "outbound_transfer", "livemode": false, "transaction": "trxn_1MtkgV2eZvKYlo2CRYxD7KLh", "type": "outbound_transfer"}