This document is a rubyist adaptation of the original README file made for the Java API version. You can get access to it by clicking here. Konduto is a trademark, all rights reserved. This project has no intention beyond helping ruby users to get easy access to Konduto's API through a simplified interface.

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 Ruby SDK used for our API.

• This API was tested with Ruby MRI version 2.

To get started add Konduto's gem as a dependency in your Gemfile:

gem 'konduto-ruby'

After that, run bundle install. If your are not using a Gemfile, run the following command

$ gem install konduto-ruby

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 = KondutoRuby.new('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 KondutoBase and you can get access to them by calling their name and passing a hash of attributes, as shown below.

order = KondutoOrder.new({
          id: '123',
          totalAmount: 123.4,
          customer: customer # customer is an instance of KondutoCustomer
        })

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

order = KondutoOrder.new
order.id = "123"
order.total_amount = 123.4
order.customer = customer

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

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

if order.valid?
  begin
    konduto.analyze(order);
    # A RuntimeError will be thrown if the response is anything other than 200 OK.
  rescue RuntimeError => e
    # Put any exception handling here.
    p e.message
  end
else
  p order.errors.messages
end

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

After the analysis, some order attributes will be filled. For example the recommendation.

# The command below should print something like "Konduto recommendation is to APPROVE".
p "Konduto recommendation is to: #{order.recommendation}";

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

order = konduto.get_order order_id # orderId is a String

# the order status will be set to newStatus if the request succeeds.
konduto.update_order_status(order, new_status, 'some comments');

To send requests through a proxy just build a new Konduto instance and set the proxy host passing the proxy url as parameters of proxy= method. If the proxy requires username and password, just set then at the proxy url you'll pass to proxy= method.

konduto = KondutoRuby.new(API_KEY)
konduto.proxy = 'http://server-ip:port/'
# Or, using username and password
konduto.proxy = 'http://USERNAME:PASSWORD@proxy-server:port/'
# use Konduto's API as usual
konduto.get_order(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 end us a feedback via email or open an issue if you have some doubts or find out bugs. You can also contact konduto's support team if you have any questions or suggestions!