forked from stripe/stripe-go
-
Notifications
You must be signed in to change notification settings - Fork 0
/
transfer.go
155 lines (135 loc) · 5.96 KB
/
transfer.go
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
package stripe
import "encoding/json"
// TransferStatus is the list of allowed values for the transfer's status.
// Allowed values are "paid", "pending", "in_transit", "failed", "canceled".
type TransferStatus string
// TransferType is the list of allowed values for the transfer's type.
// Allowed values are "bank_account", "card", "stripe_account".
type TransferType string
// TransferSourceType is the list of allowed values for the transfer's source_type field.
// Allowed values are "alipay_account", bank_account", "bitcoin_receiver", "card".
type TransferSourceType string
// TransferFailCode is the list of allowed values for the transfer's failure code.
// Allowed values are "insufficient_funds", "account_closed", "no_account",
// "invalid_account_number", "debit_not_authorized", "bank_ownership_changed",
// "account_frozen", "could_not_process", "bank_account_restricted", "invalid_currency".
type TransferFailCode string
// TransferDestinationType consts represent valid transfer destinations.
type TransferDestinationType string
const (
// TransferDestinationAccount is a constant representing a transfer destination
// which is a Stripe account.
TransferDestinationAccount TransferDestinationType = "account"
// TransferDestinationBankAccount is a constant representing a transfer destination
// which is a bank account.
TransferDestinationBankAccount TransferDestinationType = "bank_account"
// TransferDestinationCard is a constant representing a transfer destination
// which is a card.
TransferDestinationCard TransferDestinationType = "card"
)
// TransferDestination describes the destination of a Transfer.
// The Type should indicate which object is fleshed out
// For more details see https://stripe.com/docs/api/go#transfer_object
type TransferDestination struct {
Type TransferDestinationType `json:"object"`
ID string `json:"id"`
Account *Account `json:"-"`
BankAccount *BankAccount `json:"-"`
Card *Card `json:"-"`
}
// TransferParams is the set of parameters that can be used when creating or updating a transfer.
// For more details see https://stripe.com/docs/api#create_transfer and https://stripe.com/docs/api#update_transfer.
type TransferParams struct {
Params
Amount int64
Fee uint64
Currency Currency
Recipient, Desc, Statement, Bank, Card, SourceTx, Dest string
SourceType TransferSourceType
}
// TransferListParams is the set of parameters that can be used when listing transfers.
// For more details see https://stripe.com/docs/api#list_transfers.
type TransferListParams struct {
ListParams
Created, Date int64
Recipient string
Status TransferStatus
}
// Transfer is the resource representing a Stripe transfer.
// For more details see https://stripe.com/docs/api#transfers.
type Transfer struct {
ID string `json:"id"`
Live bool `json:"livemode"`
Amount int64 `json:"amount"`
AmountReversed int64 `json:"amount_reversed"`
Currency Currency `json:"currency"`
Created int64 `json:"created"`
Date int64 `json:"date"`
Desc string `json:"description"`
Dest TransferDestination `json:"destination"`
FailCode TransferFailCode `json:"failure_code"`
FailMsg string `json:"failure_message"`
Status TransferStatus `json:"status"`
Type TransferType `json:"type"`
Tx *Transaction `json:"balance_transaction"`
Meta map[string]string `json:"metadata"`
Bank *BankAccount `json:"bank_account"`
Card *Card `json:"card"`
Recipient *Recipient `json:"recipient"`
Statement string `json:"statement_descriptor"`
Reversals *ReversalList `json:"reversals"`
Reversed bool `json:"reversed"`
SourceTx *TransactionSource `json:"source_transaction"`
SourceType TransferSourceType `json:"source_type"`
DestPayment string `json:"destination_payment"`
}
// TransferList is a list of transfers as retrieved from a list endpoint.
type TransferList struct {
ListMeta
Values []*Transfer `json:"data"`
}
// UnmarshalJSON handles deserialization of a Transfer.
// This custom unmarshaling is needed because the resulting
// property may be an id or the full struct if it was expanded.
func (t *Transfer) UnmarshalJSON(data []byte) error {
type transfer Transfer
var tb transfer
err := json.Unmarshal(data, &tb)
if err == nil {
*t = Transfer(tb)
} else {
// the id is surrounded by "\" characters, so strip them
t.ID = string(data[1 : len(data)-1])
}
return nil
}
// UnmarshalJSON handles deserialization of a TransferDestination.
// This custom unmarshaling is needed because the specific
// type of destination it refers to is specified in the JSON
func (d *TransferDestination) UnmarshalJSON(data []byte) error {
type dest TransferDestination
var dd dest
err := json.Unmarshal(data, &dd)
if err == nil {
*d = TransferDestination(dd)
switch d.Type {
case TransferDestinationAccount:
json.Unmarshal(data, &d.Account)
case TransferDestinationBankAccount:
json.Unmarshal(data, &d.BankAccount)
case TransferDestinationCard:
json.Unmarshal(data, &d.Card)
}
} else {
// the id is surrounded by "\" characters, so strip them
d.ID = string(data[1 : len(data)-1])
}
return nil
}
// MarshalJSON handles serialization of a TransferDestination.
// This custom marshaling is needed because we can only send a string
// ID as a destination, even though it can be expanded to a full
// object when retrieving
func (d *TransferDestination) MarshalJSON() ([]byte, error) {
return json.Marshal(d.ID)
}