# `Stripe.Resources.Transfer`
[🔗](https://github.com/jeffhuen/tiger_stripe/blob/main/lib/stripe/resources/transfer.ex#L2)

Transfer

A `Transfer` object is created when you move funds between Stripe accounts as
part of Connect.

Before April 6, 2017, transfers also represented movement of funds from a
Stripe account to a card or bank account. This behavior has since been split
out into a [Payout](https://api.stripe.com#payout_object) object, with corresponding payout endpoints. For more
information, read about the
[transfer/payout split](https://docs.stripe.com/transfer-payout-split).

Related guide: [Creating separate charges and transfers](https://docs.stripe.com/connect/separate-charges-and-transfers)

# `t`

```elixir
@type t() :: %Stripe.Resources.Transfer{
  amount: integer(),
  amount_reversed: integer(),
  balance_transaction: String.t() | Stripe.Resources.BalanceTransaction.t(),
  created: integer(),
  currency: String.t(),
  description: String.t(),
  destination: String.t() | Stripe.Resources.Account.t(),
  destination_payment: String.t() | Stripe.Resources.Charge.t() | nil,
  id: String.t(),
  livemode: boolean(),
  metadata: %{required(String.t()) => String.t()},
  object: String.t(),
  reversals: Stripe.Resources.Transfer.Reversals.t(),
  reversed: boolean(),
  source_transaction: String.t() | Stripe.Resources.Charge.t(),
  source_type: String.t() | nil,
  transfer_group: String.t()
}
```

* `amount` - Amount in cents (or local equivalent) to be transferred.
* `amount_reversed` - Amount in cents (or local equivalent) reversed (can be less than the amount attribute on the transfer if a partial reversal was issued).
* `balance_transaction` - Balance transaction that describes the impact of this transfer on your account balance. Nullable. Expandable.
* `created` - Time that this record of the transfer was first created. Format: Unix timestamp.
* `currency` - Three-letter [ISO currency code](https://www.iso.org/iso-4217-currency-codes.html), in lowercase. Must be a [supported currency](https://stripe.com/docs/currencies). Format: ISO 4217 currency code.
* `description` - An arbitrary string attached to the object. Often useful for displaying to users. Max length: 5000. Nullable.
* `destination` - ID of the Stripe account the transfer was sent to. Nullable. Expandable.
* `destination_payment` - If the destination is a Stripe account, this will be the ID of the payment that the destination account received for the transfer. Expandable.
* `id` - Unique identifier for the object. Max length: 5000.
* `livemode` - Has the value `true` if the object exists in live mode or the value `false` if the object exists in test mode.
* `metadata` - Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
* `object` - String representing the object's type. Objects of the same type share the same value. Possible values: `transfer`.
* `reversals` - A list of reversals that have been applied to the transfer. Expandable.
* `reversed` - Whether the transfer has been fully reversed. If the transfer is only partially reversed, this attribute will still be false.
* `source_transaction` - ID of the charge that was used to fund the transfer. If null, the transfer was funded from the available balance. Nullable. Expandable.
* `source_type` - The source balance this transfer came from. One of `card`, `fpx`, or `bank_account`. Max length: 5000.
* `transfer_group` - A string that identifies this transaction as part of a group. See the [Connect documentation](https://docs.stripe.com/connect/separate-charges-and-transfers#transfer-options) for details. Max length: 5000. Nullable.

# `expandable_fields`

# `object_name`

---

*Consult [api-reference.md](api-reference.md) for complete listing*