Release 6.40.0.

.github/workflows/api-docs.yml

@@ -0,0 +1,56 @@
+name: API docs
+
+on:
+  push:
+    tags: ['[0-9]+.[0-9]+*']
+
+permissions:
+  contents: write
+
+jobs:
+  api-docs:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v3
+        with:
+          path: code
+          persist-credentials: false
+      - name: Setup Java
+        uses: actions/setup-java@v3
+        with:
+          java-version: '8'
+          distribution: 'temurin'
+          cache: 'maven'
+      - name: Build API docs
+        run: mvn javadoc:javadoc -Dnotimestamp
+        working-directory: code
+      - name: Checkout pages
+        uses: actions/checkout@v3
+        with:
+          ref: gh-pages
+          path: pages
+      - name: Deploy pages
+        run: |
+          SDK_VERSION_FOLDER=`echo "$SDK_VERSION" | awk --field-separator '.' '{print $1".x";}'`
+
+          # Create .nojekyll if it doesn't exist yet
+          touch .nojekyll
+
+          mkdir -p "apidocs/$SDK_VERSION_FOLDER"
+          rsync --quiet --archive --checksum --delete --exclude .git ../code/target/site/apidocs/ "apidocs/$SDK_VERSION_FOLDER/"
+          if [ -e apidocs/latest ]; then rm -r apidocs/latest; fi
+          pushd apidocs && ln -s "$SDK_VERSION_FOLDER" latest && popd
+
+          git config user.email "$USER_EMAIL"
+          git config user.name "$USER_NAME"
+          git add --all .
+          # Only commit when there are changes
+          git diff --quiet && git diff --staged --quiet || git commit --message "Generated API docs for version ${SDK_VERSION}"
+          git push
+        shell: bash
+        working-directory: pages
+        env:
+          SDK_VERSION: ${{ github.ref_name }}
+          USER_EMAIL: ${{ github.event.pusher.email }}
+          USER_NAME: ${{ github.event.pusher.name }}

pom.xml

@@ -5,7 +5,7 @@
 
 	<groupId>com.ingenico.connect.gateway</groupId>
 	<artifactId>connect-sdk-java</artifactId>
-	<version>6.39.0</version>
+	<version>6.40.0</version>
 	<packaging>jar</packaging>
 
 	<name>connect-sdk-java</name>

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/hostedcheckout/definitions/CreatedPaymentOutput.java

