stripe_shared/
dispute_evidence.rs

1/// For more details see <<https://stripe.com/docs/api/disputes/evidence_object>>.
2#[derive(Clone, Debug)]
3#[cfg_attr(feature = "serialize", derive(serde::Serialize))]
4#[cfg_attr(feature = "deserialize", derive(serde::Deserialize))]
5pub struct DisputeEvidence {
6    /// Any server or activity logs showing proof that the customer accessed or downloaded the purchased digital product.
7    /// This information should include IP addresses, corresponding timestamps, and any detailed recorded activity.
8    pub access_activity_log: Option<String>,
9    /// The billing address provided by the customer.
10    pub billing_address: Option<String>,
11    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Your subscription cancellation policy, as shown to the customer.
12    pub cancellation_policy: Option<stripe_types::Expandable<stripe_shared::File>>,
13    /// An explanation of how and when the customer was shown your refund policy prior to purchase.
14    pub cancellation_policy_disclosure: Option<String>,
15    /// A justification for why the customer's subscription was not canceled.
16    pub cancellation_rebuttal: Option<String>,
17    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any communication with the customer that you feel is relevant to your case.
18    /// Examples include emails proving that the customer received the product or service, or demonstrating their use of or satisfaction with the product or service.
19    pub customer_communication: Option<stripe_types::Expandable<stripe_shared::File>>,
20    /// The email address of the customer.
21    pub customer_email_address: Option<String>,
22    /// The name of the customer.
23    pub customer_name: Option<String>,
24    /// The IP address that the customer used when making the purchase.
25    pub customer_purchase_ip: Option<String>,
26    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) A relevant document or contract showing the customer's signature.
27    pub customer_signature: Option<stripe_types::Expandable<stripe_shared::File>>,
28    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Documentation for the prior charge that can uniquely identify the charge, such as a receipt, shipping label, work order, etc.
29    /// This document should be paired with a similar document from the disputed payment that proves the two payments are separate.
30    pub duplicate_charge_documentation: Option<stripe_types::Expandable<stripe_shared::File>>,
31    /// An explanation of the difference between the disputed charge versus the prior charge that appears to be a duplicate.
32    pub duplicate_charge_explanation: Option<String>,
33    /// The Stripe ID for the prior charge which appears to be a duplicate of the disputed charge.
34    pub duplicate_charge_id: Option<String>,
35    pub enhanced_evidence: stripe_shared::DisputeEnhancedEvidence,
36    /// A description of the product or service that was sold.
37    pub product_description: Option<String>,
38    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any receipt or message sent to the customer notifying them of the charge.
39    pub receipt: Option<stripe_types::Expandable<stripe_shared::File>>,
40    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Your refund policy, as shown to the customer.
41    pub refund_policy: Option<stripe_types::Expandable<stripe_shared::File>>,
42    /// Documentation demonstrating that the customer was shown your refund policy prior to purchase.
43    pub refund_policy_disclosure: Option<String>,
44    /// A justification for why the customer is not entitled to a refund.
45    pub refund_refusal_explanation: Option<String>,
46    /// The date on which the customer received or began receiving the purchased service, in a clear human-readable format.
47    pub service_date: Option<String>,
48    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Documentation showing proof that a service was provided to the customer.
49    /// This could include a copy of a signed contract, work order, or other form of written agreement.
50    pub service_documentation: Option<stripe_types::Expandable<stripe_shared::File>>,
51    /// The address to which a physical product was shipped.
52    /// You should try to include as complete address information as possible.
53    pub shipping_address: Option<String>,
54    /// The delivery service that shipped a physical product, such as Fedex, UPS, USPS, etc.
55    /// If multiple carriers were used for this purchase, please separate them with commas.
56    pub shipping_carrier: Option<String>,
57    /// The date on which a physical product began its route to the shipping address, in a clear human-readable format.
58    pub shipping_date: Option<String>,
59    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Documentation showing proof that a product was shipped to the customer at the same address the customer provided to you.
60    /// This could include a copy of the shipment receipt, shipping label, etc.
61    /// It should show the customer's full shipping address, if possible.
62    pub shipping_documentation: Option<stripe_types::Expandable<stripe_shared::File>>,
63    /// The tracking number for a physical product, obtained from the delivery service.
64    /// If multiple tracking numbers were generated for this purchase, please separate them with commas.
65    pub shipping_tracking_number: Option<String>,
66    /// (ID of a [file upload](https://stripe.com/docs/guides/file-upload)) Any additional evidence or statements.
67    pub uncategorized_file: Option<stripe_types::Expandable<stripe_shared::File>>,
68    /// Any additional evidence or statements.
69    pub uncategorized_text: Option<String>,
70}
71#[doc(hidden)]
72pub struct DisputeEvidenceBuilder {
73    access_activity_log: Option<Option<String>>,
74    billing_address: Option<Option<String>>,
75    cancellation_policy: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
76    cancellation_policy_disclosure: Option<Option<String>>,
77    cancellation_rebuttal: Option<Option<String>>,
78    customer_communication: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
79    customer_email_address: Option<Option<String>>,
80    customer_name: Option<Option<String>>,
81    customer_purchase_ip: Option<Option<String>>,
82    customer_signature: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
83    duplicate_charge_documentation: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
84    duplicate_charge_explanation: Option<Option<String>>,
85    duplicate_charge_id: Option<Option<String>>,
86    enhanced_evidence: Option<stripe_shared::DisputeEnhancedEvidence>,
87    product_description: Option<Option<String>>,
88    receipt: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
89    refund_policy: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
90    refund_policy_disclosure: Option<Option<String>>,
91    refund_refusal_explanation: Option<Option<String>>,
92    service_date: Option<Option<String>>,
93    service_documentation: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
94    shipping_address: Option<Option<String>>,
95    shipping_carrier: Option<Option<String>>,
96    shipping_date: Option<Option<String>>,
97    shipping_documentation: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
98    shipping_tracking_number: Option<Option<String>>,
99    uncategorized_file: Option<Option<stripe_types::Expandable<stripe_shared::File>>>,
100    uncategorized_text: Option<Option<String>>,
101}
102
103#[allow(
104    unused_variables,
105    irrefutable_let_patterns,
106    clippy::let_unit_value,
107    clippy::match_single_binding,
108    clippy::single_match
109)]
110const _: () = {
111    use miniserde::de::{Map, Visitor};
112    use miniserde::json::Value;
113    use miniserde::{Deserialize, Result, make_place};
114    use stripe_types::miniserde_helpers::FromValueOpt;
115    use stripe_types::{MapBuilder, ObjectDeser};
116
117    make_place!(Place);
118
119    impl Deserialize for DisputeEvidence {
120        fn begin(out: &mut Option<Self>) -> &mut dyn Visitor {
121            Place::new(out)
122        }
123    }
124
125    struct Builder<'a> {
126        out: &'a mut Option<DisputeEvidence>,
127        builder: DisputeEvidenceBuilder,
128    }
129
130    impl Visitor for Place<DisputeEvidence> {
131        fn map(&mut self) -> Result<Box<dyn Map + '_>> {
132            Ok(Box::new(Builder {
133                out: &mut self.out,
134                builder: DisputeEvidenceBuilder::deser_default(),
135            }))
136        }
137    }
138
139    impl MapBuilder for DisputeEvidenceBuilder {
140        type Out = DisputeEvidence;
141        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
142            Ok(match k {
143                "access_activity_log" => Deserialize::begin(&mut self.access_activity_log),
144                "billing_address" => Deserialize::begin(&mut self.billing_address),
145                "cancellation_policy" => Deserialize::begin(&mut self.cancellation_policy),
146                "cancellation_policy_disclosure" => {
147                    Deserialize::begin(&mut self.cancellation_policy_disclosure)
148                }
149                "cancellation_rebuttal" => Deserialize::begin(&mut self.cancellation_rebuttal),
150                "customer_communication" => Deserialize::begin(&mut self.customer_communication),
151                "customer_email_address" => Deserialize::begin(&mut self.customer_email_address),
152                "customer_name" => Deserialize::begin(&mut self.customer_name),
153                "customer_purchase_ip" => Deserialize::begin(&mut self.customer_purchase_ip),
154                "customer_signature" => Deserialize::begin(&mut self.customer_signature),
155                "duplicate_charge_documentation" => {
156                    Deserialize::begin(&mut self.duplicate_charge_documentation)
157                }
158                "duplicate_charge_explanation" => {
159                    Deserialize::begin(&mut self.duplicate_charge_explanation)
160                }
161                "duplicate_charge_id" => Deserialize::begin(&mut self.duplicate_charge_id),
162                "enhanced_evidence" => Deserialize::begin(&mut self.enhanced_evidence),
163                "product_description" => Deserialize::begin(&mut self.product_description),
164                "receipt" => Deserialize::begin(&mut self.receipt),
165                "refund_policy" => Deserialize::begin(&mut self.refund_policy),
166                "refund_policy_disclosure" => {
167                    Deserialize::begin(&mut self.refund_policy_disclosure)
168                }
169                "refund_refusal_explanation" => {
170                    Deserialize::begin(&mut self.refund_refusal_explanation)
171                }
172                "service_date" => Deserialize::begin(&mut self.service_date),
173                "service_documentation" => Deserialize::begin(&mut self.service_documentation),
174                "shipping_address" => Deserialize::begin(&mut self.shipping_address),
175                "shipping_carrier" => Deserialize::begin(&mut self.shipping_carrier),
176                "shipping_date" => Deserialize::begin(&mut self.shipping_date),
177                "shipping_documentation" => Deserialize::begin(&mut self.shipping_documentation),
178                "shipping_tracking_number" => {
179                    Deserialize::begin(&mut self.shipping_tracking_number)
180                }
181                "uncategorized_file" => Deserialize::begin(&mut self.uncategorized_file),
182                "uncategorized_text" => Deserialize::begin(&mut self.uncategorized_text),
183                _ => <dyn Visitor>::ignore(),
184            })
185        }
186
187        fn deser_default() -> Self {
188            Self {
189                access_activity_log: Deserialize::default(),
190                billing_address: Deserialize::default(),
191                cancellation_policy: Deserialize::default(),
192                cancellation_policy_disclosure: Deserialize::default(),
193                cancellation_rebuttal: Deserialize::default(),
194                customer_communication: Deserialize::default(),
195                customer_email_address: Deserialize::default(),
196                customer_name: Deserialize::default(),
197                customer_purchase_ip: Deserialize::default(),
198                customer_signature: Deserialize::default(),
199                duplicate_charge_documentation: Deserialize::default(),
200                duplicate_charge_explanation: Deserialize::default(),
201                duplicate_charge_id: Deserialize::default(),
202                enhanced_evidence: Deserialize::default(),
203                product_description: Deserialize::default(),
204                receipt: Deserialize::default(),
205                refund_policy: Deserialize::default(),
206                refund_policy_disclosure: Deserialize::default(),
207                refund_refusal_explanation: Deserialize::default(),
208                service_date: Deserialize::default(),
209                service_documentation: Deserialize::default(),
210                shipping_address: Deserialize::default(),
211                shipping_carrier: Deserialize::default(),
212                shipping_date: Deserialize::default(),
213                shipping_documentation: Deserialize::default(),
214                shipping_tracking_number: Deserialize::default(),
215                uncategorized_file: Deserialize::default(),
216                uncategorized_text: Deserialize::default(),
217            }
218        }
219
220        fn take_out(&mut self) -> Option<Self::Out> {
221            let (
222                Some(access_activity_log),
223                Some(billing_address),
224                Some(cancellation_policy),
225                Some(cancellation_policy_disclosure),
226                Some(cancellation_rebuttal),
227                Some(customer_communication),
228                Some(customer_email_address),
229                Some(customer_name),
230                Some(customer_purchase_ip),
231                Some(customer_signature),
232                Some(duplicate_charge_documentation),
233                Some(duplicate_charge_explanation),
234                Some(duplicate_charge_id),
235                Some(enhanced_evidence),
236                Some(product_description),
237                Some(receipt),
238                Some(refund_policy),
239                Some(refund_policy_disclosure),
240                Some(refund_refusal_explanation),
241                Some(service_date),
242                Some(service_documentation),
243                Some(shipping_address),
244                Some(shipping_carrier),
245                Some(shipping_date),
246                Some(shipping_documentation),
247                Some(shipping_tracking_number),
248                Some(uncategorized_file),
249                Some(uncategorized_text),
250            ) = (
251                self.access_activity_log.take(),
252                self.billing_address.take(),
253                self.cancellation_policy.take(),
254                self.cancellation_policy_disclosure.take(),
255                self.cancellation_rebuttal.take(),
256                self.customer_communication.take(),
257                self.customer_email_address.take(),
258                self.customer_name.take(),
259                self.customer_purchase_ip.take(),
260                self.customer_signature.take(),
261                self.duplicate_charge_documentation.take(),
262                self.duplicate_charge_explanation.take(),
263                self.duplicate_charge_id.take(),
264                self.enhanced_evidence.take(),
265                self.product_description.take(),
266                self.receipt.take(),
267                self.refund_policy.take(),
268                self.refund_policy_disclosure.take(),
269                self.refund_refusal_explanation.take(),
270                self.service_date.take(),
271                self.service_documentation.take(),
272                self.shipping_address.take(),
273                self.shipping_carrier.take(),
274                self.shipping_date.take(),
275                self.shipping_documentation.take(),
276                self.shipping_tracking_number.take(),
277                self.uncategorized_file.take(),
278                self.uncategorized_text.take(),
279            )
280            else {
281                return None;
282            };
283            Some(Self::Out {
284                access_activity_log,
285                billing_address,
286                cancellation_policy,
287                cancellation_policy_disclosure,
288                cancellation_rebuttal,
289                customer_communication,
290                customer_email_address,
291                customer_name,
292                customer_purchase_ip,
293                customer_signature,
294                duplicate_charge_documentation,
295                duplicate_charge_explanation,
296                duplicate_charge_id,
297                enhanced_evidence,
298                product_description,
299                receipt,
300                refund_policy,
301                refund_policy_disclosure,
302                refund_refusal_explanation,
303                service_date,
304                service_documentation,
305                shipping_address,
306                shipping_carrier,
307                shipping_date,
308                shipping_documentation,
309                shipping_tracking_number,
310                uncategorized_file,
311                uncategorized_text,
312            })
313        }
314    }
315
316    impl Map for Builder<'_> {
317        fn key(&mut self, k: &str) -> Result<&mut dyn Visitor> {
318            self.builder.key(k)
319        }
320
321        fn finish(&mut self) -> Result<()> {
322            *self.out = self.builder.take_out();
323            Ok(())
324        }
325    }
326
327    impl ObjectDeser for DisputeEvidence {
328        type Builder = DisputeEvidenceBuilder;
329    }
330
331    impl FromValueOpt for DisputeEvidence {
332        fn from_value(v: Value) -> Option<Self> {
333            let Value::Object(obj) = v else {
334                return None;
335            };
336            let mut b = DisputeEvidenceBuilder::deser_default();
337            for (k, v) in obj {
338                match k.as_str() {
339                    "access_activity_log" => b.access_activity_log = FromValueOpt::from_value(v),
340                    "billing_address" => b.billing_address = FromValueOpt::from_value(v),
341                    "cancellation_policy" => b.cancellation_policy = FromValueOpt::from_value(v),
342                    "cancellation_policy_disclosure" => {
343                        b.cancellation_policy_disclosure = FromValueOpt::from_value(v)
344                    }
345                    "cancellation_rebuttal" => {
346                        b.cancellation_rebuttal = FromValueOpt::from_value(v)
347                    }
348                    "customer_communication" => {
349                        b.customer_communication = FromValueOpt::from_value(v)
350                    }
351                    "customer_email_address" => {
352                        b.customer_email_address = FromValueOpt::from_value(v)
353                    }
354                    "customer_name" => b.customer_name = FromValueOpt::from_value(v),
355                    "customer_purchase_ip" => b.customer_purchase_ip = FromValueOpt::from_value(v),
356                    "customer_signature" => b.customer_signature = FromValueOpt::from_value(v),
357                    "duplicate_charge_documentation" => {
358                        b.duplicate_charge_documentation = FromValueOpt::from_value(v)
359                    }
360                    "duplicate_charge_explanation" => {
361                        b.duplicate_charge_explanation = FromValueOpt::from_value(v)
362                    }
363                    "duplicate_charge_id" => b.duplicate_charge_id = FromValueOpt::from_value(v),
364                    "enhanced_evidence" => b.enhanced_evidence = FromValueOpt::from_value(v),
365                    "product_description" => b.product_description = FromValueOpt::from_value(v),
366                    "receipt" => b.receipt = FromValueOpt::from_value(v),
367                    "refund_policy" => b.refund_policy = FromValueOpt::from_value(v),
368                    "refund_policy_disclosure" => {
369                        b.refund_policy_disclosure = FromValueOpt::from_value(v)
370                    }
371                    "refund_refusal_explanation" => {
372                        b.refund_refusal_explanation = FromValueOpt::from_value(v)
373                    }
374                    "service_date" => b.service_date = FromValueOpt::from_value(v),
375                    "service_documentation" => {
376                        b.service_documentation = FromValueOpt::from_value(v)
377                    }
378                    "shipping_address" => b.shipping_address = FromValueOpt::from_value(v),
379                    "shipping_carrier" => b.shipping_carrier = FromValueOpt::from_value(v),
380                    "shipping_date" => b.shipping_date = FromValueOpt::from_value(v),
381                    "shipping_documentation" => {
382                        b.shipping_documentation = FromValueOpt::from_value(v)
383                    }
384                    "shipping_tracking_number" => {
385                        b.shipping_tracking_number = FromValueOpt::from_value(v)
386                    }
387                    "uncategorized_file" => b.uncategorized_file = FromValueOpt::from_value(v),
388                    "uncategorized_text" => b.uncategorized_text = FromValueOpt::from_value(v),
389                    _ => {}
390                }
391            }
392            b.take_out()
393        }
394    }
395};
stripe_shared/dispute_evidence.rs

stripe_shared/
dispute_evidence.rs
