IBillingObserver.java

/*   Copyright 2011 Robot Media SL (http://www.robotmedia.net)
 *
 *   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.
 */

package net.robotmedia.billing;

import android.app.PendingIntent;
import net.robotmedia.billing.BillingRequest.ResponseCode;
import net.robotmedia.billing.model.Transaction.PurchaseState;

public interface IBillingObserver {

    /**
     * Called after checking if in-app product billing is supported or not.
     *
     * @param supported if true, in-app product billing is supported. If false, in-app
     *                  product billing is not supported, and neither is subscription
     *                  billing.
     * @see BillingController#checkBillingSupported(android.content.Context)
     */
    public void onBillingChecked(boolean supported);

    /**
     * Called after checking if subscription billing is supported or not.
     *
     * @param supported if true, subscription billing is supported, and also is in-app
     *                  product billing. Otherwise, subscription billing is not
     *                  supported.
     */
    public void onSubscriptionChecked(boolean supported);

    /**
     * Called after requesting the purchase of the specified item.
     *
     * @param itemId         id of the item whose purchase was requested.
     * @param purchaseIntent a purchase pending intent for the specified item.
     * @see BillingController#requestPurchase(android.content.Context, String,
     *      boolean)
     */
    public void onPurchaseIntent(String itemId, PendingIntent purchaseIntent);

    /**
     * Called when the specified item is purchased, cancelled or refunded.
     *
     * @param itemId id of the item whose purchase state has changed.
     * @param state  purchase state of the specified item.
     */
    public void onPurchaseStateChanged(String itemId, PurchaseState state);

    /**
     * Called with the response for the purchase request of the specified item.
     * This is used for reporting various errors, or if the user backed out and
     * didn't purchase the item.
     *
     * @param itemId   id of the item whose purchase was requested
     * @param response response of the purchase request
     */
    public void onRequestPurchaseResponse(String itemId, ResponseCode response);

    /**
     * Called when a restore transactions request has been successfully
     * received by the server.
     */
    public void onTransactionsRestored();

}