Merge pull request #273 from maxmind/fatih/sanbox-info

Add Sandbox information

Author: horgh

README.md

@@ -41,13 +41,20 @@ Page](https://maxmind.github.io/minfraud-api-java/) under the API tab.
 ## Usage ##
 
 To use this API, first create a new `WebServiceClient` object. The constructor
-takes your MaxMind account ID, license key, and an optional options array as
-arguments. For example:
+takes your MaxMind account ID and license key as arguments. For example:
 
 ```java
 WebServiceClient client = new WebServiceClient.Builder(6, "ABCD567890").build();
 ```
 
+If you would like to use the Sandbox environment, you can use the `host` method 
+that belongs to the Builder. For example,
+
+```java
+WebServiceClient client = new WebServiceClient.Builder(6, "ABCD567890")
+    .host("sandbox.maxmind.com").build();
+```
+
 Then create a new `Transaction` object. This represents the transaction that
 you are sending to minFraud. The class is instantiated using an inner builder
 class, `Transaction.Builder`. Each builder method takes a corresponding

src/main/java/com/maxmind/minfraud/WebServiceClient.java

@@ -138,6 +138,11 @@ public WebServiceClient.Builder disableHttps() {
 
         /**
          * @param val The host to use.
+         * By default, the client connects to the production host. However,
+         * during testing and development, you can set this option to
+         * 'sandbox.maxmind.com' to use the Sandbox environment's host. The
+         * sandbox allows you to experiment with the API without affecting your
+         * production data.
          * @return Builder object
          */
         public WebServiceClient.Builder host(String val) {