Skip to main content

stripe_shared/
payment_links_resource_payment_intent_data.rs

1#[derive(Clone)]
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 PaymentLinksResourcePaymentIntentData {
6    /// Indicates when the funds will be captured from the customer's account.
7    pub capture_method: Option<PaymentLinksResourcePaymentIntentDataCaptureMethod>,
8    /// An arbitrary string attached to the object. Often useful for displaying to users.
9    pub description: Option<String>,
10    /// Set of [key-value pairs](https://docs.stripe.com/api/metadata) that will set metadata on [Payment Intents](https://docs.stripe.com/api/payment_intents) generated from this payment link.
11    pub metadata: std::collections::HashMap<String, String>,
12    /// Indicates that you intend to make future payments with the payment method collected during checkout.
13    pub setup_future_usage: Option<PaymentLinksResourcePaymentIntentDataSetupFutureUsage>,
14    /// For a non-card payment, information about the charge that appears on the customer's statement when this payment succeeds in creating a charge.
15    pub statement_descriptor: Option<String>,
16    /// For a card payment, information about the charge that appears on the customer's statement when this payment succeeds in creating a charge.
17    /// Concatenated with the account's statement descriptor prefix to form the complete statement descriptor.
18    pub statement_descriptor_suffix: Option<String>,
19    /// A string that identifies the resulting payment as part of a group.
20    /// See the PaymentIntents [use case for connected accounts](https://docs.stripe.com/connect/separate-charges-and-transfers) for details.
21    pub transfer_group: Option<String>,
22}
23#[cfg(feature = "redact-generated-debug")]
24impl std::fmt::Debug for PaymentLinksResourcePaymentIntentData {
25    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
26        f.debug_struct("PaymentLinksResourcePaymentIntentData").finish_non_exhaustive()
27    }
28}
29#[doc(hidden)]
30pub struct PaymentLinksResourcePaymentIntentDataBuilder {
31    capture_method: Option<Option<PaymentLinksResourcePaymentIntentDataCaptureMethod>>,
32    description: Option<Option<String>>,
33    metadata: Option<std::collections::HashMap<String, String>>,
34    setup_future_usage: Option<Option<PaymentLinksResourcePaymentIntentDataSetupFutureUsage>>,
35    statement_descriptor: Option<Option<String>>,
36    statement_descriptor_suffix: Option<Option<String>>,
37    transfer_group: Option<Option<String>>,
38}
39
40#[allow(
41    unused_variables,
42    irrefutable_let_patterns,
43    clippy::let_unit_value,
44    clippy::match_single_binding,
45    clippy::single_match
46)]
47const _: () = {
48    use miniserde::de::{Map, Visitor};
49    use miniserde::json::Value;
50    use miniserde::{Deserialize, Result, make_place};
51    use stripe_types::miniserde_helpers::FromValueOpt;
52    use stripe_types::{MapBuilder, ObjectDeser};
53
54    make_place!(Place);
55
56    impl Deserialize for PaymentLinksResourcePaymentIntentData {
57        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
58            Place::new(out)
59        }
60    }
61
62    struct Builder<'a> {
63        out: &'a mut Option<PaymentLinksResourcePaymentIntentData>,
64        builder: PaymentLinksResourcePaymentIntentDataBuilder,
65    }
66
67    impl Visitor for Place<PaymentLinksResourcePaymentIntentData> {
68        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
69            Ok(Box::new(Builder {
70                out: &mut self.out,
71                builder: PaymentLinksResourcePaymentIntentDataBuilder::deser_default(),
72            }))
73        }
74    }
75
76    impl MapBuilder for PaymentLinksResourcePaymentIntentDataBuilder {
77        type Out = PaymentLinksResourcePaymentIntentData;
78        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
79            Ok(match k {
80                "capture_method" => Deserialize::begin(&mut self.capture_method),
81                "description" => Deserialize::begin(&mut self.description),
82                "metadata" => Deserialize::begin(&mut self.metadata),
83                "setup_future_usage" => Deserialize::begin(&mut self.setup_future_usage),
84                "statement_descriptor" => Deserialize::begin(&mut self.statement_descriptor),
85                "statement_descriptor_suffix" => {
86                    Deserialize::begin(&mut self.statement_descriptor_suffix)
87                }
88                "transfer_group" => Deserialize::begin(&mut self.transfer_group),
89                _ => <dyn Visitor>::ignore(),
90            })
91        }
92
93        fn deser_default() -> Self {
94            Self {
95                capture_method: Some(None),
96                description: Some(None),
97                metadata: None,
98                setup_future_usage: Some(None),
99                statement_descriptor: Some(None),
100                statement_descriptor_suffix: Some(None),
101                transfer_group: Some(None),
102            }
103        }
104
105        fn take_out(&mut self) -> Option<Self::Out> {
106            let (
107                Some(capture_method),
108                Some(description),
109                Some(metadata),
110                Some(setup_future_usage),
111                Some(statement_descriptor),
112                Some(statement_descriptor_suffix),
113                Some(transfer_group),
114            ) = (
115                self.capture_method.take(),
116                self.description.take(),
117                self.metadata.take(),
118                self.setup_future_usage.take(),
119                self.statement_descriptor.take(),
120                self.statement_descriptor_suffix.take(),
121                self.transfer_group.take(),
122            )
123            else {
124                return None;
125            };
126            Some(Self::Out {
127                capture_method,
128                description,
129                metadata,
130                setup_future_usage,
131                statement_descriptor,
132                statement_descriptor_suffix,
133                transfer_group,
134            })
135        }
136    }
137
138    impl Map for Builder<'_> {
139        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
140            self.builder.key(k)
141        }
142
143        fn finish(&mut self) -> Result<()> {
144            *self.out = self.builder.take_out();
145            Ok(())
146        }
147    }
148
149    impl ObjectDeser for PaymentLinksResourcePaymentIntentData {
150        type Builder = PaymentLinksResourcePaymentIntentDataBuilder;
151    }
152
153    impl FromValueOpt for PaymentLinksResourcePaymentIntentData {
154        fn from_value(v: Value) -> Option<Self> {
155            let Value::Object(obj) = v else {
156                return None;
157            };
158            let mut b = PaymentLinksResourcePaymentIntentDataBuilder::deser_default();
159            for (k, v) in obj {
160                match k.as_str() {
161                    "capture_method" => b.capture_method = FromValueOpt::from_value(v),
162                    "description" => b.description = FromValueOpt::from_value(v),
163                    "metadata" => b.metadata = FromValueOpt::from_value(v),
164                    "setup_future_usage" => b.setup_future_usage = FromValueOpt::from_value(v),
165                    "statement_descriptor" => b.statement_descriptor = FromValueOpt::from_value(v),
166                    "statement_descriptor_suffix" => {
167                        b.statement_descriptor_suffix = FromValueOpt::from_value(v)
168                    }
169                    "transfer_group" => b.transfer_group = FromValueOpt::from_value(v),
170                    _ => {}
171                }
172            }
173            b.take_out()
174        }
175    }
176};
177/// Indicates when the funds will be captured from the customer's account.
178#[derive(Clone, Eq, PartialEq)]
179#[non_exhaustive]
180pub enum PaymentLinksResourcePaymentIntentDataCaptureMethod {
181    Automatic,
182    AutomaticAsync,
183    Manual,
184    /// An unrecognized value from Stripe. Should not be used as a request parameter.
185    Unknown(String),
186}
187impl PaymentLinksResourcePaymentIntentDataCaptureMethod {
188    pub fn as_str(&self) -> &str {
189        use PaymentLinksResourcePaymentIntentDataCaptureMethod::*;
190        match self {
191            Automatic => "automatic",
192            AutomaticAsync => "automatic_async",
193            Manual => "manual",
194            Unknown(v) => v,
195        }
196    }
197}
198
199impl std::str::FromStr for PaymentLinksResourcePaymentIntentDataCaptureMethod {
200    type Err = std::convert::Infallible;
201    fn from_str(s: &str) -> Result<Self, Self::Err> {
202        use PaymentLinksResourcePaymentIntentDataCaptureMethod::*;
203        match s {
204            "automatic" => Ok(Automatic),
205            "automatic_async" => Ok(AutomaticAsync),
206            "manual" => Ok(Manual),
207            v => {
208                tracing::warn!(
209                    "Unknown value '{}' for enum '{}'",
210                    v,
211                    "PaymentLinksResourcePaymentIntentDataCaptureMethod"
212                );
213                Ok(Unknown(v.to_owned()))
214            }
215        }
216    }
217}
218impl std::fmt::Display for PaymentLinksResourcePaymentIntentDataCaptureMethod {
219    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
220        f.write_str(self.as_str())
221    }
222}
223
224#[cfg(not(feature = "redact-generated-debug"))]
225impl std::fmt::Debug for PaymentLinksResourcePaymentIntentDataCaptureMethod {
226    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
227        f.write_str(self.as_str())
228    }
229}
230#[cfg(feature = "redact-generated-debug")]
231impl std::fmt::Debug for PaymentLinksResourcePaymentIntentDataCaptureMethod {
232    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
233        f.debug_struct(stringify!(PaymentLinksResourcePaymentIntentDataCaptureMethod))
234            .finish_non_exhaustive()
235    }
236}
237#[cfg(feature = "serialize")]
238impl serde::Serialize for PaymentLinksResourcePaymentIntentDataCaptureMethod {
239    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
240    where
241        S: serde::Serializer,
242    {
243        serializer.serialize_str(self.as_str())
244    }
245}
246impl miniserde::Deserialize for PaymentLinksResourcePaymentIntentDataCaptureMethod {
247    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
248        crate::Place::new(out)
249    }
250}
251
252impl miniserde::de::Visitor for crate::Place<PaymentLinksResourcePaymentIntentDataCaptureMethod> {
253    fn string(&mut self, s: &str) -> miniserde::Result<()> {
254        use std::str::FromStr;
255        self.out = Some(
256            PaymentLinksResourcePaymentIntentDataCaptureMethod::from_str(s).expect("infallible"),
257        );
258        Ok(())
259    }
260}
261
262stripe_types::impl_from_val_with_from_str!(PaymentLinksResourcePaymentIntentDataCaptureMethod);
263#[cfg(feature = "deserialize")]
264impl<'de> serde::Deserialize<'de> for PaymentLinksResourcePaymentIntentDataCaptureMethod {
265    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
266        use std::str::FromStr;
267        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
268        Ok(Self::from_str(&s).expect("infallible"))
269    }
270}
271/// Indicates that you intend to make future payments with the payment method collected during checkout.
272#[derive(Clone, Eq, PartialEq)]
273#[non_exhaustive]
274pub enum PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
275    OffSession,
276    OnSession,
277    /// An unrecognized value from Stripe. Should not be used as a request parameter.
278    Unknown(String),
279}
280impl PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
281    pub fn as_str(&self) -> &str {
282        use PaymentLinksResourcePaymentIntentDataSetupFutureUsage::*;
283        match self {
284            OffSession => "off_session",
285            OnSession => "on_session",
286            Unknown(v) => v,
287        }
288    }
289}
290
291impl std::str::FromStr for PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
292    type Err = std::convert::Infallible;
293    fn from_str(s: &str) -> Result<Self, Self::Err> {
294        use PaymentLinksResourcePaymentIntentDataSetupFutureUsage::*;
295        match s {
296            "off_session" => Ok(OffSession),
297            "on_session" => Ok(OnSession),
298            v => {
299                tracing::warn!(
300                    "Unknown value '{}' for enum '{}'",
301                    v,
302                    "PaymentLinksResourcePaymentIntentDataSetupFutureUsage"
303                );
304                Ok(Unknown(v.to_owned()))
305            }
306        }
307    }
308}
309impl std::fmt::Display for PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
310    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
311        f.write_str(self.as_str())
312    }
313}
314
315#[cfg(not(feature = "redact-generated-debug"))]
316impl std::fmt::Debug for PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
317    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
318        f.write_str(self.as_str())
319    }
320}
321#[cfg(feature = "redact-generated-debug")]
322impl std::fmt::Debug for PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
323    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
324        f.debug_struct(stringify!(PaymentLinksResourcePaymentIntentDataSetupFutureUsage))
325            .finish_non_exhaustive()
326    }
327}
328#[cfg(feature = "serialize")]
329impl serde::Serialize for PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
330    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
331    where
332        S: serde::Serializer,
333    {
334        serializer.serialize_str(self.as_str())
335    }
336}
337impl miniserde::Deserialize for PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
338    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
339        crate::Place::new(out)
340    }
341}
342
343impl miniserde::de::Visitor
344    for crate::Place<PaymentLinksResourcePaymentIntentDataSetupFutureUsage>
345{
346    fn string(&mut self, s: &str) -> miniserde::Result<()> {
347        use std::str::FromStr;
348        self.out = Some(
349            PaymentLinksResourcePaymentIntentDataSetupFutureUsage::from_str(s).expect("infallible"),
350        );
351        Ok(())
352    }
353}
354
355stripe_types::impl_from_val_with_from_str!(PaymentLinksResourcePaymentIntentDataSetupFutureUsage);
356#[cfg(feature = "deserialize")]
357impl<'de> serde::Deserialize<'de> for PaymentLinksResourcePaymentIntentDataSetupFutureUsage {
358    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
359        use std::str::FromStr;
360        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
361        Ok(Self::from_str(&s).expect("infallible"))
362    }
363}