feat: adds new credit card and bank account functions for referral customers

Author: Justintime50

CHANGELOG.md

@@ -3,6 +3,11 @@
 ## Next Release
 
 - Adds Ruby 3.4 support
+- Adds the following functions to assist ReferralCustomers add credit cards and bank accounts:
+  - `beta_referral_customer.create_credit_card_client_secret`
+  - `beta_referral_customer.create_bank_account_client_secret`
+  - `referral_customer.add_credit_card_from_stripe`
+  - `referral_customer.add_bank_account_from_stripe`
 - Fixes error parsing
   - Allows for alternative format of `errors` field
   - Corrects available properties of an `EasyPostError` and `ApiError` (`code` and `field` removed from `EasyPostError`, `message` unfurled and explicitly added to `ApiError`)

lib/easypost/services/beta_referral_customer.rb

@@ -41,4 +41,19 @@ def refund_by_payment_log(payment_log_id)
 
     EasyPost::InternalUtilities::Json.convert_json_to_object(response)
   end
+
+  # Creates a client secret to use with Stripe when adding a credit card.
+  def create_credit_card_client_secret()
+    response = @client.make_request(:post, 'setup_intents', nil, 'beta')
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response)
+  end
+
+  # Creates a client secret to use with Stripe when adding a bank account.
+  def create_bank_account_client_secret(return_url = nil)
+    params = return_url ? { return_url: return_url } : nil
+    response = @client.make_request(:post, 'financial_connections_sessions', params, 'beta')
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response)
+  end
 end

lib/easypost/services/referral_customer.rb

@@ -40,7 +40,7 @@ def get_next_page(collection, page_size = nil)
     all(params)
   end
 
-  # Add credit card to a referral customer. This function requires the ReferralCustomer Customer's API key.
+  # Add a credit card to EasyPost for a ReferralCustomer without needing a Stripe account. This function requires the ReferralCustomer User's API key.
   def add_credit_card(referral_api_key, number, expiration_month, expiration_year, cvc, priority = 'primary')
     easypost_stripe_api_key = retrieve_easypost_stripe_api_key
 
@@ -59,6 +59,41 @@ def add_credit_card(referral_api_key, number, expiration_month, expiration_year,
     create_easypost_credit_card(referral_api_key, stripe_credit_card_token, priority)
   end
 
+  # Add a credit card to EasyPost for a ReferralCustomer with a payment method ID from Stripe. This function requires the ReferralCustomer User's API key.
+  def add_credit_card_from_stripe(referral_api_key, payment_method_id, priority = 'primary')
+    params = {
+      credit_card: {
+        payment_method_id: payment_method_id,
+        priority: priority,
+      },
+    }
+    referral_client = EasyPost::Client.new(api_key: referral_api_key)
+    response = referral_client.make_request(
+      :post,
+      'credit_cards',
+      params,
+    )
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response)
+  end
+
+  # Add a bank account to EasyPost for a ReferralCustomer. This function requires the ReferralCustomer User's API key.
+  def add_bank_account_from_stripe(referral_api_key, financial_connections_id, mandate_data, priority = 'primary')
+    params = {
+      financial_connections_id: financial_connections_id,
+      mandate_data: mandate_data,
+      priority: priority,
+    }
+    referral_client = EasyPost::Client.new(api_key: referral_api_key)
+    response = referral_client.make_request(
+      :post,
+      'bank_accounts',
+      params,
+    )
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response)
+  end
+
   private
 
   # Retrieve EasyPost's Stripe public API key.

spec/beta_referral_spec.rb spec/beta_referral_customer_spec.rbspec/beta_referral_spec.rb renamed to spec/beta_referral_customer_spec.rb

@@ -39,4 +39,20 @@
       )
     end
   end
+
+  describe '.create_credit_card_client_secret' do
+    it 'returns a client secret for credit cards' do
+      response = client.beta_referral_customer.create_credit_card_client_secret()
+
+      expect(response.client_secret).to match('seti_')
+    end
+  end
+
+  describe '.create_bank_account_client_secret' do
+    it 'returns a client secret for bank accounts' do
+      response = client.beta_referral_customer.create_bank_account_client_secret()
+
+      expect(response.client_secret).to match('fcsess_client_secret_')
+    end
+  end
 end