fix: buying a pickup when providing a rate

Author: Justintime50

CHANGELOG.md

@@ -2,6 +2,8 @@
 
 ## Next Release
 
+- Fixes how params are passed to the API when buying a pickup and providing a pickup rate (closes #340)
+  - Removes the unusable buy a pickup overload where no params are specified as `carrier` and `service` are required paramaters when buying a pickup
 - Removes the deprecated `create_list` tracker endpoint function as it is no longer available via API
 
 ## v7.4.3 (2024-09-16)

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

@@ -95,18 +95,6 @@ public Pickup retrieve(final String id) throws EasyPostException {
         return Requestor.request(RequestMethod.GET, endpoint, null, Pickup.class, client);
     }
 
-    /**
-     * Buy this Pickup.
-     *
-     * @param id The ID of pickup.
-     * @return Pickup object.
-     * @throws EasyPostException when the request fails.
-     */
-    public Pickup buy(final String id) throws EasyPostException {
-        // Pass in empty map to avoid method ambiguous.
-        return this.buy(id, new HashMap<String, Object>());
-    }
-
     /**
      * Buy this Pickup.
      *
@@ -131,7 +119,8 @@ public Pickup buy(final String id, final Map<String, Object> params) throws Easy
      */
     public Pickup buy(final String id, final PickupRate pickupRate) throws EasyPostException {
         Map<String, Object> params = new HashMap<String, Object>();
-        params.put("rate", pickupRate);
+        params.put("carrier", pickupRate.getCarrier());
+        params.put("service", pickupRate.getService());
 
         return this.buy(id, params);
     }

src/test/cassettes/pickup/buy.json

@@ -223,7 +223,7 @@ public static HashMap<String, Object> basicPickup() {
          * If you need to re-record cassettes, increment the date below and ensure it is one day in the future,
          * USPS only does "next-day" pickups including Saturday but not Sunday or Holidays.
          */
-        String pickupDate = "2024-08-18";
+        String pickupDate = "2025-01-03";
 
         fixture.put("min_datetime", pickupDate);
         fixture.put("max_datetime", pickupDate);

src/test/cassettes/pickup/buy_with_rate.json

@@ -145,7 +145,11 @@ public void testBuy() throws EasyPostException, InterruptedException {
 
         Pickup pickup = createBasicPickup();
 
-        Pickup boughtPickup = vcr.client.pickup.buy(pickup.getId());
+        Map<String, Object> params = new HashMap<String, Object>();
+        params.put("carrier", Fixtures.usps());
+        params.put("service", Fixtures.pickupService());
+
+        Pickup boughtPickup = vcr.client.pickup.buy(pickup.getId(), params);
 
         assertInstanceOf(Pickup.class, boughtPickup);
         assertTrue(boughtPickup.getId().startsWith("pickup_"));
@@ -154,7 +158,7 @@ public void testBuy() throws EasyPostException, InterruptedException {
     }
 
     /**
-     * Test buying a pickup with lowest rate.
+     * Test buying a pickup by specifying a pickup rate.
      *
      * @throws EasyPostException when the request fails.
      */