stripe_core/
balance_settings_resource_payouts.rs

1#[derive(Clone, Debug)]
2#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
3#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
4pub struct BalanceSettingsResourcePayouts {
5    /// The minimum balance amount to retain per currency after automatic payouts.
6    /// Only funds that exceed these amounts are paid out.
7    /// Learn more about the [minimum balances for automatic payouts](/payouts/minimum-balances-for-automatic-payouts).
8    pub minimum_balance_by_currency: Option<std::collections::HashMap<String, i64>>,
9    /// Details on when funds from charges are available, and when they are paid out to an external account.
10    /// See our [Setting Bank and Debit Card Payouts](https://stripe.com/docs/connect/bank-transfers#payout-information) documentation for details.
11    pub schedule: Option<stripe_core::BalanceSettingsResourcePayoutSchedule>,
12    /// The text that appears on the bank account statement for payouts.
13    /// If not set, this defaults to the platform's bank descriptor as set in the Dashboard.
14    pub statement_descriptor: Option<String>,
15    /// Whether the funds in this account can be paid out.
16    pub status: BalanceSettingsResourcePayoutsStatus,
17}
18#[doc(hidden)]
19pub struct BalanceSettingsResourcePayoutsBuilder {
20    minimum_balance_by_currency: Option<Option<std::collections::HashMap<String, i64>>>,
21    schedule: Option<Option<stripe_core::BalanceSettingsResourcePayoutSchedule>>,
22    statement_descriptor: Option<Option<String>>,
23    status: Option<BalanceSettingsResourcePayoutsStatus>,
24}
25
26#[allow(
27    unused_variables,
28    irrefutable_let_patterns,
29    clippy::let_unit_value,
30    clippy::match_single_binding,
31    clippy::single_match
32)]
33const _: () = {
34    use miniserde::de::{Map, Visitor};
35    use miniserde::json::Value;
36    use miniserde::{Deserialize, Result, make_place};
37    use stripe_types::miniserde_helpers::FromValueOpt;
38    use stripe_types::{MapBuilder, ObjectDeser};
39
40    make_place!(Place);
41
42    impl Deserialize for BalanceSettingsResourcePayouts {
43        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
44            Place::new(out)
45        }
46    }
47
48    struct Builder<'a> {
49        out: &'a mut Option<BalanceSettingsResourcePayouts>,
50        builder: BalanceSettingsResourcePayoutsBuilder,
51    }
52
53    impl Visitor for Place<BalanceSettingsResourcePayouts> {
54        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
55            Ok(Box::new(Builder {
56                out: &mut self.out,
57                builder: BalanceSettingsResourcePayoutsBuilder::deser_default(),
58            }))
59        }
60    }
61
62    impl MapBuilder for BalanceSettingsResourcePayoutsBuilder {
63        type Out = BalanceSettingsResourcePayouts;
64        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
65            Ok(match k {
66                "minimum_balance_by_currency" => {
67                    Deserialize::begin(&mut self.minimum_balance_by_currency)
68                }
69                "schedule" => Deserialize::begin(&mut self.schedule),
70                "statement_descriptor" => Deserialize::begin(&mut self.statement_descriptor),
71                "status" => Deserialize::begin(&mut self.status),
72                _ => <dyn Visitor>::ignore(),
73            })
74        }
75
76        fn deser_default() -> Self {
77            Self {
78                minimum_balance_by_currency: Deserialize::default(),
79                schedule: Deserialize::default(),
80                statement_descriptor: Deserialize::default(),
81                status: Deserialize::default(),
82            }
83        }
84
85        fn take_out(&mut self) -> Option<Self::Out> {
86            let (
87                Some(minimum_balance_by_currency),
88                Some(schedule),
89                Some(statement_descriptor),
90                Some(status),
91            ) = (
92                self.minimum_balance_by_currency.take(),
93                self.schedule.take(),
94                self.statement_descriptor.take(),
95                self.status,
96            )
97            else {
98                return None;
99            };
100            Some(Self::Out { minimum_balance_by_currency, schedule, statement_descriptor, status })
101        }
102    }
103
104    impl Map for Builder<'_> {
105        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
106            self.builder.key(k)
107        }
108
109        fn finish(&mut self) -> Result<()> {
110            *self.out = self.builder.take_out();
111            Ok(())
112        }
113    }
114
115    impl ObjectDeser for BalanceSettingsResourcePayouts {
116        type Builder = BalanceSettingsResourcePayoutsBuilder;
117    }
118
119    impl FromValueOpt for BalanceSettingsResourcePayouts {
120        fn from_value(v: Value) -> Option<Self> {
121            let Value::Object(obj) = v else {
122                return None;
123            };
124            let mut b = BalanceSettingsResourcePayoutsBuilder::deser_default();
125            for (k, v) in obj {
126                match k.as_str() {
127                    "minimum_balance_by_currency" => {
128                        b.minimum_balance_by_currency = FromValueOpt::from_value(v)
129                    }
130                    "schedule" => b.schedule = FromValueOpt::from_value(v),
131                    "statement_descriptor" => b.statement_descriptor = FromValueOpt::from_value(v),
132                    "status" => b.status = FromValueOpt::from_value(v),
133                    _ => {}
134                }
135            }
136            b.take_out()
137        }
138    }
139};
140/// Whether the funds in this account can be paid out.
141#[derive(Copy, Clone, Eq, PartialEq)]
142pub enum BalanceSettingsResourcePayoutsStatus {
143    Disabled,
144    Enabled,
145}
146impl BalanceSettingsResourcePayoutsStatus {
147    pub fn as_str(self) -> &'static str {
148        use BalanceSettingsResourcePayoutsStatus::*;
149        match self {
150            Disabled => "disabled",
151            Enabled => "enabled",
152        }
153    }
154}
155
156impl std::str::FromStr for BalanceSettingsResourcePayoutsStatus {
157    type Err = stripe_types::StripeParseError;
158    fn from_str(s: &str) -> Result<Self, Self::Err> {
159        use BalanceSettingsResourcePayoutsStatus::*;
160        match s {
161            "disabled" => Ok(Disabled),
162            "enabled" => Ok(Enabled),
163            _ => Err(stripe_types::StripeParseError),
164        }
165    }
166}
167impl std::fmt::Display for BalanceSettingsResourcePayoutsStatus {
168    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
169        f.write_str(self.as_str())
170    }
171}
172
173impl std::fmt::Debug for BalanceSettingsResourcePayoutsStatus {
174    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
175        f.write_str(self.as_str())
176    }
177}
178#[cfg(feature = "serialize")]
179impl serde::Serialize for BalanceSettingsResourcePayoutsStatus {
180    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
181    where
182        S: serde::Serializer,
183    {
184        serializer.serialize_str(self.as_str())
185    }
186}
187impl miniserde::Deserialize for BalanceSettingsResourcePayoutsStatus {
188    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
189        crate::Place::new(out)
190    }
191}
192
193impl miniserde::de::Visitor for crate::Place<BalanceSettingsResourcePayoutsStatus> {
194    fn string(&mut self, s: &str) -> miniserde::Result<()> {
195        use std::str::FromStr;
196        self.out =
197            Some(BalanceSettingsResourcePayoutsStatus::from_str(s).map_err(|_| miniserde::Error)?);
198        Ok(())
199    }
200}
201
202stripe_types::impl_from_val_with_from_str!(BalanceSettingsResourcePayoutsStatus);
203#[cfg(feature = "deserialize")]
204impl<'de> serde::Deserialize<'de> for BalanceSettingsResourcePayoutsStatus {
205    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
206        use std::str::FromStr;
207        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
208        Self::from_str(&s).map_err(|_| {
209            serde::de::Error::custom("Unknown value for BalanceSettingsResourcePayoutsStatus")
210        })
211    }
212}