feature/INT-1632 SDK update - Latests changes in payments and other updates

src/main/java/com/checkout/ApacheHttpClientTransport.java

@@ -152,7 +152,7 @@ public Response invokeSync(final ClientOperation clientOperation,
     public Response submitFileSync(final String path, final SdkAuthorization authorization, final AbstractFileRequest fileRequest) {
         final HttpPost request = new HttpPost(getRequestUrl(path));
         request.setEntity(getMultipartFileEntity(fileRequest));
-        
+
         final Supplier<Response> callSupplier = () -> performCall(authorization, null, request, POST);
         return executeWithResilience4j(callSupplier);
     }

src/main/java/com/checkout/CheckoutApi.java

@@ -22,6 +22,7 @@
 import com.checkout.issuing.IssuingClient;
 import com.checkout.metadata.MetadataClient;
 import com.checkout.networktokens.NetworkTokensClient;
+import com.checkout.onboardingsimulator.OnboardingSimulatorClient;
 import com.checkout.paymentmethods.PaymentMethodsClient;
 import com.checkout.payments.PaymentsClient;
 import com.checkout.payments.contexts.PaymentContextsClient;
@@ -109,4 +110,9 @@ public interface CheckoutApi extends CheckoutApmApi {
      */
     AgenticCommerceClient agenticCommerceClient();
 
+    /**
+     * Returns the client for the Onboarding Simulator (Sandbox only).
+     */
+    OnboardingSimulatorClient onboardingSimulatorClient();
+
 }

src/main/java/com/checkout/CheckoutApiImpl.java

@@ -44,6 +44,8 @@
 import com.checkout.metadata.MetadataClientImpl;
 import com.checkout.networktokens.NetworkTokensClient;
 import com.checkout.networktokens.NetworkTokensClientImpl;
+import com.checkout.onboardingsimulator.OnboardingSimulatorClient;
+import com.checkout.onboardingsimulator.OnboardingSimulatorClientImpl;
 import com.checkout.paymentmethods.PaymentMethodsClient;
 import com.checkout.paymentmethods.PaymentMethodsClientImpl;
 import com.checkout.payments.PaymentsClient;
@@ -107,6 +109,7 @@ public class CheckoutApiImpl extends AbstractCheckoutApmApi implements CheckoutA
     private final NetworkTokensClient networkTokensClient;
     private final StandaloneAccountUpdaterClient standaloneAccountUpdaterClient;
     private final AgenticCommerceClient agenticCommerceClient;
+    private final OnboardingSimulatorClient onboardingSimulatorClient;
 
     public CheckoutApiImpl(final CheckoutConfiguration configuration) {
         super(configuration);
@@ -146,6 +149,7 @@ public CheckoutApiImpl(final CheckoutConfiguration configuration) {
         this.networkTokensClient = new NetworkTokensClientImpl(this.apiClient, configuration);
         this.standaloneAccountUpdaterClient = new StandaloneAccountUpdaterClientImpl(this.apiClient, configuration);
         this.agenticCommerceClient = new AgenticCommerceClientImpl(this.apiClient, configuration);
+        this.onboardingSimulatorClient = new OnboardingSimulatorClientImpl(this.apiClient, configuration);
     }
 
     @Override
@@ -284,6 +288,9 @@ public MetadataClient metadataClient() {
     @Override
     public AgenticCommerceClient agenticCommerceClient() { return agenticCommerceClient; }
 
+    @Override
+    public OnboardingSimulatorClient onboardingSimulatorClient() { return onboardingSimulatorClient; }
+
     private ApiClient getFilesClient(final CheckoutConfiguration configuration) {
         return new ApiClientImpl(configuration, new FilesApiUriStrategy(configuration));
     }

src/main/java/com/checkout/GsonSerializer.java

@@ -93,6 +93,10 @@ public final class GsonSerializer implements Serializer {
     }.getType();
     private static final Type PAYMENT_ACTIONS_TYPE = new TypeToken<ItemsResponse<com.checkout.payments.PaymentAction>>() {
     }.getType();
+    private static final Type SIMULATOR_AVAILABLE_REQUIREMENTS_TYPE = new TypeToken<ItemsResponse<com.checkout.onboardingsimulator.entities.SimulatorAvailableRequirement>>() {
+    }.getType();
+    private static final Type SIMULATOR_SCENARIOS_TYPE = new TypeToken<ItemsResponse<com.checkout.onboardingsimulator.entities.SimulatorScenario>>() {
+    }.getType();
 
     private static final Gson DEFAULT_GSON = new GsonBuilder()
             .setFieldNamingPolicy(FieldNamingPolicy.LOWER_CASE_WITH_UNDERSCORES)
@@ -118,6 +122,7 @@ public final class GsonSerializer implements Serializer {
                     .registerSubtype(com.checkout.handlepaymentsandpayouts.payments.common.source.almasource.AlmaSource.class, identifier(com.checkout.handlepaymentsandpayouts.payments.common.source.SourceType.ALMA))
                     .registerSubtype(com.checkout.handlepaymentsandpayouts.payments.common.source.bancontactsource.BancontactSource.class, identifier(com.checkout.handlepaymentsandpayouts.payments.common.source.SourceType.BANCONTACT))
                     .registerSubtype(com.checkout.handlepaymentsandpayouts.payments.common.source.benefitsource.BenefitSource.class, identifier(com.checkout.handlepaymentsandpayouts.payments.common.source.SourceType.BENEFIT))
+                    .registerSubtype(com.checkout.handlepaymentsandpayouts.payments.common.source.bliksource.BlikSource.class, identifier(com.checkout.handlepaymentsandpayouts.payments.common.source.SourceType.BLIK))
                     .registerSubtype(com.checkout.handlepaymentsandpayouts.payments.common.source.currencyaccountsource.CurrencyAccountSource.class, identifier(com.checkout.handlepaymentsandpayouts.payments.common.source.SourceType.CURRENCY_ACCOUNT))
                     .registerSubtype(com.checkout.handlepaymentsandpayouts.payments.common.source.cvconnectsource.CvconnectSource.class, identifier(com.checkout.handlepaymentsandpayouts.payments.common.source.SourceType.CVCONNECT))
                     .registerSubtype(com.checkout.handlepaymentsandpayouts.payments.common.source.danasource.DanaSource.class, identifier(com.checkout.handlepaymentsandpayouts.payments.common.source.SourceType.DANA))
@@ -233,6 +238,8 @@ public final class GsonSerializer implements Serializer {
             .registerTypeAdapter(WEBHOOKS_TYPE, webhooksResponseDeserializer())
             .registerTypeAdapter(PREVIOUS_PAYMENT_ACTIONS_TYPE, paymentActionsResponsePreviousDeserializer())
             .registerTypeAdapter(PAYMENT_ACTIONS_TYPE, paymentActionsResponseDeserializer())
+            .registerTypeAdapter(SIMULATOR_AVAILABLE_REQUIREMENTS_TYPE, simulatorAvailableRequirementsResponseDeserializer())
+            .registerTypeAdapter(SIMULATOR_SCENARIOS_TYPE, simulatorScenariosResponseDeserializer())
             .registerTypeAdapter(ProductResponse.class, getProductDeserializer())
             .create();
 
@@ -344,6 +351,26 @@ private static JsonDeserializer<ItemsResponse<com.checkout.payments.PaymentActio
         };
     }
 
+    private static JsonDeserializer<ItemsResponse<com.checkout.onboardingsimulator.entities.SimulatorAvailableRequirement>> simulatorAvailableRequirementsResponseDeserializer() {
+        return (json, typeOfT, context) -> {
+            final ItemsResponse<com.checkout.onboardingsimulator.entities.SimulatorAvailableRequirement> response = new ItemsResponse<>();
+            if (json.isJsonArray()) {
+                response.setItems(deserializeJsonArray(json, com.checkout.onboardingsimulator.entities.SimulatorAvailableRequirement.class));
+            }
+            return response;
+        };
+    }
+
+    private static JsonDeserializer<ItemsResponse<com.checkout.onboardingsimulator.entities.SimulatorScenario>> simulatorScenariosResponseDeserializer() {
+        return (json, typeOfT, context) -> {
+            final ItemsResponse<com.checkout.onboardingsimulator.entities.SimulatorScenario> response = new ItemsResponse<>();
+            if (json.isJsonArray()) {
+                response.setItems(deserializeJsonArray(json, com.checkout.onboardingsimulator.entities.SimulatorScenario.class));
+            }
+            return response;
+        };
+    }
+
     private static <T> List<T> deserializeJsonArray(final JsonElement json, final Class<T> itemsType) {
         final JsonArray jsonArray = json.getAsJsonArray();
         return IntStream

src/main/java/com/checkout/accounts/AccountsClient.java

@@ -63,6 +63,33 @@ CompletableFuture<ReserveRuleCreateResponse> updateReserveRule(String entityId,
 
     CompletableFuture<ReserveRulesResponse> getReserveRules(String entityId);
 
+    /**
+     * Retrieves the list of pending requirements that the sub-entity must resolve.
+     *
+     * @param entityId The sub-entity ID.
+     * @return a {@link CompletableFuture} resolving to the requirements list.
+     */
+    CompletableFuture<EntityRequirementListResponse> getEntityRequirements(String entityId);
+
+    /**
+     * Retrieves detailed information for a single requirement.
+     *
+     * @param entityId      The sub-entity ID.
+     * @param requirementId The requirement ID.
+     * @return a {@link CompletableFuture} resolving to the requirement details.
+     */
+    CompletableFuture<EntityRequirementDetailsResponse> getEntityRequirementDetails(String entityId, String requirementId);
+
+    /**
+     * Submits a response to resolve a requirement.
+     *
+     * @param entityId      The sub-entity ID.
+     * @param requirementId The requirement ID.
+     * @param updateRequest The response payload.
+     * @return a {@link CompletableFuture} resolving to the resolve response.
+     */
+    CompletableFuture<EntityRequirementUpdateResponse> resolveEntityRequirement(String entityId, String requirementId, EntityRequirementUpdateRequest updateRequest);
+
     // Synchronous methods
     IdResponse submitFileSync(final AccountsFileRequest accountsFileRequest);
 
@@ -103,4 +130,19 @@ IdResponse updatePaymentInstrumentDetailsSync(final String entityId,
 
     ReserveRulesResponse getReserveRulesSync(final String entityId);
 
+    /**
+     * Synchronous variant of {@link #getEntityRequirements(String)}.
+     */
+    EntityRequirementListResponse getEntityRequirementsSync(final String entityId);
+
+    /**
+     * Synchronous variant of {@link #getEntityRequirementDetails(String, String)}.
+     */
+    EntityRequirementDetailsResponse getEntityRequirementDetailsSync(final String entityId, final String requirementId);
+
+    /**
+     * Synchronous variant of {@link #resolveEntityRequirement(String, String, EntityRequirementUpdateRequest)}.
+     */
+    EntityRequirementUpdateResponse resolveEntityRequirementSync(final String entityId, final String requirementId, final EntityRequirementUpdateRequest updateRequest);
+
 }

src/main/java/com/checkout/accounts/AccountsClientImpl.java

@@ -34,6 +34,7 @@
     private static final String PAYMENT_INSTRUMENTS_PATH = "payment-instruments";
     private static final String MEMBERS_PATH = "members";
     private static final String RESERVE_RULES_PATH = "reserve-rules";
+    private static final String REQUIREMENTS_PATH = "requirements";
 
     private final ApiClient filesClient;
 
@@ -240,6 +241,34 @@
                 ReserveRulesResponse.class);
     }
 
+    @Override
+    public CompletableFuture<EntityRequirementListResponse> getEntityRequirements(final String entityId) {
+        validateEntityId(entityId);
+        return apiClient.getAsync(
+                buildPath(ACCOUNTS_PATH, ENTITIES_PATH, entityId, REQUIREMENTS_PATH),
+                sdkAuthorization(),
+                EntityRequirementListResponse.class);
+    }
+
+    @Override
+    public CompletableFuture<EntityRequirementDetailsResponse> getEntityRequirementDetails(final String entityId, final String requirementId) {
+        validateParams("entityId", entityId, "requirementId", requirementId);
+        return apiClient.getAsync(
+                buildPath(ACCOUNTS_PATH, ENTITIES_PATH, entityId, REQUIREMENTS_PATH, requirementId),
+                sdkAuthorization(),
+                EntityRequirementDetailsResponse.class);
+    }
+
+    @Override
+    public CompletableFuture<EntityRequirementUpdateResponse> resolveEntityRequirement(final String entityId, final String requirementId, final EntityRequirementUpdateRequest updateRequest) {
+        validateParams("entityId", entityId, "requirementId", requirementId, "updateRequest", updateRequest);
+        return apiClient.putAsync(
+                buildPath(ACCOUNTS_PATH, ENTITIES_PATH, entityId, REQUIREMENTS_PATH, requirementId),
+                sdkAuthorization(),
+                EntityRequirementUpdateResponse.class,
+                updateRequest);
+    }
+
     // Synchronous methods
     @Override
     public IdResponse submitFileSync(final AccountsFileRequest accountsFileRequest) {
@@ -434,6 +463,34 @@
                 ReserveRulesResponse.class);
     }
 
+    @Override
+    public EntityRequirementListResponse getEntityRequirementsSync(final String entityId) {
+        validateEntityId(entityId);
+        return apiClient.get(
+                buildPath(ACCOUNTS_PATH, ENTITIES_PATH, entityId, REQUIREMENTS_PATH),
+                sdkAuthorization(),
+                EntityRequirementListResponse.class);
+    }
+
+    @Override
+    public EntityRequirementDetailsResponse getEntityRequirementDetailsSync(final String entityId, final String requirementId) {
+        validateParams("entityId", entityId, "requirementId", requirementId);
+        return apiClient.get(
+                buildPath(ACCOUNTS_PATH, ENTITIES_PATH, entityId, REQUIREMENTS_PATH, requirementId),
+                sdkAuthorization(),
+                EntityRequirementDetailsResponse.class);
+    }
+
+    @Override
+    public EntityRequirementUpdateResponse resolveEntityRequirementSync(final String entityId, final String requirementId, final EntityRequirementUpdateRequest updateRequest) {
+        validateParams("entityId", entityId, "requirementId", requirementId, "updateRequest", updateRequest);
+        return apiClient.put(
+                buildPath(ACCOUNTS_PATH, ENTITIES_PATH, entityId, REQUIREMENTS_PATH, requirementId),
+                sdkAuthorization(),
+                EntityRequirementUpdateResponse.class,
+                updateRequest);
+    }
+
     // Common methods
     private Map<Currency, UpdateScheduleRequest> buildScheduleRequestMap(final Currency currency, final UpdateScheduleRequest updateScheduleRequest) {
         final Map<Currency, UpdateScheduleRequest> request = new EnumMap<>(Currency.class);

src/main/java/com/checkout/accounts/EntityRequirementDetailsResponse.java

@@ -0,0 +1,35 @@
+package com.checkout.accounts;
+
+import com.google.gson.annotations.SerializedName;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.util.Map;
+
+/**
+ * Detailed information about a single requirement.
+ */
+@Data
+@NoArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public final class EntityRequirementDetailsResponse extends EntityRequirementListItem {
+
+    /**
+     * A user-facing explanation of what is needed to resolve the requirement.
+     * [Optional]
+     */
+    private String message;
+
+    /**
+     * JSON Schema that the value supplied to PUT /accounts/entities/{id}/requirements/{requirementId}
+     * must conform to. The shape varies by requirement type (for example: an identity document upload,
+     * a free-text response, or a structured object). May be {@code null} if no schema is registered
+     * for the requirement's field.
+     * [Optional]
+     */
+    @SerializedName("_schema")
+    private Map<String, Object> schema;
+}

src/main/java/com/checkout/accounts/EntityRequirementListItem.java

@@ -0,0 +1,96 @@
+package com.checkout.accounts;
+
+import com.checkout.common.Resource;
+import com.google.gson.annotations.SerializedName;
+import lombok.AllArgsConstructor;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.NoArgsConstructor;
+import lombok.ToString;
+
+import java.time.Instant;
+import java.util.Map;
+
+/**
+ * A pending requirement that the sub-entity must resolve to remain compliant or unlock capabilities.
+ */
+@Data
+@NoArgsConstructor
+@AllArgsConstructor
+@EqualsAndHashCode(callSuper = true)
+@ToString(callSuper = true)
+public class EntityRequirementListItem extends Resource {
+
+    /**
+     * The unique identifier of the requirement.
+     * [Optional]
+     */
+    private String id;
+
+    /**
+     * The ID of the resource (sub-entity or representative) the requirement applies to.
+     * [Optional]
+     */
+    private String resource;
+
+    /**
+     * The type of resource the requirement applies to derived from the resource's URN.
+     * Common values include {@code company}, {@code individual}, and {@code representative}.
+     * Defaults to {@code entity} if the URN cannot be parsed.
+     * [Optional]
+     */
+    @SerializedName("resource_type")
+    private String resourceType;
+
+    /**
+     * The reason the requirement was raised.
+     * [Optional]
+     * Enum: "periodic_review" "attestation"
+     */
+    private EntityRequirementReason reason;
+
+    /**
+     * Priority level of this requirement. {@code high} by default, {@code critical} if deadline
+     * is within 7 days.
+     * [Optional]
+     * Enum: "high" "critical"
+     */
+    private EntityRequirementPriority priority;
+
+    /**
+     * The date and time, in ISO 8601 UTC format, by which the requirement must be resolved.
+     * [Optional]
+     * Format: date-time (RFC 3339)
+     */
+    private Instant deadline;
+
+    /**
+     * The schema-registry URN identifying the field this requirement applies to.
+     * Format: {@code urn:object:{resource_type}#{resource_id}#field:{field_name}}.
+     * [Optional]
+     */
+    private String urn;
+
+    /**
+     * Dot-notation path of the field on the resource that needs to be supplied or updated.
+     * May be {@code null} for ad-hoc requirements (such as additional documents or free-text
+     * responses) that do not map to a specific field on the entity.
+     * [Optional]
+     */
+    @SerializedName("field_path")
+    private String fieldPath;
+
+    /**
+     * The schema-registry URN of the field, from the public mapping definition.
+     * May be {@code null} if no mapping exists.
+     * [Optional]
+     */
+    @SerializedName("field_urn")
+    private String fieldUrn;
+
+    /**
+     * Optional metadata from the property mapping definition. Shape varies by requirement.
+     * [Optional]
+     */
+    private Map<String, Object> metadata;
+}