Skip to content

Commit c0400ce

Browse files
gnongsiegnongsie
authored
Merge pull request #114 from CyberSource/oct-22-release
oct release update
2 parents 72b78bb + baa416a commit c0400ce

File tree

796 files changed

+7245
-836
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

796 files changed

+7245
-836
lines changed

‎.gitignore‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -19,3 +19,10 @@ hs_err_pid*
1919
target
2020
.gradle
2121
build
22+
.travis.yml
23+
.swagger-codegen/VERSION
24+
.swagger-codegen-ignore
25+
.settings/org.eclipse.jdt.core.prefs
26+
.project
27+
.classpath
28+
.settings/org.eclipse.core.resources.prefs

‎Logging.md‎

Lines changed: 104 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,104 @@
1+
[![Generic badge](https://img.shields.io/badge/LOGGING-NEW-GREEN.svg)](https://shields.io/)
2+
3+
# Logging in CyberSource REST Client SDK (JAVA)
4+
Logging framework has been introduced in the SDK which makes use of log4j2 and standardizes the logging so that it can be integrated with the logging in the client application.
5+
6+
## Setup
7+
In order to leverage the new logging framework, all logging configuration settings are entrusted to the log4j2 framework. For this, a new file `log4j.xml` has to be added to contain the configuration properties. A sample file has been provided below.
8+
9+
For more detailed information on how to change this configuration file, refer to [Apache Log4j2 Configuration](https://logging.apache.org/log4j/2.x/manual/configuration.html).
10+
11+
12+
## Log4j Configuration
13+
14+
### Sample log4j.xml File
15+
16+
```xml
17+
<?xml version="1.0" encoding="UTF-8"?>
18+
19+
<!-- ################################################################################################################ -->
20+
<!-- For information on how to change this configuration file, -->
21+
<!-- refer to https://logging.apache.org/log4j/2.x/manual/configuration.html -->
22+
23+
<!-- To enable masking of sensitive data, replace `%m` with `%maskedMessage` in the patterns below -->
24+
<!-- ################################################################################################################ -->
25+
26+
<Configuration status="warn">
27+
<Properties>
28+
<Property name="log-path">./logs</Property>
29+
<Property name="logFileName">application</Property>
30+
</Properties>
31+
<Appenders>
32+
<Console name="LogToConsole" target="SYSTEM_OUT">
33+
<PatternLayout pattern="%d{MM/dd/yy HH:mm:ss,SS:} [%t] %5p (%C{1}:%-1L) - %m%n"/>
34+
</Console>
35+
<RollingFile name="RollingFile"
36+
fileName="${log-path}/${logFileName}.log"
37+
filePattern="${log-path}/${logFileName}-%d{yyyy-MM-dd}-%i.log">
38+
<PatternLayout>
39+
<pattern>%d{MM/dd/yy HH:mm:ss,SS:} [%t] %5p (%C{1}:%-1L) - %m%n</pattern>
40+
</PatternLayout>
41+
<Policies>
42+
<TimeBasedTriggeringPolicy interval="1" modulate="true"/>
43+
</Policies>
44+
<DefaultRolloverStrategy max="4"/>
45+
</RollingFile>
46+
</Appenders>
47+
<Loggers>
48+
<Logger name="com.cybersource" level="error" additivity="true">
49+
<AppenderRef ref="LogToConsole" level="error" />
50+
</Logger>
51+
<Logger name="Api" level="error" additivity="true">
52+
<AppenderRef ref="LogToConsole" level="error" />
53+
</Logger>
54+
<Logger name="Invoker" level="error" additivity="true">
55+
<AppenderRef ref="LogToConsole" level="error" />
56+
</Logger>
57+
<Logger name="samples" level="error" additivity="true">
58+
<AppenderRef ref="LogToConsole" level="error" />
59+
</Logger>
60+
<Root level="info" additivity="true">
61+
<AppenderRef ref="RollingFile" />
62+
</Root>
63+
<Logger name="com.cybersource" level="info" additivity="true">
64+
<AppenderRef ref="LogToConsole" level="info" />
65+
</Logger>
66+
<Logger name="Api" level="info" additivity="true">
67+
<AppenderRef ref="LogToConsole" level="info" />
68+
</Logger>
69+
<Logger name="Invoker" level="info" additivity="true">
70+
<AppenderRef ref="LogToConsole" level="info" />
71+
</Logger>
72+
<Logger name="samples" level="info" additivity="true">
73+
<AppenderRef ref="LogToConsole" level="info" />
74+
</Logger>
75+
</Loggers>
76+
</Configuration>
77+
```
78+
79+
### Important Notes
80+
* To enable masking of sensitive data i.e. sensitive data in the request/response should be hidden/masked, then replace `%m` with `%maskedMessage` in the pattern below:
81+
82+
```xml
83+
<PatternLayout pattern="%d{MM/dd/yy HH:mm:ss,SS:} [%t] %5p (%C{1}:%-1L) - %m%n"/>
84+
```
85+
must be replaced with
86+
```xml
87+
<PatternLayout pattern="%d{MM/dd/yy HH:mm:ss,SS:} [%t] %5p (%C{1}:%-1L) - %maskedMessage%n"/>
88+
```
89+
90+
91+
* Sensitive data fields are listed below:
92+
* Card Security Code
93+
* Card Number
94+
* Any field with number in the name
95+
* Card Expiration Month
96+
* Card Expiration Year
97+
* Account
98+
* Routing Number
99+
* Email
100+
* First Name & Last Name
101+
* Phone Number
102+
* Type
103+
* Token
104+
* Signature

‎README.md‎

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -105,6 +105,13 @@ To Use OAuth, use OAuth enabled URLs
105105

106106
API credentials are different for each environment, so be sure to switch to the appropriate credentials when switching environments.
107107

108+
## Logging
109+
[![Generic badge](https://img.shields.io/badge/LOGGING-NEW-GREEN.svg)](https://shields.io/)
110+
111+
Logging framework has been introduced in the SDK which makes use of log4j2 and standardizes the logging so that it can be integrated with the logging in the client application.
112+
113+
More information about this new logging framework can be found in this file : [Logging.md](Logging.md)
114+
108115
## License
109116

110117
This repository is distributed under a proprietary license. See the provided [`LICENSE.txt`](/LICENSE.txt) file.

‎docs/Body.md‎

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
2+
# Body
3+
4+
## Properties
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**requestor** | **String** | Identifies the service requesting parsing |
8+
**parsedTagLimit** | **Integer** | Number of tags to parse for each EMV tag string provided. | [optional]
9+
**emvDetailsList** | [**List&lt;Tssv2transactionsemvTagDetailsEmvDetailsList&gt;**](Tssv2transactionsemvTagDetailsEmvDetailsList.md) | An array of objects, each containing a requestId and the corresponding emvRequestCombinedTags |
10+
11+
12+

‎docs/EMVTagDetailsApi.md‎

Lines changed: 96 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,96 @@
1+
# EMVTagDetailsApi
2+
3+
All URIs are relative to *https://apitest.cybersource.com*
4+
5+
Method | HTTP request | Description
6+
------------- | ------------- | -------------
7+
[**getEmvTags**](EMVTagDetailsApi.md#getEmvTags) | **GET** /tss/v2/transactions/emvTagDetails | Retrieve the EMV Dictionary
8+
[**parseEmvTags**](EMVTagDetailsApi.md#parseEmvTags) | **POST** /tss/v2/transactions/emvTagDetails | Parse an EMV String
9+
10+
11+
<a name="getEmvTags"></a>
12+
# **getEmvTags**
13+
> TssV2GetEmvTags200Response getEmvTags()
14+
15+
Retrieve the EMV Dictionary
16+
17+
Returns the entire EMV tag dictionary
18+
19+
### Example
20+
```java
21+
// Import classes:
22+
//import Invokers.ApiException;
23+
//import Api.EMVTagDetailsApi;
24+
25+
26+
EMVTagDetailsApi apiInstance = new EMVTagDetailsApi();
27+
try {
28+
TssV2GetEmvTags200Response result = apiInstance.getEmvTags();
29+
System.out.println(result);
30+
} catch (ApiException e) {
31+
System.err.println("Exception when calling EMVTagDetailsApi#getEmvTags");
32+
e.printStackTrace();
33+
}
34+
```
35+
36+
### Parameters
37+
This endpoint does not need any parameter.
38+
39+
### Return type
40+
41+
[**TssV2GetEmvTags200Response**](TssV2GetEmvTags200Response.md)
42+
43+
### Authorization
44+
45+
No authorization required
46+
47+
### HTTP request headers
48+
49+
- **Content-Type**: application/json;charset=utf-8
50+
- **Accept**: application/json;charset=utf-8
51+
52+
<a name="parseEmvTags"></a>
53+
# **parseEmvTags**
54+
> TssV2PostEmvTags200Response parseEmvTags(body)
55+
56+
Parse an EMV String
57+
58+
Pass an EMV Tag-Length-Value (TLV) string for parsing.
59+
60+
### Example
61+
```java
62+
// Import classes:
63+
//import Invokers.ApiException;
64+
//import Api.EMVTagDetailsApi;
65+
66+
67+
EMVTagDetailsApi apiInstance = new EMVTagDetailsApi();
68+
Body body = new Body(); // Body |
69+
try {
70+
TssV2PostEmvTags200Response result = apiInstance.parseEmvTags(body);
71+
System.out.println(result);
72+
} catch (ApiException e) {
73+
System.err.println("Exception when calling EMVTagDetailsApi#parseEmvTags");
74+
e.printStackTrace();
75+
}
76+
```
77+
78+
### Parameters
79+
80+
Name | Type | Description | Notes
81+
------------- | ------------- | ------------- | -------------
82+
**body** | [**Body**](Body.md)| |
83+
84+
### Return type
85+
86+
[**TssV2PostEmvTags200Response**](TssV2PostEmvTags200Response.md)
87+
88+
### Authorization
89+
90+
No authorization required
91+
92+
### HTTP request headers
93+
94+
- **Content-Type**: application/json;charset=utf-8
95+
- **Accept**: application/hal+json;charset=utf-8
96+

‎docs/GenerateUnifiedCheckoutCaptureContextRequest.md‎

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,18 @@
1+
2+
# GenerateUnifiedCheckoutCaptureContextRequest
3+
4+
## Properties
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**targetOrigins** | **List&lt;String&gt;** | | [optional]
8+
**clientVersion** | **String** | verson number of Unified Checkout being used | [optional]
9+
**allowedCardNetworks** | **List&lt;String&gt;** | | [optional]
10+
**allowedPaymentTypes** | **List&lt;String&gt;** | | [optional]
11+
**country** | **String** | Country the purchase is originating from (e.g. country of the merchant). Use the two- character ISO Standard | [optional]
12+
**locale** | **String** | Localization of the User experience conforming to the ISO 639-1 language standards and two-character ISO Standard Country Code | [optional]
13+
**captureMandate** | [**Upv1capturecontextsCaptureMandate**](Upv1capturecontextsCaptureMandate.md) | | [optional]
14+
**orderInformation** | [**Upv1capturecontextsOrderInformation**](Upv1capturecontextsOrderInformation.md) | | [optional]
15+
**checkoutApiInitialization** | [**Upv1capturecontextsCheckoutApiInitialization**](Upv1capturecontextsCheckoutApiInitialization.md) | | [optional]
16+
17+
18+

‎docs/InlineResponse4003.md‎

Lines changed: 35 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,35 @@
1+
2+
# InlineResponse4003
3+
4+
## Properties
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**correlationId** | **String** | | [optional]
8+
**details** | [**List&lt;InlineResponse4003Details&gt;**](InlineResponse4003Details.md) | | [optional]
9+
**informationLink** | **String** | | [optional]
10+
**message** | **String** | |
11+
**reason** | [**ReasonEnum**](#ReasonEnum) | |
12+
13+
14+
<a name="ReasonEnum"></a>
15+
## Enum: ReasonEnum
16+
Name | Value
17+
---- | -----
18+
INVALID_APIKEY | &quot;INVALID_APIKEY&quot;
19+
INVALID_SHIPPING_INPUT_PARAMS | &quot;INVALID_SHIPPING_INPUT_PARAMS&quot;
20+
CAPTURE_CONTEXT_INVALID | &quot;CAPTURE_CONTEXT_INVALID&quot;
21+
CAPTURE_CONTEXT_EXPIRED | &quot;CAPTURE_CONTEXT_EXPIRED&quot;
22+
SDK_XHR_ERROR | &quot;SDK_XHR_ERROR&quot;
23+
UNIFIEDPAYMENTS_VALIDATION_PARAMS | &quot;UNIFIEDPAYMENTS_VALIDATION_PARAMS&quot;
24+
UNIFIEDPAYMENTS_VALIDATION_FIELDS | &quot;UNIFIEDPAYMENTS_VALIDATION_FIELDS&quot;
25+
UNIFIEDPAYMENT_PAYMENT_PARAMITERS | &quot;UNIFIEDPAYMENT_PAYMENT_PARAMITERS&quot;
26+
CREATE_TOKEN_TIMEOUT | &quot;CREATE_TOKEN_TIMEOUT&quot;
27+
CREATE_TOKEN_XHR_ERROR | &quot;CREATE_TOKEN_XHR_ERROR&quot;
28+
SHOW_LOAD_CONTAINER_SELECTOR | &quot;SHOW_LOAD_CONTAINER_SELECTOR&quot;
29+
SHOW_LOAD_INVALID_CONTAINER | &quot;SHOW_LOAD_INVALID_CONTAINER&quot;
30+
SHOW_TOKEN_TIMEOUT | &quot;SHOW_TOKEN_TIMEOUT&quot;
31+
SHOW_TOKEN_XHR_ERROR | &quot;SHOW_TOKEN_XHR_ERROR&quot;
32+
SHOW_PAYMENT_TIMEOUT | &quot;SHOW_PAYMENT_TIMEOUT&quot;
33+
34+
35+

‎docs/InlineResponse4003Details.md‎

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
2+
# InlineResponse4003Details
3+
4+
## Properties
5+
Name | Type | Description | Notes
6+
------------ | ------------- | ------------- | -------------
7+
**location** | **String** | | [optional]
8+
**message** | **String** | | [optional]
9+
10+
11+

‎docs/PtsV2PaymentsPost201ResponseConsumerAuthenticationInformationStrongAuthenticationIssuerInformation.md‎

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -6,6 +6,9 @@ Name | Type | Description | Notes
66
------------ | ------------- | ------------- | -------------
77
**riskAnalysisExemptionResult** | **String** | Possible values: Visa Platform Connect - &#x60;8401&#x60; Merchant not participating in Visa Trusted Listing Program. - &#x60;8402&#x60; Issuer not participating in Visa Trusted Listing Program. - &#x60;8403&#x60; Cardholder has not trusted the merchant (supplied by Visa Net). - &#x60;8404&#x60; Indeterminate or invalid issuer response. - &#x60;8473&#x60; Cardholder has not trusted the merchant (issuer-supplied). - &#x60;8474&#x60; Did not meet the exemption criteria (issuer-supplied). Upto 20 Values may be received in a transaction. | [optional]
88
**trustedMerchantExemptionResult** | **String** | Possible values: Visa Platform Connect - &#x60;2&#x60; Trusted merchant exemption validated/honored. - &#x60;3&#x60; Trusted merchant exemption failed validation/not honored. | [optional]
9+
**lowValueExemptionResult** | **String** | This will be the value returned by Visanet when low value exemption has been requested. Valid values: Visa Platform Connect - &#x60;2&#x60; Low value exemption validated/honored - &#x60;3&#x60; Low value exemption failed validation/not honored | [optional]
10+
**secureCorporatePaymentResult** | **String** | This will be the value returned by Visanet when secure corporate payment (scp) exemption has been requested. Valid values: Visa Platform Connect - &#x60;2&#x60; Secure corporate payment exemption validated/honored - &#x60;3&#x60; Secure corporate payment exemption failed validation/not honored | [optional]
11+
**transactionRiskAnalysisExemptionResult** | **String** | This will be the value returned by Visanet when transaction risk analysis (TRA) exemption has been requested. Valid values: Visa Platform Connect - &#x60;2&#x60; transaction risk analysis (TRA) exemption validated/honored - &#x60;3&#x60; transaction risk analysis (TRA) exemption failed validation/not honored | [optional]
912

1013

1114

‎docs/PtsV2PaymentsPost201ResponseIssuerInformation.md‎

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,6 @@ Name | Type | Description | Notes
88
**discretionaryData** | **String** | Data defined by the issuer. The value for this reply field will probably be the same as the value that you submitted in the authorization request, but it is possible for the processor, issuer, or acquirer to modify the value. This field is supported only for Visa transactions on **CyberSource through VisaNet**. For details, see &#x60;issuer_additional_data&#x60; field description in the [Credit Card Services Using the SCMP API Guide.](https://apps.cybersource.com/library/documentation/dev_guides/CC_Svcs_SCMP_API/html/) | [optional]
99
**countrySpecificDiscretionaryData** | **String** | Data defined by the issuer. This national use field contains two subfields for information unique to the processing of Visa transactions by members in Japan. This subfield contains the Katakana text to be printed on the receipt. For details, see &#x60;jpo_issuer_message&#x60; field description in the [Credit Card Services Using the SCMP API Guide.](https://apps.cybersource.com/library/documentation/dev_guides/CC_Svcs_SCMP_API/html/) | [optional]
1010
**responseCode** | **String** | Additional authorization code that must be printed on the receipt when returned by the processor. This value is generated by the processor and is returned only for a successful transaction. This reply field is supported only for these processors: - FDC Nashville Global - SIX | [optional]
11-
**responseRaw** | **String** | issuerInformation.responseRaw is the raw processor auth response returned to merchant in CYBS auth response if auth request includes \&quot;processingInformation.isReturnAuthRecordEnabled&#x3D;true\&quot;. If supported by the gateway code, it is available to merchants who auth through CYBS and run their own settlement processing. | [optional]
1211

1312

1413

0 commit comments

Comments
 (0)