Release 8.2.1

Author: wallee-deployment-user

README.md

@@ -21,7 +21,7 @@ Add this dependency to your project's POM:
 <dependency>
     <groupId>ch.postfinance</groupId>
     <artifactId>postfinancecheckout-java-sdk</artifactId>
-    <version>8.0.0</version>
+    <version>8.2.1</version>
     <scope>compile</scope>
 </dependency>
 ```
@@ -31,7 +31,7 @@ Add this dependency to your project's POM:
 Add this dependency to your project's build file:
 
 ```groovy
-compile "ch.postfinance:postfinancecheckout-java-sdk:8.0.0"
+compile "ch.postfinance:postfinancecheckout-java-sdk:8.2.1"
 ```
 
 ### Others
@@ -44,7 +44,7 @@ mvn clean package
 
 Then manually install the following JARs:
 
-* `target/postfinancecheckout-java-sdk-8.0.0.jar`
+* `target/postfinancecheckout-java-sdk-8.2.1.jar`
 * `target/lib/*.jar`
 
 ## Usage

build.gradle

@@ -2,7 +2,7 @@ apply plugin: 'idea'
 apply plugin: 'eclipse'
 
 group = 'ch.postfinance'
-version = '8.0.0'
+version = '8.2.1'
 
 buildscript {
     repositories {

pom.xml

@@ -5,7 +5,7 @@
     <artifactId>postfinancecheckout-java-sdk</artifactId>
     <packaging>jar</packaging>
     <name>postfinancecheckout-java-sdk</name>
-    <version>8.0.0</version>
+    <version>8.2.1</version>
     <url>https://postfinance.ch/en/business/products/e-commerce/postfinance-checkout-all-in-one.html</url>
     <description>The SDK for simplifying the integration with PostFinance Checkout API.</description>
     <scm>

src/main/java/ch/postfinance/sdk/DefaultHeaders.java

@@ -34,7 +34,7 @@ public void intercept(HttpRequest request) throws IOException {
 
     private HttpHeaders getDefaultHeaders() {
         HttpHeaders headers = new HttpHeaders();
-        headers.put("x-meta-sdk-version", "8.0.0");
+        headers.put("x-meta-sdk-version", "8.2.1");
         headers.put("x-meta-sdk-language", "java");
         headers.put("x-meta-sdk-provider", "PostFinance Checkout");
         headers.put("x-meta-sdk-language-version", System.getProperty("java.version"));

src/main/java/ch/postfinance/sdk/model/AbstractTokenUpdate.java

@@ -66,10 +66,10 @@ public AbstractTokenUpdate customerEmailAddress(String customerEmailAddress) {
   }
 
    /**
-   * The customer email address is the email address of the customer.
+   * The customer's email address.
    * @return customerEmailAddress
   **/
-  @ApiModelProperty(value = "The customer email address is the email address of the customer.")
+  @ApiModelProperty(value = "The customer's email address.")
   public String getCustomerEmailAddress() {
     return customerEmailAddress;
   }
@@ -85,10 +85,10 @@ public AbstractTokenUpdate customerId(String customerId) {
   }
 
    /**
-   * The customer ID identifies the customer in the merchant system. In case the customer ID has been provided it has to correspond with the customer ID provided on the transaction. The customer ID will not be changed automatically. The merchant system has to provide it.
+   * The unique identifier of the customer in the external system.
    * @return customerId
   **/
-  @ApiModelProperty(value = "The customer ID identifies the customer in the merchant system. In case the customer ID has been provided it has to correspond with the customer ID provided on the transaction. The customer ID will not be changed automatically. The merchant system has to provide it.")
+  @ApiModelProperty(value = "The unique identifier of the customer in the external system.")
   public String getCustomerId() {
     return customerId;
   }
@@ -104,10 +104,10 @@ public AbstractTokenUpdate enabledForOneClickPayment(Boolean enabledForOneClickP
   }
 
    /**
-   * When a token is enabled for one-click payments the buyer will be able to select the token within the iFrame or on the payment page to pay with the token. The usage of the token will reduce the number of steps the buyer has to go through. The buyer is linked via the customer ID on the transaction with the token. Means the token will be visible for buyers with the same customer ID. Additionally the payment method has to be configured to allow the one-click payments.
+   * Whether the token is enabled for one-click payments, which simplify the payment process for the customer. One-click tokens are linked to customers via the customer ID.
    * @return enabledForOneClickPayment
   **/
-  @ApiModelProperty(value = "When a token is enabled for one-click payments the buyer will be able to select the token within the iFrame or on the payment page to pay with the token. The usage of the token will reduce the number of steps the buyer has to go through. The buyer is linked via the customer ID on the transaction with the token. Means the token will be visible for buyers with the same customer ID. Additionally the payment method has to be configured to allow the one-click payments.")
+  @ApiModelProperty(value = "Whether the token is enabled for one-click payments, which simplify the payment process for the customer. One-click tokens are linked to customers via the customer ID.")
   public Boolean isEnabledForOneClickPayment() {
     return enabledForOneClickPayment;
   }
