You can sign up for a Shippo account at https://goshippo.com

Java 1.5 and later

Add this dependency to your project's POM:

<dependency>
    <groupId>com.goshippo</groupId>
    <artifactId>shippo-java-client</artifactId>
    <version>1.1.4</version>
</dependency>

You'll need to manually install the following JARs:

• The latest Shippo JAR from https://github.com/goshippo/shippo-java-client/releases
• Google Gson from http://google-gson.googlecode.com/files/google-gson-2.2.4-release.zip.

You can also load the source into Eclipse, simply clone this repository. Then open up Eclipse (the latest eclipse comes with maven). Within eclipse, File --> Import In the dialog window that appears, chose "Existing Maven Projects", from there on, follow the wizard, and you will have imported the project. You can then run Example.java, or any of the individual JUnit test cases.

Check out the file Example.java for more examples, alternatively you can look through all of the test classes for each particular model for examples. For useful debugging information including headers, server raw response etc, set Shippo.setDEBUG(true);

Below is a brief code example:

/* Code Example */
    public static void main(String[] args) {

    Shippo.apiKey = "<Your Shippo authToken>";
    
    Map<String, Object> addressMap = new HashMap<String, Object>();
	addressMap.put("object_purpose", "PURCHASE");
	addressMap.put("name", "Shippo Itle");
	addressMap.put("company", "Shippo");
	addressMap.put("street1", "215 Clayton St.");
	addressMap.put("city", "San Francisco");
	addressMap.put("state", "CA");
	addressMap.put("zip", "94117");
	addressMap.put("country", "US");
	addressMap.put("phone", "+1 555 341 9393");
	addressMap.put("email", "[email protected]")

    try {
        Address address = Address.create(addressMap);
        System.out.println(address.toString());
        System.out.println("Zip code: " + address.getZip());
    } catch (ShippoException e) {
        e.printStackTrace();
    }
}

You must have Maven installed. To run the tests, simply run mvn test. You can run particular tests by passing -D test=Class#method -- for example, -D test=ShippoTest#testAddressCreate.

You can also run the tests in eclipse.