The OutboundTransfer object

Attributes

• id (string) Unique identifier for the object.

• object (string) String representing the object’s type. Objects of the same type share the same value.

• amount (integer) Amount (in cents) transferred.

• cancelable (boolean) Returns true if the object can be canceled, and false otherwise.

• created (timestamp) Time at which the object was created. Measured in seconds since the Unix epoch.

• currency (enum) Three-letter ISO currency code, in lowercase. Must be a supported currency.

• description (string, nullable) An arbitrary string attached to the object. Often useful for displaying to users.

• destination_payment_method (string, nullable) The PaymentMethod used as the payment instrument for an OutboundTransfer.

• destination_payment_method_details (object) Details about the PaymentMethod for an OutboundTransfer

  • destination_payment_method_details.billing_details (object) Contact details for the person or business receiving the OutboundTransfer.

    • destination_payment_method_details.billing_details.address (object) Billing address.

      • destination_payment_method_details.billing_details.address.city (string, nullable) City, district, suburb, town, or village.

      • destination_payment_method_details.billing_details.address.country (string, nullable) Two-letter country code (ISO 3166-1 alpha-2).

      • destination_payment_method_details.billing_details.address.line1 (string, nullable) Address line 1, such as the street, PO Box, or company name.

      • destination_payment_method_details.billing_details.address.line2 (string, nullable) Address line 2, such as the apartment, suite, unit, or building.

      • destination_payment_method_details.billing_details.address.postal_code (string, nullable) ZIP or postal code.

      • destination_payment_method_details.billing_details.address.state (string, nullable) State, county, province, or region (ISO 3166-2).

    • destination_payment_method_details.billing_details.email (string, nullable) Email address.

    • destination_payment_method_details.billing_details.name (string, nullable) Full name.

  • destination_payment_method_details.financial_account (object, nullable) Details about the financial_account.

    • destination_payment_method_details.financial_account.id (string) Token of the FinancialAccount.

    • destination_payment_method_details.financial_account.network (enum) The rails used to send funds.

  • destination_payment_method_details.type (enum) The type of the payment method used in the OutboundTransfer.

  • destination_payment_method_details.us_bank_account (object, nullable) Details about the us_bank_account.

    • destination_payment_method_details.us_bank_account.account_holder_type (enum, nullable) Account holder type: individual or company. Possible enum values:

      • company Account belongs to a company

      • individual Account belongs to an individual

    • destination_payment_method_details.us_bank_account.account_type (enum, nullable) Account type: checkings or savings. Defaults to checking if omitted. Possible enum values:

      • checking Bank account type is checking

      • savings Bank account type is savings

    • destination_payment_method_details.us_bank_account.bank_name (string, nullable) Name of the bank associated with the bank account.

    • destination_payment_method_details.us_bank_account.fingerprint (string, nullable) Uniquely identifies this particular bank account. You can use this attribute to check whether two bank accounts are the same.

    • destination_payment_method_details.us_bank_account.last4 (string, nullable) Last four digits of the bank account number.

    • destination_payment_method_details.us_bank_account.mandate (string, nullable, expandable (can be expanded into an object with the expand request parameter)) ID of the mandate used to make this payment.

    • destination_payment_method_details.us_bank_account.network (enum) The network rails used. See the docs to learn more about money movement timelines for each network type. Possible enum values:

      • ach ACH network

      • us_domestic_wire US domestic wire network

    • destination_payment_method_details.us_bank_account.routing_number (string, nullable) Routing number of the bank account.

• expected_arrival_date (timestamp) The date when funds are expected to arrive in the destination account.

• financial_account (string) The FinancialAccount that funds were pulled from.

• hosted_regulatory_receipt_url (string, nullable) A hosted transaction receipt URL that is provided when money movement is considered regulated under Stripe’s money transmission licenses.

• livemode (boolean) If the object exists in live mode, the value is true. If the object exists in test mode, the value is false.

