This is a forked OpenIAB branch. The functionality has been reduced so that it no longer supports the SamsungApps store or Fortumo. I reduced functionality because the original forced the Google Play store to target my app to armeabi and armeabi-v7a only devices, I planed to stop supporting the SamsungApps store, and I wanted to reduce the package size.

1. Download the latest version of OpenIAB.jar from http://www.onepf.org/openiab and attach it to the project. Or clone the library git clone https://github.com/onepf/OpenIAB.git and add /library as a Library Project.

2. Map Google Play SKUs to Yandex/Amazon/etc SKUs like this: https://github.com/onepf/OpenIAB/blob/master/samples/trivialdrive/src/org/onepf/trivialdrive/MainActivity.java#L109

3. Instantiate new OpenIabHelper and call helper.startSetup(). When setup is done call helper.queryInventory()

     helper = new OpenIabHelper(this, options);
     helper.startSetup(new IabHelper.OnIabSetupFinishedListener() {
         public void onIabSetupFinished(IabResult result) {
             if (!result.isSuccess()) {
                 complain("Problem setting up in-app billing: "   result);
                 return;
             }
             Log.d(TAG, "Setup successful. Querying inventory.");
                 helper.queryInventoryAsync(mGotInventoryListener);
             }
     });

https://github.com/onepf/OpenIAB/blob/master/samples/trivialdrive/src/org/onepf/trivialdrive/MainActivity.java#L196

4. Handle the results of helper.queryInventory() in an inventory listener and update UI to show what was purchased https://github.com/onepf/OpenIAB/blob/master/samples/trivialdrive/src/org/onepf/trivialdrive/MainActivity.java#L224

5. To process purchases you need to override onActivityResult() of your Activity

      @Override
      protected void onActivityResult(int requestCode, int resultCode, Intent data) {
          // Pass on the activity result to the helper for handling
          mHelper.handleActivityResult(requestCode, resultCode, data));
      }

When the user requests purchase of an item, call helper.launchPurchaseFlow() https://github.com/onepf/OpenIAB/blob/master/samples/trivialdrive/src/org/onepf/trivialdrive/MainActivity.java#L301 and handle the results with the listener https://github.com/onepf/OpenIAB/blob/master/samples/trivialdrive/src/org/onepf/trivialdrive/MainActivity.java#L413

6. If the user has purchased a consumable item, call helper.consume() to remove it from the inventory. If it is not removed from the invetnory, the store assumes it as non-consumable item and still will not allow it to be purchased more than once. Also it will be returned by helper.queryInventory() next time https://github.com/onepf/OpenIAB/blob/master/samples/trivialdrive/src/org/onepf/trivialdrive/MainActivity.java#L432

7. Specify keys for different stores like this: https://github.com/onepf/OpenIAB/blob/master/samples/trivialdrive/src/org/onepf/trivialdrive/MainActivity.java#L188

8. Add the required permissions to the AndroidManifest.xml

   <!--all-->
   <uses-permission android:name="android.permission.INTERNET"/>
   <!--Google Play-->
   <uses-permission android:name="com.android.vending.BILLING" />
   <!--Open Store-->
   <uses-permission android:name="org.onepf.openiab.permission.BILLING" />
   <!--Amazon requires no permissions -->
   <!--Nokia-->
   <uses-permission android:name="com.nokia.payment.BILLING"/>
   <!--SlideME-->
   <uses-permission android:name="com.slideme.sam.manager.inapp.permission.BILLING" />

   Be careful using sms permissions. If you want to support devices without sms functionality, don't forget to add

   <uses-feature android:name="android.hardware.telephony" android:required="false"/>

9. Edit your proguard config file

   # GOOGLE
   -keep class com.android.vending.billing.**
   
   # AMAZON
   -dontwarn com.amazon.**
   -keep class com.amazon.** {*;}
   -keepattributes *Annotation*
   -dontoptimize
   
   # NOKIA
   -keep class com.nokia.payment.iap.aidl.**
   
   

10. Troubleshooting: additional logging is very helpful if you are trying to understand what's wrong with configuration or raise an issue:

    helper.enableDebugLogging(true);

1. Add the corresponding billing permissions

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

2. Provide your public keys

   OpenIabHelper.Options.Builder builder = new OpenIabHelper.Options.Builder();
   builder.addStoreKey(OpenIabHelper.NAME_GOOGLE, googleBase64EncodedPublicKey);
   builder.addStoreKey(OPEN_STORE_NAME, openStoreBase64EncodedPublicKey);
   mHelper = new OpenIabHelper(this, builder.build());

   otherwise verify purchases on your server side.

