Add refund function in insurance service (#299)

Author: jchen293

CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## Next release
+
+- Add `refund` function in Insurance service for requesting a refund for standalone insurance.
+
 ## v6.1.1 (2024-01-23)
 
 - Fix issues funding wallet due to invalid internal function call

lib/easypost/services/insurance.rb

@@ -34,4 +34,11 @@ def get_next_page(collection, page_size = nil)
 
     all(params)
   end
+
+  # Refund an Insurance object
+  def refund(id)
+    response = @client.make_request(:post, "insurances/#{id}/refund")
+
+    EasyPost::InternalUtilities::Json.convert_json_to_object(response, MODEL_CLASS)
+  end
 end

spec/cassettes/insurance/EasyPost_Services_Insurance_refund_cancels_an_insurance.yml

@@ -3,6 +3,7 @@
 require 'spec_helper'
 require 'faraday'
 require 'typhoeus'
+require 'ostruct'
 
 describe EasyPost::Client do
   describe 'client object' do

spec/client_spec.rb

@@ -72,4 +72,19 @@
       end
     end
   end
+
+  describe '.refund' do
+    it 'cancels an insurance' do
+      insurance_data = Fixture.basic_insurance
+      insurance_data[:tracking_code] = 'EZ1000000001'
+
+      insurance = client.insurance.create(insurance_data)
+      cancelled_insurance = client.insurance.refund(insurance.id)
+
+      expect(cancelled_insurance).to be_an_instance_of(EasyPost::Models::Insurance)
+      expect(cancelled_insurance.id).to match('ins_')
+      expect(cancelled_insurance.status).to eq('cancelled')
+      expect(cancelled_insurance.messages[0]).to eq('Insurance was cancelled by the user.')
+    end
+  end
 end