Skip to main content

stripe_shared/
issuing_cardholder_requirements.rs

1#[derive(Clone, Eq, PartialEq)]
2#[cfg_attr(not(feature = "redact-generated-debug"), derive(Debug))]
3#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
4#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
5pub struct IssuingCardholderRequirements {
6    /// If `disabled_reason` is present, all cards will decline authorizations with `cardholder_verification_required` reason.
7    pub disabled_reason: Option<IssuingCardholderRequirementsDisabledReason>,
8    /// Array of fields that need to be collected in order to verify and re-enable the cardholder.
9    pub past_due: Option<Vec<IssuingCardholderRequirementsPastDue>>,
10}
11#[cfg(feature = "redact-generated-debug")]
12impl std::fmt::Debug for IssuingCardholderRequirements {
13    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
14        f.debug_struct("IssuingCardholderRequirements").finish_non_exhaustive()
15    }
16}
17#[doc(hidden)]
18pub struct IssuingCardholderRequirementsBuilder {
19    disabled_reason: Option<Option<IssuingCardholderRequirementsDisabledReason>>,
20    past_due: Option<Option<Vec<IssuingCardholderRequirementsPastDue>>>,
21}
22
23#[allow(
24    unused_variables,
25    irrefutable_let_patterns,
26    clippy::let_unit_value,
27    clippy::match_single_binding,
28    clippy::single_match
29)]
30const _: () = {
31    use miniserde::de::{Map, Visitor};
32    use miniserde::json::Value;
33    use miniserde::{Deserialize, Result, make_place};
34    use stripe_types::miniserde_helpers::FromValueOpt;
35    use stripe_types::{MapBuilder, ObjectDeser};
36
37    make_place!(Place);
38
39    impl Deserialize for IssuingCardholderRequirements {
40        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
41            Place::new(out)
42        }
43    }
44
45    struct Builder<'a> {
46        out: &'a mut Option<IssuingCardholderRequirements>,
47        builder: IssuingCardholderRequirementsBuilder,
48    }
49
50    impl Visitor for Place<IssuingCardholderRequirements> {
51        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
52            Ok(Box::new(Builder {
53                out: &mut self.out,
54                builder: IssuingCardholderRequirementsBuilder::deser_default(),
55            }))
56        }
57    }
58
59    impl MapBuilder for IssuingCardholderRequirementsBuilder {
60        type Out = IssuingCardholderRequirements;
61        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
62            Ok(match k {
63                "disabled_reason" => Deserialize::begin(&mut self.disabled_reason),
64                "past_due" => Deserialize::begin(&mut self.past_due),
65                _ => <dyn Visitor>::ignore(),
66            })
67        }
68
69        fn deser_default() -> Self {
70            Self { disabled_reason: Some(None), past_due: Some(None) }
71        }
72
73        fn take_out(&mut self) -> Option<Self::Out> {
74            let (Some(disabled_reason), Some(past_due)) =
75                (self.disabled_reason.take(), self.past_due.take())
76            else {
77                return None;
78            };
79            Some(Self::Out { disabled_reason, past_due })
80        }
81    }
82
83    impl Map for Builder<'_> {
84        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
85            self.builder.key(k)
86        }
87
88        fn finish(&mut self) -> Result<()> {
89            *self.out = self.builder.take_out();
90            Ok(())
91        }
92    }
93
94    impl ObjectDeser for IssuingCardholderRequirements {
95        type Builder = IssuingCardholderRequirementsBuilder;
96    }
97
98    impl FromValueOpt for IssuingCardholderRequirements {
99        fn from_value(v: Value) -> Option<Self> {
100            let Value::Object(obj) = v else {
101                return None;
102            };
103            let mut b = IssuingCardholderRequirementsBuilder::deser_default();
104            for (k, v) in obj {
105                match k.as_str() {
106                    "disabled_reason" => b.disabled_reason = FromValueOpt::from_value(v),
107                    "past_due" => b.past_due = FromValueOpt::from_value(v),
108                    _ => {}
109                }
110            }
111            b.take_out()
112        }
113    }
114};
115/// If `disabled_reason` is present, all cards will decline authorizations with `cardholder_verification_required` reason.
116#[derive(Clone, Eq, PartialEq)]
117#[non_exhaustive]
118pub enum IssuingCardholderRequirementsDisabledReason {
119    Listed,
120    RejectedListed,
121    RequirementsPastDue,
122    UnderReview,
123    /// An unrecognized value from Stripe. Should not be used as a request parameter.
124    Unknown(String),
125}
126impl IssuingCardholderRequirementsDisabledReason {
127    pub fn as_str(&self) -> &str {
128        use IssuingCardholderRequirementsDisabledReason::*;
129        match self {
130            Listed => "listed",
131            RejectedListed => "rejected.listed",
132            RequirementsPastDue => "requirements.past_due",
133            UnderReview => "under_review",
134            Unknown(v) => v,
135        }
136    }
137}
138
139impl std::str::FromStr for IssuingCardholderRequirementsDisabledReason {
140    type Err = std::convert::Infallible;
141    fn from_str(s: &str) -> Result<Self, Self::Err> {
142        use IssuingCardholderRequirementsDisabledReason::*;
143        match s {
144            "listed" => Ok(Listed),
145            "rejected.listed" => Ok(RejectedListed),
146            "requirements.past_due" => Ok(RequirementsPastDue),
147            "under_review" => Ok(UnderReview),
148            v => {
149                tracing::warn!(
150                    "Unknown value '{}' for enum '{}'",
151                    v,
152                    "IssuingCardholderRequirementsDisabledReason"
153                );
154                Ok(Unknown(v.to_owned()))
155            }
156        }
157    }
158}
159impl std::fmt::Display for IssuingCardholderRequirementsDisabledReason {
160    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
161        f.write_str(self.as_str())
162    }
163}
164
165#[cfg(not(feature = "redact-generated-debug"))]
166impl std::fmt::Debug for IssuingCardholderRequirementsDisabledReason {
167    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
168        f.write_str(self.as_str())
169    }
170}
171#[cfg(feature = "redact-generated-debug")]
172impl std::fmt::Debug for IssuingCardholderRequirementsDisabledReason {
173    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
174        f.debug_struct(stringify!(IssuingCardholderRequirementsDisabledReason))
175            .finish_non_exhaustive()
176    }
177}
178#[cfg(feature = "serialize")]
179impl serde::Serialize for IssuingCardholderRequirementsDisabledReason {
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 IssuingCardholderRequirementsDisabledReason {
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<IssuingCardholderRequirementsDisabledReason> {
194    fn string(&mut self, s: &str) -> miniserde::Result<()> {
195        use std::str::FromStr;
196        self.out =
197            Some(IssuingCardholderRequirementsDisabledReason::from_str(s).expect("infallible"));
198        Ok(())
199    }
200}
201
202stripe_types::impl_from_val_with_from_str!(IssuingCardholderRequirementsDisabledReason);
203#[cfg(feature = "deserialize")]
204impl<'de> serde::Deserialize<'de> for IssuingCardholderRequirementsDisabledReason {
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        Ok(Self::from_str(&s).expect("infallible"))
209    }
210}
211/// Array of fields that need to be collected in order to verify and re-enable the cardholder.
212#[derive(Clone, Eq, PartialEq)]
213#[non_exhaustive]
214pub enum IssuingCardholderRequirementsPastDue {
215    CompanyTaxId,
216    IndividualCardIssuingUserTermsAcceptanceDate,
217    IndividualCardIssuingUserTermsAcceptanceIp,
218    IndividualDobDay,
219    IndividualDobMonth,
220    IndividualDobYear,
221    IndividualFirstName,
222    IndividualLastName,
223    IndividualVerificationDocument,
224    /// An unrecognized value from Stripe. Should not be used as a request parameter.
225    Unknown(String),
226}
227impl IssuingCardholderRequirementsPastDue {
228    pub fn as_str(&self) -> &str {
229        use IssuingCardholderRequirementsPastDue::*;
230        match self {
231            CompanyTaxId => "company.tax_id",
232            IndividualCardIssuingUserTermsAcceptanceDate => {
233                "individual.card_issuing.user_terms_acceptance.date"
234            }
235            IndividualCardIssuingUserTermsAcceptanceIp => {
236                "individual.card_issuing.user_terms_acceptance.ip"
237            }
238            IndividualDobDay => "individual.dob.day",
239            IndividualDobMonth => "individual.dob.month",
240            IndividualDobYear => "individual.dob.year",
241            IndividualFirstName => "individual.first_name",
242            IndividualLastName => "individual.last_name",
243            IndividualVerificationDocument => "individual.verification.document",
244            Unknown(v) => v,
245        }
246    }
247}
248
249impl std::str::FromStr for IssuingCardholderRequirementsPastDue {
250    type Err = std::convert::Infallible;
251    fn from_str(s: &str) -> Result<Self, Self::Err> {
252        use IssuingCardholderRequirementsPastDue::*;
253        match s {
254            "company.tax_id" => Ok(CompanyTaxId),
255            "individual.card_issuing.user_terms_acceptance.date" => {
256                Ok(IndividualCardIssuingUserTermsAcceptanceDate)
257            }
258            "individual.card_issuing.user_terms_acceptance.ip" => {
259                Ok(IndividualCardIssuingUserTermsAcceptanceIp)
260            }
261            "individual.dob.day" => Ok(IndividualDobDay),
262            "individual.dob.month" => Ok(IndividualDobMonth),
263            "individual.dob.year" => Ok(IndividualDobYear),
264            "individual.first_name" => Ok(IndividualFirstName),
265            "individual.last_name" => Ok(IndividualLastName),
266            "individual.verification.document" => Ok(IndividualVerificationDocument),
267            v => {
268                tracing::warn!(
269                    "Unknown value '{}' for enum '{}'",
270                    v,
271                    "IssuingCardholderRequirementsPastDue"
272                );
273                Ok(Unknown(v.to_owned()))
274            }
275        }
276    }
277}
278impl std::fmt::Display for IssuingCardholderRequirementsPastDue {
279    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
280        f.write_str(self.as_str())
281    }
282}
283
284#[cfg(not(feature = "redact-generated-debug"))]
285impl std::fmt::Debug for IssuingCardholderRequirementsPastDue {
286    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
287        f.write_str(self.as_str())
288    }
289}
290#[cfg(feature = "redact-generated-debug")]
291impl std::fmt::Debug for IssuingCardholderRequirementsPastDue {
292    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
293        f.debug_struct(stringify!(IssuingCardholderRequirementsPastDue)).finish_non_exhaustive()
294    }
295}
296#[cfg(feature = "serialize")]
297impl serde::Serialize for IssuingCardholderRequirementsPastDue {
298    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
299    where
300        S: serde::Serializer,
301    {
302        serializer.serialize_str(self.as_str())
303    }
304}
305impl miniserde::Deserialize for IssuingCardholderRequirementsPastDue {
306    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
307        crate::Place::new(out)
308    }
309}
310
311impl miniserde::de::Visitor for crate::Place<IssuingCardholderRequirementsPastDue> {
312    fn string(&mut self, s: &str) -> miniserde::Result<()> {
313        use std::str::FromStr;
314        self.out = Some(IssuingCardholderRequirementsPastDue::from_str(s).expect("infallible"));
315        Ok(())
316    }
317}
318
319stripe_types::impl_from_val_with_from_str!(IssuingCardholderRequirementsPastDue);
320#[cfg(feature = "deserialize")]
321impl<'de> serde::Deserialize<'de> for IssuingCardholderRequirementsPastDue {
322    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
323        use std::str::FromStr;
324        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
325        Ok(Self::from_str(&s).expect("infallible"))
326    }
327}