3. Map the SKUs if they are different for the required stores

   OpenIabHelper.mapSku(SKU_PREMIUM, OpenIabHelper.STORE_NAME, "org.onepf.trivialdrive.storename.premium");
   OpenIabHelper.mapSku(SKU_GAS, OpenIabHelper.STORE_NAME, "org.onepf.trivialdrive.storename.gas");
   OpenIabHelper.mapSku(SKU_INFINITE_GAS, OpenIabHelper.STORE_NAME, "org.onepf.trivialdrive.storename.infinite_gas");

4. In the proguard configuration file

    # GOOGLE
    -keep class com.android.vending.billing.**
   

5. To test .apk with Google Play please ensure

   • your .apk is submitted to Google Play Developer Console
   • your .apk is signed by the production key
   • versionCode in AndroidManifest.xml of your .apk is equal to versionCode of .apk submitted to Developer Console

1. Create OpenIabHelper with "Skip signature verification" option and no publicKeys. If you specify no publicKeys and forget VERIFY_SKIP option, an IllegalArgumentException will be thrown

   OpenIabHelper.Options.Builder builder = new OpenIabHelper.Options.Builder();
   builder.setVerifyMode(OpenIabHelper.Options.VERIFY_SKIP);
   mHelper = new OpenIabHelper(context, builder.build());

2. Get receipt data and signature from Purchase object and send it to your server

   new IabHelper.OnIabPurchaseFinishedListener() {
       public void onIabPurchaseFinished(IabResult result, Purchase purchase) {
           // … different result checks ...
           String receiptData = purchase.getOriginalJson();
           String receiptSignature = purchase.getSignature();
           String storeName = purchase.getAppstoreName();
           String urlToContent  = yourRequestReceiptVerificationOnServer(receiptData, receiptSignature, storeName);
           // … further code ...
       }
   }

1. In the AndroidManifest.xml declare the receiver

   <receiver android:name="com.amazon.inapp.purchasing.ResponseReceiver">
       <intent-filter>
           <action
               android:name="com.amazon.inapp.purchasing.NOTIFY"
               android:permission="com.amazon.inapp.purchasing.Permission.NOTIFY"
           />
       </intent-filter>
   </receiver>

2. Map the SKUs if required. Remember, the SKUs must be unique across your Amazon developer account.

   OpenIabHelper.mapSku(SKU_PREMIUM, OpenIabHelper.NAME_AMAZON, "org.onepf.trivialdrive.amazon.premium");
   OpenIabHelper.mapSku(SKU_GAS, OpenIabHelper.NAME_AMAZON, "org.onepf.trivialdrive.amazon.gas");
   OpenIabHelper.mapSku(SKU_INFINITE_GAS, OpenIabHelper.NAME_AMAZON, "org.onepf.trivialdrive.amazon.infinite_gas");

3. In the proguard config file add

    # AMAZON
   -dontwarn com.amazon.**
   -keep class com.amazon.** {*;}
   -keepattributes *Annotation*
   -dontoptimize
   

4. If OpenIAB is added as library project, the build path should contain Amazon SDK in-app-purchasing-1.0.3.jar.

5. To test .apk with Amazon SDK Tester some steps are needed:

   • Download and install Amazon SDK Tester from Amazon website
   • Download JSON with in-app products from Amazon Developer Console and put JSON with in-app products to /mnt/sdcard
   • Install your .apk with special option to help OpenIAB choose Amazon protocol

   # install for Amazon SDK Tester:
   adb install -i com.amazon.venezia /path/to/YourApp.apk

1. In the AndroidManifest.xml add the corresponding billing permission

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

2. Map the SKUs if required.

   OpenIabHelper.mapSku(SKU_PREMIUM, OpenIabHelper.NAME_NOKIA, "1023608");
   OpenIabHelper.mapSku(SKU_GAS, OpenIabHelper.NAME_NOKIA, "1023609");
   OpenIabHelper.mapSku(SKU_INFINITE_GAS, OpenIabHelper.NAME_NOKIA, "1023610");

3. In the proguard configuration file

   # NOKIA
   -keep class com.nokia.payment.iap.aidl.**
   

