feat: fedex registration endpoints

Author: Justintime50

CHANGELOG.md

@@ -1,5 +1,14 @@
 # CHANGELOG
 
+## v8.5.0 (2025-12-08)
+
+- Adds the following functions:
+  - `fedex.verifyBillingAddress`
+  - `fedex.generatePin`
+  - `fedex.validatePin`
+  - `fedex.validateInvoice`
+- Adds `details` property of a `Rate` object
+
 ## v8.4.1 (2025-12-01)
 
 - Adds missing `apiKeys` field to `BaseUser`

README.md

@@ -16,7 +16,7 @@ Add this to your project's POM:
 <dependency>
   <groupId>com.easypost</groupId>
   <artifactId>easypost-api-client</artifactId>
-  <version>8.4.1</version>
+  <version>8.5.0</version>
 </dependency>
 ```
 
@@ -25,7 +25,7 @@ Add this to your project's POM:
 Add this to your project's build file:
 
 ```groovy
-implementation "com.easypost:easypost-api-client:8.4.1"
+implementation "com.easypost:easypost-api-client:8.5.0"
 ```
 
 **NOTE:** [Google Gson](http://code.google.com/p/google-gson/) is required.

VERSION

@@ -1 +1 @@
-8.4.1
+8.5.0

pom.xml

@@ -6,7 +6,7 @@
     <groupId>com.easypost</groupId>
     <artifactId>easypost-api-client</artifactId>
 
-    <version>8.4.1</version>
+    <version>8.5.0</version>
     <packaging>jar</packaging>
 
     <name>com.easypost:easypost-api-client</name>

src/main/java/com/easypost/model/FedExAccountValidationResponse.java

@@ -0,0 +1,18 @@
+package com.easypost.model;
+
+import java.util.Map;
+import lombok.Getter;
+
+@Getter
+public class FedExAccountValidationResponse {
+    // If the response contains the following, one must complete pin or invoice validation next
+    private String emailAddress;
+    private Map<String, String> options;
+    private String phoneNumber;
+
+    // If the response contains the following, pre-validation has been completed
+    private String id;
+    private String object;
+    private String type;
+    private Map<String, String> credentials;
+}

src/main/java/com/easypost/model/FedExGeneratePinResponse.java

@@ -0,0 +1,8 @@
+package com.easypost.model;
+
+import lombok.Getter;
+
+@Getter
+public class FedExGeneratePinResponse {
+    private String message;
+}

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

@@ -34,6 +34,7 @@ public class EasyPostClient {
     public final EmbeddableService embeddable = new EmbeddableService(this);
     public final EndShipperService endShipper = new EndShipperService(this);
     public final EventService event = new EventService(this);
+    public final FedExService fedex = new FedExService(this);
     public final InsuranceService insurance = new InsuranceService(this);
     public final LumaService luma = new LumaService(this);
     public final OrderService order = new OrderService(this);

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

@@ -0,0 +1,83 @@
+package com.easypost.service;
+
+import java.util.Map;
+import java.util.HashMap;
+
+import com.easypost.exception.EasyPostException;
+import com.easypost.http.Requestor;
+import com.easypost.http.Requestor.RequestMethod;
+import com.easypost.model.FedExAccountValidationResponse;
+import com.easypost.model.FedExGeneratePinResponse;
+
+public class FedExService {
+    private final EasyPostClient client;
+
+    /**
+     * FedExService constructor.
+     *
+     * @param client The client object.
+     */
+    FedExService(EasyPostClient client) {
+        this.client = client;
+    }
+
+    /**
+     * Verify a FedEx billing address via the API.
+     *
+     * @param fedexAccountNumber FedEx account number.
+     * @param params Map of parameters.
+     * @return FedExAccountValidationResponse object
+     * @throws EasyPostException when the request fails.
+     */
+    public FedExAccountValidationResponse verifyBillingAddress(final String fedexAccountNumber, final Map<String, Object> params) throws EasyPostException {
+        String endpoint = "fedex_registrations/" + fedexAccountNumber + "/address";
+
+        return Requestor.request(RequestMethod.POST, endpoint, params, FedExAccountValidationResponse.class, client);
+    }
+
+    /**
+     * Generate a pin to verify your FedEx account via the API.
+     *
+     * @param fedexAccountNumber FedEx account number.
+     * @param pinMethod Method of delivery for the pin.
+     * @return FedExGeneratePinResponse object
+     * @throws EasyPostException when the request fails.
+     */
+    public FedExGeneratePinResponse generatePin(final String fedexAccountNumber, final String pinMethod) throws EasyPostException {
+        Map<String, Object> wrappedParams = new HashMap<>();
+        Map<String, Object> pinMethodMap = new HashMap<>();
+        pinMethodMap.put("option", pinMethod);
+        wrappedParams.put("pin_method", pinMethodMap);
+        String endpoint = "fedex_registrations/" + fedexAccountNumber + "/pin";
+
+        return Requestor.request(RequestMethod.POST, endpoint, wrappedParams, FedExGeneratePinResponse.class, client);
+    }
+
+    /**
+     * Validates a pin for a FedEx account via the API.
+     *
+     * @param fedexAccountNumber FedEx account number.
+     * @param params Map of parameters.
+     * @return FedExAccountValidationResponse object
+     * @throws EasyPostException when the request fails.
+     */
+    public FedExAccountValidationResponse validatePin(final String fedexAccountNumber, final Map<String, Object> params) throws EasyPostException {
+        String endpoint = "fedex_registrations/" + fedexAccountNumber + "/pin/validate";
+
+        return Requestor.request(RequestMethod.POST, endpoint, params, FedExAccountValidationResponse.class, client);
+    }
+
+    /**
+     * Validates details of an invoice for a FedEx account via the API.
+     *
+     * @param fedexAccountNumber FedEx account number.
+     * @param params Map of parameters.
+     * @return FedExAccountValidationResponse object
+     * @throws EasyPostException when the request fails.
+     */
+    public FedExAccountValidationResponse validateInvoice(final String fedexAccountNumber, final Map<String, Object> params) throws EasyPostException {
+        String endpoint = "fedex_registrations/" + fedexAccountNumber + "/invoice";
+
+        return Requestor.request(RequestMethod.POST, endpoint, params, FedExAccountValidationResponse.class, client);
+    }
+}