Release - 7.1.0 (#552)

This release introduces improved handling of request serialization and adds support for new identity-related API clients. The most significant update is the refactoring of the transport layer to support both JSON and form-encoded requests, making it more flexible for different content types. Additionally, several new clients for identity verification and screening have been integrated into the main API interface.

### Transport layer improvements

* Refactored `ApacheHttpClientTransport` to accept an `Object` as the request payload, allowing both JSON and `UrlEncodedFormEntity` form-encoded requests. Added logic to serialize objects to JSON or pass form entities directly, and set the appropriate `Content-Type` header. (`src/main/java/com/checkout/ApacheHttpClientTransport.java`) [[1]](diffhunk://#diff-3b863271ae76c2c75fc4ab50e731525ce851c694ee144332dd038c68e2873e44R91-R102) [[2]](diffhunk://#diff-3b863271ae76c2c75fc4ab50e731525ce851c694ee144332dd038c68e2873e44R238-R260) [[3]](diffhunk://#diff-3b863271ae76c2c75fc4ab50e731525ce851c694ee144332dd038c68e2873e44L265-R303)
* Updated `ApiClientImpl` methods to pass raw request objects to the transport layer instead of pre-serializing them, aligning with the new transport interface. (`src/main/java/com/checkout/ApiClientImpl.java`) [[1]](diffhunk://#diff-17788e6798031a3a75095fb61f03d1a3c404d2b6a6960c446262cfaae5d2688cL130-R130) [[2]](diffhunk://#diff-17788e6798031a3a75095fb61f03d1a3c404d2b6a6960c446262cfaae5d2688cL234-R234) [[3]](diffhunk://#diff-17788e6798031a3a75095fb61f03d1a3c404d2b6a6960c446262cfaae5d2688cL346-R346) [[4]](diffhunk://#diff-17788e6798031a3a75095fb61f03d1a3c404d2b6a6960c446262cfaae5d2688cL396-R396)

### Identity API client integration

* Added new identity-related clients (`FaceAuthenticationClient`, `ApplicantClient`, `IdentityVerificationClient`, `IdDocumentVerificationClient`, `AmlScreeningClient`) to `CheckoutApi` and `CheckoutApiImpl`, including their instantiation and interface methods. (`src/main/java/com/checkout/CheckoutApi.java`, `src/main/java/com/checkout/CheckoutApiImpl.java`) [[1]](diffhunk://#diff-9241579b48dfbc8729f69d42cd3fc2532b3ce2868663f46a307fc3b73638ef57R12-R16) [[2]](diffhunk://#diff-9241579b48dfbc8729f69d42cd3fc2532b3ce2868663f46a307fc3b73638ef57R77-R86) [[3]](diffhunk://#diff-9e68f52b37d22f45b3135eb0837bed690d1e0be8740b6ced9b5a65c94dafd478R21-R30) [[4]](diffhunk://#diff-9e68f52b37d22f45b3135eb0837bed690d1e0be8740b6ced9b5a65c94dafd478R84-R88) [[5]](diffhunk://#diff-9e68f52b37d22f45b3135eb0837bed690d1e0be8740b6ced9b5a65c94dafd478R116-R120) [[6]](diffhunk://#diff-9e68f52b37d22f45b3135eb0837bed690d1e0be8740b6ced9b5a65c94dafd478R221-R235)

### Supporting changes

* Updated imports in `GsonSerializer.java` to support form-encoded serialization, including `UrlEncodedFormEntity` and related classes. (`src/main/java/com/checkout/GsonSerializer.java`) [[1]](diffhunk://#diff-9b967a13c2a5016ea0995c3b77a5b750b221cf2d49970df6815d52970d5a73d8R46-R53) [[2]](diffhunk://#diff-9b967a13c2a5016ea0995c3b77a5b750b221cf2d49970df6815d52970d5a73d8L57)

These changes enhance the SDK's flexibility for handling different request types and expand its functionality for identity verification workflows.

Author: david-ruiz-cko

gradle.properties

@@ -1,5 +1,5 @@
 group=com.checkout
-version=7.0.2
+version=7.1.0
 
 project_name=Checkout SDK Java
 project_description=Checkout SDK for Java https://checkout.com

src/main/java/com/checkout/ApiClientImpl.java

@@ -238,7 +238,20 @@ private <T extends HttpMetadata> CompletableFuture<T> sendRequestAsync(final Cli
 
     private Response errorCheck(final Response response) {
         if (!CheckoutUtils.isSuccessHttpStatusCode(response.getStatusCode())) {
-            final Map<String, Object> errorDetails = serializer.fromJson(response.getBody());
+            Map<String, Object> errorDetails = null;
+            try{
+                errorDetails = serializer.fromJson(response.getBody());
+            }
+            catch (final Exception e) {
+                // Ignore deserialization errors, errorDetails will be null or the response body if
+                // existing and the exception will not be propagated as we want to throw a CheckoutApiException
+                // with the raw response details
+                if(response.getBody() != null) {
+                    errorDetails = new HashMap<>();
+                    errorDetails.put("Unknown Error", response.getBody());
+                }
+            }
+
             throw new CheckoutApiException(response.getStatusCode(), response.getHeaders(), errorDetails);
         }
         return response;

src/test/java/com/checkout/accounts/AccountsTestIT.java

@@ -14,6 +14,7 @@
 import com.checkout.common.InstrumentType;
 import org.apache.commons.lang3.RandomStringUtils;
 import org.apache.http.entity.ContentType;
+import org.junit.jupiter.api.Disabled;
 import org.junit.jupiter.api.Test;
 
 import java.io.File;
@@ -32,6 +33,7 @@ class AccountsTestIT extends SandboxTestFixture {
         super(PlatformType.DEFAULT_OAUTH);
     }
 
+    @Disabled("Recently giving a 503 with 'no healthy upstream' description from the API, disabled")
     @Test
     void shouldCreateGetAndUpdateOnboardIndividualEntity() {
         final String randomReference = RandomStringUtils.random(15, true, true);
@@ -51,6 +53,7 @@ void shouldCreateGetAndUpdateOnboardIndividualEntity() {
         assertEquals(onboardEntityRequest.getIndividual().getFirstName(), verifyUpdated.getIndividual().getFirstName());
     }
 
+    @Disabled("Recently giving a 503 with 'no healthy upstream' description from the API, disabled")
     @Test
     void shouldCreateGetAndUpdateOnboardCompanyEntity() {
         final String randomReference = RandomStringUtils.random(15, true, true);
@@ -69,6 +72,7 @@ void shouldUploadAccountsFile() throws URISyntaxException {
         validateFileUploadResponse(fileResponse);
     }
 
+    @Disabled("Recently giving a 503 with 'no healthy upstream' description from the API, disabled")
     @Test
     void shouldCreateAndRetrievePaymentInstrument() throws URISyntaxException {
         final CheckoutApi checkoutApi = getAccountsCheckoutApi();
@@ -90,6 +94,7 @@ void shouldCreateAndRetrievePaymentInstrument() throws URISyntaxException {
     }
 
     // Synchronous methods
+    @Disabled("Recently giving a 503 with 'no healthy upstream' description from the API, disabled")
     @Test
     void shouldCreateGetAndUpdateOnboardIndividualEntitySync() {
         final String randomReference = RandomStringUtils.random(15, true, true);
@@ -110,6 +115,7 @@ void shouldCreateGetAndUpdateOnboardIndividualEntitySync() {
     }
 
     @Test
+    @Disabled("Recently giving a 503 with 'no healthy upstream' description from the API, disabled")
     void shouldCreateGetAndUpdateOnboardCompanyEntitySync() {
         final String randomReference = RandomStringUtils.random(15, true, true);
         final OnboardEntityRequest onboardEntityRequest = buildCompanyEntity(randomReference);
@@ -127,6 +133,7 @@ void shouldUploadAccountsFileSync() throws URISyntaxException {
         validateFileUploadResponse(fileResponse);
     }
 
+    @Disabled("Recently giving a 503 with 'no healthy upstream' description from the API, disabled")
     @Test
     void shouldCreateAndRetrievePaymentInstrumentSync() throws URISyntaxException {
         final CheckoutApi checkoutApi = getAccountsCheckoutApi();