Add refund function in insurance service (#308)

CHANGELOG.md

@@ -1,5 +1,9 @@
 # CHANGELOG
 
+## Next release
+
+- Adds `refund` function in Insurance service for requesting a refund for a standalone insurance
+
 ## v7.1.1 (2024-03-21)
 
 - Fix `EasyPostTimeInTransitData` class and `easypostTimeInTransitData` property of `EstimatedDeliveryDate` class being publicly inaccessible

src/main/java/com/easypost/service/InsuranceService.java

@@ -66,6 +66,19 @@ public InsuranceCollection all(final Map<String, Object> params) throws EasyPost
         return Requestor.request(RequestMethod.GET, endpoint, params, InsuranceCollection.class, client);
     }
 
+    /**
+     * Refund an Insurance from the API.
+     *
+     * @param id The ID of the Insurance to refund.
+     * @return Insurance object
+     * @throws EasyPostException when the request fails.
+     */
+    public Insurance refund(final String id) throws EasyPostException {
+        String endpoint = String.format("insurances/%s/refund", id);
+
+        return Requestor.request(RequestMethod.POST, endpoint, null, Insurance.class, client);
+    }
+
     /**
      * Get the next page of an InsuranceCollection.
      *

src/test/java/com/easypost/InsuranceTest.java

@@ -129,4 +129,24 @@ public void testGetNextPage() throws EasyPostException {
             fail();
         }
     }
+
+    /**
+     * Test refunding an insurance.
+     *
+     * @throws EasyPostException when the request fails.
+     */
+    @Test
+    public void testRefundInsurance() throws EasyPostException {
+        vcr.setUpTest("refund");
+
+        HashMap<String, Object> params = Fixtures.basicInsurance();
+        params.put("tracking_code", "EZ1000000001");
+        Insurance insurance = vcr.client.insurance.create(params);
+        Insurance cancelledInsurance = vcr.client.insurance.refund(insurance.getId());
+
+        assertInstanceOf(Insurance.class, cancelledInsurance);
+        assertTrue(insurance.getId().startsWith("ins_"));
+        assertEquals("cancelled", cancelledInsurance.getStatus());
+        assertEquals("Insurance was cancelled by the user.", cancelledInsurance.getMessages().get(0));
+    }
 }