@@ -142,10 +142,10 @@ public AbstractTokenUpdate timeZone(String timeZone) {
   }
 
    /**
-   * The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.
+   * The customer's time zone, which affects how dates and times are formatted when communicating with the customer.
    * @return timeZone
   **/
-  @ApiModelProperty(value = "The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.")
+  @ApiModelProperty(value = "The customer's time zone, which affects how dates and times are formatted when communicating with the customer.")
   public String getTimeZone() {
     return timeZone;
   }
@@ -161,10 +161,10 @@ public AbstractTokenUpdate tokenReference(String tokenReference) {
   }
 
    /**
-   * Use something that it is easy to identify and may help you find the token (e.g. customer id, email address).
+   * The reference used to identify the payment token (e.g. the customer's ID or email address).
    * @return tokenReference
   **/
-  @ApiModelProperty(value = "Use something that it is easy to identify and may help you find the token (e.g. customer id, email address).")
+  @ApiModelProperty(value = "The reference used to identify the payment token (e.g. the customer's ID or email address).")
   public String getTokenReference() {
     return tokenReference;
   }

src/main/java/ch/postfinance/sdk/model/AbstractTransactionPending.java

@@ -134,10 +134,10 @@ public AbstractTransactionPending addAllowedPaymentMethodBrandsItem(Long allowed
   }
 
    /**
-   * 
+   * The payment method brands that can be used to authorize the transaction.
    * @return allowedPaymentMethodBrands
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The payment method brands that can be used to authorize the transaction.")
   public List<Long> getAllowedPaymentMethodBrands() {
     return allowedPaymentMethodBrands;
   }
@@ -161,10 +161,10 @@ public AbstractTransactionPending addAllowedPaymentMethodConfigurationsItem(Long
   }
 
    /**
-   * 
+   * The payment method configurations that can be used to authorize the transaction.
    * @return allowedPaymentMethodConfigurations
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The payment method configurations that can be used to authorize the transaction.")
   public List<Long> getAllowedPaymentMethodConfigurations() {
     return allowedPaymentMethodConfigurations;
   }
@@ -180,10 +180,10 @@ public AbstractTransactionPending billingAddress(AddressCreate billingAddress) {
   }
 
    /**
-   * 
+   * The address associated with the payment method for invoicing and transaction processing purposes.
    * @return billingAddress
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The address associated with the payment method for invoicing and transaction processing purposes.")
   public AddressCreate getBillingAddress() {
     return billingAddress;
   }
@@ -199,10 +199,10 @@ public AbstractTransactionPending completionBehavior(TransactionCompletionBehavi
   }
 
    /**
-   * The completion behavior controls when the transaction is completed.
+   * The behavior that controls when the transaction is completed.
    * @return completionBehavior
   **/
-  @ApiModelProperty(value = "The completion behavior controls when the transaction is completed.")
+  @ApiModelProperty(value = "The behavior that controls when the transaction is completed.")
   public TransactionCompletionBehavior getCompletionBehavior() {
     return completionBehavior;
   }
@@ -218,10 +218,10 @@ public AbstractTransactionPending currency(String currency) {
   }
 
    /**
-   * 
+   * The three-letter code (ISO 4217 format) of the transaction&#39;s currency.
    * @return currency
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The three-letter code (ISO 4217 format) of the transaction's currency.")
   public String getCurrency() {
     return currency;
   }
@@ -237,10 +237,10 @@ public AbstractTransactionPending customerEmailAddress(String customerEmailAddre
   }
 
    /**
-   * The customer email address is the email address of the customer. If no email address is provided on the shipping or billing address this address is used.
+   * The customer&#39;s email address.
    * @return customerEmailAddress
   **/
-  @ApiModelProperty(value = "The customer email address is the email address of the customer. If no email address is provided on the shipping or billing address this address is used.")
+  @ApiModelProperty(value = "The customer's email address.")
   public String getCustomerEmailAddress() {
     return customerEmailAddress;
   }
@@ -256,10 +256,10 @@ public AbstractTransactionPending customerId(String customerId) {
   }
 
    /**
-   * 
+   * The unique identifier of the customer in the external system.
    * @return customerId
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The unique identifier of the customer in the external system.")
   public String getCustomerId() {
     return customerId;
   }
@@ -275,10 +275,10 @@ public AbstractTransactionPending failedUrl(String failedUrl) {
   }
 
    /**
-   * The user will be redirected to failed URL when the transaction could not be authorized or completed. In case no failed URL is specified a default failed page will be displayed.
+   * The URL to redirect the customer back to after they canceled or failed to authenticated their payment.
    * @return failedUrl
   **/
-  @ApiModelProperty(value = "The user will be redirected to failed URL when the transaction could not be authorized or completed. In case no failed URL is specified a default failed page will be displayed.")
+  @ApiModelProperty(value = "The URL to redirect the customer back to after they canceled or failed to authenticated their payment.")
   public String getFailedUrl() {
     return failedUrl;
   }
