#MasterCard Java SDK Readme

##Overview

MasterCard's Java SDK gives developers access to a host of powerful tools, including P2P Money transfers (MoneySend), the ability to detect potentially fraudulent transactions (Fraud Scoring), and finding information about locally popular restaurants (Local Favorites). Calls to MasterCard's API are in accordance with OAuth 1.0 standards.

The following APIs are supported in the Java SDK:

Bill Payment

Fraud Scoring

Locations

MDES Customer Service

Merchant Identifier

MoneySend

MasterPass - Partner Wallet

MasterCard rePower

Local Favorites (for finding restaurants)

---

##Consumer Key and Private Key Acquisition

Before beginning to use MasterCard's Java SDK, make sure you are a registered MasterCard developer and have a consumer and private key to use for your project:

• Go to https://developer.mastercard.com/ and click "Register" to register yourself for all of MasterCard's developer tools.

• Once registered, you will need both a Consumer Key and Private Key in order to use most of the MasterCard APIs. You can get a consumer key by going to the home screen, clicking on "Services", scrolling two-thirds of the way down the page, and clicking on "Go to My Dashboard".

• Follow the instructions on this link - https://developer.mastercard.com/portal/display/api/Generating+RSA+Keys - to obtain both a Consumer Key and a .p12 file that contains your private key.

• Make sure to store your .p12 file in the same directory as where you pulled the MasterCard SDK so that the private key is accessible from within your code.

---

##Code example

Using the Local Favorites API to get a list of popular restaurants in the US. Since the Environment is listed as "SANDBOX", the data returned won't be real MasterCard data.

import com.mastercard.api.common.Environment;
import com.mastercard.api.restaurants.v1.domain.Restaurants;
import com.mastercard.api.restaurants.v1.domain.options.RestaurantsLocalFavoritesOptions;
import com.mastercard.api.restaurants.v1.services.RestaurantsLocalFavoritesService;

import junit.framework.TestCase;
import utils.TestUtils;

public class RestaurantsSampleCode {

	public static void main(String[] args)
	{
		TestUtils testUtils = new TestUtils(Environment.SANDBOX);
		RestaurantsLocalFavoritesService service = new RestaurantsLocationServiceService(
        	Environment.SANDBOX,
        	testUtils.getConsumerKey(), 
        	testUtils.getPrivateKey()
    	);

    	RestaurantsLocalFavoritesOptions options = new RestaurantsLocalFavoritesOptions(
    	0, 25)

    	options.setCountry("USA");

    	Restaurants restaurants = service.getRestaurants(options2);
    	List<Restaurants.Restaurant> list = restaurants.getRestaurantList();
    	for (Restaurants.Restaurant r : list)
        	System.out.println("Restaurant is " + r.getName());
	}
}

Note that the TestUtils class is designed to get the user's consumer key and private key credentials. The getConsumerKey method and getPrivateKey methods look like so

return the consumer key:

public String getConsumerKey() { 
	return "example-consumer-key"
}

return private key from .p12 file:

public PrivateKey getPrivateKey() {

    	String fileName = "example-file.p12"; // put the name of your p12 file here
    	String password = "password"; // your keystore password here
    	KeyStore ks;
    	Key key;
    	try 
    	{ 
     		ks = KeyStore.getInstance("PKCS12"); // get user password and file input stream
    		ClassLoader cl = this.getClass().getClassLoader();
   			InputStream stream = cl.getResourceAsStream(fileName);
    		ks.load(stream, password.toCharArray());
    		Enumeration<String> enumeration = ks.aliases();
     		String keyAlias = enumeration.nextElement();
    		key = ks.getKey(keyAlias, password.toCharArray());
    	}
    	catch (Exception e) {
    		throw new MCApiRuntimeException(e);
    	}
    	return (PrivateKey) key;
	}

---

##Full APIs

For a full API reference, head to the MasterCard Developer Zone: https://developer.mastercard.com/portal/display/api/API

Moreover, for code examples similar to the one above, you can also look at the test cases in this directory: https://github.com/MasterCard/mastercard-api-java/tree/master/src/test/java/com/mastercard/api

---