The Balance object

Attributes

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

• available (array of objects) Available funds that you can transfer or pay out automatically by Stripe or explicitly through the Transfers API or Payouts API. You can find the available balance for each currency and payment type in the source_types property.

  • available.amount (integer) Balance amount.

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

  • available.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

    • available.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

    • available.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

    • available.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

• connect_reserved (array of objects, nullable) Funds held due to negative balances on connected accounts where account.controller.requirement_collection is application, which includes Custom accounts. You can find the connect reserve balance for each currency and payment type in the source_types property.

  • connect_reserved.amount (integer) Balance amount.

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

  • connect_reserved.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

    • connect_reserved.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

    • connect_reserved.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

    • connect_reserved.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

• instant_available (array of objects, nullable) Funds that you can pay out using Instant Payouts.

  • instant_available.amount (integer) Balance amount.

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

  • instant_available.net_available (array of objects, nullable, expandable (can be expanded into an object with the expand request parameter)) Breakdown of balance by destination.

    • instant_available.net_available.amount (integer) Net balance amount, subtracting fees from platform-set pricing.

    • instant_available.net_available.destination (string) ID of the external account for this net balance (not expandable).

    • instant_available.net_available.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

      • instant_available.net_available.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

      • instant_available.net_available.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

      • instant_available.net_available.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

  • instant_available.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

    • instant_available.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

    • instant_available.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

    • instant_available.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

• issuing (object, nullable) Funds that you can spend on your Issued Cards.

  • issuing.available (array of objects) Funds that are available for use.

    • issuing.available.amount (integer) Balance amount.

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

    • issuing.available.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

      • issuing.available.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

      • issuing.available.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

      • issuing.available.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

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

• pending (array of objects) Funds that aren’t available in the balance yet. You can find the pending balance for each currency and each payment type in the source_types property.

  • pending.amount (integer) Balance amount.

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

  • pending.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

    • pending.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

    • pending.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

    • pending.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

• refund_and_dispute_prefunding (object, nullable) Funds to cover future refunds, disputes, or a negative balance. See the Add funds to your Stripe balance guide for more information.

  • refund_and_dispute_prefunding.available (array of objects) Funds that are available for use.

    • refund_and_dispute_prefunding.available.amount (integer) Balance amount.

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

    • refund_and_dispute_prefunding.available.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

      • refund_and_dispute_prefunding.available.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

      • refund_and_dispute_prefunding.available.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

      • refund_and_dispute_prefunding.available.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

  • refund_and_dispute_prefunding.pending (array of objects) Funds that are pending

    • refund_and_dispute_prefunding.pending.amount (integer) Balance amount.

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

    • refund_and_dispute_prefunding.pending.source_types (object, nullable) Breakdown of balance by source types. Funds coming from certain source / payment method types must be shown separately. All payment methods that do not have this restriction will be combined with the card source type balance.

      • refund_and_dispute_prefunding.pending.source_types.bank_account (integer, nullable) Amount coming from legacy US ACH payments.

      • refund_and_dispute_prefunding.pending.source_types.card (integer, nullable) Amount coming from most payment methods, including cards as well as non-legacy bank debits.

      • refund_and_dispute_prefunding.pending.source_types.fpx (integer, nullable) Amount coming from FPX, a Malaysian payment method.

The Balance object

{
  "object": "balance",
  "available": [
    {
      "amount": 666670,
      "currency": "usd",
      "source_types": {
        "card": 666670
      }
    }
  ],
  "connect_reserved": [
    {
      "amount": 0,
      "currency": "usd"
    }
  ],
  "livemode": false,
  "pending": [
    {
      "amount": 61414,
      "currency": "usd",
      "source_types": {
        "card": 61414
      }
    }
  ]
}