@@ -294,10 +294,10 @@ public AbstractTransactionPending invoiceMerchantReference(String invoiceMerchan
   }
 
    /**
-   * 
+   * The merchant&#39;s reference used to identify the invoice.
    * @return invoiceMerchantReference
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The merchant's reference used to identify the invoice.")
   public String getInvoiceMerchantReference() {
     return invoiceMerchantReference;
   }
@@ -340,10 +340,10 @@ public AbstractTransactionPending addLineItemsItem(LineItemCreate lineItemsItem)
   }
 
    /**
-   * 
+   * The line items purchased by the customer.
    * @return lineItems
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The line items purchased by the customer.")
   public List<LineItemCreate> getLineItems() {
     return lineItems;
   }
@@ -359,10 +359,10 @@ public AbstractTransactionPending merchantReference(String merchantReference) {
   }
 
    /**
-   * 
+   * The merchant&#39;s reference used to identify the transaction.
    * @return merchantReference
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The merchant's reference used to identify the transaction.")
   public String getMerchantReference() {
     return merchantReference;
   }
@@ -405,10 +405,10 @@ public AbstractTransactionPending shippingAddress(AddressCreate shippingAddress)
   }
 
    /**
-   * 
+   * The address to where the order will be shipped.
    * @return shippingAddress
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The address to where the order will be shipped.")
   public AddressCreate getShippingAddress() {
     return shippingAddress;
   }
@@ -424,10 +424,10 @@ public AbstractTransactionPending shippingMethod(String shippingMethod) {
   }
 
    /**
-   * 
+   * The name of the shipping method used to ship the products.
    * @return shippingMethod
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The name of the shipping method used to ship the products.")
   public String getShippingMethod() {
     return shippingMethod;
   }
@@ -443,10 +443,10 @@ public AbstractTransactionPending successUrl(String successUrl) {
   }
 
    /**
-   * The user will be redirected to success URL when the transaction could be authorized or completed. In case no success URL is specified a default success page will be displayed.
+   * The URL to redirect the customer back to after they successfully authenticated their payment.
    * @return successUrl
   **/
-  @ApiModelProperty(value = "The user will be redirected to success URL when the transaction could be authorized or completed. In case no success URL is specified a default success page will be displayed.")
+  @ApiModelProperty(value = "The URL to redirect the customer back to after they successfully authenticated their payment.")
   public String getSuccessUrl() {
     return successUrl;
   }
@@ -462,10 +462,10 @@ public AbstractTransactionPending timeZone(String timeZone) {
   }
 
    /**
-   * The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.
+   * The customer&#39;s time zone, which affects how dates and times are formatted when communicating with the customer.
    * @return timeZone
   **/
-  @ApiModelProperty(value = "The time zone defines in which time zone the customer is located in. The time zone may affects how dates are formatted when interacting with the customer.")
+  @ApiModelProperty(value = "The customer's time zone, which affects how dates and times are formatted when communicating with the customer.")
   public String getTimeZone() {
     return timeZone;
   }
@@ -481,10 +481,10 @@ public AbstractTransactionPending token(Long token) {
   }
 
    /**
-   * 
+   * The payment token that should be used to charge the customer.
    * @return token
   **/
-  @ApiModelProperty(value = "")
+  @ApiModelProperty(value = "The payment token that should be used to charge the customer.")
   public Long getToken() {
     return token;
   }
@@ -500,10 +500,10 @@ public AbstractTransactionPending tokenizationMode(TokenizationMode tokenization
   }
 
    /**
-   * The tokenization mode controls if and how the tokenization of payment information is applied to the transaction.
+   * The tokenization mode specifies whether and how the tokenization of payment information is applied to the transaction.
    * @return tokenizationMode
   **/
-  @ApiModelProperty(value = "The tokenization mode controls if and how the tokenization of payment information is applied to the transaction.")
+  @ApiModelProperty(value = "The tokenization mode specifies whether and how the tokenization of payment information is applied to the transaction.")
   public TokenizationMode getTokenizationMode() {
     return tokenizationMode;
   }

src/main/java/ch/postfinance/sdk/model/AbstractWebhookListenerUpdate.java

@@ -65,10 +65,10 @@ public AbstractWebhookListenerUpdate enablePayloadSignatureAndState(Boolean enab
   }
 
    /**
-   * Whether signature header and state property are enabled in webhook payload.
+   * Whether signature header and 'state' property are enabled in webhook payload.
    * @return enablePayloadSignatureAndState
   **/
-  @ApiModelProperty(value = "Whether signature header and state property are enabled in webhook payload.")
+  @ApiModelProperty(value = "Whether signature header and 'state' property are enabled in webhook payload.")
   public Boolean isEnablePayloadSignatureAndState() {
     return enablePayloadSignatureAndState;
   }