Attributes
- idstring
Unique identifier for the object.
- objectstring
String representing the object’s type. Objects of the same type share the same value.
- amountinteger
Amount (in cents) transferred.
- balance_
impactobject The change made to each of the FinancialAccount’s sub-balances by the Transaction.
- 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.
- descriptionstring
An arbitrary string attached to the object. Often useful for displaying to users.
- entriesnullable objectExpandable
A list of TransactionEntries that are part of this Transaction. This cannot be expanded in any list endpoints.
- entries.
objectstring String representing the object’s type. Objects of the same type share the same value. Always has the value
list
. - entries.
dataarray of objects Details about each object.
- entries.
data. idstring Unique identifier for the object.
- entries.
data. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. balance_ impactobject The current impact of the TransactionEntry on the FinancialAccount’s balance.
- entries.
data. balance_impact. cashinteger The change made to funds the user can spend right now.
- entries.
data. balance_impact. inbound_ pendinginteger The change made to funds that are not spendable yet, but will become available at a later time.
- entries.
data. balance_impact. outbound_ pendinginteger The change made to funds in the account, but not spendable because they are being held for pending outbound flows.
- entries.
data. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. effective_ attimestamp When the TransactionEntry will impact the FinancialAccount’s balance.
- entries.
data. financial_ accountstring The FinancialAccount associated with this object.
- entries.
data. flownullable string Token of the flow associated with the TransactionEntry.
- entries.
data. flow_ detailsnullable objectExpandable Details of the flow associated with the TransactionEntry.
- entries.
data. flow_details. credit_ reversalnullable object The CreditReversal object associated with the Transaction. Set if
type=credit_
.reversal - entries.
data. flow_details. credit_reversal. idstring Unique identifier for the object.
- entries.
data. flow_details. credit_reversal. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. credit_reversal. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. credit_reversal. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. credit_reversal. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. credit_reversal. financial_ accountstring The FinancialAccount to reverse funds from.
- entries.
data. 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.
- entries.
data. flow_details. credit_reversal. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. credit_reversal. networkenum The rails used to reverse the funds.
- entries.
data. flow_details. credit_reversal. received_ creditstring The ReceivedCredit being reversed.
- entries.
data. flow_details. credit_reversal. statusenum Status of the CreditReversal
Possible enum valuescanceled
The CreditReversal has been canceled before it has been sent to the network and no funds have left the account. (Currently not supported).
posted
The CreditReversal has been sent to the network and funds have left the account (with the Transaction posting)
processing
The CreditReversal starting state. Funds are “held” by a pending Transaction (but they are still part of the current balance).
- entries.
data. flow_details. credit_reversal. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status
.- entries.
data. flow_details. credit_reversal. status_transitions. posted_ atnullable timestamp Timestamp describing when the CreditReversal changed status to
posted
- entries.
data. flow_details. credit_reversal. transactionnullable stringExpandable The Transaction associated with this object.
- entries.
data. flow_details. debit_ reversalnullable object The DebitReversal object associated with the Transaction. Set if
type=debit_
.reversal - entries.
data. flow_details. debit_reversal. idstring Unique identifier for the object.
- entries.
data. flow_details. debit_reversal. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. debit_reversal. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. debit_reversal. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. debit_reversal. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. debit_reversal. financial_ accountnullable string The FinancialAccount to reverse funds from.
- entries.
data. 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.
- entries.
data. flow_details. debit_reversal. linked_ flowsnullable object Other flows linked to a DebitReversal.
- entries.
data. flow_details. debit_reversal. linked_flows. issuing_ disputenullable string Set if there is an Issuing dispute associated with the DebitReversal.
- entries.
data. flow_details. debit_reversal. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. debit_reversal. networkenum The rails used to reverse the funds.
- entries.
data. flow_details. debit_reversal. received_ debitstring The ReceivedDebit being reversed.
- entries.
data. flow_details. debit_reversal. statusenum Status of the DebitReversal
Possible enum valuesfailed
The network has resolved the DebitReversal against the user.
processing
The DebitReversal starting state.
succeeded
The network has resolved the DebitReversal in the users favour. A crediting Transaction is created.
- entries.
data. flow_details. debit_reversal. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status
.- entries.
data. flow_details. debit_reversal. status_transitions. completed_ atnullable timestamp Timestamp describing when the DebitReversal changed status to
completed
.
- entries.
data. flow_details. debit_reversal. transactionnullable stringExpandable The Transaction associated with this object.
- entries.
data. flow_details. inbound_ transfernullable object The InboundTransfer object associated with the Transaction. Set if
type=inbound_
.transfer - entries.
data. flow_details. inbound_transfer. idstring Unique identifier for the object.
- entries.
data. flow_details. inbound_transfer. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. inbound_transfer. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. inbound_transfer. cancelableboolean Returns
true
if the InboundTransfer is able to be canceled. - entries.
data. flow_details. inbound_transfer. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. inbound_transfer. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. inbound_transfer. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- entries.
data. flow_details. inbound_transfer. failure_ detailsnullable object Details about this InboundTransfer’s failure. Only set when status is
failed
.- entries.
data. 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
- entries.
data. flow_details. inbound_transfer. financial_ accountstring The FinancialAccount that received the funds.
- entries.
data. 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.
- entries.
data. flow_details. inbound_transfer. linked_ flowsobject Other flows linked to a InboundTransfer.
- entries.
data. flow_details. inbound_transfer. linked_flows. received_ debitnullable string If funds for this flow were returned after the flow went to the
succeeded
state, this field contains a reference to the ReceivedDebit return.
- entries.
data. flow_details. inbound_transfer. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. inbound_transfer. origin_ payment_ methodnullable string The origin payment method to be debited for an InboundTransfer.
- entries.
data. flow_details. inbound_transfer. origin_ payment_ method_ detailsnullable object Details about the PaymentMethod for an InboundTransfer.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_ detailsobject Contact details for the person or business referenced by the PaymentMethod.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. addressobject Billing address.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. emailnullable string Email address.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. billing_details. namenullable string Full name.
- entries.
data. 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
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. us_ bank_ accountnullable object Optional fields for
us_
.bank_ account - entries.
data. flow_details. inbound_transfer. origin_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompany
Account belongs to a company
individual
Account belongs to an individual
- entries.
data. 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 valueschecking
Bank account type is checking
savings
Bank account type is savings
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- entries.
data. 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.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- entries.
data. 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.
- entries.
data. flow_details. inbound_transfer. origin_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- entries.
data. flow_details. inbound_transfer. returnednullable boolean Returns
true
if the funds for an InboundTransfer were returned after the InboundTransfer went to thesucceeded
state. - entries.
data. flow_details. inbound_transfer. statement_ descriptorstring Statement descriptor shown when funds are debited from the source. Not all payment networks support
statement_
.descriptor - entries.
data. flow_details. inbound_transfer. statusenum Status of the InboundTransfer:
processing
,succeeded
,failed
, andcanceled
. An InboundTransfer isprocessing
if it is created and pending. The status changes tosucceeded
once the funds have been “confirmed” and atransaction
is created and posted. The status changes tofailed
if the transfer fails. - entries.
data. flow_details. inbound_transfer. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status
.- entries.
data. flow_details. inbound_transfer. status_transitions. failed_ atnullable timestamp Timestamp describing when an InboundTransfer changed status to
failed
. - entries.
data. flow_details. inbound_transfer. status_transitions. succeeded_ atnullable timestamp Timestamp describing when an InboundTransfer changed status to
succeeded
.
- entries.
data. flow_details. inbound_transfer. transactionnullable stringExpandable The Transaction associated with this object.
- entries.
data. flow_details. nullable object The Issuing authorization object associated with the Transaction. Set if
type=issuing_
.authorization - entries.
data. flow_details. issuing_authorization. string Unique identifier for the object.
- entries.
data. flow_details. issuing_authorization. string String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. issuing_authorization. integer The total amount that was authorized or rejected. This amount is in
currency
and in the smallest currency unit.amount
should be the same asmerchant_
, unlessamount currency
andmerchant_
are different.currency - entries.
data. flow_details. issuing_authorization. nullable object Detailed breakdown of amount components. These amounts are denominated in
currency
and in the smallest currency unit.- entries.
data. flow_details. issuing_authorization. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- entries.
data. flow_details. issuing_authorization. amount_details. nullable integer The amount of cash requested by the cardholder.
- entries.
data. flow_details. issuing_authorization. boolean Whether the authorization has been approved.
- entries.
data. flow_details. issuing_authorization. enum How the card details were provided.
Possible enum valueschip
The card was physically present and inserted into a chip-enabled terminal. The transaction is cryptographically secured.
contactless
The card was tapped on a contactless-enabled terminal. If a digital wallet copy of the card was used, the
wallet
field will be present.keyed_
in The card number was manually entered into a terminal.
online
The card was used in a card-not-present scenario, such as a transaction initiated at an online e-commerce checkout.
swipe
The card was physically swiped in a terminal.
- entries.
data. flow_details. issuing_authorization. array of objects List of balance transactions associated with this authorization.
- entries.
data. flow_details. issuing_authorization. balance_transactions. string Unique identifier for the object.
- entries.
data. flow_details. issuing_authorization. balance_transactions. string String representing the object’s type. Objects of the same type share the same value.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. balance_transactions. timestamp The date that the transaction’s net funds become available in the Stripe balance.
- entries.
data. flow_details. issuing_authorization. balance_transactions. enumPreview feature The balance that this transaction impacts.
Possible enum valuesissuing
Balance Transactions that affect your Issuing balance
payments
Balance Transactions that affect your Payments balance
refund_
and_ dispute_ prefunding Balance Transactions that affect your Refund and Dispute Prefunding balance
- entries.
data. flow_details. issuing_authorization. balance_transactions. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. issuing_authorization. balance_transactions. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. issuing_authorization. balance_transactions. nullable string An arbitrary string attached to the object. Often useful for displaying to users.
- entries.
data. 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
amount
in currency A, multipled by theexchange_
, equals therate amount
in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent’samount
is1000
andcurrency
iseur
. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction’samount
is1234
, itscurrency
isusd
, and theexchange_
israte 1.
.234 - entries.
data. flow_details. issuing_authorization. balance_transactions. integer Fees (in cents) paid for this transaction. Represented as a positive integer when assessed.
- entries.
data. flow_details. issuing_authorization. balance_transactions. array of objects Detailed breakdown of fees (in cents) paid for this transaction.
- entries.
data. flow_details. issuing_authorization. balance_transactions. fee_details. integer Amount of the fee, in cents.
- entries.
data. flow_details. issuing_authorization. balance_transactions. fee_details. nullable string ID of the Connect application that earned the fee.
- entries.
data. flow_details. issuing_authorization. balance_transactions. fee_details. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. issuing_authorization. balance_transactions. fee_details. nullable string An arbitrary string attached to the object. Often useful for displaying to users.
- entries.
data. flow_details. issuing_authorization. balance_transactions. fee_details. string Type of the fee, one of:
application_
,fee payment_
,method_ passthrough_ fee stripe_
orfee tax
.
- entries.
data. 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
- entries.
data. flow_details. issuing_authorization. balance_transactions. string Learn more about how reporting categories can help you understand balance transactions from an accounting perspective.
- entries.
data. flow_details. issuing_authorization. balance_transactions. nullable stringExpandable This transaction relates to the Stripe object.
- entries.
data. flow_details. issuing_authorization. balance_transactions. string The transaction’s net funds status in the Stripe balance, which are either
available
orpending
. - entries.
data. 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 valuesadjustment
advance
advance_
funding anticipation_
repayment application_
fee application_
fee_ refund charge
climate_
order_ purchase climate_
order_ refund connect_
collection_ transfer Show 34 more
- entries.
data. flow_details. issuing_authorization. object Card associated with this authorization.
- entries.
data. flow_details. issuing_authorization. card. string Unique identifier for the object.
- entries.
data. flow_details. issuing_authorization. card. string String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. issuing_authorization. card. string The brand of the card.
- entries.
data. 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.
lost
The card was lost.
stolen
The card was stolen.
- entries.
data. flow_details. issuing_authorization. card. object The Cardholder object to which the card belongs.
- entries.
data. flow_details. issuing_authorization. card. cardholder. string Unique identifier for the object.
- entries.
data. flow_details. issuing_authorization. card. cardholder. string String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. issuing_authorization. card. cardholder. object The cardholder’s billing information.
- entries.
data. flow_details. issuing_authorization. card. cardholder. billing. object The cardholder’s billing address.
- entries.
data. flow_details. issuing_authorization. card. cardholder. billing. address. nullable string City, district, suburb, town, or village.
- entries.
data. flow_details. issuing_authorization. card. cardholder. billing. address. nullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. issuing_authorization. card. cardholder. billing. address. nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. issuing_authorization. card. cardholder. billing. address. nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. issuing_authorization. card. cardholder. billing. address. nullable string ZIP or postal code.
- entries.
data. flow_details. issuing_authorization. card. cardholder. billing. address. nullable string State, county, province, or region.
- entries.
data. flow_details. issuing_authorization. card. cardholder. nullable object Additional information about a
company
cardholder.- entries.
data. flow_details. issuing_authorization. card. cardholder. company. boolean Whether the company’s business ID number was provided.
- entries.
data. flow_details. issuing_authorization. card. cardholder. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. issuing_authorization. card. cardholder. nullable string The cardholder’s email address.
- entries.
data. flow_details. issuing_authorization. card. cardholder. nullable object Additional information about an
individual
cardholder.- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. nullable object Information related to the card_issuing program for this cardholder.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. nullable object The date of birth of this cardholder.
- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. dob. nullable integer The day of birth, between 1 and 31.
- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. dob. nullable integer The month of birth, between 1 and 12.
- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. dob. nullable integer The four-digit year of birth.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. nullable object Government-issued ID document for this cardholder.
- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. verification. nullable object An identifying document, either a passport or local ID card.
- entries.
data. flow_details. issuing_authorization. card. cardholder. individual. verification. document. nullable stringExpandable The back of a document returned by a file upload with a
purpose
value ofidentity_
.document - entries.
data. flow_details. issuing_authorization. card. cardholder. individual. verification. document. nullable stringExpandable The front of a document returned by a file upload with a
purpose
value ofidentity_
.document
- entries.
data. flow_details. issuing_authorization. card. cardholder. boolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. cardholder. string The cardholder’s name. This will be printed on cards issued to them.
- entries.
data. 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.
- entries.
data. 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. - entries.
data. flow_details. issuing_authorization. card. cardholder. object Information about verification requirements for the cardholder.
- entries.
data. 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 valueslisted
Account 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 - entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. cardholder. nullable object Rules that control spending across this cardholder’s cards. Refer to our documentation for more details.
- entries.
data. 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 - entries.
data. 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 - entries.
data. 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 - entries.
data. 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 - entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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 - entries.
data. 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.
daily
Limit applies to a day, starting at midnight UTC.
monthly
Limit applies to a month, starting on the 1st at midnight UTC.
per_
authorization Limit applies to each authorization.
weekly
Limit applies to a week, starting on Sunday at midnight UTC.
yearly
Limit applies to a year, starting on January 1st at midnight UTC.
- entries.
data. flow_details. issuing_authorization. card. cardholder. spending_controls. nullable enum Currency of the amounts within
spending_
.limits
- entries.
data. flow_details. issuing_authorization. card. cardholder. enum Specifies whether to permit authorizations on this cardholder’s cards.
Possible enum valuesactive
Cards attached to this cardholder can approve authorizations.
blocked
Cards attached to this cardholder will decline all authorizations with the
cardholder_
reason. This status is non-reversible.blocked inactive
Cards attached to this cardholder will decline all authorizations with the
cardholder_
reason.inactive - entries.
data. flow_details. issuing_authorization. card. cardholder. enum One of
individual
orcompany
. See Choose a cardholder type for more details.Possible enum valuescompany
The 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.
individual
The 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.
- entries.
data. flow_details. issuing_authorization. card. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. issuing_authorization. card. enum Three-letter ISO currency code, in lowercase. Supported currencies are
usd
in the US,eur
in the EU, andgbp
in the UK. - entries.
data. 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
expand
parameter. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint. - entries.
data. flow_details. issuing_authorization. card. integer The expiration month of the card.
- entries.
data. flow_details. issuing_authorization. card. integer The expiration year of the card.
- entries.
data. flow_details. issuing_authorization. card. string The last 4 digits of the card number.
- entries.
data. flow_details. issuing_authorization. card. boolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. 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
expand
parameter. Additionally, it’s only available via the “Retrieve a card” endpoint, not via “List all cards” or any other endpoint. - entries.
data. flow_details. issuing_authorization. card. nullable stringExpandable The personalization design object belonging to this card.
- entries.
data. flow_details. issuing_authorization. card. nullable stringExpandable The latest card that replaces this card, if any.
- entries.
data. flow_details. issuing_authorization. card. nullable stringExpandable The card this card replaces, if any.
- entries.
data. flow_details. issuing_authorization. card. nullable enum The reason why the previous card needed to be replaced.
Possible enum valuesdamaged
The physical card has been damaged and cannot be used at terminals. This reason is only valid for cards of type
physical
.expired
The expiration date has passed or is imminent.
lost
The card was lost. This status is only valid if the card it replaces is marked as lost.
stolen
The card was stolen. This status is only valid if the card it replaces is marked as stolen.
- entries.
data. flow_details. issuing_authorization. card. nullable object Where and how the card will be shipped.
- entries.
data. flow_details. issuing_authorization. card. shipping. object Shipping address.
- entries.
data. flow_details. issuing_authorization. card. shipping. address. nullable string City, district, suburb, town, or village.
- entries.
data. flow_details. issuing_authorization. card. shipping. address. nullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. issuing_authorization. card. shipping. address. nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. issuing_authorization. card. shipping. address. nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. issuing_authorization. card. shipping. address. nullable string ZIP or postal code.
- entries.
data. flow_details. issuing_authorization. card. shipping. address. nullable string State, county, province, or region.
- entries.
data. flow_details. issuing_authorization. card. shipping. nullable object Address validation details for the shipment.
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. enum The address validation capabilities to use.
Possible enum valuesdisabled
The 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.
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. nullable object The normalized shipping address.
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. normalized_address. nullable string City, district, suburb, town, or village.
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. normalized_address. nullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. normalized_address. nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. normalized_address. nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. normalized_address. nullable string ZIP or postal code.
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. normalized_address. nullable string State, county, province, or region.
- entries.
data. flow_details. issuing_authorization. card. shipping. address_validation. nullable enum The validation result for the shipping address.
Possible enum valuesindeterminate
The 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.
- entries.
data. flow_details. issuing_authorization. card. shipping. nullable enum The delivery company that shipped a card.
Possible enum valuesdhl
DHL
fedex
FedEx
royal_
mail Royal Mail
usps
USPS
- entries.
data. flow_details. issuing_authorization. card. shipping. nullable object Additional information that may be required for clearing customs.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. shipping. nullable timestamp A unix timestamp representing a best estimate of when the card will be delivered.
- entries.
data. flow_details. issuing_authorization. card. shipping. string Recipient name.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. shipping. enum Shipment service, such as
standard
orexpress
.Possible enum valuesexpress
Cards arrive in 4 business days.
priority
Cards arrive in 2-3 business days.
standard
Cards arrive in 5-8 business days.
- entries.
data. flow_details. issuing_authorization. card. shipping. nullable enum The delivery status of the card.
Possible enum valuescanceled
The card was canceled before being shipped.
delivered
The card has been delivered to its destination.
failure
The card failed to be delivered but was not returned.
pending
The card is being prepared and has not yet shipped.
returned
The card failed to be delivered and was returned to the sender.
shipped
The card has been shipped. If the card’s shipping carrier does not support tracking, this will be the card’s final status.
submitted
The card has been submitted to the printer for shipment.
- entries.
data. flow_details. issuing_authorization. card. shipping. nullable string A tracking number for a card shipment.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. shipping. enum Packaging options.
Possible enum valuesbulk
Cards are grouped and mailed together.
individual
Cards are sent individually in an envelope.
- entries.
data. flow_details. issuing_authorization. card. object Rules that control spending for this card. Refer to our documentation for more details.
- entries.
data. 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 - entries.
data. 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 - entries.
data. 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 - entries.
data. 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 - entries.
data. 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 - entries.
data. 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.
- entries.
data. 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 - entries.
data. 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.
daily
Limit applies to a day, starting at midnight UTC.
monthly
Limit applies to a month, starting on the 1st at midnight UTC.
per_
authorization Limit applies to each authorization.
weekly
Limit applies to a week, starting on Sunday at midnight UTC.
yearly
Limit applies to a year, starting on January 1st at midnight UTC.
- entries.
data. 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
- entries.
data. 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 valuesactive
The 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’.
canceled
The card will decline authorizations with the
card_
reason. This status is permanent.canceled inactive
The card will decline authorizations with the
card_
reason.inactive - entries.
data. flow_details. issuing_authorization. card. enum The type of the card.
Possible enum valuesphysical
A physical card will be printed and shipped. It can be used at physical terminals.
virtual
No physical card will be printed. The card can be used online and can be added to digital wallets.
- entries.
data. flow_details. issuing_authorization. card. nullable object Information relating to digital wallets (like Apple Pay and Google Pay).
- entries.
data. flow_details. issuing_authorization. card. wallets. object Apple Pay Details
- entries.
data. flow_details. issuing_authorization. card. wallets. apple_pay. boolean Apple Pay Eligibility
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. wallets. object Google Pay Details
- entries.
data. flow_details. issuing_authorization. card. wallets. google_pay. boolean Google Pay Eligibility
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. card. wallets. nullable string Unique identifier for a card used with digital wallets
- entries.
data. flow_details. issuing_authorization. nullable stringExpandable The cardholder to whom this authorization belongs.
- entries.
data. flow_details. issuing_authorization. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. 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 - entries.
data. flow_details. issuing_authorization. nullable object Fleet-specific information for authorizations using Fleet cards.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. fleet. cardholder_prompt_data. nullable string Driver ID.
- entries.
data. flow_details. issuing_authorization. fleet. cardholder_prompt_data. nullable integer Odometer reading.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. fleet. cardholder_prompt_data. nullable string User ID.
- entries.
data. flow_details. issuing_authorization. fleet. cardholder_prompt_data. nullable string Vehicle number.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. fleet. reported_breakdown. nullable object Breakdown of fuel portion of the purchase.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. fleet. reported_breakdown. nullable object Breakdown of non-fuel portion of the purchase.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. fleet. reported_breakdown. nullable object Information about tax included in this transaction.
- entries.
data. flow_details. issuing_authorization. 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. - entries.
data. flow_details. issuing_authorization. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. nullable array of objectsExpandable Fraud challenges sent to the cardholder, if this authorization was declined for fraud risk reasons.
- entries.
data. flow_details. issuing_authorization. fraud_challenges. enum The method by which the fraud challenge was delivered to the cardholder.
Possible enum valuessms
SMS sent to the cardholder’s phone number.
- entries.
data. flow_details. issuing_authorization. fraud_challenges. enum The status of the fraud challenge.
Possible enum valuesexpired
The 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.
pending
The challenge has been sent to the cardholder or is about to be sent.
rejected
The cardholder responded to the challenge indicating that the authorization was fraudulent, and that similar authorizations should continue to be declined.
undeliverable
A challenge has been requested to be sent, but the cardholder is unable to receive it.
verified
The cardholder responded to the challenge indicating that the authorization was not fraudulent, and that similar authorizations should be approved.
- entries.
data. 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
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. fuel. nullable string Conexxus Payment System Product Code identifying the primary fuel product purchased.
- entries.
data. flow_details. issuing_authorization. fuel. nullable decimal string The quantity of
unit
s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places. - entries.
data. flow_details. issuing_authorization. fuel. nullable enum The type of fuel that was purchased.
Possible enum valuesdiesel
Diesel.
other
Other.
unleaded_
plus Unleaded plus.
unleaded_
regular Unleaded regular.
unleaded_
super Unleaded super.
- entries.
data. flow_details. issuing_authorization. fuel. nullable enum The units for
quantity_
.decimal Possible enum valuescharging_
minute Charging minute.
imperial_
gallon Imperial gallon.
kilogram
Kilogram.
kilowatt_
hour Kilowatt-hour.
liter
Liter.
other
Other.
pound
Pound.
us_
gallon US gallon.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. boolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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 currency
are different. - entries.
data. 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
currency
field on this authorization. Three-letter ISO currency code, in lowercase. Must be a supported currency. - entries.
data. flow_details. issuing_authorization. object Details about the seller (grocery store, e-commerce website, etc.) where the card authorization happened.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. merchant_data. string The merchant category code for the seller’s business
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string City where the seller is located
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string Country where the seller is located
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string Name of the seller
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string Postal code where the seller is located
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string State where the seller is located
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string The seller’s tax identification number. Currently populated for French merchants only.
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string An ID assigned by the seller to the location of the sale.
- entries.
data. flow_details. issuing_authorization. merchant_data. nullable string URL provided by the merchant on a 3DS request
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. nullable object Details about the authorization, such as identifiers, set by the card network.
- entries.
data. 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
. - entries.
data. 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 - entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. nullable object The pending authorization request. This field will only be non-null during an
issuing_
webhook.authorization. request - entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. pending_request. nullable object Detailed breakdown of amount components. These amounts are denominated in
currency
and in the smallest currency unit.- entries.
data. flow_details. issuing_authorization. pending_request. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- entries.
data. flow_details. issuing_authorization. pending_request. amount_details. nullable integer The amount of cash requested by the cardholder.
- entries.
data. flow_details. issuing_authorization. pending_request. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. issuing_authorization. pending_request. boolean If set
true
, you may provide amount to control how much to hold for the authorization. - entries.
data. 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 - entries.
data. flow_details. issuing_authorization. pending_request. enum The local currency the merchant is requesting to authorize.
- entries.
data. 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.
- entries.
data. 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 - entries.
data. 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 - entries.
data. flow_details. issuing_authorization. request_history. nullable object Detailed breakdown of amount components. These amounts are denominated in
currency
and in the smallest currency unit.- entries.
data. flow_details. issuing_authorization. request_history. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- entries.
data. flow_details. issuing_authorization. request_history. amount_details. nullable integer The amount of cash requested by the cardholder.
- entries.
data. flow_details. issuing_authorization. request_history. boolean Whether this request was approved.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. request_history. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. issuing_authorization. request_history. string Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. 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 - entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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 - entries.
data. 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 - entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. enum The current status of the authorization in its lifecycle.
Possible enum valuesclosed
The authorization was declined or captured through one or more transactions.
expired
The authorization was expired without capture.
pending
The authorization was created and is awaiting approval or was approved and is awaiting capture.
reversed
The authorization was reversed by the merchant.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. array of objects List of transactions associated with this authorization.
- entries.
data. flow_details. issuing_authorization. transactions. string Unique identifier for the object.
- entries.
data. flow_details. issuing_authorization. transactions. string String representing the object’s type. Objects of the same type share the same value.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. nullable object Detailed breakdown of amount components. These amounts are denominated in
currency
and in the smallest currency unit.- entries.
data. flow_details. issuing_authorization. transactions. amount_details. nullable integer The fee charged by the ATM for the cash withdrawal.
- entries.
data. flow_details. issuing_authorization. transactions. amount_details. nullable integer The amount of cash requested by the cardholder.
- entries.
data. flow_details. issuing_authorization. transactions. nullable stringExpandable The
Authorization
object that led to this transaction. - entries.
data. flow_details. issuing_authorization. transactions. nullable stringExpandable ID of the balance transaction associated with this transaction.
- entries.
data. flow_details. issuing_authorization. transactions. stringExpandable The card used to make this transaction.
- entries.
data. flow_details. issuing_authorization. transactions. nullable stringExpandable The cardholder to whom this transaction belongs.
- entries.
data. flow_details. issuing_authorization. transactions. timestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. issuing_authorization. transactions. enum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. issuing_authorization. transactions. nullable stringExpandable If you’ve disputed the transaction, the ID of the dispute.
- entries.
data. flow_details. issuing_authorization. transactions. boolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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 amount
if the merchant is taking payment in a different currency. - entries.
data. flow_details. issuing_authorization. transactions. enum The currency with which the merchant is taking payment.
- entries.
data. flow_details. issuing_authorization. transactions. object Details about the seller (grocery store, e-commerce website, etc.) involved in this transaction.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. string The merchant category code for the seller’s business
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string City where the seller is located
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string Country where the seller is located
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string Name of the seller
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string Postal code where the seller is located
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string State where the seller is located
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string The seller’s tax identification number. Currently populated for French merchants only.
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string An ID assigned by the seller to the location of the sale.
- entries.
data. flow_details. issuing_authorization. transactions. merchant_data. nullable string URL provided by the merchant on a 3DS request
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. nullable object Details about the transaction, such as processing dates, set by the card network.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. nullable objectExpandable Additional purchase information that is optionally provided by the merchant.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. nullable object Fleet-specific information for transactions using Fleet cards.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. nullable object Answers to prompts presented to cardholder at point of sale.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable string Driver ID.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable integer Odometer reading.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable string User ID.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. cardholder_prompt_data. nullable string Vehicle number.
- entries.
data. 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 - entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. nullable object Breakdown of fuel portion of the purchase.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. nullable object Breakdown of non-fuel portion of the purchase.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. reported_breakdown. nullable object Information about tax included in this transaction.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fleet. nullable string The type of fuel service. One of
non_
,fuel_ transaction full_
, orservice self_
.service
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. nullable object Information about the flight that was purchased with this transaction.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. nullable integer The time that the flight departed.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. nullable string The name of the passenger.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. nullable boolean Whether the ticket is refundable.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. nullable array of objects The legs of the trip.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. segments. nullable string The three-letter IATA airport code of the flight’s destination.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. segments. nullable string The airline carrier code.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. segments. nullable string The three-letter IATA airport code that the flight departed from.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. segments. nullable string The flight number.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. segments. nullable string The flight’s service class.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. segments. nullable boolean Whether a stopover is allowed on this flight.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. flight. nullable string The travel agency that issued the ticket.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. nullable object Information about fuel that was purchased with this transaction.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fuel. nullable string Conexxus Payment System Product Code identifying the primary fuel product purchased.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. fuel. nullable decimal string The quantity of
unit
s of fuel that was dispensed, represented as a decimal string with at most 12 decimal places. - entries.
data. 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
. - entries.
data. 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
. - entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. nullable object Information about lodging that was purchased with this transaction.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. lodging. nullable integer The time of checking into the lodging.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. lodging. nullable integer The number of nights stayed at the lodging.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. nullable array of objects The line items in the purchase.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. receipt. nullable string The description of the item. The maximum length of this field is 26 characters.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. receipt. nullable float The quantity of the item.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. receipt. nullable integer The total for this line item in cents.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. receipt. nullable integer The unit cost of the item in cents.
- entries.
data. flow_details. issuing_authorization. transactions. purchase_details. nullable string A merchant-specific order number.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. transactions. enum The nature of the transaction.
Possible enum valuescapture
Funds were captured by the acquirer.
amount
will 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.refund
An acquirer initiated a refund. This transaction might not be linked to an original capture, for example credits are original transactions.
amount
will be positive for refunds and negative for refund reversals (very rare). - entries.
data. flow_details. issuing_authorization. transactions. nullable enum The digital wallet used for this transaction. One of
apple_
,pay google_
, orpay samsung_
.pay
- entries.
data. flow_details. issuing_authorization. object Verifications that Stripe performed on information that the cardholder provided to the merchant.
- entries.
data. 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 valuesmatch
Verification succeeded, values matched.
mismatch
Verification failed, values didn’t match.
not_
provided Verification was not performed because no value was provided.
- entries.
data. 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 valuesmatch
Verification succeeded, values matched.
mismatch
Verification failed, values didn’t match.
not_
provided Verification was not performed because no value was provided.
- entries.
data. flow_details. issuing_authorization. verification_data. nullable object The exemption applied to this authorization.
- entries.
data. 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 valuesacquirer
Acquiring merchant.
issuer
Issuing user.
- entries.
data. 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.
unknown
Specifies an unknown exemption type.
- entries.
data. flow_details. issuing_authorization. verification_data. enum Whether the cardholder provided a CVC and if it matched Stripe’s record.
Possible enum valuesmatch
Verification succeeded, values matched.
mismatch
Verification failed, values didn’t match.
not_
provided Verification was not performed because no value was provided.
- entries.
data. flow_details. issuing_authorization. verification_data. enum Whether the cardholder provided an expiry date and if it matched Stripe’s record.
Possible enum valuesmatch
Verification succeeded, values matched.
mismatch
Verification failed, values didn’t match.
not_
provided Verification was not performed because no value was provided.
- entries.
data. flow_details. issuing_authorization. verification_data. nullable string The postal code submitted as part of the authorization used for postal code verification.
- entries.
data. flow_details. issuing_authorization. verification_data. nullable object 3D Secure details.
- entries.
data. 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.
authenticated
Authentication successful.
failed
Authentication failed.
required
The 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.
- entries.
data. 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.
- entries.
data. flow_details. issuing_authorization. nullable string The digital wallet used for this transaction. One of
apple_
,pay google_
, orpay samsung_
. Will populate aspay null
when no digital wallet was utilized.
- entries.
data. flow_details. outbound_ paymentnullable object The OutboundPayment object associated with the Transaction. Set if
type=outbound_
.payment - entries.
data. flow_details. outbound_payment. idstring Unique identifier for the object.
- entries.
data. flow_details. outbound_payment. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. outbound_payment. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. outbound_payment. cancelableboolean Returns
true
if the object can be canceled, andfalse
otherwise. - entries.
data. flow_details. outbound_payment. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. outbound_payment. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. outbound_payment. customernullable string ID of the customer to whom an OutboundPayment is sent.
- entries.
data. flow_details. outbound_payment. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- entries.
data. 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 - entries.
data. flow_details. outbound_payment. destination_ payment_ method_ detailsnullable object Details about the PaymentMethod for an OutboundPayment.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_ detailsobject Contact details for the person or business receiving the OutboundPayment.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. addressobject Billing address.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. emailnullable string Email address.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. billing_details. namenullable string Full name.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. financial_ accountnullable object Details about the
financial_
.account - entries.
data. flow_details. outbound_payment. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- entries.
data. 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 - entries.
data. flow_details. outbound_payment. destination_payment_method_details. us_ bank_ accountnullable object Details about the
us_
.bank_ account - entries.
data. flow_details. outbound_payment. destination_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompany
Account belongs to a company
individual
Account belongs to an individual
- entries.
data. 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 valueschecking
Bank account type is checking
savings
Bank account type is savings
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- entries.
data. 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.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- entries.
data. 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 valuesach
ACH network
us_
domestic_ wire US domestic wire network
- entries.
data. flow_details. outbound_payment. destination_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- entries.
data. flow_details. outbound_payment. end_ user_ detailsnullable object Details about the end user.
- entries.
data. flow_details. outbound_payment. end_user_details. ip_ addressnullable string IP address of the user initiating the OutboundPayment. Set if
present
is 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. - entries.
data. flow_details. outbound_payment. end_user_details. presentboolean true
if the OutboundPayment creation request is being made on behalf of an end user by a platform. Otherwise,false
.
- entries.
data. flow_details. outbound_payment. expected_ arrival_ datetimestamp The date when funds are expected to arrive in the destination account.
- entries.
data. flow_details. outbound_payment. financial_ accountstring The FinancialAccount that funds were pulled from.
- entries.
data. 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.
- entries.
data. flow_details. outbound_payment. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. outbound_payment. returned_ detailsnullable object Details about a returned OutboundPayment. Only set when the status is
returned
.- entries.
data. 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.
declined
The 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.
other
The destination could not process this OutboundPayment.
- entries.
data. flow_details. outbound_payment. returned_details. transactionstringExpandable The Transaction associated with this object.
- entries.
data. 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).
- entries.
data. flow_details. outbound_payment. statusenum Current status of the OutboundPayment:
processing
,failed
,posted
,returned
,canceled
. An OutboundPayment isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundPayment has been “confirmed” and funds have left the account, or tofailed
orcanceled
. If an OutboundPayment fails to arrive at its destination, its status will change toreturned
. - entries.
data. flow_details. outbound_payment. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status
.- entries.
data. flow_details. outbound_payment. status_transitions. canceled_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
canceled
. - entries.
data. flow_details. outbound_payment. status_transitions. failed_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
failed
. - entries.
data. flow_details. outbound_payment. status_transitions. posted_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
posted
. - entries.
data. flow_details. outbound_payment. status_transitions. returned_ atnullable timestamp Timestamp describing when an OutboundPayment changed status to
returned
.
- entries.
data. flow_details. outbound_payment. tracking_ detailsnullable object Details about network-specific tracking information if available.
- entries.
data. flow_details. outbound_payment. tracking_details. achnullable object ACH network tracking details.
- entries.
data. flow_details. outbound_payment. tracking_details. ach. trace_ idstring ACH trace ID of the OutboundPayment for payments sent over the
ach
network.
- entries.
data. flow_details. outbound_payment. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesach
us_
domestic_ wire - entries.
data. flow_details. outbound_payment. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- entries.
data. 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 - entries.
data. flow_details. outbound_payment. tracking_details. us_domestic_wire. imadnullable string IMAD of the OutboundPayment for payments sent over the
us_
network.domestic_ wire - entries.
data. flow_details. outbound_payment. tracking_details. us_domestic_wire. omadnullable string OMAD of the OutboundPayment for payments sent over the
us_
network.domestic_ wire
- entries.
data. flow_details. outbound_payment. transactionstringExpandable The Transaction associated with this object.
- entries.
data. flow_details. outbound_ transfernullable object The OutboundTransfer object associated with the Transaction. Set if
type=outbound_
.transfer - entries.
data. flow_details. outbound_transfer. idstring Unique identifier for the object.
- entries.
data. flow_details. outbound_transfer. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. outbound_transfer. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. outbound_transfer. cancelableboolean Returns
true
if the object can be canceled, andfalse
otherwise. - entries.
data. flow_details. outbound_transfer. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. outbound_transfer. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. outbound_transfer. descriptionnullable string An arbitrary string attached to the object. Often useful for displaying to users.
- entries.
data. flow_details. outbound_transfer. destination_ payment_ methodnullable string The PaymentMethod used as the payment instrument for an OutboundTransfer.
- entries.
data. flow_details. outbound_transfer. destination_ payment_ method_ detailsobject Details about the PaymentMethod for an OutboundTransfer
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_ detailsobject Contact details for the person or business receiving the OutboundTransfer.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. addressobject Billing address.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. emailnullable string Email address.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. billing_details. namenullable string Full name.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. financial_ accountnullable objectPreview feature Details about the
financial_
.account - entries.
data. flow_details. outbound_transfer. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. typeenum The type of the payment method used in the OutboundTransfer.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. us_ bank_ accountnullable object Details about the
us_
.bank_ account - entries.
data. flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. account_ holder_ typenullable enum Account holder type: individual or company.
Possible enum valuescompany
Account belongs to a company
individual
Account belongs to an individual
- entries.
data. 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 valueschecking
Bank account type is checking
savings
Bank account type is savings
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. bank_ namenullable string Name of the bank associated with the bank account.
- entries.
data. 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.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. last4nullable string Last four digits of the bank account number.
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. mandatenullable stringExpandable ID of the mandate used to make this payment.
- entries.
data. 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 valuesach
ACH network
us_
domestic_ wire US domestic wire network
- entries.
data. flow_details. outbound_transfer. destination_payment_method_details. us_bank_account. routing_ numbernullable string Routing number of the bank account.
- entries.
data. flow_details. outbound_transfer. expected_ arrival_ datetimestamp The date when funds are expected to arrive in the destination account.
- entries.
data. flow_details. outbound_transfer. financial_ accountstring The FinancialAccount that funds were pulled from.
- entries.
data. 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.
- entries.
data. flow_details. outbound_transfer. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. outbound_transfer. returned_ detailsnullable object Details about a returned OutboundTransfer. Only set when the status is
returned
.- entries.
data. 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.
declined
The 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.
other
The destination could not process this OutboundTransfer.
- entries.
data. flow_details. outbound_transfer. returned_details. transactionstringExpandable The Transaction associated with this object.
- entries.
data. flow_details. outbound_transfer. statement_ descriptorstring Information about the OutboundTransfer to be sent to the recipient account.
- entries.
data. flow_details. outbound_transfer. statusenum Current status of the OutboundTransfer:
processing
,failed
,canceled
,posted
,returned
. An OutboundTransfer isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundTransfer has been “confirmed” and funds have left the account, or tofailed
orcanceled
. If an OutboundTransfer fails to arrive at its destination, its status will change toreturned
. - entries.
data. flow_details. outbound_transfer. status_ transitionsobject Hash containing timestamps of when the object transitioned to a particular
status
.- entries.
data. flow_details. outbound_transfer. status_transitions. canceled_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
canceled
- entries.
data. flow_details. outbound_transfer. status_transitions. failed_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
failed
- entries.
data. flow_details. outbound_transfer. status_transitions. posted_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
posted
- entries.
data. flow_details. outbound_transfer. status_transitions. returned_ atnullable timestamp Timestamp describing when an OutboundTransfer changed status to
returned
- entries.
data. flow_details. outbound_transfer. tracking_ detailsnullable object Details about network-specific tracking information if available.
- entries.
data. flow_details. outbound_transfer. tracking_details. achnullable object ACH network tracking details.
- entries.
data. flow_details. outbound_transfer. tracking_details. ach. trace_ idstring ACH trace ID of the OutboundTransfer for transfers sent over the
ach
network.
- entries.
data. flow_details. outbound_transfer. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesach
us_
domestic_ wire - entries.
data. flow_details. outbound_transfer. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- entries.
data. 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 - entries.
data. flow_details. outbound_transfer. tracking_details. us_domestic_wire. imadnullable string IMAD of the OutboundTransfer for transfers sent over the
us_
network.domestic_ wire - entries.
data. flow_details. outbound_transfer. tracking_details. us_domestic_wire. omadnullable string OMAD of the OutboundTransfer for transfers sent over the
us_
network.domestic_ wire
- entries.
data. flow_details. outbound_transfer. transactionstringExpandable The Transaction associated with this object.
- entries.
data. flow_details. received_ creditnullable object The ReceivedCredit object associated with the Transaction. Set if
type=received_
.credit - entries.
data. flow_details. received_credit. idstring Unique identifier for the object.
- entries.
data. flow_details. received_credit. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. received_credit. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. received_credit. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. received_credit. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. received_credit. descriptionstring An arbitrary string attached to the object. Often useful for displaying to users.
- entries.
data. 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.
other
Funds can’t be sent to FinancialAccount for other reasons.
- entries.
data. flow_details. received_credit. financial_ accountnullable string The FinancialAccount that received the funds.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. initiating_ payment_ method_ detailsobject Details about the PaymentMethod used to send a ReceivedCredit.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. balancenullable enum Set when
type
isbalance
.Possible enum valuespayments
The Stripe payments balance.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. addressobject Billing address.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. emailnullable string Email address.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. billing_details. namenullable string Full name.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. financial_ accountnullable object Set when
type
isfinancial_
. This is a FinancialAccount ID.account - entries.
data. flow_details. received_credit. initiating_payment_method_details. financial_account. idstring The FinancialAccount ID.
- entries.
data. 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
.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. issuing_ cardnullable string Set when
type
isissuing_
. This is an Issuing Card ID.card - entries.
data. 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.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. us_ bank_ accountnullable object Set when
type
isus_
.bank_ account - entries.
data. flow_details. received_credit. initiating_payment_method_details. us_bank_account. bank_ namenullable string Bank name.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. us_bank_account. last4nullable string The last four digits of the bank account number.
- entries.
data. flow_details. received_credit. initiating_payment_method_details. us_bank_account. routing_ numbernullable string The routing number for the bank account.
- entries.
data. flow_details. received_credit. linked_ flowsobject Other flows linked to a ReceivedCredit.
- entries.
data. flow_details. received_credit. linked_flows. credit_ reversalnullable string The CreditReversal created as a result of this ReceivedCredit being reversed.
- entries.
data. flow_details. received_credit. linked_flows. nullable string Set if the ReceivedCredit was created due to an Issuing Authorization object.
- entries.
data. flow_details. received_credit. linked_flows. issuing_ transactionnullable string Set if the ReceivedCredit is also viewable as an Issuing transaction object.
- entries.
data. flow_details. received_credit. linked_flows. source_ flownullable string ID of the source flow. Set if
network
isstripe
and the source flow is visible to the user. Examples of source flows include OutboundPayments, payouts, or CreditReversals. - entries.
data. flow_details. received_credit. linked_flows. source_ flow_ detailsnullable objectExpandable The expandable object of the source flow.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_ reversalnullable object Details about a CreditReversal.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. idstring Unique identifier for the object.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. amountinteger Amount (in cents) transferred.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. financial_ accountstring The FinancialAccount to reverse funds from.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. networkenum The rails used to reverse the funds.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. received_ creditstring The ReceivedCredit being reversed.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. statusenum Status of the CreditReversal
Possible enum valuescanceled
The CreditReversal has been canceled before it has been sent to the network and no funds have left the account. (Currently not supported).
posted
The CreditReversal has been sent to the network and funds have left the account (with the Transaction posting)
processing
The CreditReversal starting state. Funds are “held” by a pending Transaction (but they are still part of the current balance).
- entries.
data. 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
.- entries.
data. 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
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. credit_reversal. transactionnullable stringExpandable The Transaction associated with this object.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_ paymentnullable object Details about an OutboundPayment.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. idstring Unique identifier for the object.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. cancelableboolean Returns
true
if the object can be canceled, andfalse
otherwise. - entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. customernullable string ID of the customer to whom an OutboundPayment is sent.
- entries.
data. 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.
- entries.
data. 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 - entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_ payment_ method_ detailsnullable object Details about the PaymentMethod for an OutboundPayment.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. addressobject Billing address.
- entries.
data. 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.
- entries.
data. 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).
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. emailnullable string Email address.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. billing_details. namenullable string Full name.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. financial_ accountnullable object Details about the
financial_
.account - entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- entries.
data. 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 - entries.
data. 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 - entries.
data. 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 valuescompany
Account belongs to a company
individual
Account belongs to an individual
- entries.
data. 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 valueschecking
Bank account type is checking
savings
Bank account type is savings
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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 valuesach
ACH network
us_
domestic_ wire US domestic wire network
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. end_ user_ detailsnullable object Details about the end user.
- entries.
data. 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
present
is 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. - entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. end_user_details. presentboolean true
if the OutboundPayment creation request is being made on behalf of an end user by a platform. Otherwise,false
.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. financial_ accountstring The FinancialAccount that funds were pulled from.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. 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
.- entries.
data. 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.
declined
The 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.
other
The destination could not process this OutboundPayment.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. returned_details. transactionstringExpandable The Transaction associated with this object.
- entries.
data. 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).
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. statusenum Current status of the OutboundPayment:
processing
,failed
,posted
,returned
,canceled
. An OutboundPayment isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundPayment has been “confirmed” and funds have left the account, or tofailed
orcanceled
. If an OutboundPayment fails to arrive at its destination, its status will change toreturned
. - entries.
data. 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
.- entries.
data. 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
. - entries.
data. 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
. - entries.
data. 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
. - entries.
data. 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
.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. tracking_ detailsnullable object Details about network-specific tracking information if available.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. achnullable object ACH network tracking details.
- entries.
data. 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
ach
network.
- entries.
data. 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 valuesach
us_
domestic_ wire - entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- entries.
data. 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 - entries.
data. 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 - entries.
data. 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
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_payment. transactionstringExpandable The Transaction associated with this object.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_ transfernullable objectPreview feature Details about an OutboundTransfer.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. idstring Unique identifier for the object.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. cancelableboolean Returns
true
if the object can be canceled, andfalse
otherwise. - entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_ payment_ method_ detailsobject Details about the PaymentMethod for an OutboundTransfer
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. addressobject Billing address.
- entries.
data. 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.
- entries.
data. 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).
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. emailnullable string Email address.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. billing_details. namenullable string Full name.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. financial_ accountnullable objectPreview feature Details about the
financial_
.account - entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. financial_account. idstring Token of the FinancialAccount.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. destination_payment_method_details. financial_account. networkenum The rails used to send funds.
- entries.
data. 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.
- entries.
data. 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 - entries.
data. 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 valuescompany
Account belongs to a company
individual
Account belongs to an individual
- entries.
data. 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 valueschecking
Bank account type is checking
savings
Bank account type is savings
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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 valuesach
ACH network
us_
domestic_ wire US domestic wire network
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. financial_ accountstring The FinancialAccount that funds were pulled from.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. 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
.- entries.
data. 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.
declined
The 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.
other
The destination could not process this OutboundTransfer.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. returned_details. transactionstringExpandable The Transaction associated with this object.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. statement_ descriptorstring Information about the OutboundTransfer to be sent to the recipient account.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. statusenum Current status of the OutboundTransfer:
processing
,failed
,canceled
,posted
,returned
. An OutboundTransfer isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundTransfer has been “confirmed” and funds have left the account, or tofailed
orcanceled
. If an OutboundTransfer fails to arrive at its destination, its status will change toreturned
. - entries.
data. 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
.- entries.
data. 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
- entries.
data. 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
- entries.
data. 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
- entries.
data. 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
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_ detailsnullable object Details about network-specific tracking information if available.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. achnullable object ACH network tracking details.
- entries.
data. 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
ach
network.
- entries.
data. 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 valuesach
us_
domestic_ wire - entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. tracking_details. us_ domestic_ wirenullable object US domestic wire network tracking details.
- entries.
data. 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 - entries.
data. 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 - entries.
data. 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
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. outbound_transfer. transactionstringExpandable The Transaction associated with this object.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payoutnullable object Details about a Payout.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. idstring Unique identifier for the object.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. amountinteger The amount (in cents) that transfers to your bank account or debit card.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. automaticboolean Returns
true
if the payout is created by an automated payout schedule andfalse
if it’s requested manually. - entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. destinationnullable stringExpandable ID of the bank account or card the payout is sent to.
- entries.
data. 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.
- entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. failure_ messagenullable string Message that provides the reason for a payout failure, if available.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. methodstring The method used to send this payout, which can be
standard
orinstant
.instant
is supported for payouts to debit cards and bank accounts in certain countries. Learn more about bank support for Instant Payouts. - entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. payout_ methodnullable string ID of the v2 FinancialAccount the funds are sent to.
- entries.
data. 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 valuescompleted
The 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.
- entries.
data. 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.
- entries.
data. 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 - entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. statusstring Current status of the payout:
paid
,pending
,in_
,transit canceled
orfailed
. A payout ispending
until it’s submitted to the bank, when it becomesin_
. The status changes totransit paid
if the transaction succeeds, or tofailed
orcanceled
(within 5 business days). Some payouts that fail might initially show aspaid
, then change tofailed
. - entries.
data. 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.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. trace_id. statusstring Possible values are
pending
,supported
, andunsupported
. Whenpayout.
isstatus pending
orin_
, this will betransit pending
. When the payout transitions topaid
,failed
, orcanceled
, this status will becomesupported
orunsupported
shortly after in most cases. In some cases, this may appear aspending
for up to 10 days afterarrival_
until transitioning todate supported
orunsupported
. - entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. trace_id. valuenullable string The trace ID value if
trace_
isid. status supported
, otherwisenil
.
- entries.
data. flow_details. received_credit. linked_flows. source_flow_details. payout. typeenum Can be
bank_
oraccount card
.
- entries.
data. 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.
other
ReceivedCredits created from other source flow.
outbound_
payment ReceivedCredits created from OutboundPayments.
outbound_
transfer ReceivedCredits created from OutboundPayments.
payout
ReceivedCredits created from Payouts.
- entries.
data. flow_details. received_credit. linked_flows. source_ flow_ typenullable string The type of flow that originated the ReceivedCredit (for example,
outbound_
).payment
- entries.
data. flow_details. received_credit. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. flow_details. received_credit. networkenum The rails used to send the funds.
Possible enum valuesach
card
stripe
us_
domestic_ wire - entries.
data. flow_details. received_credit. reversal_ detailsnullable object Details describing when a ReceivedCredit may be reversed.
- entries.
data. flow_details. received_credit. reversal_details. deadlinenullable timestamp Time before which a ReceivedCredit can be reversed.
- entries.
data. 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.
other
A ReceivedCredit that was reversed because of another reason.
source_
flow_ restricted Stripe restricts users from reversing a Stripe network ReceivedCredit.
- entries.
data. 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 valuesfailed
The ReceivedCredit was declined, and no Transaction was created.
succeeded
The ReceivedCredit was approved.
- entries.
data. flow_details. received_credit. transactionnullable stringExpandable The Transaction associated with this object.
- entries.
data. flow_details. received_ debitnullable object The ReceivedDebit object associated with the Transaction. Set if
type=received_
.debit - entries.
data. flow_details. received_debit. idstring Unique identifier for the object.
- entries.
data. flow_details. received_debit. objectstring String representing the object’s type. Objects of the same type share the same value.
- entries.
data. flow_details. received_debit. amountinteger Amount (in cents) transferred.
- entries.
data. flow_details. received_debit. createdtimestamp Time at which the object was created. Measured in seconds since the Unix epoch.
- entries.
data. flow_details. received_debit. currencyenum Three-letter ISO currency code, in lowercase. Must be a supported currency.
- entries.
data. flow_details. received_debit. descriptionstring An arbitrary string attached to the object. Often useful for displaying to users.
- entries.
data. 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.
other
Funds can’t be pulled from the FinancialAccount for other reasons.
- entries.
data. flow_details. received_debit. financial_ accountnullable string The FinancialAccount that funds were pulled from.
- entries.
data. 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.
- entries.
data. flow_details. received_debit. initiating_ payment_ method_ detailsobject Details about how a ReceivedDebit was created.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. balancenullable enum Set when
type
isbalance
.Possible enum valuespayments
The Stripe payments balance.
- entries.
data. 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.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. addressobject Billing address.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. address. citynullable string City, district, suburb, town, or village.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. address. countrynullable string Two-letter country code (ISO 3166-1 alpha-2).
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. address. line1nullable string Address line 1 (e.g., street, PO Box, or company name).
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., apartment, suite, unit, or building).
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. address. postal_ codenullable string ZIP or postal code.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. address. statenullable string State, county, province, or region.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. emailnullable string Email address.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. billing_details. namenullable string Full name.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. financial_ accountnullable object Set when
type
isfinancial_
. This is a FinancialAccount ID.account - entries.
data. flow_details. received_debit. initiating_payment_method_details. financial_account. idstring The FinancialAccount ID.
- entries.
data. 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
.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. issuing_ cardnullable string Set when
type
isissuing_
. This is an Issuing Card ID.card - entries.
data. 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.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. us_ bank_ accountnullable object Set when
type
isus_
.bank_ account - entries.
data. flow_details. received_debit. initiating_payment_method_details. us_bank_account. bank_ namenullable string Bank name.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. us_bank_account. last4nullable string The last four digits of the bank account number.
- entries.
data. flow_details. received_debit. initiating_payment_method_details. us_bank_account. routing_ numbernullable string The routing number for the bank account.
- entries.
data. flow_details. received_debit. linked_ flowsobject Other flows linked to a ReceivedDebit.
- entries.
data. flow_details. received_debit. linked_flows. debit_ reversalnullable string The DebitReversal created as a result of this ReceivedDebit being reversed.
- entries.
data. flow_details. received_debit. linked_flows. inbound_ transfernullable string Set if the ReceivedDebit is associated with an InboundTransfer’s return of funds.
- entries.
data. flow_details. received_debit. linked_flows. nullable string Set if the ReceivedDebit was created due to an Issuing Authorization object.
- entries.
data. flow_details. received_debit. linked_flows. issuing_ transactionnullable string Set if the ReceivedDebit is also viewable as an Issuing Dispute object.
- entries.
data. flow_details. received_debit. linked_flows. payoutnullable string Set if the ReceivedDebit was created due to a Payout object.
- entries.
data. flow_details. received_debit. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. flow_details. received_debit. networkenum The network used for the ReceivedDebit.
- entries.
data. flow_details. received_debit. reversal_ detailsnullable object Details describing when a ReceivedDebit might be reversed.
- entries.
data. flow_details. received_debit. reversal_details. deadlinenullable timestamp Time before which a ReceivedDebit can be reversed.
- entries.
data. 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 deadline
populated.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.
other
A 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
- entries.
data. 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 valuesfailed
The ReceivedDebit was declined, and no Transaction was created.
succeeded
The ReceivedDebit was approved.
- entries.
data. flow_details. received_debit. transactionnullable stringExpandable The Transaction associated with this object.
- entries.
data. 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.
other
The 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.
- entries.
data. 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.
other
The 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.
- entries.
data. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - entries.
data. transactionstringExpandable The Transaction associated with this object.
- entries.
data. 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.
other
The 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
- entries.
has_ moreboolean True if this list has another page of items after this one that can be fetched.
- entries.
urlstring The URL where this list can be accessed.
- financial_
accountstring The FinancialAccount associated with this object.
- flownullable string
ID of the flow that created the Transaction.
- flow_
detailsnullable objectExpandable Details of the flow that created the Transaction.
- 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
true
if the object exists in live mode or the valuefalse
if 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 valuescanceled
The CreditReversal has been canceled before it has been sent to the network and no funds have left the account. (Currently not supported).
posted
The CreditReversal has been sent to the network and funds have left the account (with the Transaction posting)
processing
The 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
true
if the object exists in live mode or the valuefalse
if 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 valuesfailed
The network has resolved the DebitReversal against the user.
processing
The DebitReversal starting state.
succeeded
The 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
true
if 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
succeeded
state, this field contains a reference to the ReceivedDebit return.
- flow_details.
inbound_transfer. livemodeboolean Has the value
true
if the object exists in live mode or the valuefalse
if 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 (e.g., street, PO Box, or company name).
- flow_details.
inbound_transfer. origin_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., 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 valuescompany
Account belongs to a company
individual
Account 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 valueschecking
Bank account type is checking
savings
Bank 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
true
if the funds for an InboundTransfer were returned after the InboundTransfer went to thesucceeded
state. - 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 isprocessing
if it is created and pending. The status changes tosucceeded
once the funds have been “confirmed” and atransaction
is created and posted. The status changes tofailed
if 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
currency
and in the smallest currency unit.amount
should be the same asmerchant_
, unlessamount currency
andmerchant_
are different.currency - flow_details.
issuing_authorization. nullable object Detailed breakdown of amount components. These amounts are denominated in
currency
and 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 valueschip
The card was physically present and inserted into a chip-enabled terminal. The transaction is cryptographically secured.
contactless
The card was tapped on a contactless-enabled terminal. If a digital wallet copy of the card was used, the
wallet
field will be present.keyed_
in The card number was manually entered into a terminal.
online
The card was used in a card-not-present scenario, such as a transaction initiated at an online e-commerce checkout.
swipe
The 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 valuesissuing
Balance Transactions that affect your Issuing balance
payments
Balance 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
amount
in currency A, multipled by theexchange_
, equals therate amount
in currency B. For example, if you charge a customer 10.00 EUR, the PaymentIntent’samount
is1000
andcurrency
iseur
. If this converts to 12.34 USD in your Stripe account, the BalanceTransaction’samount
is1234
, itscurrency
isusd
, 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
available
orpending
. - 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 valuesadjustment
advance
advance_
funding anticipation_
repayment application_
fee application_
fee_ refund charge
climate_
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.
lost
The card was lost.
stolen
The 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 (e.g., street, PO Box, or company name).
- flow_details.
issuing_authorization. card. cardholder. billing. address. nullable string Address line 2 (e.g., 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
company
cardholder.- 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
individual
cardholder.- 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
purpose
value 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
purpose
value ofidentity_
.document
- flow_details.
issuing_authorization. card. cardholder. boolean Has the value
true
if the object exists in live mode or the valuefalse
if 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 valueslisted
Account 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.
daily
Limit applies to a day, starting at midnight UTC.
monthly
Limit applies to a month, starting on the 1st at midnight UTC.
per_
authorization Limit applies to each authorization.
weekly
Limit applies to a week, starting on Sunday at midnight UTC.
yearly
Limit 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 valuesactive
Cards attached to this cardholder can approve authorizations.
blocked
Cards attached to this cardholder will decline all authorizations with the
cardholder_
reason. This status is non-reversible.blocked inactive
Cards attached to this cardholder will decline all authorizations with the
cardholder_
reason.inactive - flow_details.
issuing_authorization. card. cardholder. enum One of
individual
orcompany
. See Choose a cardholder type for more details.Possible enum valuescompany
The 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.
individual
The 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
usd
in the US,eur
in the EU, andgbp
in 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
expand
parameter. 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
true
if the object exists in live mode or the valuefalse
if 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
expand
parameter. 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 valuesdamaged
The physical card has been damaged and cannot be used at terminals. This reason is only valid for cards of type
physical
.expired
The expiration date has passed or is imminent.
lost
The card was lost. This status is only valid if the card it replaces is marked as lost.
stolen
The card was stolen. This status is only valid if the card it replaces is marked as stolen.
- 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 (e.g., street, PO Box, or company name).
- flow_details.
issuing_authorization. card. shipping. address. nullable string Address line 2 (e.g., 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 valuesdisabled
The 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 (e.g., street, PO Box, or company name).
- flow_details.
issuing_authorization. card. shipping. address_validation. normalized_address. nullable string Address line 2 (e.g., 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 valuesindeterminate
The 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 valuesdhl
DHL
fedex
FedEx
royal_
mail Royal Mail
usps
USPS
- 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
standard
orexpress
.Possible enum valuesexpress
Cards arrive in 4 business days.
priority
Cards arrive in 2-3 business days.
standard
Cards arrive in 5-8 business days.
- flow_details.
issuing_authorization. card. shipping. nullable enum The delivery status of the card.
Possible enum valuescanceled
The card was canceled before being shipped.
delivered
The card has been delivered to its destination.
failure
The card failed to be delivered but was not returned.
pending
The card is being prepared and has not yet shipped.
returned
The card failed to be delivered and was returned to the sender.
shipped
The card has been shipped. If the card’s shipping carrier does not support tracking, this will be the card’s final status.
submitted
The 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 valuesbulk
Cards are grouped and mailed together.
individual
Cards 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.
daily
Limit applies to a day, starting at midnight UTC.
monthly
Limit applies to a month, starting on the 1st at midnight UTC.
per_
authorization Limit applies to each authorization.
weekly
Limit applies to a week, starting on Sunday at midnight UTC.
yearly
Limit 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 valuesactive
The 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’.
canceled
The card will decline authorizations with the
card_
reason. This status is permanent.canceled inactive
The card will decline authorizations with the
card_
reason.inactive - flow_details.
issuing_authorization. card. enum The type of the card.
Possible enum valuesphysical
A physical card will be printed and shipped. It can be used at physical terminals.
virtual
No 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.
null
if 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.
null
if 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 valuessms
SMS sent to the cardholder’s phone number.
- flow_details.
issuing_authorization. fraud_challenges. enum The status of the fraud challenge.
Possible enum valuesexpired
The 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.
pending
The challenge has been sent to the cardholder or is about to be sent.
rejected
The cardholder responded to the challenge indicating that the authorization was fraudulent, and that similar authorizations should continue to be declined.
undeliverable
A challenge has been requested to be sent, but the cardholder is unable to receive it.
verified
The 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
unit
s 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 valuesdiesel
Diesel.
other
Other.
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.
kilogram
Kilogram.
kilowatt_
hour Kilowatt-hour.
liter
Liter.
other
Other.
pound
Pound.
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
true
if the object exists in live mode or the valuefalse
if 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 currency
are 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
currency
field 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
currency
and 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
currency
and 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 valuesclosed
The authorization was declined or captured through one or more transactions.
expired
The authorization was expired without capture.
pending
The authorization was created and is awaiting approval or was approved and is awaiting capture.
reversed
The 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
currency
and 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
Authorization
object 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
true
if the object exists in live mode or the valuefalse
if 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 amount
if 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
unit
s 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 valuescapture
Funds were captured by the acquirer.
amount
will 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.refund
An acquirer initiated a refund. This transaction might not be linked to an original capture, for example credits are original transactions.
amount
will 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 valuesmatch
Verification succeeded, values matched.
mismatch
Verification 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 valuesmatch
Verification succeeded, values matched.
mismatch
Verification 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 valuesacquirer
Acquiring merchant.
issuer
Issuing 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.
unknown
Specifies 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 valuesmatch
Verification succeeded, values matched.
mismatch
Verification 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 valuesmatch
Verification succeeded, values matched.
mismatch
Verification 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.
authenticated
Authentication successful.
failed
Authentication failed.
required
The 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 null
when 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
true
if the object can be canceled, andfalse
otherwise. - 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 (e.g., street, PO Box, or company name).
- flow_details.
outbound_payment. destination_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., 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 valuescompany
Account belongs to a company
individual
Account 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 valueschecking
Bank account type is checking
savings
Bank 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 valuesach
ACH 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
present
is 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 true
if 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
true
if the object exists in live mode or the valuefalse
if 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.
declined
The 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.
other
The 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 isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundPayment has been “confirmed” and funds have left the account, or tofailed
orcanceled
. 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
ach
network.
- flow_details.
outbound_payment. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesach
us_
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
true
if the object can be canceled, andfalse
otherwise. - 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 (e.g., street, PO Box, or company name).
- flow_details.
outbound_transfer. destination_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., 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 valuescompany
Account belongs to a company
individual
Account 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 valueschecking
Bank account type is checking
savings
Bank 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 valuesach
ACH 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
true
if the object exists in live mode or the valuefalse
if 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.
declined
The 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.
other
The 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 isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundTransfer has been “confirmed” and funds have left the account, or tofailed
orcanceled
. 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
ach
network.
- flow_details.
outbound_transfer. tracking_details. typeenum The US bank account network used to send funds.
Possible enum valuesach
us_
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.
other
Funds 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
type
isbalance
.Possible enum valuespayments
The 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 (e.g., street, PO Box, or company name).
- flow_details.
received_credit. initiating_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., 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
type
isfinancial_
. 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
type
isissuing_
. 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
type
isus_
.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
network
isstripe
and 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
true
if the object exists in live mode or the valuefalse
if 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 valuescanceled
The CreditReversal has been canceled before it has been sent to the network and no funds have left the account. (Currently not supported).
posted
The CreditReversal has been sent to the network and funds have left the account (with the Transaction posting)
processing
The 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
true
if the object can be canceled, andfalse
otherwise. - 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 (e.g., 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 (e.g., 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 valuescompany
Account belongs to a company
individual
Account 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 valueschecking
Bank account type is checking
savings
Bank 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 valuesach
ACH 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
present
is 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 true
if 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
true
if the object exists in live mode or the valuefalse
if 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.
declined
The 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.
other
The 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 isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundPayment has been “confirmed” and funds have left the account, or tofailed
orcanceled
. 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
ach
network.
- 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 valuesach
us_
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
true
if the object can be canceled, andfalse
otherwise. - 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 (e.g., 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 (e.g., 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 valuescompany
Account belongs to a company
individual
Account 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 valueschecking
Bank account type is checking
savings
Bank 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 valuesach
ACH 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
true
if the object exists in live mode or the valuefalse
if 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.
declined
The 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.
other
The 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 isprocessing
if it has been created and is pending. The status changes toposted
once the OutboundTransfer has been “confirmed” and funds have left the account, or tofailed
orcanceled
. 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
ach
network.
- 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 valuesach
us_
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
true
if the payout is created by an automated payout schedule andfalse
if 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
true
if the object exists in live mode or the valuefalse
if 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
standard
orinstant
.instant
is 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 valuescompleted
The 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 canceled
orfailed
. A payout ispending
until it’s submitted to the bank, when it becomesin_
. The status changes totransit paid
if the transaction succeeds, or tofailed
orcanceled
(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 pending
orin_
, this will betransit pending
. When the payout transitions topaid
,failed
, orcanceled
, this status will becomesupported
orunsupported
shortly after in most cases. In some cases, this may appear aspending
for up to 10 days afterarrival_
until transitioning todate supported
orunsupported
. - 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.
other
ReceivedCredits created from other source flow.
outbound_
payment ReceivedCredits created from OutboundPayments.
outbound_
transfer ReceivedCredits created from OutboundPayments.
payout
ReceivedCredits 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
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - flow_details.
received_credit. networkenum The rails used to send the funds.
Possible enum valuesach
card
stripe
us_
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.
other
A 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 valuesfailed
The ReceivedCredit was declined, and no Transaction was created.
succeeded
The 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.
other
Funds 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
type
isbalance
.Possible enum valuespayments
The 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 (e.g., street, PO Box, or company name).
- flow_details.
received_debit. initiating_payment_method_details. billing_details. address. line2nullable string Address line 2 (e.g., 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
type
isfinancial_
. 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
type
isissuing_
. 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
type
isus_
.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
true
if the object exists in live mode or the valuefalse
if 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 deadline
populated.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.
other
A 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 valuesfailed
The ReceivedDebit was declined, and no Transaction was created.
succeeded
The 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.
other
The 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 that created the Transaction.
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.
other
The 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
true
if the object exists in live mode or the valuefalse
if the object exists in test mode. - statusenum
Status of the Transaction.
Possible enum valuesopen
The initial state for all Transactions. The Transaction results in updates to the sub-balance amounts, but the current balance is not affected until the Transaction posts.
posted
Funds have successfully entered or left the account. The current balance was affected.
void
The Transaction never impacted the balance. For example, a Transaction would enter this state if an OutboundPayment was initiated but then canceled before the funds left the account.
- status_
transitionsobject Hash containing timestamps of when the object transitioned to a particular
status
.- status_transitions.
posted_ atnullable timestamp Timestamp describing when the Transaction changed status to
posted
. - status_transitions.
void_ atnullable timestamp Timestamp describing when the Transaction changed status to
void
.
{ "id": "trxn_1MtkYw2eZvKYlo2ClMGIO54z", "object": "treasury.transaction", "amount": -100, "balance_impact": { "cash": -100, "inbound_pending": 0, "outbound_pending": 100 }, "created": 1680755802, "currency": "usd", "description": "Jane Austen (6789) | Outbound transfer | transfer", "financial_account": "fa_1MtkYw2eZvKYlo2CrqmzUo3O", "flow": "obt_1MtkYw2eZvKYlo2CqsyBpQts", "flow_type": "outbound_transfer", "livemode": false, "status": "open", "status_transitions": { "posted_at": null, "void_at": null }}