OctopusDeploy release: 14.2.20

Author: securesubmit-buildmaster

CHANGELOG.md

@@ -1,6 +1,11 @@
 # Changelog
 
-## Latest Version - V14.2.19 (05/20/2025)
+## Latest Version - V14.2.20 (05/29/2025)
+### Enhancements
+- [GPApi] - Added Installment Object in Create Sale API (POST /transactions)
+- [GPApi] - Added Installment Object in Reporting API (GET /transactions & GET /transactions/{id})
+
+## V14.2.19 (05/20/2025)
 ### Bug Fixes
 - [NTS] - Reverted code to add back the EMV data into Retransmit transactions(Issue -10356).
 

pom.xml

@@ -3,7 +3,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>com.heartlandpaymentsystems</groupId>
   <artifactId>globalpayments-sdk</artifactId>
-  <version>14.2.19</version>
+  <version>14.2.20</version>
   <packaging>jar</packaging>
   <name>Heartland &amp; Global Payments SDK</name>
   <description>API for processing payments through Global Payments</description>

src/main/java/com/global/api/builders/AuthorizationBuilder.java

@@ -203,6 +203,10 @@ public AuthorizationBuilder withNtsUtilityMessageRequest(NtsUtilityMessageReques
 
     public boolean requestUniqueToken;
 
+    @Getter
+    @Setter
+    private InstallmentData installmentData;
+
     public AuthorizationBuilder withNtsProductData(NtsProductData ntsProductData) {
         this.ntsProductData = ntsProductData;
         return this;
@@ -261,6 +265,11 @@ public AuthorizationBuilder withPurchaseRestrictionFlag(PurchaseRestrictionFlag
         return this;
     }
 
+    public AuthorizationBuilder withInstallmentData(InstallmentData installmentData) {
+        this.installmentData = installmentData;
+        return this;
+    }
+
     public String getAlias() {
         return alias;
     }

src/main/java/com/global/api/builders/requestbuilder/gpApi/GpApiAuthorizationRequestBuilder.java

@@ -690,6 +690,10 @@ else if (builderPaymentMethod instanceof ITrackData) {
                             .set("reason", EnumUtils.getMapping(Target.GP_API, builder.getStoredCredential().getReason()))
                             .set("sequence", EnumUtils.getMapping(Target.GP_API, builder.getStoredCredential().getSequence()));
             data.set("stored_credential", storedCredential);
+            //set installment data
+            if(builder.getInstallmentData() != null && builder.getStoredCredential().getType().equals(StoredCredentialType.Installment)) {
+                data.set("installment", setInstallmentData(builder.getInstallmentData()));
+            }
         }
 
         return (GpApiRequest)
@@ -1104,4 +1108,14 @@ private static String getChipCondition(EmvChipCondition emvChipCondition) {
         }
     }
 
+    private static JsonDoc setInstallmentData(InstallmentData installmentData)
+    {
+        JsonDoc installment = new JsonDoc();
+        installment
+                .set("program", installmentData.getProgram())
+                .set("mode", installmentData.getMode())
+                .set("count", installmentData.getCount())
+                .set("grace_period_count", installmentData.getGracePeriodCount());
+        return installment;
+    }
 }

src/main/java/com/global/api/entities/Transaction.java

@@ -20,6 +20,7 @@
 import com.global.api.network.enums.nts.PendingRequestIndicator;
 import com.global.api.paymentMethods.GiftCard;
 import com.global.api.paymentMethods.IPaymentMethod;
+import com.global.api.paymentMethods.InstallmentData;
 import com.global.api.paymentMethods.TransactionReference;
 import lombok.Getter;
 import lombok.Setter;
