View Source Stripe.CashBalance (Striped v0.1.0)

A customer's Cash balance represents real funds. Customers can add funds to their cash balance by sending a bank transfer. These funds can be used for payment and can eventually be paid out to your bank account.

Link to this section Summary

Types

t()

The cash_balance type.

Functions

Retrieves a customer’s cash balance.

Changes the settings on a customer’s cash balance.

Link to this section Types

@type t() :: %Stripe.CashBalance{
  available: term() | nil,
  customer: binary(),
  livemode: boolean(),
  object: binary(),
  settings: term()
}

The cash_balance type.

  • available A hash of all cash balances available to this customer. You cannot delete a customer with any cash balances, even if the balance is 0. Amounts are represented in the smallest currency unit.
  • customer The ID of the customer whose cash balance this object represents.
  • livemode Has the value true if the object exists in live mode or the value false if the object exists in test mode.
  • object String representing the object's type. Objects of the same type share the same value.
  • settings

Link to this section Functions

Link to this function

retrieve(client, customer, params \\ %{})

View Source
@spec retrieve(client :: term(), customer :: binary(), params :: map()) ::
  {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}

Retrieves a customer’s cash balance.

Details

  • Method: get
  • Path: /v1/customers/{customer}/cash_balance

Query parameters

  • :expand array of: string
Link to this function

update(client, customer, params \\ %{})

View Source
@spec update(client :: term(), customer :: binary(), params :: map()) ::
  {:ok, t()} | {:error, Stripe.ApiErrors.t()} | {:error, term()}

Changes the settings on a customer’s cash balance.

Details

  • Method: post
  • Path: /v1/customers/{customer}/cash_balance