stripe_billing.rs

  1use std::sync::Arc;
  2
  3use anyhow::{Context as _, anyhow};
  4use chrono::Utc;
  5use collections::HashMap;
  6use stripe::SubscriptionStatus;
  7use tokio::sync::RwLock;
  8use uuid::Uuid;
  9
 10use crate::Result;
 11use crate::db::billing_subscription::SubscriptionKind;
 12use crate::llm::AGENT_EXTENDED_TRIAL_FEATURE_FLAG;
 13use crate::stripe_client::{
 14    RealStripeClient, StripeCheckoutSessionMode, StripeCheckoutSessionPaymentMethodCollection,
 15    StripeClient, StripeCreateCheckoutSessionLineItems, StripeCreateCheckoutSessionParams,
 16    StripeCreateCheckoutSessionSubscriptionData, StripeCreateMeterEventParams,
 17    StripeCreateMeterEventPayload, StripeCustomerId, StripeMeter, StripePrice, StripePriceId,
 18    StripeSubscription, StripeSubscriptionId, StripeSubscriptionTrialSettings,
 19    StripeSubscriptionTrialSettingsEndBehavior,
 20    StripeSubscriptionTrialSettingsEndBehaviorMissingPaymentMethod, UpdateSubscriptionItems,
 21    UpdateSubscriptionParams,
 22};
 23
 24pub struct StripeBilling {
 25    state: RwLock<StripeBillingState>,
 26    real_client: Arc<stripe::Client>,
 27    client: Arc<dyn StripeClient>,
 28}
 29
 30#[derive(Default)]
 31struct StripeBillingState {
 32    meters_by_event_name: HashMap<String, StripeMeter>,
 33    price_ids_by_meter_id: HashMap<String, StripePriceId>,
 34    prices_by_lookup_key: HashMap<String, StripePrice>,
 35}
 36
 37impl StripeBilling {
 38    pub fn new(client: Arc<stripe::Client>) -> Self {
 39        Self {
 40            client: Arc::new(RealStripeClient::new(client.clone())),
 41            real_client: client,
 42            state: RwLock::default(),
 43        }
 44    }
 45
 46    #[cfg(test)]
 47    pub fn test(client: Arc<crate::stripe_client::FakeStripeClient>) -> Self {
 48        Self {
 49            // This is just temporary until we can remove all usages of the real Stripe client.
 50            real_client: Arc::new(stripe::Client::new("sk_test")),
 51            client,
 52            state: RwLock::default(),
 53        }
 54    }
 55
 56    pub async fn initialize(&self) -> Result<()> {
 57        log::info!("StripeBilling: initializing");
 58
 59        let mut state = self.state.write().await;
 60
 61        let (meters, prices) =
 62            futures::try_join!(self.client.list_meters(), self.client.list_prices())?;
 63
 64        for meter in meters {
 65            state
 66                .meters_by_event_name
 67                .insert(meter.event_name.clone(), meter);
 68        }
 69
 70        for price in prices {
 71            if let Some(lookup_key) = price.lookup_key.clone() {
 72                state.prices_by_lookup_key.insert(lookup_key, price.clone());
 73            }
 74
 75            if let Some(recurring) = price.recurring {
 76                if let Some(meter) = recurring.meter {
 77                    state.price_ids_by_meter_id.insert(meter, price.id);
 78                }
 79            }
 80        }
 81
 82        log::info!("StripeBilling: initialized");
 83
 84        Ok(())
 85    }
 86
 87    pub async fn zed_pro_price_id(&self) -> Result<StripePriceId> {
 88        self.find_price_id_by_lookup_key("zed-pro").await
 89    }
 90
 91    pub async fn zed_free_price_id(&self) -> Result<StripePriceId> {
 92        self.find_price_id_by_lookup_key("zed-free").await
 93    }
 94
 95    pub async fn find_price_id_by_lookup_key(&self, lookup_key: &str) -> Result<StripePriceId> {
 96        self.state
 97            .read()
 98            .await
 99            .prices_by_lookup_key
100            .get(lookup_key)
101            .map(|price| price.id.clone())
102            .ok_or_else(|| crate::Error::Internal(anyhow!("no price ID found for {lookup_key:?}")))
103    }
104
105    pub async fn find_price_by_lookup_key(&self, lookup_key: &str) -> Result<StripePrice> {
106        self.state
107            .read()
108            .await
109            .prices_by_lookup_key
110            .get(lookup_key)
111            .cloned()
112            .ok_or_else(|| crate::Error::Internal(anyhow!("no price found for {lookup_key:?}")))
113    }
114
115    pub async fn determine_subscription_kind(
116        &self,
117        subscription: &stripe::Subscription,
118    ) -> Option<SubscriptionKind> {
119        let zed_pro_price_id: stripe::PriceId =
120            self.zed_pro_price_id().await.ok()?.try_into().ok()?;
121        let zed_free_price_id: stripe::PriceId =
122            self.zed_free_price_id().await.ok()?.try_into().ok()?;
123
124        subscription.items.data.iter().find_map(|item| {
125            let price = item.price.as_ref()?;
126
127            if price.id == zed_pro_price_id {
128                Some(if subscription.status == SubscriptionStatus::Trialing {
129                    SubscriptionKind::ZedProTrial
130                } else {
131                    SubscriptionKind::ZedPro
132                })
133            } else if price.id == zed_free_price_id {
134                Some(SubscriptionKind::ZedFree)
135            } else {
136                None
137            }
138        })
139    }
140
141    /// Returns the Stripe customer associated with the provided email address, or creates a new customer, if one does
142    /// not already exist.
143    ///
144    /// Always returns a new Stripe customer if the email address is `None`.
145    pub async fn find_or_create_customer_by_email(
146        &self,
147        email_address: Option<&str>,
148    ) -> Result<StripeCustomerId> {
149        let existing_customer = if let Some(email) = email_address {
150            let customers = self.client.list_customers_by_email(email).await?;
151
152            customers.first().cloned()
153        } else {
154            None
155        };
156
157        let customer_id = if let Some(existing_customer) = existing_customer {
158            existing_customer.id
159        } else {
160            let customer = self
161                .client
162                .create_customer(crate::stripe_client::CreateCustomerParams {
163                    email: email_address,
164                })
165                .await?;
166
167            customer.id
168        };
169
170        Ok(customer_id)
171    }
172
173    pub async fn subscribe_to_price(
174        &self,
175        subscription_id: &StripeSubscriptionId,
176        price: &StripePrice,
177    ) -> Result<()> {
178        let subscription = self.client.get_subscription(subscription_id).await?;
179
180        if subscription_contains_price(&subscription, &price.id) {
181            return Ok(());
182        }
183
184        const BILLING_THRESHOLD_IN_CENTS: i64 = 20 * 100;
185
186        let price_per_unit = price.unit_amount.unwrap_or_default();
187        let _units_for_billing_threshold = BILLING_THRESHOLD_IN_CENTS / price_per_unit;
188
189        self.client
190            .update_subscription(
191                subscription_id,
192                UpdateSubscriptionParams {
193                    items: Some(vec![UpdateSubscriptionItems {
194                        price: Some(price.id.clone()),
195                    }]),
196                    trial_settings: Some(StripeSubscriptionTrialSettings {
197                        end_behavior: StripeSubscriptionTrialSettingsEndBehavior {
198                            missing_payment_method: StripeSubscriptionTrialSettingsEndBehaviorMissingPaymentMethod::Cancel
199                        },
200                    }),
201                },
202            )
203            .await?;
204
205        Ok(())
206    }
207
208    pub async fn bill_model_request_usage(
209        &self,
210        customer_id: &StripeCustomerId,
211        event_name: &str,
212        requests: i32,
213    ) -> Result<()> {
214        let timestamp = Utc::now().timestamp();
215        let idempotency_key = Uuid::new_v4();
216
217        self.client
218            .create_meter_event(StripeCreateMeterEventParams {
219                identifier: &format!("model_requests/{}", idempotency_key),
220                event_name,
221                payload: StripeCreateMeterEventPayload {
222                    value: requests as u64,
223                    stripe_customer_id: customer_id,
224                },
225                timestamp: Some(timestamp),
226            })
227            .await?;
228
229        Ok(())
230    }
231
232    pub async fn checkout_with_zed_pro(
233        &self,
234        customer_id: &StripeCustomerId,
235        github_login: &str,
236        success_url: &str,
237    ) -> Result<String> {
238        let zed_pro_price_id = self.zed_pro_price_id().await?;
239
240        let mut params = StripeCreateCheckoutSessionParams::default();
241        params.mode = Some(StripeCheckoutSessionMode::Subscription);
242        params.customer = Some(customer_id);
243        params.client_reference_id = Some(github_login);
244        params.line_items = Some(vec![StripeCreateCheckoutSessionLineItems {
245            price: Some(zed_pro_price_id.to_string()),
246            quantity: Some(1),
247        }]);
248        params.success_url = Some(success_url);
249
250        let session = self.client.create_checkout_session(params).await?;
251        Ok(session.url.context("no checkout session URL")?)
252    }
253
254    pub async fn checkout_with_zed_pro_trial(
255        &self,
256        customer_id: &StripeCustomerId,
257        github_login: &str,
258        feature_flags: Vec<String>,
259        success_url: &str,
260    ) -> Result<String> {
261        let zed_pro_price_id = self.zed_pro_price_id().await?;
262
263        let eligible_for_extended_trial = feature_flags
264            .iter()
265            .any(|flag| flag == AGENT_EXTENDED_TRIAL_FEATURE_FLAG);
266
267        let trial_period_days = if eligible_for_extended_trial { 60 } else { 14 };
268
269        let mut subscription_metadata = std::collections::HashMap::new();
270        if eligible_for_extended_trial {
271            subscription_metadata.insert(
272                "promo_feature_flag".to_string(),
273                AGENT_EXTENDED_TRIAL_FEATURE_FLAG.to_string(),
274            );
275        }
276
277        let mut params = StripeCreateCheckoutSessionParams::default();
278        params.subscription_data = Some(StripeCreateCheckoutSessionSubscriptionData {
279            trial_period_days: Some(trial_period_days),
280            trial_settings: Some(StripeSubscriptionTrialSettings {
281                end_behavior: StripeSubscriptionTrialSettingsEndBehavior {
282                    missing_payment_method:
283                        StripeSubscriptionTrialSettingsEndBehaviorMissingPaymentMethod::Cancel,
284                },
285            }),
286            metadata: if !subscription_metadata.is_empty() {
287                Some(subscription_metadata)
288            } else {
289                None
290            },
291        });
292        params.mode = Some(StripeCheckoutSessionMode::Subscription);
293        params.payment_method_collection =
294            Some(StripeCheckoutSessionPaymentMethodCollection::IfRequired);
295        params.customer = Some(customer_id);
296        params.client_reference_id = Some(github_login);
297        params.line_items = Some(vec![StripeCreateCheckoutSessionLineItems {
298            price: Some(zed_pro_price_id.to_string()),
299            quantity: Some(1),
300        }]);
301        params.success_url = Some(success_url);
302
303        let session = self.client.create_checkout_session(params).await?;
304        Ok(session.url.context("no checkout session URL")?)
305    }
306
307    pub async fn subscribe_to_zed_free(
308        &self,
309        customer_id: stripe::CustomerId,
310    ) -> Result<stripe::Subscription> {
311        let zed_free_price_id = self.zed_free_price_id().await?;
312
313        let existing_subscriptions = stripe::Subscription::list(
314            &self.real_client,
315            &stripe::ListSubscriptions {
316                customer: Some(customer_id.clone()),
317                status: None,
318                ..Default::default()
319            },
320        )
321        .await?;
322
323        let existing_active_subscription =
324            existing_subscriptions
325                .data
326                .into_iter()
327                .find(|subscription| {
328                    subscription.status == SubscriptionStatus::Active
329                        || subscription.status == SubscriptionStatus::Trialing
330                });
331        if let Some(subscription) = existing_active_subscription {
332            return Ok(subscription);
333        }
334
335        let mut params = stripe::CreateSubscription::new(customer_id);
336        params.items = Some(vec![stripe::CreateSubscriptionItems {
337            price: Some(zed_free_price_id.to_string()),
338            quantity: Some(1),
339            ..Default::default()
340        }]);
341
342        let subscription = stripe::Subscription::create(&self.real_client, params).await?;
343
344        Ok(subscription)
345    }
346}
347
348fn subscription_contains_price(
349    subscription: &StripeSubscription,
350    price_id: &StripePriceId,
351) -> bool {
352    subscription.items.iter().any(|item| {
353        item.price
354            .as_ref()
355            .map_or(false, |price| price.id == *price_id)
356    })
357}