@@ -120,6 +121,8 @@ public class Transaction {
     private Address address;
     private  Customer customerData;
     private TokenData tokenData;
+    @Getter @Setter
+    private InstallmentData installmentData;
 
     public Customer getCustomerData() {
         return customerData;

src/main/java/com/global/api/entities/TransactionSummary.java

@@ -4,6 +4,7 @@
 import com.global.api.entities.billing.Bill;
 import com.global.api.entities.reporting.AltPaymentData;
 import com.global.api.entities.reporting.CheckData;
+import com.global.api.paymentMethods.InstallmentData;
 import lombok.Getter;
 import lombok.Setter;
 import org.joda.time.DateTime;
@@ -154,5 +155,5 @@ public class TransactionSummary {
     private String cardAcquisition;
     private String transactionTime;
     private Card cardDetails;
-
+    private InstallmentData installmentData;
 }

src/main/java/com/global/api/mapping/GpApiMapping.java

@@ -12,6 +12,7 @@
 import com.global.api.entities.payFac.UserReference;
 import com.global.api.entities.reporting.*;
 import com.global.api.paymentMethods.CreditCardData;
+import com.global.api.paymentMethods.InstallmentData;
 import com.global.api.paymentMethods.RecurringPaymentMethod;
 import com.global.api.paymentMethods.eCheck;
 import com.global.api.utils.EnumUtils;
@@ -157,6 +158,9 @@ public static Transaction mapResponse(String rawResponse) throws GatewayExceptio
                     var cardDetails = new Card();
                     cardDetails.setMaskedNumberLast4(paymentMethodObj.getString("masked_number_last4"));
                     cardDetails.setBrand(paymentMethodObj.getString("brand"));
+                    cardDetails.setIssuer(paymentMethodObj.getString("issuer"));
+                    cardDetails.setFunding(paymentMethodObj.getString("funding"));
+                    cardDetails.setBinCountry(paymentMethodObj.getString("country"));
                     transaction.setCardDetails(cardDetails);
 
                     transaction.setCardType(paymentMethodObj.getString("brand"));
@@ -252,6 +256,11 @@ public static Transaction mapResponse(String rawResponse) throws GatewayExceptio
 
                 transaction.setCardDetails(cardDetail);
             }
+
+            if (json.has("installment")) {
+                JsonDoc installment = json.get("installment");
+                transaction.setInstallmentData(setInstallmentData(installment));
+            }
         }
 
         return transaction;
@@ -510,6 +519,10 @@ public static TransactionSummary mapTransactionSummary(JsonDoc doc) throws Gatew
                 summary.setPaymentType(EnumUtils.getMapping(Target.GP_API, PaymentMethodName.BNPL));
             }
         }
+        if(doc.has("installment")){
+            JsonDoc installment = doc.get("installment");
+            summary.setInstallmentData(setInstallmentData(installment));
+        }
 
         summary.setFraudManagementResponse(doc.has("risk_assessment") ? mapFraudManagementReport(doc.get("risk_assessment")) : null);
 
@@ -1672,6 +1685,7 @@ private static ThreeDSecure map3DSInfo(JsonDoc response) {
             threeDSecure.setCavv(threeDSNode.getString("cavv_result"));
             threeDSecure.setMessageVersion(threeDSNode.getString("message_version"));
             threeDSecure.setEci(threeDSNode.getString("eci"));
+            threeDSecure.setStatus(threeDSNode.getString("status"));
         }
 
         return threeDSecure;
@@ -1683,7 +1697,18 @@ private static Card mapCardDetails(JsonDoc cardInfo) {
         cardDetails.setFunding(cardInfo.getString("funding"));
         cardDetails.setBrand(cardInfo.getString("brand"));
         cardDetails.setIssuer(cardInfo.getString("issuer"));
+        cardDetails.setBinCountry(cardInfo.getString("country"));
 
         return cardDetails;
     }
+
+    private static InstallmentData setInstallmentData(JsonDoc installment)
+    {
+        var installmentData = new InstallmentData();
+        installmentData.setProgram(installment.getString("program"));
+        installmentData.setMode(installment.getString("mode"));
+        installmentData.setCount(installment.getString("count"));
+        installmentData.setGracePeriodCount(installment.getString("grace_period_count"));
+        return installmentData;
+    }
 }

src/main/java/com/global/api/paymentMethods/InstallmentData.java

@@ -0,0 +1,16 @@
+package com.global.api.paymentMethods;
+
+import lombok.Getter;
+import lombok.Setter;
+
+public class InstallmentData  {
+    //Indicates the installment payment plan program.
+    @Getter @Setter private String program;
+    //Indicates the mode of the Installment plan choosen
+    @Getter @Setter private String mode;
+    //Indicates the total number of payments to be made over the course of the installment payment plan.
+    @Getter @Setter private String count;
+    //Indicates the grace period before the first payment.
+    @Getter @Setter private String gracePeriodCount;
+
+}