stripe_misc/
gelato_id_number_report.rs

1/// Result from an id_number check
2#[derive(Clone, Debug)]
3#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
4#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
5pub struct GelatoIdNumberReport {
6    /// Date of birth.
7    pub dob: Option<stripe_misc::GelatoDataIdNumberReportDate>,
8    /// Details on the verification error. Present when status is `unverified`.
9    pub error: Option<stripe_misc::GelatoIdNumberReportError>,
10    /// First name.
11    pub first_name: Option<String>,
12    /// ID number. When `id_number_type` is `us_ssn`, only the last 4 digits are present.
13    pub id_number: Option<String>,
14    /// Type of ID number.
15    pub id_number_type: Option<GelatoIdNumberReportIdNumberType>,
16    /// Last name.
17    pub last_name: Option<String>,
18    /// Status of this `id_number` check.
19    pub status: GelatoIdNumberReportStatus,
20}
21#[doc(hidden)]
22pub struct GelatoIdNumberReportBuilder {
23    dob: Option<Option<stripe_misc::GelatoDataIdNumberReportDate>>,
24    error: Option<Option<stripe_misc::GelatoIdNumberReportError>>,
25    first_name: Option<Option<String>>,
26    id_number: Option<Option<String>>,
27    id_number_type: Option<Option<GelatoIdNumberReportIdNumberType>>,
28    last_name: Option<Option<String>>,
29    status: Option<GelatoIdNumberReportStatus>,
30}
31
32#[allow(
33    unused_variables,
34    irrefutable_let_patterns,
35    clippy::let_unit_value,
36    clippy::match_single_binding,
37    clippy::single_match
38)]
39const _: () = {
40    use miniserde::de::{Map, Visitor};
41    use miniserde::json::Value;
42    use miniserde::{Deserialize, Result, make_place};
43    use stripe_types::miniserde_helpers::FromValueOpt;
44    use stripe_types::{MapBuilder, ObjectDeser};
45
46    make_place!(Place);
47
48    impl Deserialize for GelatoIdNumberReport {
49        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
50            Place::new(out)
51        }
52    }
53
54    struct Builder<'a> {
55        out: &'a mut Option<GelatoIdNumberReport>,
56        builder: GelatoIdNumberReportBuilder,
57    }
58
59    impl Visitor for Place<GelatoIdNumberReport> {
60        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
61            Ok(Box::new(Builder {
62                out: &mut self.out,
63                builder: GelatoIdNumberReportBuilder::deser_default(),
64            }))
65        }
66    }
67
68    impl MapBuilder for GelatoIdNumberReportBuilder {
69        type Out = GelatoIdNumberReport;
70        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
71            Ok(match k {
72                "dob" => Deserialize::begin(&mut self.dob),
73                "error" => Deserialize::begin(&mut self.error),
74                "first_name" => Deserialize::begin(&mut self.first_name),
75                "id_number" => Deserialize::begin(&mut self.id_number),
76                "id_number_type" => Deserialize::begin(&mut self.id_number_type),
77                "last_name" => Deserialize::begin(&mut self.last_name),
78                "status" => Deserialize::begin(&mut self.status),
79                _ => <dyn Visitor>::ignore(),
80            })
81        }
82
83        fn deser_default() -> Self {
84            Self {
85                dob: Deserialize::default(),
86                error: Deserialize::default(),
87                first_name: Deserialize::default(),
88                id_number: Deserialize::default(),
89                id_number_type: Deserialize::default(),
90                last_name: Deserialize::default(),
91                status: Deserialize::default(),
92            }
93        }
94
95        fn take_out(&mut self) -> Option<Self::Out> {
96            let (
97                Some(dob),
98                Some(error),
99                Some(first_name),
100                Some(id_number),
101                Some(id_number_type),
102                Some(last_name),
103                Some(status),
104            ) = (
105                self.dob,
106                self.error.take(),
107                self.first_name.take(),
108                self.id_number.take(),
109                self.id_number_type.take(),
110                self.last_name.take(),
111                self.status.take(),
112            )
113            else {
114                return None;
115            };
116            Some(Self::Out { dob, error, first_name, id_number, id_number_type, last_name, status })
117        }
118    }
119
120    impl Map for Builder<'_> {
121        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
122            self.builder.key(k)
123        }
124
125        fn finish(&mut self) -> Result<()> {
126            *self.out = self.builder.take_out();
127            Ok(())
128        }
129    }
130
131    impl ObjectDeser for GelatoIdNumberReport {
132        type Builder = GelatoIdNumberReportBuilder;
133    }
134
135    impl FromValueOpt for GelatoIdNumberReport {
136        fn from_value(v: Value) -> Option<Self> {
137            let Value::Object(obj) = v else {
138                return None;
139            };
140            let mut b = GelatoIdNumberReportBuilder::deser_default();
141            for (k, v) in obj {
142                match k.as_str() {
143                    "dob" => b.dob = FromValueOpt::from_value(v),
144                    "error" => b.error = FromValueOpt::from_value(v),
145                    "first_name" => b.first_name = FromValueOpt::from_value(v),
146                    "id_number" => b.id_number = FromValueOpt::from_value(v),
147                    "id_number_type" => b.id_number_type = FromValueOpt::from_value(v),
148                    "last_name" => b.last_name = FromValueOpt::from_value(v),
149                    "status" => b.status = FromValueOpt::from_value(v),
150                    _ => {}
151                }
152            }
153            b.take_out()
154        }
155    }
156};
157/// Type of ID number.
158#[derive(Clone, Eq, PartialEq)]
159#[non_exhaustive]
160pub enum GelatoIdNumberReportIdNumberType {
161    BrCpf,
162    SgNric,
163    UsSsn,
164    /// An unrecognized value from Stripe. Should not be used as a request parameter.
165    Unknown(String),
166}
167impl GelatoIdNumberReportIdNumberType {
168    pub fn as_str(&self) -> &str {
169        use GelatoIdNumberReportIdNumberType::*;
170        match self {
171            BrCpf => "br_cpf",
172            SgNric => "sg_nric",
173            UsSsn => "us_ssn",
174            Unknown(v) => v,
175        }
176    }
177}
178
179impl std::str::FromStr for GelatoIdNumberReportIdNumberType {
180    type Err = std::convert::Infallible;
181    fn from_str(s: &str) -> Result<Self, Self::Err> {
182        use GelatoIdNumberReportIdNumberType::*;
183        match s {
184            "br_cpf" => Ok(BrCpf),
185            "sg_nric" => Ok(SgNric),
186            "us_ssn" => Ok(UsSsn),
187            v => {
188                tracing::warn!(
189                    "Unknown value '{}' for enum '{}'",
190                    v,
191                    "GelatoIdNumberReportIdNumberType"
192                );
193                Ok(Unknown(v.to_owned()))
194            }
195        }
196    }
197}
198impl std::fmt::Display for GelatoIdNumberReportIdNumberType {
199    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
200        f.write_str(self.as_str())
201    }
202}
203
204impl std::fmt::Debug for GelatoIdNumberReportIdNumberType {
205    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
206        f.write_str(self.as_str())
207    }
208}
209#[cfg(feature = "serialize")]
210impl serde::Serialize for GelatoIdNumberReportIdNumberType {
211    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
212    where
213        S: serde::Serializer,
214    {
215        serializer.serialize_str(self.as_str())
216    }
217}
218impl miniserde::Deserialize for GelatoIdNumberReportIdNumberType {
219    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
220        crate::Place::new(out)
221    }
222}
223
224impl miniserde::de::Visitor for crate::Place<GelatoIdNumberReportIdNumberType> {
225    fn string(&mut self, s: &str) -> miniserde::Result<()> {
226        use std::str::FromStr;
227        self.out = Some(GelatoIdNumberReportIdNumberType::from_str(s).expect("infallible"));
228        Ok(())
229    }
230}
231
232stripe_types::impl_from_val_with_from_str!(GelatoIdNumberReportIdNumberType);
233#[cfg(feature = "deserialize")]
234impl<'de> serde::Deserialize<'de> for GelatoIdNumberReportIdNumberType {
235    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
236        use std::str::FromStr;
237        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
238        Ok(Self::from_str(&s).expect("infallible"))
239    }
240}
241/// Status of this `id_number` check.
242#[derive(Clone, Eq, PartialEq)]
243#[non_exhaustive]
244pub enum GelatoIdNumberReportStatus {
245    Unverified,
246    Verified,
247    /// An unrecognized value from Stripe. Should not be used as a request parameter.
248    Unknown(String),
249}
250impl GelatoIdNumberReportStatus {
251    pub fn as_str(&self) -> &str {
252        use GelatoIdNumberReportStatus::*;
253        match self {
254            Unverified => "unverified",
255            Verified => "verified",
256            Unknown(v) => v,
257        }
258    }
259}
260
261impl std::str::FromStr for GelatoIdNumberReportStatus {
262    type Err = std::convert::Infallible;
263    fn from_str(s: &str) -> Result<Self, Self::Err> {
264        use GelatoIdNumberReportStatus::*;
265        match s {
266            "unverified" => Ok(Unverified),
267            "verified" => Ok(Verified),
268            v => {
269                tracing::warn!("Unknown value '{}' for enum '{}'", v, "GelatoIdNumberReportStatus");
270                Ok(Unknown(v.to_owned()))
271            }
272        }
273    }
274}
275impl std::fmt::Display for GelatoIdNumberReportStatus {
276    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
277        f.write_str(self.as_str())
278    }
279}
280
281impl std::fmt::Debug for GelatoIdNumberReportStatus {
282    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
283        f.write_str(self.as_str())
284    }
285}
286#[cfg(feature = "serialize")]
287impl serde::Serialize for GelatoIdNumberReportStatus {
288    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
289    where
290        S: serde::Serializer,
291    {
292        serializer.serialize_str(self.as_str())
293    }
294}
295impl miniserde::Deserialize for GelatoIdNumberReportStatus {
296    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
297        crate::Place::new(out)
298    }
299}
300
301impl miniserde::de::Visitor for crate::Place<GelatoIdNumberReportStatus> {
302    fn string(&mut self, s: &str) -> miniserde::Result<()> {
303        use std::str::FromStr;
304        self.out = Some(GelatoIdNumberReportStatus::from_str(s).expect("infallible"));
305        Ok(())
306    }
307}
308
309stripe_types::impl_from_val_with_from_str!(GelatoIdNumberReportStatus);
310#[cfg(feature = "deserialize")]
311impl<'de> serde::Deserialize<'de> for GelatoIdNumberReportStatus {
312    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
313        use std::str::FromStr;
314        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
315        Ok(Self::from_str(&s).expect("infallible"))
316    }
317}