balance.go

package stripe

// BalanceSourceType is the list of allowed values for the balance amount's source_type field keys.
type BalanceSourceType string

// List of values that BalanceSourceType can take.
const (
	BalanceSourceTypeAlipayAccount   BalanceSourceType = "alipay_account"
	BalanceSourceTypeBankAccount     BalanceSourceType = "bank_account"
	BalanceSourceTypeBitcoinReceiver BalanceSourceType = "bitcoin_receiver"
	BalanceSourceTypeCard            BalanceSourceType = "card"
	BalanceSourceTypeFPX             BalanceSourceType = "fpx"
)

// BalanceTransactionStatus is the list of allowed values for the balance transaction's status.
type BalanceTransactionStatus string

// BalanceParams is the set of parameters that can be used when retrieving a balance.
// For more details see https://stripe.com/docs/api#balance.
type BalanceParams struct {
	Params `form:"*"`
}

// Amount is a structure wrapping an amount value and its currency.
type Amount struct {
	Currency    Currency                    `json:"currency"`
	SourceTypes map[BalanceSourceType]int64 `json:"source_types"`
	Value       int64                       `json:"amount"`
}

// BalanceDetails is the resource representing details about a specific product's balance.
type BalanceDetails struct {
	Available []*Amount `json:"available"`
}

// Balance is the resource representing your Stripe balance.
// For more details see https://stripe.com/docs/api/#balance.
type Balance struct {
	APIResource
	Available       []*Amount       `json:"available"`
	ConnectReserved []*Amount       `json:"connect_reserved"`
	Issuing         *BalanceDetails `json:"issuing"`
	Livemode        bool            `json:"livemode"`
	Object          string          `json:"object"`
	Pending         []*Amount       `json:"pending"`
}