stripe_shared/
checkout_affirm_payment_method_options.rs

1#[derive(Clone, Debug)]
2#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
3#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
4pub struct CheckoutAffirmPaymentMethodOptions {
5    /// Controls when the funds will be captured from the customer's account.
6    pub capture_method: Option<CheckoutAffirmPaymentMethodOptionsCaptureMethod>,
7    /// Indicates that you intend to make future payments with this PaymentIntent's payment method.
8    ///
9    /// If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions.
10    /// If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
11    ///
12    /// If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
13    ///
14    /// When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
15    pub setup_future_usage: Option<CheckoutAffirmPaymentMethodOptionsSetupFutureUsage>,
16}
17#[doc(hidden)]
18pub struct CheckoutAffirmPaymentMethodOptionsBuilder {
19    capture_method: Option<Option<CheckoutAffirmPaymentMethodOptionsCaptureMethod>>,
20    setup_future_usage: Option<Option<CheckoutAffirmPaymentMethodOptionsSetupFutureUsage>>,
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 CheckoutAffirmPaymentMethodOptions {
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<CheckoutAffirmPaymentMethodOptions>,
47        builder: CheckoutAffirmPaymentMethodOptionsBuilder,
48    }
49
50    impl Visitor for Place<CheckoutAffirmPaymentMethodOptions> {
51        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
52            Ok(Box::new(Builder {
53                out: &mut self.out,
54                builder: CheckoutAffirmPaymentMethodOptionsBuilder::deser_default(),
55            }))
56        }
57    }
58
59    impl MapBuilder for CheckoutAffirmPaymentMethodOptionsBuilder {
60        type Out = CheckoutAffirmPaymentMethodOptions;
61        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
62            Ok(match k {
63                "capture_method" => Deserialize::begin(&mut self.capture_method),
64                "setup_future_usage" => Deserialize::begin(&mut self.setup_future_usage),
65                _ => <dyn Visitor>::ignore(),
66            })
67        }
68
69        fn deser_default() -> Self {
70            Self {
71                capture_method: Deserialize::default(),
72                setup_future_usage: Deserialize::default(),
73            }
74        }
75
76        fn take_out(&mut self) -> Option<Self::Out> {
77            let (Some(capture_method), Some(setup_future_usage)) =
78                (self.capture_method.take(), self.setup_future_usage.take())
79            else {
80                return None;
81            };
82            Some(Self::Out { capture_method, setup_future_usage })
83        }
84    }
85
86    impl Map for Builder<'_> {
87        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
88            self.builder.key(k)
89        }
90
91        fn finish(&mut self) -> Result<()> {
92            *self.out = self.builder.take_out();
93            Ok(())
94        }
95    }
96
97    impl ObjectDeser for CheckoutAffirmPaymentMethodOptions {
98        type Builder = CheckoutAffirmPaymentMethodOptionsBuilder;
99    }
100
101    impl FromValueOpt for CheckoutAffirmPaymentMethodOptions {
102        fn from_value(v: Value) -> Option<Self> {
103            let Value::Object(obj) = v else {
104                return None;
105            };
106            let mut b = CheckoutAffirmPaymentMethodOptionsBuilder::deser_default();
107            for (k, v) in obj {
108                match k.as_str() {
109                    "capture_method" => b.capture_method = FromValueOpt::from_value(v),
110                    "setup_future_usage" => b.setup_future_usage = FromValueOpt::from_value(v),
111                    _ => {}
112                }
113            }
114            b.take_out()
115        }
116    }
117};
118/// Controls when the funds will be captured from the customer's account.
119#[derive(Clone, Eq, PartialEq)]
120#[non_exhaustive]
121pub enum CheckoutAffirmPaymentMethodOptionsCaptureMethod {
122    Manual,
123    /// An unrecognized value from Stripe. Should not be used as a request parameter.
124    Unknown(String),
125}
126impl CheckoutAffirmPaymentMethodOptionsCaptureMethod {
127    pub fn as_str(&self) -> &str {
128        use CheckoutAffirmPaymentMethodOptionsCaptureMethod::*;
129        match self {
130            Manual => "manual",
131            Unknown(v) => v,
132        }
133    }
134}
135
136impl std::str::FromStr for CheckoutAffirmPaymentMethodOptionsCaptureMethod {
137    type Err = std::convert::Infallible;
138    fn from_str(s: &str) -> Result<Self, Self::Err> {
139        use CheckoutAffirmPaymentMethodOptionsCaptureMethod::*;
140        match s {
141            "manual" => Ok(Manual),
142            v => {
143                tracing::warn!(
144                    "Unknown value '{}' for enum '{}'",
145                    v,
146                    "CheckoutAffirmPaymentMethodOptionsCaptureMethod"
147                );
148                Ok(Unknown(v.to_owned()))
149            }
150        }
151    }
152}
153impl std::fmt::Display for CheckoutAffirmPaymentMethodOptionsCaptureMethod {
154    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
155        f.write_str(self.as_str())
156    }
157}
158
159impl std::fmt::Debug for CheckoutAffirmPaymentMethodOptionsCaptureMethod {
160    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
161        f.write_str(self.as_str())
162    }
163}
164#[cfg(feature = "serialize")]
165impl serde::Serialize for CheckoutAffirmPaymentMethodOptionsCaptureMethod {
166    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
167    where
168        S: serde::Serializer,
169    {
170        serializer.serialize_str(self.as_str())
171    }
172}
173impl miniserde::Deserialize for CheckoutAffirmPaymentMethodOptionsCaptureMethod {
174    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
175        crate::Place::new(out)
176    }
177}
178
179impl miniserde::de::Visitor for crate::Place<CheckoutAffirmPaymentMethodOptionsCaptureMethod> {
180    fn string(&mut self, s: &str) -> miniserde::Result<()> {
181        use std::str::FromStr;
182        self.out =
183            Some(CheckoutAffirmPaymentMethodOptionsCaptureMethod::from_str(s).expect("infallible"));
184        Ok(())
185    }
186}
187
188stripe_types::impl_from_val_with_from_str!(CheckoutAffirmPaymentMethodOptionsCaptureMethod);
189#[cfg(feature = "deserialize")]
190impl<'de> serde::Deserialize<'de> for CheckoutAffirmPaymentMethodOptionsCaptureMethod {
191    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
192        use std::str::FromStr;
193        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
194        Ok(Self::from_str(&s).expect("infallible"))
195    }
196}
197/// Indicates that you intend to make future payments with this PaymentIntent's payment method.
198///
199/// If you provide a Customer with the PaymentIntent, you can use this parameter to [attach the payment method](/payments/save-during-payment) to the Customer after the PaymentIntent is confirmed and the customer completes any required actions.
200/// If you don't provide a Customer, you can still [attach](/api/payment_methods/attach) the payment method to a Customer after the transaction completes.
201///
202/// If the payment method is `card_present` and isn't a digital wallet, Stripe creates and attaches a [generated_card](/api/charges/object#charge_object-payment_method_details-card_present-generated_card) payment method representing the card to the Customer instead.
203///
204/// When processing card payments, Stripe uses `setup_future_usage` to help you comply with regional legislation and network rules, such as [SCA](/strong-customer-authentication).
205#[derive(Clone, Eq, PartialEq)]
206#[non_exhaustive]
207pub enum CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
208    None,
209    /// An unrecognized value from Stripe. Should not be used as a request parameter.
210    Unknown(String),
211}
212impl CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
213    pub fn as_str(&self) -> &str {
214        use CheckoutAffirmPaymentMethodOptionsSetupFutureUsage::*;
215        match self {
216            None => "none",
217            Unknown(v) => v,
218        }
219    }
220}
221
222impl std::str::FromStr for CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
223    type Err = std::convert::Infallible;
224    fn from_str(s: &str) -> Result<Self, Self::Err> {
225        use CheckoutAffirmPaymentMethodOptionsSetupFutureUsage::*;
226        match s {
227            "none" => Ok(None),
228            v => {
229                tracing::warn!(
230                    "Unknown value '{}' for enum '{}'",
231                    v,
232                    "CheckoutAffirmPaymentMethodOptionsSetupFutureUsage"
233                );
234                Ok(Unknown(v.to_owned()))
235            }
236        }
237    }
238}
239impl std::fmt::Display for CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
240    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
241        f.write_str(self.as_str())
242    }
243}
244
245impl std::fmt::Debug for CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
246    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
247        f.write_str(self.as_str())
248    }
249}
250#[cfg(feature = "serialize")]
251impl serde::Serialize for CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
252    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
253    where
254        S: serde::Serializer,
255    {
256        serializer.serialize_str(self.as_str())
257    }
258}
259impl miniserde::Deserialize for CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
260    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
261        crate::Place::new(out)
262    }
263}
264
265impl miniserde::de::Visitor for crate::Place<CheckoutAffirmPaymentMethodOptionsSetupFutureUsage> {
266    fn string(&mut self, s: &str) -> miniserde::Result<()> {
267        use std::str::FromStr;
268        self.out = Some(
269            CheckoutAffirmPaymentMethodOptionsSetupFutureUsage::from_str(s).expect("infallible"),
270        );
271        Ok(())
272    }
273}
274
275stripe_types::impl_from_val_with_from_str!(CheckoutAffirmPaymentMethodOptionsSetupFutureUsage);
276#[cfg(feature = "deserialize")]
277impl<'de> serde::Deserialize<'de> for CheckoutAffirmPaymentMethodOptionsSetupFutureUsage {
278    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
279        use std::str::FromStr;
280        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
281        Ok(Self::from_str(&s).expect("infallible"))
282    }
283}