4. To test your .apk with Nokia Store Install your .apk with special option to help OpenIAB choose Nokia protocol

   # install for Nokia Store:
   adb install -i com.nokia.payment.iapenabler /path/to/YourApp.apk

1. In the AndroidManifest.xml add the corresponding billing permission

    <uses-permission android:name="com.slideme.sam.manager.inapp.permission.BILLING" />

2. To test your application with SlideME store install your .apk with special option

   # install for SlideME:
   adb install -i com.slideme.sam.manager /path/to/YourApp.apk

There is also an Unity engine plugin that will simplify integration for C#/JavaScript developers. No need to write any java code.

Uploading Android apps to all the existing Android app stores is a painful process and the AppDF project was designed to make it easier. But what is even more difficult for the developers is supporting different in-purchase APIs of different app stores. There are already a lot of different In-App Purchase APIs (e.g. Google Play, Amazon Appstore, Nokia Store) and the number is still increasing. OpenIAB is an open source library which provides an easy way for the developers to develop their apps/games in a way that one APK will work in all the stores and automatically use the right in-app purchase API under each store. OpenIAB also provides an open in-app billing API that stores could implement to support all the built APK files using this library. Currently there are alreay 5 stores that support the Open API: Yandex.Store, SlideME, Appland, Aptoide and AppMall. The open stores don't need extra libraries to be included with your project, only OpenIAB is required to support all of them. For developers it means that in most cases they don't even need to recompile their apps for a new open store. The only thing that can be reqired is to add an RSA key if purchase verification is on the library side.

1. An Android app developer integrates OpenIAB library in his/her Android code
2. An Android app developer implements in-app purchases using OpenIAB API (which is very close to Google Play IAB API, just a few changes in source code will be needed)
3. OpenIAB Lib detects which app store installed the app
4. OpenIAB Lib redirects in-app purchase calls to the corresponding app store IAB API (OpenIAB Lib wraps IAB APIs of severall apstores)
5. All In-App Billing logic is handled by the corresponding app store, OpenIAB has no code to process in-app purchases and has no UI, it just wraps In-App Billing APIs of different stores in one library

OpenIAB SDK is used in production by wide variety of application and games. OpenIAB packages are available for Android apps and games based on Unity3d or Marmalade SDK. OpenIAB protocol is implemented by several Appstores.

We have some samples in our samples folder. To find differences between TrivialDrive provided by Google and TrivialDrive with OpenIAB, please check our sample. It demonstrates what changes need to be done to work with all Appstores and Carrier Billing.

If you an app store developer and want to know how to integrate OpenIAB protocol in your Appstore, please start with our Step-By-Step How-To

• As close to Google Play In-app Billing API as possible - we optimize the OpenIAB library by the following parameter "lines on code you need to change in an app that already works in Google Play to make it working in all the appstores"
• One APK works in all app stores - OpenIAB chooses proper billing method automatically or follows your requirements
• Open In-App Billing protocol - OpenIAB is designed to provide a lightweight solution that supports hundreds of appstores. When app store implements OpenIAB protocol on app store side all applications with OpenIAB become fully compatible with new app store without recompiling.
• No middle man

OpenIAB is an open source library that handles OpenIAB protocol and wraps some already existing IAB SDKs as well. It is important to understand that all payments are processed directly by the app store and there is no middle man standing between the app developers and the appstores. OpenIAB is not a payment service. It is just an API how the apps communicate with app stores to request in-app billing. There is a common open API all the stores can use instead of each new store implementing their own API and developers having to integrate all these different APIs in their apps.

• If you know about issues we missed - please, let us know in Issues on GitHub
• If you have contacts with an app store you like, ask them to implement OpenIAB on their side
• If you are an Android app developer check the list of open tasks, see if any of these tasks interests you and comment on it. Fork OpenIAB on GitHub and submit your code
• If you are an app store and already support In-App Billing we will be happy to meet with your API and find best way to make it compatible with OpenIAB. Please, raise an Issue to let us know
• If you are an app store that does not yet support in-app billing, but plans to support it, then we will be glad to help you with OpenIAB API. Please check our How-To and contact us to get deeper explanation of questions you have by raising an Issue

Source code of the OpenIAB library and the samples is available under the terms of the Apache License, Version 2.0: http://www.apache.org/licenses/LICENSE-2.0

The OpenIAB API specification and the related texts are available under the terms of the Creative Commons Attribution 2.5 license: http://creativecommons.org/licenses/by/2.5/