Merge pull request #322 from EasyPost/new_partner_white_label_billing

feat: new partner white label billing

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`)

easypost.gemspec

@@ -29,8 +29,8 @@ Gem::Specification.new do |spec|
   spec.add_development_dependency 'ostruct', '~> 0.6'
   spec.add_development_dependency 'rdoc', '~> 6.12'
   spec.add_development_dependency 'rspec', '~> 3.13'
-  spec.add_development_dependency 'rubocop', '= 1.73'
-  spec.add_development_dependency 'rubocop-rspec', '2.31' # can't upgrade to 3.0, requires easycop config changes
+  spec.add_development_dependency 'rubocop', '= 1.72' # TODO: v1.73 no longer packages certain plugins and will require changes
+  spec.add_development_dependency 'rubocop-rspec', '= 2.31' # can't upgrade to 3.0, requires easycop config changes
   spec.add_development_dependency 'simplecov', '~> 0.22'
   spec.add_development_dependency 'simplecov-lcov', '~> 0.8'
   spec.add_development_dependency 'typhoeus', '~> 1.4'

examples

@@ -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/beta_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.

lib/easypost/services/referral_customer.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

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

@@ -15,7 +15,7 @@
                                                          },
                                              )
       allow(client).to receive(:make_request).with(:post, '/credit_cards/pm_123/charges', { amount: '2000' })
-      credit_card = client.billing.fund_wallet('2000', 'primary')
+      credit_card = client.billing.fund_wallet('2000', Fixture.billing['priority'])
 
       expect(credit_card).to eq(true)
     end
@@ -32,7 +32,7 @@
                                              )
       allow(client).to receive(:make_request).with(:delete, '/credit_cards/pm_123')
 
-      deleted_credit_card = client.billing.delete_payment_method('primary')
+      deleted_credit_card = client.billing.delete_payment_method(Fixture.billing['priority'])
 
       expect(deleted_credit_card).to eq(true)
     end
@@ -55,7 +55,7 @@
       # will pass if get_payment_method_info returns ['credit_cards', 'pm_123'], fail otherwise
       allow(client).to receive(:make_request).with(:delete, '/credit_cards/pm_123')
 
-      deleted_credit_card = client.billing.delete_payment_method('primary')
+      deleted_credit_card = client.billing.delete_payment_method(Fixture.billing['priority'])
 
       expect(deleted_credit_card).to eq(true)
     end