Core Resources
Payment Methods
Money Management
Products
Checkout
Payment Links
Billing
Capital
Connect
Fraud
Issuing
Terminal
Treasury
Entitlements
Sigma
Reporting
Financial Connections
Tax
Identity
Crypto
Climate
Forwarding
Privacy
Webhooks

The ReceivedDebit object 

Money Management
Received Debits
The ReceivedDebit object

Attributes

  • idstring

    Unique identifier for the ReceivedDebit.

  • objectstring, value is "v2.money_management.received_debit"

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

  • amountobject

    Amount and currency of the ReceivedDebit.

    • amount.currencystring

      A lowercase alpha3 currency code like “usd”.

    • amount.valueinteger

      In minor units like 123 for 1.23 USD.

  • bank_transfernullable object

    This object stores details about the originating banking transaction that resulted in the ReceivedDebit. Present if type field value is bank_transfer.

    • bank_transfer.financial_addressstring

      The Financial Address that was debited.

    • bank_transfer.payment_method_typeenum

      The type of the payment method used to originate the debit.

      Possible enum values
      us_bank_account

      The debit was originated from a US Bank Account.

    • bank_transfer.statement_descriptornullable string

      The statement descriptor set by the originator of the debit.

    • bank_transfer.us_bank_accountobject

      The payment method used to originate the debit.

      • bank_transfer.us_bank_account.bank_namenullable string

        The name of the bank the debit originated from.

      • bank_transfer.us_bank_account.networkenum

        The bank network the debit was originated on.

        Possible enum values
        ach

        Funds received via ACH (Automated Clearing House) network.

      • bank_transfer.us_bank_account.routing_numbernullable string

        The routing number of the bank that originated the debit.

  • createdtimestamp

    The time at which the ReceivedDebit was created. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

  • descriptionnullable string

    Freeform string sent by the originator of the ReceivedDebit.

  • financial_accountstring

    Financial Account on which funds for ReceivedDebit were debited.

  • livemodeboolean

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

  • receipt_urlnullable string

    A link to the Stripe-hosted receipt for this ReceivedDebit.

  • statusenum

    The status of the ReceivedDebit.

    Possible enum values
    canceled

    The ReceivedDebit was canceled and the balance has been adjusted.

    failed

    The ReceivedDebit was rejected by Stripe and funds don’t change existing balance. More details why it failed can be obtained from status_details.

    pending

    The ReceivedDebit was successfully processed. However, the funds are not yet available for use.

    returned

    The ReceivedDebit was returned from the originator bank and the balance has been adjusted accordingly.

    succeeded

    The ReceivedDebit was successfully processed and balance reflects the withdrawn funds. Note that this is not a terminal state. The ReceivedDebit status may transition to returned even after succeeded.

  • status_detailsnullable object

    Detailed information about the status of the ReceivedDebit.

    • status_details.failedobject

      Information that elaborates on the failed status of a ReceivedDebit. It is only present when the ReceivedDebit status is failed.

      • status_details.failed.reasonenum

        The reason for the failure of the ReceivedDebit.

        Possible enum values
        financial_address_inactive

        Funds rejected because the associated Financial Address has been archived.

        insufficient_funds

        Funds rejected due to insufficient funds on balance.

        stripe_rejected

        Funds were rejected Stripe.

  • status_transitionsnullable object

    The time at which the ReceivedDebit transitioned to a particular status.

    • status_transitions.canceled_atnullable timestamp

      The time when the ReceivedDebit was marked as canceled. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

    • status_transitions.failed_atnullable timestamp

      The time when the ReceivedDebit was marked as failed. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

    • status_transitions.succeeded_atnullable timestamp

      The time when the ReceivedDebit was marked as succeeded. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

  • typeenum

    The type of the ReceivedDebit.

    Possible enum values
    bank_transfer

    The ReceivedDebit is the result of an bank transfer.

    external_debit

    Replaced by BANK_TRANSFER, kept for backwards compatibility. The ReceivedDebit is the result of an external debit.

The ReceivedDebit object
{
  "id": "rd_test_61PIoVqwBhv9ka9wC16PITSVZ3SQ2qpWK2k4kS9loWDo",
  "object": "v2.money_management.received_debit",
  "amount": {
    "value": 55,
    "currency": "usd"
  },
  "created": "2023-11-06T11:01:26.155Z",
  "description": "ACCTVERIFY",
  "external_debit": {
    "financial_address": "finaddr_test_61PIoViC3mXdq1lAw16PITSVZ3SQ2qpWK2k4kS9loTj6",
    "payment_method_type": "us_bank_account",
    "statement_descriptor": "ACCTVERIFY",
    "us_bank_account": {
      "bank_name": "",
      "network": "ach",
      "routing_number": "111000123"
    }
  },
  "financial_account": "fa_test_65PIoVY8QWjXEgwaibT16PITSVZ3SQ2qpWK2k4kS9loJCK",
  "receipt_url": "https://payments.stripe.com/transaction_receipt/CCMQARojCiF3a3NwX3Rlc3RfNlBJVFNWWjNTUTJxcFdLMms0a1M5bG8osJGjqgYyBlCBssNJPDpFlMRJIX8eJhbfPGVgqFw4oOmpp3COHbLKGzjRWAayQfKXUHSmoeS_VZTkCI9thg4KQHQUKGXSq5XRO06x44xrmFQCcRT6",
  "status": "succeeded",
  "status_details": null,
  "status_transitions": {
    "failed_at": null,
    "succeeded_at": "2023-11-06T11:01:26.155Z"
  },
  "type": "external_debit"
}