ory_client/models/subscription.rs
1/*
2 * Ory APIs
3 *
4 * # Introduction Documentation for all public and administrative Ory APIs. Administrative APIs can only be accessed with a valid Personal Access Token. Public APIs are mostly used in browsers. ## SDKs This document describes the APIs available in the Ory Network. The APIs are available as SDKs for the following languages: | Language | Download SDK | Documentation | | -------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------------ | | Dart | [pub.dev](https://pub.dev/packages/ory_client) | [README](https://github.com/ory/sdk/blob/master/clients/client/dart/README.md) | | .NET | [nuget.org](https://www.nuget.org/packages/Ory.Client/) | [README](https://github.com/ory/sdk/blob/master/clients/client/dotnet/README.md) | | Elixir | [hex.pm](https://hex.pm/packages/ory_client) | [README](https://github.com/ory/sdk/blob/master/clients/client/elixir/README.md) | | Go | [github.com](https://github.com/ory/client-go) | [README](https://github.com/ory/sdk/blob/master/clients/client/go/README.md) | | Java | [maven.org](https://search.maven.org/artifact/sh.ory/ory-client) | [README](https://github.com/ory/sdk/blob/master/clients/client/java/README.md) | | JavaScript | [npmjs.com](https://www.npmjs.com/package/@ory/client) | [README](https://github.com/ory/sdk/blob/master/clients/client/typescript/README.md) | | JavaScript (With fetch) | [npmjs.com](https://www.npmjs.com/package/@ory/client-fetch) | [README](https://github.com/ory/sdk/blob/master/clients/client/typescript-fetch/README.md) | | PHP | [packagist.org](https://packagist.org/packages/ory/client) | [README](https://github.com/ory/sdk/blob/master/clients/client/php/README.md) | | Python | [pypi.org](https://pypi.org/project/ory-client/) | [README](https://github.com/ory/sdk/blob/master/clients/client/python/README.md) | | Ruby | [rubygems.org](https://rubygems.org/gems/ory-client) | [README](https://github.com/ory/sdk/blob/master/clients/client/ruby/README.md) | | Rust | [crates.io](https://crates.io/crates/ory-client) | [README](https://github.com/ory/sdk/blob/master/clients/client/rust/README.md) |
5 *
6 * The version of the OpenAPI document: v1.22.4
7 * Contact: support@ory.sh
8 * Generated by: https://openapi-generator.tech
9 */
10
11use crate::models;
12use serde::{Deserialize, Serialize};
13
14#[derive(Clone, Default, Debug, PartialEq, Serialize, Deserialize)]
15pub struct Subscription {
16 #[serde(rename = "created_at")]
17 pub created_at: String,
18 /// The currency of the subscription. To change this, a new subscription must be created. usd USD eur Euro
19 #[serde(rename = "currency")]
20 pub currency: CurrencyEnum,
21 /// The currently active interval of the subscription monthly Monthly yearly Yearly
22 #[serde(rename = "current_interval")]
23 pub current_interval: CurrentIntervalEnum,
24 /// The currently active plan of the subscription
25 #[serde(rename = "current_plan")]
26 pub current_plan: String,
27 #[serde(rename = "current_plan_details", skip_serializing_if = "Option::is_none")]
28 pub current_plan_details: Option<Box<models::PlanDetails>>,
29 /// The ID of the stripe customer
30 #[serde(rename = "customer_id")]
31 pub customer_id: String,
32 /// The ID of the subscription
33 #[serde(rename = "id")]
34 pub id: String,
35 #[serde(rename = "interval_changes_to", deserialize_with = "Option::deserialize")]
36 pub interval_changes_to: Option<String>,
37 #[serde(rename = "ongoing_stripe_checkout_id", default, with = "::serde_with::rust::double_option", skip_serializing_if = "Option::is_none")]
38 pub ongoing_stripe_checkout_id: Option<Option<String>>,
39 /// Until when the subscription is payed
40 #[serde(rename = "payed_until")]
41 pub payed_until: String,
42 #[serde(rename = "plan_changes_at", skip_serializing_if = "Option::is_none")]
43 pub plan_changes_at: Option<String>,
44 #[serde(rename = "plan_changes_to", deserialize_with = "Option::deserialize")]
45 pub plan_changes_to: Option<String>,
46 /// For `collection_method=charge_automatically` a subscription moves into `incomplete` if the initial payment attempt fails. A subscription in this status can only have metadata and default_source updated. Once the first invoice is paid, the subscription moves into an `active` status. If the first invoice is not paid within 23 hours, the subscription transitions to `incomplete_expired`. This is a terminal status, the open invoice will be voided and no further invoices will be generated. A subscription that is currently in a trial period is `trialing` and moves to `active` when the trial period is over. A subscription can only enter a `paused` status [when a trial ends without a payment method](https://stripe.com/billing/subscriptions/trials#create-free-trials-without-payment). A `paused` subscription doesn't generate invoices and can be resumed after your customer adds their payment method. The `paused` status is different from [pausing collection](https://stripe.com/billing/subscriptions/pause-payment), which still generates invoices and leaves the subscription's status unchanged. If subscription `collection_method=charge_automatically`, it becomes `past_due` when payment is required but cannot be paid (due to failed payment or awaiting additional user actions). Once Stripe has exhausted all payment retry attempts, the subscription will become `canceled` or `unpaid` (depending on your subscriptions settings). If subscription `collection_method=send_invoice` it becomes `past_due` when its invoice is not paid by the due date, and `canceled` or `unpaid` if it is still not paid by an additional deadline after that. Note that when a subscription has a status of `unpaid`, no subsequent invoices will be attempted (invoices will be created, but then immediately automatically closed). After receiving updated payment information from a customer, you may choose to reopen and pay their closed invoices.
47 #[serde(rename = "status")]
48 pub status: String,
49 #[serde(rename = "stripe_checkout_expires_at", skip_serializing_if = "Option::is_none")]
50 pub stripe_checkout_expires_at: Option<String>,
51 #[serde(rename = "updated_at")]
52 pub updated_at: String,
53}
54
55impl Subscription {
56 pub fn new(created_at: String, currency: CurrencyEnum, current_interval: CurrentIntervalEnum, current_plan: String, customer_id: String, id: String, interval_changes_to: Option<String>, payed_until: String, plan_changes_to: Option<String>, status: String, updated_at: String) -> Subscription {
57 Subscription {
58 created_at,
59 currency,
60 current_interval,
61 current_plan,
62 current_plan_details: None,
63 customer_id,
64 id,
65 interval_changes_to,
66 ongoing_stripe_checkout_id: None,
67 payed_until,
68 plan_changes_at: None,
69 plan_changes_to,
70 status,
71 stripe_checkout_expires_at: None,
72 updated_at,
73 }
74 }
75}
76/// The currency of the subscription. To change this, a new subscription must be created. usd USD eur Euro
77#[derive(Clone, Copy, Debug, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize)]
78pub enum CurrencyEnum {
79 #[serde(rename = "usd")]
80 Usd,
81 #[serde(rename = "eur")]
82 Eur,
83}
84
85impl Default for CurrencyEnum {
86 fn default() -> CurrencyEnum {
87 Self::Usd
88 }
89}
90/// The currently active interval of the subscription monthly Monthly yearly Yearly
91#[derive(Clone, Copy, Debug, Eq, PartialEq, Ord, PartialOrd, Hash, Serialize, Deserialize)]
92pub enum CurrentIntervalEnum {
93 #[serde(rename = "monthly")]
94 Monthly,
95 #[serde(rename = "yearly")]
96 Yearly,
97}
98
99impl Default for CurrentIntervalEnum {
100 fn default() -> CurrentIntervalEnum {
101 Self::Monthly
102 }
103}
104