Welcome! This document will explain how to integrate with Konduto's anti-fraud service so you can begin to spot fraud on your e-commerce website.

Our service uses the visitor's behavior to analyze browsing patterns and detect fraud. You will need to add a JavaScript snippet to your website and tag your pages, so we can see your visitors, and call our REST API to send purchases, so we can analyze them.

This document refers to the Java SDK used for our API.

• Java 8

To get started add our SDK as a dependency in your pom.xml:

<dependency>
	<groupId>com.konduto.sdk</groupId>
	<artifactId>java-sdk</artifactId>
	<version>2.17.4</version>
</dependency>

When a customer makes a purchase you must send the order information to us so we can analyze it. We perform a real-time analysis and return you a recommendation of what to do next and a score, a numeric confidence level about that order.

While many of the parameters we accept are optional we recommend you send all you can, because every data point matters for the analysis. The billing address and credit card information are specially important, though we understand there are cases where you don't have that information.

You will need an API key to authenticate the requests. Luckily for you the examples below have been populated with a working key, so you can just copy and paste to see how it works.

// creates a Konduto instance, which is a class that communicates with our API by using HTTP methods.
Konduto konduto = new Konduto("T738D516F09CAB3A2C1EE"); // T738D516F09CAB3A2C1EE is the API key

KondutoOrder is a class that models the attributes and behavior of an order.

All entities involved in Konduto's analysis process (e.g customer, shopping cart, payment, etc.) inherit from KondutoModel and are under the models package.

KondutoOrder order = new KondutoOrder()
		.with("id","123")
		.with("totalAmount", 123.4)
		.with("customer", customer); // customer is an instance of KondutoCustomer

One can also use the more conventional set-based approach as seen below.

KondutoOrder order = new KondutoOrder();
order.setId("123");
order.setTotalAmount(123.4);
order.setCustomer(customer);

Another way of initializing an instance of KondutoModel is to call KondutoModel's fromMap method and pass a Map and the instance class as arguments.

Map<String, Object> attributes = new HashMap<String, Object>();
attributes.put("id", "123"); 
attributes.put("totalAmount", 123.4);
attributes.put("customer", customer);

KondutoOrder order = (KondutoOrder) KondutoModel.fromMap(attributes, KondutoOrder.class);

NOTICE: the order created above is really, really simple. The more detail you provide, more accurate Konduto's analysis will be.

Welcome! This document will explain how to integrate with Konduto's anti-fraud service so you can begin to spot fraud on your e-commerce website.

Our service uses the visitor's behavior to analyze browsing patterns and detect fraud. You will need to add a JavaScript snippet to your website and tag your pages, so we can see your visitors, and call our REST API to send purchases, so we can analyze them.

This document refers to the Java SDK used for our API.

• Java 8

To get started add our SDK as a dependency in your pom.xml:

<dependency>
	<groupId>com.konduto.sdk</groupId>
	<artifactId>java-sdk</artifactId>
	<version>2.17.4</version>
</dependency>

When a customer makes a purchase you must send the order information to us so we can analyze it. We perform a real-time analysis and return you a recommendation of what to do next and a score, a numeric confidence level about that order.

While many of the parameters we accept are optional we recommend you send all you can, because every data point matters for the analysis. The billing address and credit card information are specially important, though we understand there are cases where you don't have that information.

You will need an API key to authenticate the requests. Luckily for you the examples below have been populated with a working key, so you can just copy and paste to see how it works.

// creates a Konduto instance, which is a class that communicates with our API by using HTTP methods.
Konduto konduto = new Konduto("T738D516F09CAB3A2C1EE"); // T738D516F09CAB3A2C1EE is the API key

KondutoOrder is a class that models the attributes and behavior of an order.

All entities involved in Konduto's analysis process (e.g customer, shopping cart, payment, etc.) inherit from KondutoModel and are under the models package.

KondutoOrder order = new KondutoOrder()
		.with("id","123")
		.with("totalAmount", 123.4)
		.with("customer", customer); // customer is an instance of KondutoCustomer

One can also use the more conventional set-based approach as seen below.

KondutoOrder order = new KondutoOrder();
order.setId("123");
order.setTotalAmount(123.4);
order.setCustomer(customer);

Another way of initializing an instance of KondutoModel is to call KondutoModel's fromMap method and pass a Map and the instance class as arguments.

Map<String, Object> attributes = new HashMap<String, Object>();
attributes.put("id", "123"); 
attributes.put("totalAmount", 123.4);
attributes.put("customer", customer);

KondutoOrder order = (KondutoOrder) KondutoModel.fromMap(attributes, KondutoOrder.class);

NOTICE: the order created above is really, really simple. The more detail you provide, more accurate Konduto's analysis will be.