@@ -14,6 +14,8 @@ public class CreatedPaymentOutput {
 
 	private DisplayedData displayedData = null;
 
+	private Boolean isCheckedRememberMe = null;
+
 	private Payment payment = null;
 
 	private PaymentCreationReferences paymentCreationReferences = null;
@@ -38,6 +40,20 @@ public void setDisplayedData(DisplayedData value) {
 		this.displayedData = value;
 	}
 
+	/**
+	 * Indicates whether the customer ticked the "Remember my details for future purchases" checkbox on the MyCheckout hosted payment pages
+	 */
+	public Boolean getIsCheckedRememberMe() {
+		return isCheckedRememberMe;
+	}
+
+	/**
+	 * Indicates whether the customer ticked the "Remember my details for future purchases" checkbox on the MyCheckout hosted payment pages
+	 */
+	public void setIsCheckedRememberMe(Boolean value) {
+		this.isCheckedRememberMe = value;
+	}
+
 	/**
 	 * Object that holds the payment data
 	 */

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/payment/definitions/CardPaymentMethodSpecificInput.java

@@ -23,14 +23,14 @@ public class CardPaymentMethodSpecificInput extends AbstractCardPaymentMethodSpe
 	private ThreeDSecure threeDSecure = null;
 
 	/**
-	 * Object containing card details
+	 * Object containing card details. The card details will be ignored in case the property <span class="property">networkTokenData is present.</span>
 	 */
 	public Card getCard() {
 		return card;
 	}
 
 	/**
-	 * Object containing card details
+	 * Object containing card details. The card details will be ignored in case the property <span class="property">networkTokenData is present.</span>
 	 */
 	public void setCard(Card value) {
 		this.card = value;

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/payment/definitions/CardRecurrenceDetails.java

@@ -41,8 +41,9 @@ public void setMinFrequency(Integer value) {
 	}
 
 	/**
-	 * <ul class="paragraph-width"><li>first = This transaction is the first of a series of recurring transactions
-	 * <li>recurring = This transaction is a subsequent transaction in a series of recurring transactions
+	 * <ul class="paragraph-width"><li>first = This transaction is the first of a series of recurring transactions</li>
+	 * <li>recurring = This transaction is a subsequent transaction in a series of recurring transactions</li>
+	 * <li>last = This transaction is the last of a series of recurring transactions for payments that are processed by the WL Online Payment Acceptance platform</li>
 	 * </ul><br>
 	 * Note: For any first of a recurring the system will automatically create a token as you will need to use a token for any subsequent recurring transactions. In case a token already exists this is indicated in the response with a value of False for the isNewToken property in the response.
 	 */
@@ -51,8 +52,9 @@ public String getRecurringPaymentSequenceIndicator() {
 	}
 
 	/**
-	 * <ul class="paragraph-width"><li>first = This transaction is the first of a series of recurring transactions
-	 * <li>recurring = This transaction is a subsequent transaction in a series of recurring transactions
+	 * <ul class="paragraph-width"><li>first = This transaction is the first of a series of recurring transactions</li>
+	 * <li>recurring = This transaction is a subsequent transaction in a series of recurring transactions</li>
+	 * <li>last = This transaction is the last of a series of recurring transactions for payments that are processed by the WL Online Payment Acceptance platform</li>
 	 * </ul><br>
 	 * Note: For any first of a recurring the system will automatically create a token as you will need to use a token for any subsequent recurring transactions. In case a token already exists this is indicated in the response with a value of False for the isNewToken property in the response.
 	 */

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/payment/definitions/Installments.java

@@ -23,15 +23,15 @@ public class Installments {
 
 	/**
 	 * The amount that will be paid per installment. The total amount of amountOfMoneyPerInstallment x numberOfInstallments can not be higher than the total amount of this transaction, although we will not validate that.<br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), this property is not used as the value is decided by the issuer.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), this property is not used as the value is decided by the issuer.
 	 */
 	public AmountOfMoney getAmountOfMoneyPerInstallment() {
 		return amountOfMoneyPerInstallment;
 	}
 
 	/**
 	 * The amount that will be paid per installment. The total amount of amountOfMoneyPerInstallment x numberOfInstallments can not be higher than the total amount of this transaction, although we will not validate that.<br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), this property is not used as the value is decided by the issuer.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), this property is not used as the value is decided by the issuer.
 	 */
 	public void setAmountOfMoneyPerInstallment(AmountOfMoney value) {
 		this.amountOfMoneyPerInstallment = value;
@@ -46,7 +46,7 @@ public void setAmountOfMoneyPerInstallment(AmountOfMoney value) {
 	 * <li>monthly (default)
 	 * <li>quarterly
 	 * </ul><br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), only the value monthly is valid.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), only the value monthly is valid.
 	 */
 	public String getFrequencyOfInstallments() {
 		return frequencyOfInstallments;
@@ -61,7 +61,7 @@ public String getFrequencyOfInstallments() {
 	 * <li>monthly (default)
 	 * <li>quarterly
 	 * </ul><br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), only the value monthly is valid.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), only the value monthly is valid.
 	 */
 	public void setFrequencyOfInstallments(String value) {
 		this.frequencyOfInstallments = value;
@@ -95,31 +95,31 @@ public void setInstallmentPlanCode(Integer value) {
 
 	/**
 	 * The interest rate paid for installments expressed in percentage. So for example 5.75 means 5.75%<br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), this property is not used as the value is decided by the issuer.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), this property is not used as the value is decided by the issuer.
 	 */
 	public String getInterestRate() {
 		return interestRate;
 	}
 
 	/**
 	 * The interest rate paid for installments expressed in percentage. So for example 5.75 means 5.75%<br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), this property is not used as the value is decided by the issuer.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), this property is not used as the value is decided by the issuer.
 	 */
 	public void setInterestRate(String value) {
 		this.interestRate = value;
 	}
 
 	/**
 	 * The number of installments in which this transaction will be paid, which can be used for card payments at supported acquirers, or with specific payment products. Only used with some acquirers. In case you send in the details of this object, only the payment products (or  combination of card products and acquirers) that support installments will be shown on the MyCheckout hosted payment pages. If this property is not provided the customer will not see details on the installment plan in a HostedCheckout.<br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), there is a maximum of 12 installments.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), there is a maximum of 12 installments.
 	 */
 	public Long getNumberOfInstallments() {
 		return numberOfInstallments;
 	}
 
 	/**
 	 * The number of installments in which this transaction will be paid, which can be used for card payments at supported acquirers, or with specific payment products. Only used with some acquirers. In case you send in the details of this object, only the payment products (or  combination of card products and acquirers) that support installments will be shown on the MyCheckout hosted payment pages. If this property is not provided the customer will not see details on the installment plan in a HostedCheckout.<br>
-	 * For the payment product IDs 8590 (BC Card), 8591 (KEB Hana Card), 8592 (Hyundai Card), 8593 (KB Kookmin Card), 8594 (Lotte Card), 8595 (NH Card), 8596 (Samsung Card) or 8597 (Shinhan Card), there is a maximum of 12 installments.
+	 * For the payment product IDs BC Card (paymentProductId 8590), Hana Card (paymentProductId 8591), Hyundai Card (paymentProductId 8592), KB Card (paymentProductId 8593), Lotte Card (paymentProductId 8594), NH Card (paymentProductId 8595), Samsung Card (paymentProductId 8596) and Shinhan Card (paymentProductId 8597), there is a maximum of 12 installments.
 	 */
 	public void setNumberOfInstallments(Long value) {
 		this.numberOfInstallments = value;

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/payment/definitions/PaymentCreationOutput.java

@@ -6,12 +6,28 @@
 
 public class PaymentCreationOutput extends PaymentCreationReferences {
 
+	private Boolean isCheckedRememberMe = null;
+
 	private Boolean isNewToken = null;
 
 	private String token = null;
 
 	private Boolean tokenizationSucceeded = null;
 
+	/**
+	 * Indicates whether the customer ticked the "Remember my details for future purchases" checkbox on the MyCheckout hosted payment pages
+	 */
+	public Boolean getIsCheckedRememberMe() {
+		return isCheckedRememberMe;
+	}
+
+	/**
+	 * Indicates whether the customer ticked the "Remember my details for future purchases" checkbox on the MyCheckout hosted payment pages
+	 */
+	public void setIsCheckedRememberMe(Boolean value) {
+		this.isCheckedRememberMe = value;
+	}
+
 	/**
 	 * Indicates if a new token was created
 	 * <ul class="paragraph-width">

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/payment/definitions/PaymentReferences.java

@@ -14,6 +14,8 @@ public class PaymentReferences {
 
 	private String providerId = null;
 
+	private String providerMerchantId = null;
+
 	private String providerReference = null;
 
 	private String referenceOrigPayment = null;
@@ -74,6 +76,20 @@ public void setProviderId(String value) {
 		this.providerId = value;
 	}
 
+	/**
+	 * Provides an additional means of reconciliation, this is the MerchantId used at the provider
+	 */
+	public String getProviderMerchantId() {
+		return providerMerchantId;
+	}
+
+	/**
+	 * Provides an additional means of reconciliation, this is the MerchantId used at the provider
+	 */
+	public void setProviderMerchantId(String value) {
+		this.providerMerchantId = value;
+	}
+
 	/**
 	 * Provides an additional means of reconciliation for Gateway merchants
 	 */

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/payment/definitions/PaymentStatusOutput.java

@@ -4,6 +4,9 @@
  */
 package com.ingenico.connect.gateway.sdk.java.domain.payment.definitions;
 
+import java.util.List;
+
+import com.ingenico.connect.gateway.sdk.java.domain.definitions.KeyValuePair;
 import com.ingenico.connect.gateway.sdk.java.domain.definitions.OrderStatusOutput;
 
 public class PaymentStatusOutput extends OrderStatusOutput {
@@ -14,6 +17,8 @@ public class PaymentStatusOutput extends OrderStatusOutput {
 
 	private Boolean isRetriable = null;
 
+	private List<KeyValuePair> providerRawOutput = null;
+
 	private String threeDSecureStatus = null;
 
 	/**
@@ -76,6 +81,20 @@ public void setIsRetriable(Boolean value) {
 		this.isRetriable = value;
 	}
 
+	/**
+	 * This is the raw response returned by the acquirer. This property contains unprocessed data directly returned by the acquirer. It's recommended for data analysis only due to its dynamic nature, which may undergo future changes.
+	 */
+	public List<KeyValuePair> getProviderRawOutput() {
+		return providerRawOutput;
+	}
+
+	/**
+	 * This is the raw response returned by the acquirer. This property contains unprocessed data directly returned by the acquirer. It's recommended for data analysis only due to its dynamic nature, which may undergo future changes.
+	 */
+	public void setProviderRawOutput(List<KeyValuePair> value) {
+		this.providerRawOutput = value;
+	}
+
 	/**
 	 * The 3D Secure status, with the following possible values:
 	 * <ul class="paragraph-width"><li>ENROLLED: the card is enrolled for 3D Secure authentication. The customer can be redirected to a 3D Secure access control server (ACS)

src/main/generated/com/ingenico/connect/gateway/sdk/java/domain/payment/definitions/SchemeTokenData.java

@@ -6,6 +6,8 @@
 
 public class SchemeTokenData {
 
+	private String cardholderName = null;
+
 	private String cryptogram = null;
 
 	private String eci = null;
@@ -14,6 +16,20 @@ public class SchemeTokenData {
 
 	private String tokenExpiryDate = null;
 
+	/**
+	 * The cardholder's name on the card
+	 */
+	public String getCardholderName() {
+		return cardholderName;
+	}
+
+	/**
+	 * The cardholder's name on the card
+	 */
+	public void setCardholderName(String value) {
+		this.cardholderName = value;
+	}
+
 	/**
 	 * The Token Cryptogram is a dynamic one-time use value that is used to verify the authenticity of the transaction and the integrity of the data used in the generation of the Token Cryptogram. Visa calls this the Token Authentication Verification Value (TAVV) cryptogram.
 	 */

src/main/java/com/ingenico/connect/gateway/sdk/java/MetaDataProvider.java

@@ -19,7 +19,7 @@
  */
 public class MetaDataProvider {
 
-	private static final String SDK_VERSION = "6.39.0";
+	private static final String SDK_VERSION = "6.40.0";
 
 	private static final String SERVER_META_INFO_HEADER = "X-GCS-ServerMetaInfo";
 	static final Set<String> PROHIBITED_HEADERS;