[AC-1938] Update provider payment method (#4140)

* Refactored GET provider subscription

Refactoring this endpoint and its associated tests in preparation for the addition of more endpoints that share similar patterns

* Replaced StripePaymentService call in AccountsController, OrganizationsController

This was made in error during a previous PR. Since this is not related to Consolidated Billing, we want to try not to include it in these changes.

* Removing GetPaymentInformation call from ProviderBillingService

This method is a good call for the SubscriberService as we'll want to extend the functionality to all subscriber types

* Refactored GetTaxInformation to use Billing owned DTO

* Add UpdateTaxInformation to SubscriberService

* Added GetTaxInformation and UpdateTaxInformation endpoints to ProviderBillingController

* Added controller to manage creation of Stripe SetupIntents

With the deprecation of the Sources API, we need to move the bank account creation process to using SetupIntents. This controller brings both the creation of "card" and "us_bank_account" SetupIntents
under billing management.

* Added UpdatePaymentMethod method to SubscriberService

This method utilizes the SetupIntents created by the StripeController from the previous commit when a customer adds a card or us_bank_account payment method (Stripe). We need to cache the most recent SetupIntent for the subscriber so that we know which PaymentMethod is their most recent even when it hasn't been confirmed yet.

* Refactored GetPaymentMethod to use billing owned DTO and check setup intents

* Added GetPaymentMethod and UpdatePaymentMethod endpoints to ProviderBillingController

* Re-added GetPaymentInformation endpoint to consolidate API calls on the payment method page

* Added VerifyBankAccount endpoint to ProviderBillingController in order to finalize bank account payment methods

* Updated BitPayInvoiceRequestModel to support providers

* run dotnet format

* Conner's feedback

* Run dotnet format'

src/Api/Billing/Models/Requests/TaxInformationRequestBody.cs

@@ -0,0 +1,16 @@
+using System.ComponentModel.DataAnnotations;
+
+namespace Bit.Api.Billing.Models.Requests;
+
+public class TaxInformationRequestBody
+{
+    [Required]
+    public string Country { get; set; }
+    [Required]
+    public string PostalCode { get; set; }
+    public string TaxId { get; set; }
+    public string Line1 { get; set; }
+    public string Line2 { get; set; }
+    public string City { get; set; }
+    public string State { get; set; }
+}

src/Api/Billing/Models/Requests/TokenizedPaymentMethodRequestBody.cs

@@ -0,0 +1,18 @@
+using System.ComponentModel.DataAnnotations;
+using Bit.Api.Utilities;
+using Bit.Core.Enums;
+
+namespace Bit.Api.Billing.Models.Requests;
+
+public class TokenizedPaymentMethodRequestBody
+{
+    [Required]
+    [EnumMatches<PaymentMethodType>(
+        PaymentMethodType.BankAccount,
+        PaymentMethodType.Card,
+        PaymentMethodType.PayPal,
+        ErrorMessage = "'type' must be BankAccount, Card or PayPal")]
+    public PaymentMethodType Type { get; set; }
+    [Required]
+    public string Token { get; set; }
+}

src/Api/Billing/Models/Requests/VerifyBankAccountRequestBody.cs

@@ -0,0 +1,11 @@
+using System.ComponentModel.DataAnnotations;
+
+namespace Bit.Api.Billing.Models.Requests;
+
+public class VerifyBankAccountRequestBody
+{
+    [Range(0, 99)]
+    public long Amount1 { get; set; }
+    [Range(0, 99)]
+    public long Amount2 { get; set; }
+}

src/Api/Billing/Models/Responses/ConsolidatedBillingSubscriptionResponse.cs

@@ -1,29 +1,29 @@
 using Bit.Core.Billing.Models;
 using Bit.Core.Utilities;
-using Stripe;
 
 namespace Bit.Api.Billing.Models.Responses;
 
-public record ProviderSubscriptionResponse(
+public record ConsolidatedBillingSubscriptionResponse(
     string Status,
     DateTime CurrentPeriodEndDate,
     decimal? DiscountPercentage,
-    IEnumerable<ProviderPlanDTO> Plans)
+    IEnumerable<ProviderPlanResponse> Plans)
 {
     private const string _annualCadence = "Annual";
     private const string _monthlyCadence = "Monthly";
 
-    public static ProviderSubscriptionResponse From(
-        IEnumerable<ConfiguredProviderPlanDTO> providerPlans,
-        Subscription subscription)
+    public static ConsolidatedBillingSubscriptionResponse From(
+        ConsolidatedBillingSubscriptionDTO consolidatedBillingSubscription)
     {
+        var (providerPlans, subscription) = consolidatedBillingSubscription;
+
         var providerPlansDTO = providerPlans
             .Select(providerPlan =>
             {
                 var plan = StaticStore.GetPlan(providerPlan.PlanType);
                 var cost = (providerPlan.SeatMinimum + providerPlan.PurchasedSeats) * plan.PasswordManager.SeatPrice;
                 var cadence = plan.IsAnnual ? _annualCadence : _monthlyCadence;
-                return new ProviderPlanDTO(
+                return new ProviderPlanResponse(
                     plan.Name,
                     providerPlan.SeatMinimum,
                     providerPlan.PurchasedSeats,
@@ -32,7 +32,7 @@ public record ProviderSubscriptionResponse(
                     cadence);
             });
 
-        return new ProviderSubscriptionResponse(
+        return new ConsolidatedBillingSubscriptionResponse(
             subscription.Status,
             subscription.CurrentPeriodEnd,
             subscription.Customer?.Discount?.Coupon?.PercentOff,
@@ -40,7 +40,7 @@ public record ProviderSubscriptionResponse(
     }
 }
 
-public record ProviderPlanDTO(
+public record ProviderPlanResponse(
     string PlanName,
     int SeatMinimum,
     int PurchasedSeats,

src/Api/Billing/Models/Responses/MaskedPaymentMethodResponse.cs

@@ -0,0 +1,16 @@
+using Bit.Core.Billing.Models;
+using Bit.Core.Enums;
+
+namespace Bit.Api.Billing.Models.Responses;
+
+public record MaskedPaymentMethodResponse(
+    PaymentMethodType Type,
+    string Description,
+    bool NeedsVerification)
+{
+    public static MaskedPaymentMethodResponse From(MaskedPaymentMethodDTO maskedPaymentMethod)
+        => new(
+            maskedPaymentMethod.Type,
+            maskedPaymentMethod.Description,
+            maskedPaymentMethod.NeedsVerification);
+}

src/Api/Billing/Models/Responses/PaymentInformationResponse.cs

@@ -1,37 +1,15 @@
-using Bit.Core.Enums;
-using Bit.Core.Models.Business;
+using Bit.Core.Billing.Models;
 
 namespace Bit.Api.Billing.Models.Responses;
 
-public record PaymentInformationResponse(PaymentMethod PaymentMethod, TaxInformation TaxInformation)
+public record PaymentInformationResponse(
+    long AccountCredit,
+    MaskedPaymentMethodDTO PaymentMethod,
+    TaxInformationDTO TaxInformation)
 {
-    public static PaymentInformationResponse From(BillingInfo.BillingSource billingSource, TaxInfo taxInfo)
-    {
-        var paymentMethodDto = new PaymentMethod(
-            billingSource.Type, billingSource.Description, billingSource.CardBrand
-        );
-
-        var taxInformationDto = new TaxInformation(
-            taxInfo.BillingAddressCountry, taxInfo.BillingAddressPostalCode, taxInfo.TaxIdNumber,
-            taxInfo.BillingAddressLine1, taxInfo.BillingAddressLine2, taxInfo.BillingAddressCity,
-            taxInfo.BillingAddressState
-        );
-
-        return new PaymentInformationResponse(paymentMethodDto, taxInformationDto);
-    }
-
+    public static PaymentInformationResponse From(PaymentInformationDTO paymentInformation) =>
+        new(
+            paymentInformation.AccountCredit,
+            paymentInformation.PaymentMethod,
+            paymentInformation.TaxInformation);
 }
-
-public record PaymentMethod(
-    PaymentMethodType Type,
-    string Description,
-    string CardBrand);
-
-public record TaxInformation(
-    string Country,
-    string PostalCode,
-    string TaxId,
-    string Line1,
-    string Line2,
-    string City,
-    string State);

src/Api/Billing/Models/Responses/TaxInformationResponse.cs

@@ -0,0 +1,23 @@
+using Bit.Core.Billing.Models;
+
+namespace Bit.Api.Billing.Models.Responses;
+
+public record TaxInformationResponse(
+    string Country,
+    string PostalCode,
+    string TaxId,
+    string Line1,
+    string Line2,
+    string City,
+    string State)
+{
+    public static TaxInformationResponse From(TaxInformationDTO taxInformation)
+        => new(
+            taxInformation.Country,
+            taxInformation.PostalCode,
+            taxInformation.TaxId,
+            taxInformation.Line1,
+            taxInformation.Line2,
+            taxInformation.City,
+            taxInformation.State);
+}