The InboundTransfer object 

Money Management
Inbound Transfers
The InboundTransfer object

Attributes

  • idstring

    Unique identifier for the InboundTransfer.

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

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

  • amountobject

    The amount in specified currency that will land in the FinancialAccount balance.

    • amount.currencystring

      A lowercase alpha3 currency code like “usd”.

    • amount.valueinteger

      In minor units like 123 for 1.23 USD.

  • createdtimestamp

    Creation time of the InboundTransfer. Represented as a RFC 3339 date & time UTC value in millisecond precision, for example: 2022-09-18T13:22:18.123Z.

  • descriptionstring

    A freeform text field provided by user, containing metadata.

  • fromobject

    A nested object containing information about the origin of the InboundTransfer.

    • from.debitedobject

      The amount in specified currency that was debited from the Payment Method.

      • from.debited.currencystring

        A lowercase alpha3 currency code like “usd”.

      • from.debited.valueinteger

        In minor units like 123 for 1.23 USD.

    • from.payment_methodobject

      The Payment Method object used to create the InboundTransfer.

      • from.payment_method.typestring

        The type of object this destination represents. For a us bank account, we expect us_bank_account.

      • from.payment_method.us_bank_accountnullable string

        The destination US bank account identifier. eg “usba_***”.

  • 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 hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.

  • toobject

    A nested object containing information about the destination of the InboundTransfer.

    • to.creditedobject

      The amount by which the FinancialAccount balance is credited.

      • to.credited.currencystring

        A lowercase alpha3 currency code like “usd”.

      • to.credited.valueinteger

        In minor units like 123 for 1.23 USD.

    • to.financial_accountstring

      The FinancialAccount that funds will land in.

  • transfer_historyarray of objects

    A list of history objects, representing changes in the state of the InboundTransfer.

    • transfer_history.idstring

      A unique ID for the HistoryEntry.

    • transfer_history.bank_debit_failednullable object

      The history entry for a failed InboundTransfer.

      • transfer_history.bank_debit_failed.failure_reasonenum

        The return reason for the failed InboundTransfer.

        Possible enum values
        bank_account_closed

        The Failure Reason when the user’s external Bank Account is closed.

        bank_account_not_found

        The Failure Reason when the user’s Bank Account is not found.

        bank_debit_could_not_be_processed

        The Failure Reason when the debit cannot be processed for any other reason.

        bank_debit_not_authorized

        The Failure Reason when the user hasn’t authorized the debit with their bank.

        insufficient_funds

        The Failure Reason when there aren’t sufficient funds in the user’s bank account.

    • transfer_history.bank_debit_processingnullable object

      The history entry for a processing InboundTransfer.

    • transfer_history.bank_debit_queuednullable object

      The history entry for a queued InboundTransfer.

    • transfer_history.bank_debit_returnednullable object

      The history entry for a returned InboundTransfer.

      • transfer_history.bank_debit_returned.return_reasonenum

        The return reason for the returned InboundTransfer.

        Possible enum values
        bank_account_closed

        The Failure Reason when the user’s external Bank Account is closed.

        bank_account_not_found

        The Failure Reason when the user’s Bank Account is not found.

        bank_debit_could_not_be_processed

        The Failure Reason when the debit cannot be processed for any other reason.

        bank_debit_not_authorized

        The Failure Reason when the user hasn’t authorized the debit with their bank.

        insufficient_funds

        The Failure Reason when there aren’t sufficient funds in the user’s bank account.

    • transfer_history.bank_debit_succeedednullable object

      The history entry for a succeeded InboundTransfer.

    • transfer_history.createdtimestamp

      Creation time of the HistoryEntry in RFC 3339 format and UTC.

    • transfer_history.effective_attimestamp

      Effective at time of the HistoryEntry in RFC 3339 format and UTC.

    • transfer_history.levelenum

      The Level of the HistoryEntry.

      Possible enum values
      canonical

      History events that are canonical.

      debug

      History events that are meant to provide additional information for debugging.

    • transfer_history.typeenum

      The type of the HistoryEntry.

      Possible enum values
      bank_debit_failed

      History Entry type for an InboundTransfer that has failed.

      bank_debit_processing

      History Entry type for an InboundTransfer that is processing.

      bank_debit_queued

      History Entry type for a queued InboundTransfer.

      bank_debit_returned

      History Entry type for an InboundTransfer that has returned, after initially being successful.

      bank_debit_succeeded

      History Entry type for an InboundTransfer that has succeeded.

The InboundTransfer object
{
"id": "ibt_test_61Q58XwKMHh5ha3MI16Nr2cJ8cSQabKn4q38nZ59E6yO",
"object": "v2.money_management.inbound_transfer",
"amount": {
"value": 101,
"currency": "usd"
},
"created": "2024-03-18T18:07:12.619131Z",
"description": "earnings",
"from": {
"debited": {
"value": 101,
"currency": "usd"
},
"payment_method": {
"type": "payment_methods.us_bank_account",
"us_bank_account": "usba_test_61P22mHGGhTkqVEx416Nr2cJ8cSQabKn4q38nZ59E7ea"
}
},
"receipt_url": "https://payments.stripe.com/transaction_receipt/CCMQARojCiF3a3NwX3Rlc3RfNk5yMmNKOGNTUWFiS240cTM4blo1OUUohIbirwYyBvlQ2PtS3zpGlI2ZkpO8-dpYhb3KfWs1FlYI9eX2I94gJoeJHXOR0QwwesVCRnQwRgsUQqGFloqKV7McODKkoVKAMiuB5lD9htcDuxRtDA",
"to": {
"credited": {
"value": 101,
"currency": "usd"
},
"financial_account": "fa_test_65Nyg0pdsXOSN32kkjg16Nr2cJ8cSQabKn4q38nZ59E50y"
},
"transfer_history": [
{
"id": "ibthe_test_61Q58Xw5weaazmsWj16Nr2cJ8cSQabKn4q38nZ59E52W",
"bank_debit_queued": {},
"created": "2024-03-18T18:07:12.617Z",
"effective_at": "2024-03-18T18:07:12.617Z",
"level": "canonical",
"type": "bank_debit_queued"
},
{
"id": "ibthe_test_61Q58Y2iAWn3U9kNW16Nr2cJ8cSQabKn4q38nZ59EXzc",
"bank_debit_processing": {},
"created": "2024-03-18T18:07:18.403Z",
"effective_at": "2024-03-18T18:07:18.403Z",
"level": "canonical",
"type": "bank_debit_processing"
},
{
"id": "ibthe_test_61Q58Y7wNh292msCP16Nr2cJ8cSQabKn4q38nZ59EPz6",
"bank_debit_succeeded": {},
"created": "2024-03-18T18:07:23.103Z",
"effective_at": "2024-03-18T18:07:23.103Z",
"level": "canonical",
"type": "bank_debit_succeeded"
}
]
}