Android In-App Billing v3 Library

This is a simple, straight-forward implementation of the Android v3 In-app billing API.

It supports: In-App Product Purchases (both non-consumable and consumable) and Subscriptions.

Getting Started

You project should build against Android 2.2 SDK at least.
Add this Android In-App Billing v3 Library to your project:
- If you guys are using Eclipse, download latest jar version from the releases section of this repository and add it as a dependency
- If you guys are using Android Studio and Gradle, add this to you build.gradle file:

    repositories {
        mavenCentral()
    }
    dependencies {
       compile 'com.anjlab.android.iab.v3:library:1.0.+@aar'
    }

Open the AndroidManifest.xml of your application and add this permission:

  <uses-permission android:name="com.android.vending.BILLING" />

Create instance of BillingProcessor class and implement callback in your Activity source code. Constructor will take 3 parameters:
- Context
- Your Merchant Key from Google Developer console. This will be used to verify purchase signatures. You can pass NULL if you would like to skip this check
- IBillingHandler Interface implementation to handle purchase results and errors (see below)

public class SomeActivity extends Activity implements BillingProcessor.IBillingHandler {
	BillingProcessor bp;

	@Override
	protected void onCreate(Bundle savedInstanceState) {
		super.onCreate(savedInstanceState);
		setContentView(R.layout.activity_main);

		bp = new BillingProcessor(this, "YOUR LICENSE KEY FROM GOOGLE PLAY CONSOLE HERE", this);
	}
	
	// IBillingHandler implementation
	
	@Override
	public void onBillingInitialized() {
		/*
		 * Called then BillingProcessor was initialized and its ready to purchase 
		 */
	}
	
	@Override
	public void onProductPurchased(String productId) {
		/*
		 * Called then requested PRODUCT ID was successfully purchased
		 */
	}
	
	@Override
	public void onBillingError(int errorCode, Throwable error) {
		/*
		 * Called then some error occured. See Constants class for more details
		 */
	}
	
	@Override
	public void onPurchaseHistoryRestored() {
		/*
		 * Called then purchase history was restored and the list of all owned PRODUCT ID's 
		 * was loaded from Google Play
		 */
	}
}

override Activity's onActivityResult method:

  @Override
	protected void onActivityResult(int requestCode, int resultCode, Intent data) {
		if (!bp.handleActivityResult(requestCode, resultCode, data))
			super.onActivityResult(requestCode, resultCode, data);
	}

Call purchase method for a BillingProcessor instance to initiate purchase or subscribe to initiate a subscription:

bp.purchase("YOUR PRODUCT ID FROM GOOGLE PLAY CONSOLE HERE");
bp.subscribe("YOUR SUBSCRIPTION ID FROM GOOGLE PLAY CONSOLE HERE");

That's it! A super small and fast in-app library ever!
And dont forget to release your BillingProcessor instance!

	@Override
	public void onDestroy() {
		if (bp != null) 
			bp.release();
		
		super.onDestroy();
	}

Consume Purchased Products

You can always consume made purchase and allow to buy same product multiple times. To do this you need:

	bp.consumePurchase("YOUR PRODUCT ID FROM GOOGLE PLAY CONSOLE HERE");

Restore Purchases & Subscriptions

	bp.loadOwnedPurchasesFromGoogle();

Notice On Canceled/Expired Subscriptions

Since Google's v3 API doesn't provide any callbacks to handle canceled and/or expired subscriptions you have to handle it on your own. The easiest way to do this - call periodically bp.loadOwnedPurchasesFromGoogle() method.

License

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.

Contributing

Fork it
Create your feature branch (git checkout -b my-new-feature)
Commit your changes (git commit -am 'Add some feature')
Push to the branch (git push origin my-new-feature)
Create new Pull Request