Payments may contain a description and a amount field. The former is a description of the payment, for example: "Thanksgiving discount voucher". The latter is the amount that was charged in that specific payment type. For example, a transaction total amount could be 100.00, of which 10.00 are paid via a discount voucher and 90.00 via credit card.

• DEBIT
• TRANSFER
• VOUCHER
• TED

Safebank spans multiple nodes, the first node origin_account, which represents the source account in the balance and pix packets. The destination_accounts node brings a list that represents the destination accounts in payments of type amount and pix. The tenant node represents the platform (or marketplace) on which the pix transaction is taking place which can be declared within this tenant node.

After creating the order, sending it to Konduto's analysis is very simple.

if(order.isValid()){
	try {
		konduto.analyze(order);
		System.out.println("Konduto recommendation is to: " + order.getRecommendation());

	// A KondutoException will be thrown if the response is anything other than 200 OK.
	// You can catch more specific exceptions if you want to (e.g KondutoHTTPBadRequestException).
	catch(KondutoException e) {
		// Put any exception handling here.
		e.printStackTrace();
		persistAsNotAnalyzed(order, e.getMessage());
	}
} else {
    LOGGER.debug(order.getErrors());
}

Notice that if the analysis fails, a KondutoException will be thrown. Handle it as you wish.

In order to do that use the Konduto class in the following way:

try {
	KondutoOrder order = konduto.getOrder(orderId); // orderId is a String
} catch (KondutoException e) {
	// Exception handling code
}

try {
	// the order status will be set to newStatus if the request succeeds.
	konduto.updateOrderStatus(order, newStatus, "some comments"); 
} catch (KondutoException e) {
	// Exception handling code
}

To send requests through a proxy just build a new Konduto instance and set the proxy host passing both hostname and port as parameters of setProxyHost method. If the proxy requires username and password, set these credentials using the setProxyCredentials method.

String proxyHostname = "proxy.hostname";
int proxyPort = 1234;
Konduto konduto = new Konduto(API_KEY);
konduto.setProxyHost(proxyHostname, proxyPort);
// any object of kind org.apache.commons.httpclient.Credentials works 
// (as an example we use an instance of UsernamePasswordCredentials)
konduto.setProxyCredentials(new UsernamePasswordCredentials("username", "password")); 
// use Konduto's API as usual
konduto.getOrder(ORDER_ID);

Please click here for the Currency and Category reference tables.

If you experience problems sending orders for analysis, querying orders or updating order status, it might be a good idea to call konduto.debug(). This will print out the API Key, the endpoint, the request body and the response body.

Feel free to contact our support team if you have any questions or suggestions!

Safebank spans multiple nodes, the first node origin_account, which represents the source account in the balance and pix packets. The destination_accounts node brings a list that represents the destination accounts in payments of type amount and pix. The tenant node represents the platform (or marketplace) on which the pix transaction is taking place which can be declared within this tenant node.

After creating the order, sending it to Konduto's analysis is very simple.

if(order.isValid()){
	try {
		konduto.analyze(order);
		System.out.println("Konduto recommendation is to: " + order.getRecommendation());

	// A KondutoException will be thrown if the response is anything other than 200 OK.
	// You can catch more specific exceptions if you want to (e.g KondutoHTTPBadRequestException).
	catch(KondutoException e) {
		// Put any exception handling here.
		e.printStackTrace();
		persistAsNotAnalyzed(order, e.getMessage());
	}
} else {
    LOGGER.debug(order.getErrors());
}

Notice that if the analysis fails, a KondutoException will be thrown. Handle it as you wish.

In order to do that use the Konduto class in the following way:

try {
	KondutoOrder order = konduto.getOrder(orderId); // orderId is a String
} catch (KondutoException e) {
	// Exception handling code
}

try {
	// the order status will be set to newStatus if the request succeeds.
	konduto.updateOrderStatus(order, newStatus, "some comments"); 
} catch (KondutoException e) {
	// Exception handling code
}

To send requests through a proxy just build a new Konduto instance and set the proxy host passing both hostname and port as parameters of setProxyHost method. If the proxy requires username and password, set these credentials using the setProxyCredentials method.

String proxyHostname = "proxy.hostname";
int proxyPort = 1234;
Konduto konduto = new Konduto(API_KEY);
konduto.setProxyHost(proxyHostname, proxyPort);
// any object of kind org.apache.commons.httpclient.Credentials works 
// (as an example we use an instance of UsernamePasswordCredentials)
konduto.setProxyCredentials(new UsernamePasswordCredentials("username", "password")); 
// use Konduto's API as usual
konduto.getOrder(ORDER_ID);

Please click here for the Currency and Category reference tables.

If you experience problems sending orders for analysis, querying orders or updating order status, it might be a good idea to call konduto.debug(). This will print out the API Key, the endpoint, the request body and the response body.

Feel free to contact our support team if you have any questions or suggestions!