G1222 30904 specification api changes

README.md

@@ -520,3 +520,17 @@ N] [Generate IBAN API](https://developer.mastercard.com/send-cross-border/docume
 - OI calls the service to generate the IBAN but the country is not entered in acceptable format, use case 14
 - OI calls the service to generate the IBAN but the Bank Identifier is incorrect, use case 15
 - The above use cases just shows two the examples of error handling
+
+O] [Endpoint Guide API](https://developer.mastercard.com/cross-border-services/documentation/api-ref/endpoint-guide-adapter_api/):
+
+> Case 1: **Test Endpoint Guide API for TEG data with encryption**
+- OI can call this method to get details of TEG data for a specific corridor
+- In this use case, we need to pass payment type, destination payment instrument, destination country and destination currency as request headers. A successful response would result with TEG data.
+
+> Case 2: **Error scenario**
+- OI calls the service to get TEG data but the corridor details are incorrect
+- API results in error response as resource unknown
+
+> Case 3: **Test Endpoint Guide API for BEG data with encryption**
+- OI can call this method to get details of TEG data for a specific corridor
+- In this use case, we need to pass payment type, destination payment instrument, destination country and destination currency as request headers. A successful response would result with BEG data.

src/main/java/com/mastercard/crossborder/api/config/DetailsDeserializer.java

@@ -0,0 +1,41 @@
+package com.mastercard.crossborder.api.config;
+
+import com.fasterxml.jackson.core.JsonParser;
+import com.fasterxml.jackson.core.JsonProcessingException;
+import com.fasterxml.jackson.databind.DeserializationContext;
+import com.fasterxml.jackson.databind.JsonDeserializer;
+import com.fasterxml.jackson.databind.JsonNode;
+import com.mastercard.crossborder.api.rest.response.Detail;
+import com.mastercard.crossborder.api.rest.response.Details;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.List;
+import org.springframework.context.annotation.Configuration;
+
+@Configuration
+public class DetailsDeserializer extends JsonDeserializer<Details> {
+	@Override
+	public Details deserialize(JsonParser p, DeserializationContext ctxt)
+			throws IOException, JsonProcessingException {
+		JsonNode node = p.getCodec().readTree(p);
+
+		Details details = new Details();
+
+		if (node.isArray()) {
+			// Deserialize as a list of Detail objects
+			List<Detail> detailList = new ArrayList<>();
+			for (JsonNode detailNode : node) {
+				Detail detail = p.getCodec().treeToValue(detailNode, Detail.class);
+				detailList.add(detail);
+			}
+			details.setDetails(detailList);
+		} else if (node.isObject()) {
+			// Deserialize as a single Detail object
+			Detail detail = p.getCodec().treeToValue(node, Detail.class);
+			details.setDetails(Collections.singletonList(detail));
+		}
+
+		return details;
+	}
+}

src/main/java/com/mastercard/crossborder/api/config/JacksonConfig.java

@@ -0,0 +1,21 @@
+package com.mastercard.crossborder.api.config;
+
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.fasterxml.jackson.databind.module.SimpleModule;
+import org.springframework.context.annotation.Bean;
+import org.springframework.context.annotation.Configuration;
+import com.mastercard.crossborder.api.rest.response.Details;
+import org.springframework.context.annotation.Primary;
+
+@Configuration
+public class JacksonConfig {
+	@Bean
+	@Primary
+	public ObjectMapper objectMapper() {
+		ObjectMapper objectMapper = new ObjectMapper();
+		SimpleModule module = new SimpleModule();
+		module.addDeserializer(Details.class, new DetailsDeserializer());
+		objectMapper.registerModule(module);
+		return objectMapper;
+	}
+}

src/main/java/com/mastercard/crossborder/api/constants/MastercardHttpHeaders.java

@@ -1,7 +1,10 @@
 package com.mastercard.crossborder.api.constants;
 
 public enum MastercardHttpHeaders  {
-    ENCRYPTED_HEADER("x-encrypted");
+    ENCRYPTED_HEADER("x-encrypted"),
+    PARTNER_REF_ID("Partner-Ref-Id"),
+    SPECIFICATION_TYPE("Specification-Type");
+
     private final String text;
 
     MastercardHttpHeaders(String text) {

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/EndpointGuideAdapterApi.java

@@ -0,0 +1,33 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api;
+
+import com.mastercard.crossborder.api.exception.ServiceException;
+import com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response.EndpointGuideResponse;
+import com.mastercard.crossborder.api.service.RestClientService;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.springframework.beans.factory.annotation.Autowired;
+import org.springframework.http.HttpHeaders;
+import org.springframework.http.HttpMethod;
+import org.springframework.stereotype.Component;
+
+import java.util.List;
+import java.util.Map;
+
+@Component
+public class EndpointGuideAdapterApi {
+    @Autowired
+    RestClientService restClientService; // NOSONAR
+    private static final Logger logger = LoggerFactory.getLogger(EndpointGuideAdapterApi.class);
+    public static final String ENDPOINT_GUIDE_ADAPTER_URL="crossborder/endpoint-guide/specifications?payment_type={paymentType}&destination_payment_instrument={destinationPaymentInstrument}&destination_country={destinationCountry}&destination_currency={destinationCurrency}";
+
+    public List<EndpointGuideResponse> getEndpointWithEncryption(HttpHeaders headers, Map<String, Object> requestParams) throws ServiceException {
+        logger.info("Calling Endpoint guide adapter api with encryption");
+        return (List<EndpointGuideResponse>) restClientService.serviceEncryption(ENDPOINT_GUIDE_ADAPTER_URL,headers, HttpMethod.GET, requestParams,null, List.class, true, EndpointGuideResponse.class);
+    }
+
+    public List<EndpointGuideResponse> getEndpoint(HttpHeaders headers, Map<String, Object> requestParams) throws ServiceException {
+        logger.info("Calling Endpoint guide adapter api ");
+        return (List<EndpointGuideResponse>) restClientService.service(ENDPOINT_GUIDE_ADAPTER_URL,headers, HttpMethod.GET, requestParams,null, List.class, true,EndpointGuideResponse.class);
+    }
+
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/BaseResponse.java

@@ -0,0 +1,15 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response;
+
+import com.fasterxml.jackson.annotation.JsonIgnore;
+import lombok.Getter;
+import lombok.Setter;
+import org.springframework.http.HttpStatus;
+
+@Getter
+@Setter
+public class BaseResponse {
+    @JsonIgnore
+    private String correlationId;
+    @JsonIgnore
+    private HttpStatus responseCode;
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/DestinationPaymentInstrument.java

@@ -0,0 +1,5 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response;
+
+public enum DestinationPaymentInstrument {
+    BANK, CASH, CARD, EWALLET, MWALLET, BANKWIRE
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/EndpointGuideResponse.java

@@ -0,0 +1,28 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.databind.ObjectMapper;
+import com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response.begapi.BusinessBeg;
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import lombok.SneakyThrows;
+
+
+@EqualsAndHashCode(callSuper = true)
+@Data
+@JsonInclude(JsonInclude.Include.NON_EMPTY)
+public class EndpointGuideResponse extends BaseResponse {
+    private PaymentType paymentType;
+    private String destinationCountry;
+    private String destinationCurrency;
+    private DestinationPaymentInstrument destinationPaymentInstrument;
+    private Technical technical;
+    private BusinessBeg business;
+
+    @SneakyThrows
+    @Override
+    public String toString() {
+        return new ObjectMapper().setSerializationInclusion(JsonInclude.Include.NON_EMPTY).writeValueAsString(this);
+    }
+}
+

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/Field.java

@@ -0,0 +1,132 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response;
+
+import java.util.Date;
+import java.util.List;
+import java.util.Objects;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.Data;
+
+
+
+@Data
+@JsonInclude(JsonInclude.Include.NON_DEFAULT)
+public class Field {
+    private String fieldName;
+    private String mandatory;
+    private String validationPattern;
+    private String additionalFieldId;
+    private String additionalFieldName;
+    private String specialNotes;
+    private Date effectiveDate;
+    private Date lastUpdatedTime;
+    private String lastUpdateComments;
+    private List<SupportedValues> supportedValues;
+
+    private Field(FieldBuilder fieldBuilder) {
+        this.additionalFieldId=fieldBuilder.additionalFieldId;
+        this.additionalFieldName=fieldBuilder.additionalFieldName;
+        this.fieldName=fieldBuilder.fieldName;
+        this.mandatory=fieldBuilder.mandatory;
+        this.validationPattern=fieldBuilder.validationPattern;
+        this.specialNotes=fieldBuilder.specialNotes;
+        this.effectiveDate = fieldBuilder.effectiveDate;
+        this.lastUpdatedTime = fieldBuilder.lastUpdatedTime;
+        this.lastUpdateComments = fieldBuilder.lastUpdateComments;
+        this.supportedValues=fieldBuilder.supportedValues;
+
+    }
+
+    public Field() {
+
+    }
+
+    public String getSpecialNotes() {
+        specialNotes= specialNotes!=null?specialNotes.
+                replaceAll("(?i)\\[\\s*(Payment|Quote)\\s+(Req|Resp)\\s*-\\s*[MO]\\s*\\]\\s*", "")
+                .replaceAll("\\s+", " ") // Replace multiple spaces/newlines with a single space
+                .trim():null;
+        specialNotes= specialNotes==null?"":specialNotes;
+        if (specialNotes.isEmpty()){
+            specialNotes=null;
+        }
+        return specialNotes;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o)
+            return true;
+        if (o == null || getClass() != o.getClass())
+            return false;
+        Field field = (Field) o;
+        return Objects.equals(fieldName, field.fieldName) && Objects.equals(additionalFieldId, field.additionalFieldId);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(fieldName, additionalFieldId);
+    }
+
+    public static class FieldBuilder {
+        private String fieldName;
+        private String mandatory;
+        private String validationPattern;
+        private String additionalFieldId;
+        private String additionalFieldName;
+        private String specialNotes;
+        private Date effectiveDate;
+        private Date lastUpdatedTime;
+        private String lastUpdateComments;
+        private List<SupportedValues> supportedValues;
+
+        public FieldBuilder setMandatory(String mandatory) {
+            this.mandatory = mandatory;
+            return this;
+        }
+
+        public FieldBuilder setFieldName(String fieldName) {
+            this.fieldName = fieldName;
+            return this;
+        }
+
+        public FieldBuilder setValidationPattern(String validationPattern) {
+            this.validationPattern = validationPattern;
+            return this;
+        }
+
+        public FieldBuilder setAdditionalFieldId(String additionalFieldId) {
+            this.additionalFieldId = additionalFieldId;
+            return this;
+        }
+
+        public FieldBuilder setAdditionalFieldName(String additionalFieldName) {
+            this.additionalFieldName = additionalFieldName;
+            return this;
+        }
+
+        public FieldBuilder setSpecialNotes(String specialNotes) {
+            this.specialNotes = specialNotes;
+            return this;
+        }
+        public void setEffectiveDate(Date effectiveDate) {
+            this.effectiveDate = effectiveDate;
+        }
+        public void setLastUpdatedTime(Date lastUpdatedTime) {
+            this.lastUpdatedTime = lastUpdatedTime;
+        }
+
+        public void setLastUpdateComments(String lastUpdateComments) {
+            this.lastUpdateComments = lastUpdateComments;
+        }
+
+        public FieldBuilder setSupportedValues(List<SupportedValues> supportedValues) {
+            this.supportedValues = supportedValues;
+            return this;
+        }
+
+        public Field build() {
+            return new Field(this);
+        }
+    }
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/PaymentType.java

@@ -0,0 +1,5 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response;
+
+public enum PaymentType {
+    B2P, B2B, G2P, P2P, P2B
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/SupportedValues.java

@@ -0,0 +1,12 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response;
+
+import lombok.Getter;
+import lombok.Setter;
+
+@Setter
+@Getter
+public class SupportedValues {
+
+    private String id;
+    private String name;
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/Technical.java

@@ -0,0 +1,13 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import java.util.List;
+import lombok.Data;
+
+@Data
+@JsonInclude(JsonInclude.Include.NON_EMPTY)
+public class Technical {
+    private String specialNotes;
+    private String lastUpdatedTime;
+    private List<Field> fields;
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/begapi/AmountDTO.java

@@ -0,0 +1,11 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response.begapi;
+
+import lombok.Data;
+import org.springframework.stereotype.Component;
+
+@Data
+@Component
+public class AmountDTO {
+    private double value;
+    private String currency;
+}

src/main/java/com/mastercard/crossborder/api/rest/endpoint/guide/adapter/api/response/begapi/BegFieldDTO.java

@@ -0,0 +1,26 @@
+package com.mastercard.crossborder.api.rest.endpoint.guide.adapter.api.response.begapi;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import lombok.Data;
+
+@Data
+@JsonInclude(JsonInclude.Include.NON_EMPTY)
+public class BegFieldDTO {
+
+    private String begFieldMappingId;
+    private String endPointId;
+    private String region;
+    private Boolean recipientNotification;
+    private String channelReach;
+    private String deliveryTime;
+    private String notes;
+    private String country;
+    private String channels;
+    private String onTheFlyWalletCreation;
+    private String registrationRequirements;
+    private Boolean isInternal;
+    //Need to do its mapping from the RSD API Response
+    private String serviceType;
+    private String paymentType;
+    private String destinationCurrency;
+}