stripe_shared/
card.rs

1/// You can store multiple cards on a customer in order to charge the customer
2/// later. You can also store multiple debit cards on a recipient in order to
3/// transfer to those cards later.
4///
5/// Related guide: [Card payments with Sources](https://stripe.com/docs/sources/cards)
6///
7/// For more details see <<https://stripe.com/docs/api/cards/object>>.
8#[derive(Clone, Debug)]
9#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
10pub struct Card {
11    pub account: Option<stripe_types::Expandable<stripe_shared::Account>>,
12    /// City/District/Suburb/Town/Village.
13    pub address_city: Option<String>,
14    /// Billing address country, if provided when creating card.
15    pub address_country: Option<String>,
16    /// Address line 1 (Street address/PO Box/Company name).
17    pub address_line1: Option<String>,
18    /// If `address_line1` was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`.
19    pub address_line1_check: Option<String>,
20    /// Address line 2 (Apartment/Suite/Unit/Building).
21    pub address_line2: Option<String>,
22    /// State/County/Province/Region.
23    pub address_state: Option<String>,
24    /// ZIP or postal code.
25    pub address_zip: Option<String>,
26    /// If `address_zip` was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`.
27    pub address_zip_check: Option<String>,
28    /// This field indicates whether this payment method can be shown again to its customer in a checkout flow.
29    /// Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow.
30    /// The field defaults to “unspecified”.
31    pub allow_redisplay: Option<CardAllowRedisplay>,
32    /// A set of available payout methods for this card.
33    /// Only values from this set should be passed as the `method` when creating a payout.
34    pub available_payout_methods: Option<Vec<CardAvailablePayoutMethods>>,
35    /// Card brand.
36    /// Can be `American Express`, `Cartes Bancaires`, `Diners Club`, `Discover`, `Eftpos Australia`, `Girocard`, `JCB`, `MasterCard`, `UnionPay`, `Visa`, or `Unknown`.
37    pub brand: String,
38    /// Two-letter ISO code representing the country of the card.
39    /// You could use this attribute to get a sense of the international breakdown of cards you've collected.
40    pub country: Option<String>,
41    /// Three-letter [ISO code for currency](https://www.iso.org/iso-4217-currency-codes.html) in lowercase.
42    /// Must be a [supported currency](https://docs.stripe.com/currencies).
43    /// Only applicable on accounts (not customers or recipients).
44    /// The card can be used as a transfer destination for funds in this currency.
45    /// This property is only available when returned as an [External Account](/api/external_account_cards/object) where [controller.is_controller](/api/accounts/object#account_object-controller-is_controller) is `true`.
46    pub currency: Option<stripe_types::Currency>,
47    /// The customer that this card belongs to.
48    /// This attribute will not be in the card object if the card belongs to an account or recipient instead.
49    pub customer: Option<stripe_types::Expandable<stripe_shared::Customer>>,
50    /// If a CVC was provided, results of the check: `pass`, `fail`, `unavailable`, or `unchecked`.
51    /// A result of unchecked indicates that CVC was provided but hasn't been checked yet.
52    /// Checks are typically performed when attaching a card to a Customer object, or when creating a charge.
53    /// For more details, see [Check if a card is valid without a charge](https://support.stripe.com/questions/check-if-a-card-is-valid-without-a-charge).
54    pub cvc_check: Option<String>,
55    /// Whether this card is the default external account for its currency.
56    /// This property is only available for accounts where [controller.requirement_collection](/api/accounts/object#account_object-controller-requirement_collection) is `application`, which includes Custom accounts.
57    pub default_for_currency: Option<bool>,
58    /// A high-level description of the type of cards issued in this range.
59    /// (For internal use only and not typically available in standard API requests.).
60    pub description: Option<String>,
61    /// (For tokenized numbers only.) The last four digits of the device account number.
62    pub dynamic_last4: Option<String>,
63    /// Two-digit number representing the card's expiration month.
64    pub exp_month: i64,
65    /// Four-digit number representing the card's expiration year.
66    pub exp_year: i64,
67    /// Uniquely identifies this particular card number.
68    /// You can use this attribute to check whether two customers who’ve signed up with you are using the same card number, for example.
69    /// For payment methods that tokenize card information (Apple Pay, Google Pay), the tokenized number might be provided instead of the underlying card number.
70    ///
71    /// *As of May 1, 2021, card fingerprint in India for Connect changed to allow two fingerprints for the same card---one for India and one for the rest of the world.*.
72    pub fingerprint: Option<String>,
73    /// Card funding type. Can be `credit`, `debit`, `prepaid`, or `unknown`.
74    pub funding: String,
75    /// Unique identifier for the object.
76    pub id: stripe_shared::CardId,
77    /// Issuer identification number of the card.
78    /// (For internal use only and not typically available in standard API requests.).
79    pub iin: Option<String>,
80    /// The name of the card's issuing bank.
81    /// (For internal use only and not typically available in standard API requests.).
82    pub issuer: Option<String>,
83    /// The last four digits of the card.
84    pub last4: String,
85    /// Set of [key-value pairs](https://stripe.com/docs/api/metadata) that you can attach to an object.
86    /// This can be useful for storing additional information about the object in a structured format.
87    pub metadata: Option<std::collections::HashMap<String, String>>,
88    /// Cardholder name.
89    pub name: Option<String>,
90    pub networks: Option<stripe_shared::TokenCardNetworks>,
91    /// Status of a card based on the card issuer.
92    pub regulated_status: Option<CardRegulatedStatus>,
93    /// For external accounts that are cards, possible values are `new` and `errored`.
94    /// If a payout fails, the status is set to `errored` and [scheduled payouts](https://stripe.com/docs/payouts#payout-schedule) are stopped until account details are updated.
95    pub status: Option<String>,
96    /// If the card number is tokenized, this is the method that was used.
97    /// Can be `android_pay` (includes Google Pay), `apple_pay`, `masterpass`, `visa_checkout`, or null.
98    pub tokenization_method: Option<String>,
99}
100#[doc(hidden)]
101pub struct CardBuilder {
102    account: Option<Option<stripe_types::Expandable<stripe_shared::Account>>>,
103    address_city: Option<Option<String>>,
104    address_country: Option<Option<String>>,
105    address_line1: Option<Option<String>>,
106    address_line1_check: Option<Option<String>>,
107    address_line2: Option<Option<String>>,
108    address_state: Option<Option<String>>,
109    address_zip: Option<Option<String>>,
110    address_zip_check: Option<Option<String>>,
111    allow_redisplay: Option<Option<CardAllowRedisplay>>,
112    available_payout_methods: Option<Option<Vec<CardAvailablePayoutMethods>>>,
113    brand: Option<String>,
114    country: Option<Option<String>>,
115    currency: Option<Option<stripe_types::Currency>>,
116    customer: Option<Option<stripe_types::Expandable<stripe_shared::Customer>>>,
117    cvc_check: Option<Option<String>>,
118    default_for_currency: Option<Option<bool>>,
119    description: Option<Option<String>>,
120    dynamic_last4: Option<Option<String>>,
121    exp_month: Option<i64>,
122    exp_year: Option<i64>,
123    fingerprint: Option<Option<String>>,
124    funding: Option<String>,
125    id: Option<stripe_shared::CardId>,
126    iin: Option<Option<String>>,
127    issuer: Option<Option<String>>,
128    last4: Option<String>,
129    metadata: Option<Option<std::collections::HashMap<String, String>>>,
130    name: Option<Option<String>>,
131    networks: Option<Option<stripe_shared::TokenCardNetworks>>,
132    regulated_status: Option<Option<CardRegulatedStatus>>,
133    status: Option<Option<String>>,
134    tokenization_method: Option<Option<String>>,
135}
136
137#[allow(
138    unused_variables,
139    irrefutable_let_patterns,
140    clippy::let_unit_value,
141    clippy::match_single_binding,
142    clippy::single_match
143)]
144const _: () = {
145    use miniserde::de::{Map, Visitor};
146    use miniserde::json::Value;
147    use miniserde::{Deserialize, Result, make_place};
148    use stripe_types::miniserde_helpers::FromValueOpt;
149    use stripe_types::{MapBuilder, ObjectDeser};
150
151    make_place!(Place);
152
153    impl Deserialize for Card {
154        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
155            Place::new(out)
156        }
157    }
158
159    struct Builder<'a> {
160        out: &'a mut Option<Card>,
161        builder: CardBuilder,
162    }
163
164    impl Visitor for Place<Card> {
165        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
166            Ok(Box::new(Builder { out: &mut self.out, builder: CardBuilder::deser_default() }))
167        }
168    }
169
170    impl MapBuilder for CardBuilder {
171        type Out = Card;
172        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
173            Ok(match k {
174                "account" => Deserialize::begin(&mut self.account),
175                "address_city" => Deserialize::begin(&mut self.address_city),
176                "address_country" => Deserialize::begin(&mut self.address_country),
177                "address_line1" => Deserialize::begin(&mut self.address_line1),
178                "address_line1_check" => Deserialize::begin(&mut self.address_line1_check),
179                "address_line2" => Deserialize::begin(&mut self.address_line2),
180                "address_state" => Deserialize::begin(&mut self.address_state),
181                "address_zip" => Deserialize::begin(&mut self.address_zip),
182                "address_zip_check" => Deserialize::begin(&mut self.address_zip_check),
183                "allow_redisplay" => Deserialize::begin(&mut self.allow_redisplay),
184                "available_payout_methods" => {
185                    Deserialize::begin(&mut self.available_payout_methods)
186                }
187                "brand" => Deserialize::begin(&mut self.brand),
188                "country" => Deserialize::begin(&mut self.country),
189                "currency" => Deserialize::begin(&mut self.currency),
190                "customer" => Deserialize::begin(&mut self.customer),
191                "cvc_check" => Deserialize::begin(&mut self.cvc_check),
192                "default_for_currency" => Deserialize::begin(&mut self.default_for_currency),
193                "description" => Deserialize::begin(&mut self.description),
194                "dynamic_last4" => Deserialize::begin(&mut self.dynamic_last4),
195                "exp_month" => Deserialize::begin(&mut self.exp_month),
196                "exp_year" => Deserialize::begin(&mut self.exp_year),
197                "fingerprint" => Deserialize::begin(&mut self.fingerprint),
198                "funding" => Deserialize::begin(&mut self.funding),
199                "id" => Deserialize::begin(&mut self.id),
200                "iin" => Deserialize::begin(&mut self.iin),
201                "issuer" => Deserialize::begin(&mut self.issuer),
202                "last4" => Deserialize::begin(&mut self.last4),
203                "metadata" => Deserialize::begin(&mut self.metadata),
204                "name" => Deserialize::begin(&mut self.name),
205                "networks" => Deserialize::begin(&mut self.networks),
206                "regulated_status" => Deserialize::begin(&mut self.regulated_status),
207                "status" => Deserialize::begin(&mut self.status),
208                "tokenization_method" => Deserialize::begin(&mut self.tokenization_method),
209                _ => <dyn Visitor>::ignore(),
210            })
211        }
212
213        fn deser_default() -> Self {
214            Self {
215                account: Deserialize::default(),
216                address_city: Deserialize::default(),
217                address_country: Deserialize::default(),
218                address_line1: Deserialize::default(),
219                address_line1_check: Deserialize::default(),
220                address_line2: Deserialize::default(),
221                address_state: Deserialize::default(),
222                address_zip: Deserialize::default(),
223                address_zip_check: Deserialize::default(),
224                allow_redisplay: Deserialize::default(),
225                available_payout_methods: Deserialize::default(),
226                brand: Deserialize::default(),
227                country: Deserialize::default(),
228                currency: Deserialize::default(),
229                customer: Deserialize::default(),
230                cvc_check: Deserialize::default(),
231                default_for_currency: Deserialize::default(),
232                description: Deserialize::default(),
233                dynamic_last4: Deserialize::default(),
234                exp_month: Deserialize::default(),
235                exp_year: Deserialize::default(),
236                fingerprint: Deserialize::default(),
237                funding: Deserialize::default(),
238                id: Deserialize::default(),
239                iin: Deserialize::default(),
240                issuer: Deserialize::default(),
241                last4: Deserialize::default(),
242                metadata: Deserialize::default(),
243                name: Deserialize::default(),
244                networks: Deserialize::default(),
245                regulated_status: Deserialize::default(),
246                status: Deserialize::default(),
247                tokenization_method: Deserialize::default(),
248            }
249        }
250
251        fn take_out(&mut self) -> Option<Self::Out> {
252            let (
253                Some(account),
254                Some(address_city),
255                Some(address_country),
256                Some(address_line1),
257                Some(address_line1_check),
258                Some(address_line2),
259                Some(address_state),
260                Some(address_zip),
261                Some(address_zip_check),
262                Some(allow_redisplay),
263                Some(available_payout_methods),
264                Some(brand),
265                Some(country),
266                Some(currency),
267                Some(customer),
268                Some(cvc_check),
269                Some(default_for_currency),
270                Some(description),
271                Some(dynamic_last4),
272                Some(exp_month),
273                Some(exp_year),
274                Some(fingerprint),
275                Some(funding),
276                Some(id),
277                Some(iin),
278                Some(issuer),
279                Some(last4),
280                Some(metadata),
281                Some(name),
282                Some(networks),
283                Some(regulated_status),
284                Some(status),
285                Some(tokenization_method),
286            ) = (
287                self.account.take(),
288                self.address_city.take(),
289                self.address_country.take(),
290                self.address_line1.take(),
291                self.address_line1_check.take(),
292                self.address_line2.take(),
293                self.address_state.take(),
294                self.address_zip.take(),
295                self.address_zip_check.take(),
296                self.allow_redisplay,
297                self.available_payout_methods.take(),
298                self.brand.take(),
299                self.country.take(),
300                self.currency.take(),
301                self.customer.take(),
302                self.cvc_check.take(),
303                self.default_for_currency,
304                self.description.take(),
305                self.dynamic_last4.take(),
306                self.exp_month,
307                self.exp_year,
308                self.fingerprint.take(),
309                self.funding.take(),
310                self.id.take(),
311                self.iin.take(),
312                self.issuer.take(),
313                self.last4.take(),
314                self.metadata.take(),
315                self.name.take(),
316                self.networks.take(),
317                self.regulated_status,
318                self.status.take(),
319                self.tokenization_method.take(),
320            )
321            else {
322                return None;
323            };
324            Some(Self::Out {
325                account,
326                address_city,
327                address_country,
328                address_line1,
329                address_line1_check,
330                address_line2,
331                address_state,
332                address_zip,
333                address_zip_check,
334                allow_redisplay,
335                available_payout_methods,
336                brand,
337                country,
338                currency,
339                customer,
340                cvc_check,
341                default_for_currency,
342                description,
343                dynamic_last4,
344                exp_month,
345                exp_year,
346                fingerprint,
347                funding,
348                id,
349                iin,
350                issuer,
351                last4,
352                metadata,
353                name,
354                networks,
355                regulated_status,
356                status,
357                tokenization_method,
358            })
359        }
360    }
361
362    impl Map for Builder<'_> {
363        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
364            self.builder.key(k)
365        }
366
367        fn finish(&mut self) -> Result<()> {
368            *self.out = self.builder.take_out();
369            Ok(())
370        }
371    }
372
373    impl ObjectDeser for Card {
374        type Builder = CardBuilder;
375    }
376
377    impl FromValueOpt for Card {
378        fn from_value(v: Value) -> Option<Self> {
379            let Value::Object(obj) = v else {
380                return None;
381            };
382            let mut b = CardBuilder::deser_default();
383            for (k, v) in obj {
384                match k.as_str() {
385                    "account" => b.account = FromValueOpt::from_value(v),
386                    "address_city" => b.address_city = FromValueOpt::from_value(v),
387                    "address_country" => b.address_country = FromValueOpt::from_value(v),
388                    "address_line1" => b.address_line1 = FromValueOpt::from_value(v),
389                    "address_line1_check" => b.address_line1_check = FromValueOpt::from_value(v),
390                    "address_line2" => b.address_line2 = FromValueOpt::from_value(v),
391                    "address_state" => b.address_state = FromValueOpt::from_value(v),
392                    "address_zip" => b.address_zip = FromValueOpt::from_value(v),
393                    "address_zip_check" => b.address_zip_check = FromValueOpt::from_value(v),
394                    "allow_redisplay" => b.allow_redisplay = FromValueOpt::from_value(v),
395                    "available_payout_methods" => {
396                        b.available_payout_methods = FromValueOpt::from_value(v)
397                    }
398                    "brand" => b.brand = FromValueOpt::from_value(v),
399                    "country" => b.country = FromValueOpt::from_value(v),
400                    "currency" => b.currency = FromValueOpt::from_value(v),
401                    "customer" => b.customer = FromValueOpt::from_value(v),
402                    "cvc_check" => b.cvc_check = FromValueOpt::from_value(v),
403                    "default_for_currency" => b.default_for_currency = FromValueOpt::from_value(v),
404                    "description" => b.description = FromValueOpt::from_value(v),
405                    "dynamic_last4" => b.dynamic_last4 = FromValueOpt::from_value(v),
406                    "exp_month" => b.exp_month = FromValueOpt::from_value(v),
407                    "exp_year" => b.exp_year = FromValueOpt::from_value(v),
408                    "fingerprint" => b.fingerprint = FromValueOpt::from_value(v),
409                    "funding" => b.funding = FromValueOpt::from_value(v),
410                    "id" => b.id = FromValueOpt::from_value(v),
411                    "iin" => b.iin = FromValueOpt::from_value(v),
412                    "issuer" => b.issuer = FromValueOpt::from_value(v),
413                    "last4" => b.last4 = FromValueOpt::from_value(v),
414                    "metadata" => b.metadata = FromValueOpt::from_value(v),
415                    "name" => b.name = FromValueOpt::from_value(v),
416                    "networks" => b.networks = FromValueOpt::from_value(v),
417                    "regulated_status" => b.regulated_status = FromValueOpt::from_value(v),
418                    "status" => b.status = FromValueOpt::from_value(v),
419                    "tokenization_method" => b.tokenization_method = FromValueOpt::from_value(v),
420                    _ => {}
421                }
422            }
423            b.take_out()
424        }
425    }
426};
427#[cfg(feature = "serialize")]
428impl serde::Serialize for Card {
429    fn serialize<S: serde::Serializer>(&self, s: S) -> Result<S::Ok, S::Error> {
430        use serde::ser::SerializeStruct;
431        let mut s = s.serialize_struct("Card", 34)?;
432        s.serialize_field("account", &self.account)?;
433        s.serialize_field("address_city", &self.address_city)?;
434        s.serialize_field("address_country", &self.address_country)?;
435        s.serialize_field("address_line1", &self.address_line1)?;
436        s.serialize_field("address_line1_check", &self.address_line1_check)?;
437        s.serialize_field("address_line2", &self.address_line2)?;
438        s.serialize_field("address_state", &self.address_state)?;
439        s.serialize_field("address_zip", &self.address_zip)?;
440        s.serialize_field("address_zip_check", &self.address_zip_check)?;
441        s.serialize_field("allow_redisplay", &self.allow_redisplay)?;
442        s.serialize_field("available_payout_methods", &self.available_payout_methods)?;
443        s.serialize_field("brand", &self.brand)?;
444        s.serialize_field("country", &self.country)?;
445        s.serialize_field("currency", &self.currency)?;
446        s.serialize_field("customer", &self.customer)?;
447        s.serialize_field("cvc_check", &self.cvc_check)?;
448        s.serialize_field("default_for_currency", &self.default_for_currency)?;
449        s.serialize_field("description", &self.description)?;
450        s.serialize_field("dynamic_last4", &self.dynamic_last4)?;
451        s.serialize_field("exp_month", &self.exp_month)?;
452        s.serialize_field("exp_year", &self.exp_year)?;
453        s.serialize_field("fingerprint", &self.fingerprint)?;
454        s.serialize_field("funding", &self.funding)?;
455        s.serialize_field("id", &self.id)?;
456        s.serialize_field("iin", &self.iin)?;
457        s.serialize_field("issuer", &self.issuer)?;
458        s.serialize_field("last4", &self.last4)?;
459        s.serialize_field("metadata", &self.metadata)?;
460        s.serialize_field("name", &self.name)?;
461        s.serialize_field("networks", &self.networks)?;
462        s.serialize_field("regulated_status", &self.regulated_status)?;
463        s.serialize_field("status", &self.status)?;
464        s.serialize_field("tokenization_method", &self.tokenization_method)?;
465
466        s.serialize_field("object", "card")?;
467        s.end()
468    }
469}
470/// This field indicates whether this payment method can be shown again to its customer in a checkout flow.
471/// Stripe products such as Checkout and Elements use this field to determine whether a payment method can be shown as a saved payment method in a checkout flow.
472/// The field defaults to “unspecified”.
473#[derive(Copy, Clone, Eq, PartialEq)]
474pub enum CardAllowRedisplay {
475    Always,
476    Limited,
477    Unspecified,
478}
479impl CardAllowRedisplay {
480    pub fn as_str(self) -> &'static str {
481        use CardAllowRedisplay::*;
482        match self {
483            Always => "always",
484            Limited => "limited",
485            Unspecified => "unspecified",
486        }
487    }
488}
489
490impl std::str::FromStr for CardAllowRedisplay {
491    type Err = stripe_types::StripeParseError;
492    fn from_str(s: &str) -> Result<Self, Self::Err> {
493        use CardAllowRedisplay::*;
494        match s {
495            "always" => Ok(Always),
496            "limited" => Ok(Limited),
497            "unspecified" => Ok(Unspecified),
498            _ => Err(stripe_types::StripeParseError),
499        }
500    }
501}
502impl std::fmt::Display for CardAllowRedisplay {
503    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
504        f.write_str(self.as_str())
505    }
506}
507
508impl std::fmt::Debug for CardAllowRedisplay {
509    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
510        f.write_str(self.as_str())
511    }
512}
513#[cfg(feature = "serialize")]
514impl serde::Serialize for CardAllowRedisplay {
515    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
516    where
517        S: serde::Serializer,
518    {
519        serializer.serialize_str(self.as_str())
520    }
521}
522impl miniserde::Deserialize for CardAllowRedisplay {
523    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
524        crate::Place::new(out)
525    }
526}
527
528impl miniserde::de::Visitor for crate::Place<CardAllowRedisplay> {
529    fn string(&mut self, s: &str) -> miniserde::Result<()> {
530        use std::str::FromStr;
531        self.out = Some(CardAllowRedisplay::from_str(s).map_err(|_| miniserde::Error)?);
532        Ok(())
533    }
534}
535
536stripe_types::impl_from_val_with_from_str!(CardAllowRedisplay);
537#[cfg(feature = "deserialize")]
538impl<'de> serde::Deserialize<'de> for CardAllowRedisplay {
539    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
540        use std::str::FromStr;
541        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
542        Self::from_str(&s)
543            .map_err(|_| serde::de::Error::custom("Unknown value for CardAllowRedisplay"))
544    }
545}
546/// A set of available payout methods for this card.
547/// Only values from this set should be passed as the `method` when creating a payout.
548#[derive(Copy, Clone, Eq, PartialEq)]
549pub enum CardAvailablePayoutMethods {
550    Instant,
551    Standard,
552}
553impl CardAvailablePayoutMethods {
554    pub fn as_str(self) -> &'static str {
555        use CardAvailablePayoutMethods::*;
556        match self {
557            Instant => "instant",
558            Standard => "standard",
559        }
560    }
561}
562
563impl std::str::FromStr for CardAvailablePayoutMethods {
564    type Err = stripe_types::StripeParseError;
565    fn from_str(s: &str) -> Result<Self, Self::Err> {
566        use CardAvailablePayoutMethods::*;
567        match s {
568            "instant" => Ok(Instant),
569            "standard" => Ok(Standard),
570            _ => Err(stripe_types::StripeParseError),
571        }
572    }
573}
574impl std::fmt::Display for CardAvailablePayoutMethods {
575    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
576        f.write_str(self.as_str())
577    }
578}
579
580impl std::fmt::Debug for CardAvailablePayoutMethods {
581    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
582        f.write_str(self.as_str())
583    }
584}
585#[cfg(feature = "serialize")]
586impl serde::Serialize for CardAvailablePayoutMethods {
587    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
588    where
589        S: serde::Serializer,
590    {
591        serializer.serialize_str(self.as_str())
592    }
593}
594impl miniserde::Deserialize for CardAvailablePayoutMethods {
595    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
596        crate::Place::new(out)
597    }
598}
599
600impl miniserde::de::Visitor for crate::Place<CardAvailablePayoutMethods> {
601    fn string(&mut self, s: &str) -> miniserde::Result<()> {
602        use std::str::FromStr;
603        self.out = Some(CardAvailablePayoutMethods::from_str(s).map_err(|_| miniserde::Error)?);
604        Ok(())
605    }
606}
607
608stripe_types::impl_from_val_with_from_str!(CardAvailablePayoutMethods);
609#[cfg(feature = "deserialize")]
610impl<'de> serde::Deserialize<'de> for CardAvailablePayoutMethods {
611    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
612        use std::str::FromStr;
613        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
614        Self::from_str(&s)
615            .map_err(|_| serde::de::Error::custom("Unknown value for CardAvailablePayoutMethods"))
616    }
617}
618/// Status of a card based on the card issuer.
619#[derive(Copy, Clone, Eq, PartialEq)]
620pub enum CardRegulatedStatus {
621    Regulated,
622    Unregulated,
623}
624impl CardRegulatedStatus {
625    pub fn as_str(self) -> &'static str {
626        use CardRegulatedStatus::*;
627        match self {
628            Regulated => "regulated",
629            Unregulated => "unregulated",
630        }
631    }
632}
633
634impl std::str::FromStr for CardRegulatedStatus {
635    type Err = stripe_types::StripeParseError;
636    fn from_str(s: &str) -> Result<Self, Self::Err> {
637        use CardRegulatedStatus::*;
638        match s {
639            "regulated" => Ok(Regulated),
640            "unregulated" => Ok(Unregulated),
641            _ => Err(stripe_types::StripeParseError),
642        }
643    }
644}
645impl std::fmt::Display for CardRegulatedStatus {
646    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
647        f.write_str(self.as_str())
648    }
649}
650
651impl std::fmt::Debug for CardRegulatedStatus {
652    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
653        f.write_str(self.as_str())
654    }
655}
656#[cfg(feature = "serialize")]
657impl serde::Serialize for CardRegulatedStatus {
658    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
659    where
660        S: serde::Serializer,
661    {
662        serializer.serialize_str(self.as_str())
663    }
664}
665impl miniserde::Deserialize for CardRegulatedStatus {
666    fn begin(out: &mut Option<Self>) -> &mut dyn miniserde::de::Visitor {
667        crate::Place::new(out)
668    }
669}
670
671impl miniserde::de::Visitor for crate::Place<CardRegulatedStatus> {
672    fn string(&mut self, s: &str) -> miniserde::Result<()> {
673        use std::str::FromStr;
674        self.out = Some(CardRegulatedStatus::from_str(s).map_err(|_| miniserde::Error)?);
675        Ok(())
676    }
677}
678
679stripe_types::impl_from_val_with_from_str!(CardRegulatedStatus);
680#[cfg(feature = "deserialize")]
681impl<'de> serde::Deserialize<'de> for CardRegulatedStatus {
682    fn deserialize<D: serde::Deserializer<'de>>(deserializer: D) -> Result<Self, D::Error> {
683        use std::str::FromStr;
684        let s: std::borrow::Cow<'de, str> = serde::Deserialize::deserialize(deserializer)?;
685        Self::from_str(&s)
686            .map_err(|_| serde::de::Error::custom("Unknown value for CardRegulatedStatus"))
687    }
688}
689impl stripe_types::Object for Card {
690    type Id = stripe_shared::CardId;
691    fn id(&self) -> &Self::Id {
692        &self.id
693    }
694
695    fn into_id(self) -> Self::Id {
696        self.id
697    }
698}
699stripe_types::def_id!(CardId);
stripe_shared/card.rs

stripe_shared/
card.rs
