feat: new billing functions for referral customer

Author: Justintime50

CHANGELOG.md

@@ -4,6 +4,11 @@
 
 - Minimum .NET Framework is now v4.7.2
 - Adds custom webhook headers when creating/updating a webhook
+- Adds the following functions to assist ReferralCustomer in adding credit cards and bank accounts:
+  - `Beta.ReferralCustomer.CreateCreditCardClientSecret`
+  - `Beta.ReferralCustomer.CreateBankAccountClientSecret`
+  - `ReferralCustomer.AddCreditCardFromStripe`
+  - `ReferralCustomer.AddBankAccountFromStripe`
 - Adds `MerchantId` as Shipment option (closes #592)
 - Remove previously-marked obsolete parameter, functions and classes:
   - `EasyPost.Models.API.DeliveryDateForZipPairEstimate.EasyPostTimeInTransitData` property (use `EasyPost.Models.API.DeliveryDateForZipPairEstimate.TimeInTransitDetails` instead)

EasyPost.Tests/Fixture.cs

@@ -107,8 +107,6 @@ internal static Dictionary<string, object> BasicPickup
 
         internal static string ReportDate => "2022-04-12";
 
-        internal static string ReportIdPrefix => "shprep_";
-
         internal static string ReportType => GetFixtureStructure().ReportTypes.Shipment;
 
         internal static Dictionary<string, object> RmaFormOptions => GetFixtureStructure().FormOptions.Rma;
@@ -130,6 +128,8 @@ internal static string UspsCarrierAccountId
 
         internal static string UspsService => GetFixtureStructure().ServiceNames.Usps.FirstService;
 
+        internal static Billing Billing => GetFixtureStructure().Billing;
+
         private static FixtureStructure GetFixtureStructure()
         {
             string fixtureData = ReadFixtureData();

EasyPost.Tests/FixtureData.cs

@@ -13,6 +13,9 @@ public class FixtureStructure
         [JsonProperty("addresses")]
         public Addresses Addresses { get; set; }
 
+        [JsonProperty("billing")]
+        public Billing Billing { get; set; }
+
         [JsonProperty("carrier_accounts")]
         public CarrierAccounts CarrierAccounts { get; set; }
 
@@ -86,6 +89,25 @@ public class Addresses
         #endregion
     }
 
+    public class Billing
+    {
+        #region JSON Properties
+
+        [JsonProperty("payment_method_id")]
+        public string PaymentMethodId { get; set; }
+
+        [JsonProperty("financial_connections_id")]
+        public string FinancialConnectionsId { get; set; }
+
+        [JsonProperty("mandate_data")]
+        public Dictionary<string, object> MandateData { get; set; }
+
+        [JsonProperty("priority")]
+        public string Priority { get; set; }
+
+        #endregion
+    }
+
     public class CarrierAccounts
     {
         #region JSON Properties

EasyPost.Tests/ServicesTests/Beta/ReferralServiceTest.cs

@@ -79,6 +79,30 @@ public async Task TestRefundByPaymentLog()
             }
         }
 
+        [Fact]
+        [CrudOperations.Create]
+        [Testing.Function]
+        public async Task TestCreateCreditCardClientSecret()
+        {
+            UseVCR("create_credit_card_client_secret");
+
+            StripeClientSecret response = await Client.Beta.ReferralCustomer.CreateCreditCardClientSecret();
+
+            Assert.StartsWith("seti_", response.ClientSecret);
+        }
+
+        [Fact]
+        [CrudOperations.Create]
+        [Testing.Function]
+        public async Task TestCreateBankAccountClientSecret()
+        {
+            UseVCR("create_bank_account_client_secret");
+
+            StripeClientSecret response = await Client.Beta.ReferralCustomer.CreateBankAccountClientSecret();
+
+            Assert.StartsWith("fcsess_client_secret_", response.ClientSecret);
+        }
+
         #endregion
 
         #endregion

EasyPost.Tests/ServicesTests/ReferralCustomerServiceTest.cs

@@ -310,6 +310,46 @@ public async Task TestUpdateReferralEmail()
             Assert.Null(possibleException);
         }
 
+        [Fact]
+        [Testing.Exception]
+        public async Task TestAddCreditCardFromStripe()
+        {
+            UseVCR("add_credit_card_from_stripe");
+
+            NotFoundError exception = await Assert.ThrowsAsync<NotFoundError>(async () =>
+            {
+                await Client.ReferralCustomer.AddCreditCardFromStripe(
+                    ReferralCustomerKey,
+                    Fixtures.Billing.PaymentMethodId,
+                    PaymentMethod.Priority.Primary
+                );
+            });
+
+            Assert.Equal("Stripe::PaymentMethod does not exist for the specified reference_id", exception.Message);
+        }
+
+        [Fact]
+        [Testing.Exception]
+        public async Task TestAddBankAccountFromStripe()
+        {
+            UseVCR("add_bank_account_from_stripe");
+
+            InvalidRequestError exception = await Assert.ThrowsAsync<InvalidRequestError>(async () =>
+            {
+                await Client.ReferralCustomer.AddBankAccountFromStripe(
+                    ReferralCustomerKey,
+                    Fixtures.Billing.FinancialConnectionsId,
+                    Fixtures.Billing.MandateData,
+                    PaymentMethod.Priority.Primary
+                );
+            });
+
+            Assert.Equal(
+                "account_holder_name must be present when creating a Financial Connections payment method",
+                exception.Message
+            );
+        }
+
         #endregion
 
         #endregion

EasyPost.Tests/ServicesTests/ReportServiceTest.cs

@@ -33,7 +33,7 @@ public async Task TestCreate()
             });
 
             Assert.IsType<Report>(report);
-            Assert.StartsWith(Fixtures.ReportIdPrefix, report.Id);
+            Assert.StartsWith("shprep_", report.Id);
         }
 
         [Fact]

EasyPost.Tests/ServicesTests/WithParameters/ReportServiceTest.cs

@@ -38,7 +38,7 @@ public async Task TestCreate()
             Report report = await Client.Report.Create(parameters);
 
             Assert.IsType<Report>(report);
-            Assert.StartsWith(Fixtures.ReportIdPrefix, report.Id);
+            Assert.StartsWith("shprep_", report.Id);
         }
 
         [Fact]