Java SDK

Availability

Supports java 6, 7 and 8

How to install

Add this dependency to your project's POM:

<dependency>
    <groupId>com.github.ingenico-nps-latam</groupId>
    <artifactId>nps-sdk-java</artifactId>
    <version>1.1.0</version>
</dependency>

or add this line to your build.gradle

compile 'com.github.ingenico-nps-latam:nps-sdk-java:1.1.0'

Configuration

It's a basic configuration of the SDK

import NpsSDK.ConsoleLogger;
import NpsSDK.ILogger;
import NpsSDK.NpsSdk;
import NpsSDK.WsdlHandlerConfiguration;
import NpsSDK.ILogger.LogLevel;
import NpsSDK.WsdlHandlerConfiguration.NpsEnvironment;
import NpsSDK.WsdlHandlerException;

ILogger consoleLogger = new ConsoleLogger();
WsdlHandlerConfiguration wsdlHandlerConfiguration = new WsdlHandlerConfiguration(LogLevel.DEBUG, NpsEnvironment.sandbox, "_YOUR_SECRET_KEY_", consoleLogger);      
NpsSdk npsSdk = null;
try {
	npsSdk = new NpsSdk(wsdlHandlerConfiguration);
} 
catch (WsdlHandlerException ex) {	
	//Code to handle error
}  

Here is an simple example request:

import NpsSDK.ComplexElement;
import NpsSDK.ComplexElementArray;
import NpsSDK.ComplexElementArrayItem;
import NpsSDK.WsdlHandlerException;

RootElement data = null;
RootElement response = null;

try {
	data = new RootElement();
	data.add("psp_Version", "2.2" );
	data.add("psp_MerchantId", PSPMERCHANTID );
	data.add("psp_TxSource", "WEB" );
	data.add("psp_MerchTxRef", "ORDER69461-3" );
	data.add("psp_MerchOrderId", "ORDER69461" );
	data.add("psp_Amount", "15050" );
	data.add("psp_NumPayments", "1" );
	data.add("psp_Currency", "032" );
	data.add("psp_Country", "ARG" );
	data.add("psp_Product", "14" );
	data.add("psp_CardNumber", "4507990000000010" );
	data.add("psp_CardExpDate", "1612" );
	data.add("psp_PosDateTime", "2016-12-01 12:00:00");
	data.add("psp_CardSecurityCode", "325" );	

	response = npsSdk.payOnLine_2p(data);
} 
catch (WsdlHandlerException ex) {	
	//Code to handle error
}  

Environments

import NpsSDK.WsdlHandlerConfiguration.NpsEnvironment;

NpsEnvironment.sandbox
NpsEnvironment.staging
NpsEnvironment.production

Error handling

WsdlHandlerException: This exception is thrown when occurs any error.

import NpsSDK.WsdlHandlerException;

//Code
try {
	//code or sdk call
} 
catch (WsdlHandlerException ex) {	
	//Code to handle error
}  

Advanced configurations

Nps SDK allows you to log what’s happening with you request inside of our SDK, it logs by default to the java console

import NpsSDK.ConsoleLogger;
import NpsSDK.ILogger;
import NpsSDK.WsdlHandlerConfiguration;
import NpsSDK.ILogger.LogLevel;
import NpsSDK.WsdlHandlerConfiguration.NpsEnvironment;

ILogger consoleLogger = new ConsoleLogger();
WsdlHandlerConfiguration wsdlHandlerConfiguration = new WsdlHandlerConfiguration(LogLevel.DEBUG, NpsEnvironment.sandbox, "_YOUR_SECRET_KEY_", consoleLogger);      

If you prefer the sdk can write the output generated from the logger to the file you provided.

import NpsSDK.FileLogger;
import NpsSDK.ILogger;
import NpsSDK.WsdlHandlerConfiguration;
import NpsSDK.ILogger.LogLevel;
import NpsSDK.WsdlHandlerConfiguration.NpsEnvironment;

ILogger fileLogger = new FileLogger("path/to/your/file.log");
WsdlHandlerConfiguration wsdlHandlerConfiguration = new WsdlHandlerConfiguration(LogLevel.DEBUG, NpsEnvironment.sandbox, "_YOUR_SECRET_KEY_", fileLogger);      

The LogLevel.Info level will write concise information of the request and will mask sensitive data of the request. The LogLevel.Debug level will write information about the request to let developers debug it in a more detailed way.

you can change the open timeout and the read timeout of the request.

```java
import NpsSDK.ConsoleLogger;
import NpsSDK.ILogger;
import NpsSDK.WsdlHandlerConfiguration;
import NpsSDK.ILogger.LogLevel;
import NpsSDK.WsdlHandlerConfiguration.NpsEnvironment;

ILogger consoleLogger = new ConsoleLogger();

int openTimeOut = 10;
int readTimeOut = 60;
WsdlHandlerConfiguration wsdlHandlerConfiguration = new WsdlHandlerConfiguration(LogLevel.DEBUG, NpsEnvironment.sandbox, "_YOUR_SECRET_KEY_", consoleLogger,openTimeOut,readTimeOut);      

Proxy configuration

import NpsSDK.ConsoleLogger;
import NpsSDK.ILogger;
import NpsSDK.WsdlHandlerConfiguration;
import NpsSDK.ILogger.LogLevel;
import NpsSDK.WsdlHandlerConfiguration.NpsEnvironment;

ILogger consoleLogger = new ConsoleLogger();

int openTimeOut = 10;
int readTimeOut = 60;
HttpHost proxy = new HttpHost("PROXY HOST", 8080);
WsdlHandlerConfiguration wsdlHandlerConfiguration = new WsdlHandlerConfiguration(LogLevel.DEBUG, NpsEnvironment.sandbox, "_YOUR_SECRET_KEY_", consoleLogger,openTimeOut,readTimeOut,proxy);