• metadata (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.

• returned_details (object, nullable) Details about a returned OutboundTransfer. Only set when the status is returned.

  • returned_details.code (enum) Reason for the return. Possible enum values:

    • account_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.

  • returned_details.transaction (string, expandable (can be expanded into an object with the expand request parameter)) The Transaction associated with this object.

• statement_descriptor (string) Information about the OutboundTransfer to be sent to the recipient account.

• status (enum) Current status of the OutboundTransfer: processing, failed, canceled, posted, returned. An OutboundTransfer is processing if it has been created and is pending. The status changes to posted once the OutboundTransfer has been “confirmed” and funds have left the account, or to failed or canceled. If an OutboundTransfer fails to arrive at its destination, its status will change to returned.

• status_transitions (object) Hash containing timestamps of when the object transitioned to a particular status.

  • status_transitions.canceled_at (timestamp, nullable) Timestamp describing when an OutboundTransfer changed status to canceled

  • status_transitions.failed_at (timestamp, nullable) Timestamp describing when an OutboundTransfer changed status to failed

  • status_transitions.posted_at (timestamp, nullable) Timestamp describing when an OutboundTransfer changed status to posted

  • status_transitions.returned_at (timestamp, nullable) Timestamp describing when an OutboundTransfer changed status to returned

• tracking_details (object, nullable) Details about network-specific tracking information if available.

  • tracking_details.ach (object, nullable) ACH network tracking details.

    • tracking_details.ach.trace_id (string) ACH trace ID of the OutboundTransfer for transfers sent over the ach network.

  • tracking_details.type (enum) The US bank account network used to send funds. Possible enum values:

    • ach
    • us_domestic_wire

  • tracking_details.us_domestic_wire (object, nullable) US domestic wire network tracking details.

    • tracking_details.us_domestic_wire.chips (string, nullable) CHIPS System Sequence Number (SSN) of the OutboundTransfer for transfers sent over the us_domestic_wire network.

    • tracking_details.us_domestic_wire.imad (string, nullable) IMAD of the OutboundTransfer for transfers sent over the us_domestic_wire network.

    • tracking_details.us_domestic_wire.omad (string, nullable) OMAD of the OutboundTransfer for transfers sent over the us_domestic_wire network.

• transaction (string, expandable (can be expanded into an object with the expand request parameter)) The Transaction associated with this object.

The OutboundTransfer object

{
  "id": "obt_1Mtaaz2eZvKYlo2CUu1tWGAl",
  "object": "treasury.outbound_transfer",
  "amount": 500,
  "cancelable": true,
  "created": 1680717489,
  "currency": "usd",
  "description": "OutboundTransfer to my external bank account",
  "destination_payment_method": "pm_1234567890",
  "destination_payment_method_details": {
    "billing_details": {
      "address": {
        "city": "San Francisco",
        "country": "US",
        "line1": "1234 Fake Street",
        "line2": null,
        "postal_code": "94102",
        "state": "CA"
      },
      "email": null,
      "name": "Jane Austen"
    },
    "type": "us_bank_account",
    "us_bank_account": {
      "account_holder_type": "company",
      "account_type": "checking",
      "bank_name": "STRIPE TEST BANK",
      "fingerprint": "AP24Iso0btGp4N10",
      "last4": "6789",
      "network": "ach",
      "routing_number": "110000000"
    }
  },
  "expected_arrival_date": 1680825600,
  "financial_account": "fa_1Mtaaz2eZvKYlo2CUf56sIA1",
  "hosted_regulatory_receipt_url": "https://payments.stripe.com/regulatory-receipt/CBQaFwoVYWNjdF8xMDMyRDgyZVp2S1lsbzJDKLHttqEGMgYCCwVOvUY6NpO8ArWrjrz6Hxk3d8tQ4d_RvOqMTOeq6js5eE94-f-7DwBzjjD1wxIUhOyub1KFYH8QKxj9oA",
  "livemode": false,
  "metadata": {},
  "returned_details": null,
  "statement_descriptor": "transfer",
  "status": "processing",
  "status_transitions": {
    "canceled_at": null,
    "failed_at": null,
    "posted_at": null,
    "returned_at": null
  },
  "transaction": "trxn_1Mtaaz2eZvKYlo2Cn9D12psR"
}