Added Terminals API

Author: Wout Schoovaerts

CHANGELOG.md

@@ -1,6 +1,8 @@
-## 4.2.2
+## 4.3.0
+ - Added Terminals API
  - Added parameters "description" and "countriesOfActivity" to ProfileRequest
  - Added parameters "description" and "countriesOfActivity" to UpdateProfileRequest
+ - Use DELETE instead of POST for revoking tokens
 
 ## 4.2.1
 - Added extra fields to AddressRequest

README.md

@@ -20,7 +20,7 @@ This library requires Java 11+.
 <dependency>
     <groupId>be.woutschoovaerts</groupId>
     <artifactId>mollie</artifactId>
-    <version>4.2.1</version>
+    <version>4.3.0</version>
 </dependency>
 ```
 

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>be.woutschoovaerts</groupId>
     <artifactId>mollie</artifactId>
-    <version>4.2.1</version>
+    <version>4.3.0</version>
 
     <name>Mollie with Java</name>
     <description>Java framework to consume the Mollie API</description>

src/main/java/be/woutschoovaerts/mollie/Client.java

@@ -276,6 +276,15 @@ public ClientHandler clients() {
         return new ClientHandler(restService);
     }
 
+    /**
+     * Handles terminal actions
+     *
+     * @return TerminalHandler object
+     */
+    public TerminalHandler terminals() {
+        return new TerminalHandler(restService);
+    }
+
     private void initUniRest(ClientProxy proxy) {
         Unirest.config()
             .setObjectMapper(new JacksonObjectMapper());

src/main/java/be/woutschoovaerts/mollie/data/payment/PaymentMethod.java

@@ -28,7 +28,8 @@ public enum PaymentMethod {
     PRZELEWY24("przelewy24"),
     SOFORT("sofort"),
     TWINT("twint"),
-    VOUCHER("voucher");
+    VOUCHER("voucher"),
+    POINT_OFF_SALE("pointofsale");
 
     private final String value;
 

src/main/java/be/woutschoovaerts/mollie/data/payment/TerminalLinks.java

@@ -0,0 +1,18 @@
+package be.woutschoovaerts.mollie.data.payment;
+
+import be.woutschoovaerts.mollie.data.common.Link;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+@Builder
+public class TerminalLinks {
+
+    private Link self;
+
+    private Link documentation;
+}

src/main/java/be/woutschoovaerts/mollie/data/payment/TerminalListResponse.java

@@ -0,0 +1,17 @@
+package be.woutschoovaerts.mollie.data.payment;
+
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.util.List;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+@Builder
+public class TerminalListResponse {
+
+    private List<TerminalResponse> terminals;
+}

src/main/java/be/woutschoovaerts/mollie/data/payment/TerminalResponse.java

@@ -0,0 +1,39 @@
+package be.woutschoovaerts.mollie.data.payment;
+
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.AllArgsConstructor;
+import lombok.Builder;
+import lombok.Data;
+import lombok.NoArgsConstructor;
+
+import java.time.OffsetDateTime;
+
+@Data
+@AllArgsConstructor
+@NoArgsConstructor
+@Builder
+public class TerminalResponse {
+
+    private String id;
+
+    private String profileId;
+
+    private String description;
+
+    private TerminalStatus status;
+
+    private String brand;
+
+    private String model;
+
+    private String serialNumber;
+
+    private String currency;
+
+    private OffsetDateTime createdAt;
+
+    private OffsetDateTime updatedAt;
+
+    @JsonProperty("_links")
+    private TerminalLinks links;
+}

src/main/java/be/woutschoovaerts/mollie/data/payment/TerminalStatus.java

@@ -0,0 +1,14 @@
+package be.woutschoovaerts.mollie.data.payment;
+
+import com.fasterxml.jackson.annotation.JsonValue;
+
+public enum TerminalStatus {
+    PENDING,
+    ACTIVE,
+    INACTIVE;
+
+    @JsonValue
+    public String getJsonValue() {
+        return name().toLowerCase().replace('_', '-');
+    }
+}

src/main/java/be/woutschoovaerts/mollie/handler/payments/TerminalHandler.java

@@ -0,0 +1,66 @@
+package be.woutschoovaerts.mollie.handler.payments;
+
+import be.woutschoovaerts.mollie.data.common.Pagination;
+import be.woutschoovaerts.mollie.data.payment.TerminalListResponse;
+import be.woutschoovaerts.mollie.data.payment.TerminalResponse;
+import be.woutschoovaerts.mollie.exception.MollieException;
+import be.woutschoovaerts.mollie.util.RestService;
+import com.fasterxml.jackson.core.type.TypeReference;
+import kong.unirest.UnirestException;
+import lombok.RequiredArgsConstructor;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+
+import java.io.IOException;
+
+/**
+ * Handles the Terminal API <a href="https://docs.mollie.com/reference/v2/terminals-api/overview">Mollie docs</a>
+ *
+ * @author Wout Schoovaerts
+ */
+// TODO: Integration test once it's out of BETA
+@RequiredArgsConstructor
+public class TerminalHandler {
+    private static final Logger log = LoggerFactory.getLogger(TerminalHandler.class);
+
+    private static final TypeReference<Pagination<TerminalListResponse>> TERMINALS_LIST_RESPONSE_TYPE = new TypeReference<>() {
+    };
+
+    private static final TypeReference<TerminalResponse> TERMINAL_RESPONSE_TYPE = new TypeReference<>() {
+    };
+
+    private final RestService restService;
+
+    /**
+     * With this endpoint you can retrieve a list of terminals symbolizing the physical devices that you have received from us. In the list you can find all the terminals linked to your organization or profile, ordered from newest to oldest.
+     *
+     * @return List response of TerminalListResponse objects
+     * @throws MollieException when something went wrong
+     */
+    public Pagination<TerminalListResponse> listTerminals() throws MollieException {
+        try {
+            String uri = "/terminals";
+            return restService.get(uri, TERMINALS_LIST_RESPONSE_TYPE);
+        } catch (UnirestException | IOException ex) {
+            log.error("An unexpected exception occurred", ex);
+            throw new MollieException(ex);
+        }
+    }
+
+
+    /**
+     * With this endpoint you can retrieve a single terminal object by its terminal ID. This terminal object symbolizes the physical device that you have received from us. This endpoint is not publicly available yet — please reach out to your account manager to sign up for early access.
+     *
+     * @param id The terminal id
+     * @throws MollieException when something went wrong
+     */
+    public TerminalResponse getTerminal(String id) throws MollieException {
+        try {
+            String uri = "/terminals/" + id;
+            return restService.get(uri, TERMINAL_RESPONSE_TYPE);
+        } catch (UnirestException | IOException ex) {
+            log.error("An unexpected exception occurred", ex);
+            throw new MollieException(ex);
+        }
+    }
+}