From faede250301e291a060d094c73a25a351f96cbb5 Mon Sep 17 00:00:00 2001 From: Bill Gruber Date: Mon, 28 Mar 2011 18:27:58 -0700 Subject: [PATCH] IAB doc update for final launch Change-Id: I5173422eb65f4effc61162c2b172750dee0a6a2c --- docs/html/guide/market/billing/billing_about.jd | 62 +-------------------- docs/html/guide/market/billing/billing_admin.jd | 20 ++----- .../guide/market/billing/billing_best_practices.jd | 6 +- .../html/guide/market/billing/billing_integrate.jd | 21 +++---- docs/html/guide/market/billing/billing_overview.jd | 16 ++---- .../html/guide/market/billing/billing_reference.jd | 10 +--- docs/html/guide/market/billing/billing_testing.jd | 6 +- docs/html/guide/market/billing/index.jd | 10 +--- docs/html/images/billing_list_form.png | Bin 108532 -> 96595 bytes docs/html/images/billing_product_list.png | Bin 86319 -> 55100 bytes docs/html/images/billing_product_list_entry.png | Bin 78147 -> 77842 bytes 11 files changed, 28 insertions(+), 123 deletions(-) diff --git a/docs/html/guide/market/billing/billing_about.jd b/docs/html/guide/market/billing/billing_about.jd index ed45c199b6c6..5924170bb833 100755 --- a/docs/html/guide/market/billing/billing_about.jd +++ b/docs/html/guide/market/billing/billing_about.jd @@ -25,66 +25,6 @@ parent.link=index.html -

The in-app billing release has now entered the testing phase. During this phase we are providing documentation and a sample application that shows you how to implement in-app billing. You can use these resources to start designing and testing your in-app billing implementations.

+

Android Market In-app Billing has reached the final launch milestone and is now available to developers and users. You can now publish applications that use Android Market's in-app billing service, and users can make in-app purchases. To find out how to implement in-app billing in your applications, see the documentation and the sample application.

-

Following the testing phase we will launch in-app billing to the general public (see table 1 for a summary launch milestones). -

Table 1. Summary of launch milestones for in-app billing.

- - - - - - - - - - - - - - - - - - - - - - - - -
Release PhaseStatusDescription
Early DevelopmentCompletedProvided an early look at the documentation and the sample application.
Test DevelopmentIn processYou can perform static testing with reserved product IDs and end-to-end testing with real product IDs. You cannot publish applications that use in-app billing.
Final ReleaseComing soonYou can perform static testing with reserved product IDs and end-to-end testing with real product IDs. You can publish applications that use in-app billing.
- -

During the testing phase we are releasing version 2.3.4 of the Android Market application and version 5.0.12 of the MyApps application. To support in-app billing, devices running Android 3.0 must have version 5.0.12 (or higher) of the MyApps application. Devices running all other versions of Android must have version 2.3.4 (or higher) of the Android Market application. Table 2 summarizes these requirements.

- -

Table 2. Summary of in-app billing requirements.

- - - - - - - - - - - - - - - - - - - - -
If your device is running this...In-app billing requires this
Android 1.6Android Market 2.3.4 (or higher)
Android 2.xAndroid Market 2.3.4 (or higher)
Android 3.0MyApps 5.0.12 (or higher)
- -

Note: To learn how to check the version of the Android Market application, see Updating Android Market. To learn about other requirements for in-app billing, see Requirements and Limitations.

- -

You can test your in-app billing implementation two ways during the testing phase: you can use the reserved product IDs to test static responses or you can use your own product IDs to test end-to-end in-app purchases. To perform end-to-end testing you need to upload your application as a draft application and add products to the application's product list.

- -

During the testing phase, you cannot publish applications that use in-app billing; you can only upload the applications as draft applications. After the testing phase is complete, we will launch in-app billing to the general public and you will be able to publish applications that use in-app billing.

- -

This documentation may change as we move from the testing phase to the final release. Be sure to check this documentation frequently for updates.

diff --git a/docs/html/guide/market/billing/billing_admin.jd b/docs/html/guide/market/billing/billing_admin.jd index 16a2a36f1c99..38099ee079d9 100755 --- a/docs/html/guide/market/billing/billing_admin.jd +++ b/docs/html/guide/market/billing/billing_admin.jd @@ -28,28 +28,24 @@ parent.link=index.html -
-

During the testing phase of the in-app billing release you cannot publish applications that implement in-app billing. You can only upload in-app billing applications as draft applications. For more information, see About this Release

-
-

In-app billing frees you from processing financial transactions, but you still need to perform a few administrative tasks, including setting up and maintaining your product list on the publisher site, registering test accounts, and handling refunds when necessary.

You must have an Android Market publisher account to register test accounts. And you must have a Google Checkout Merchant account to create a product list and issue refunds to your users. If you already have a publisher account on Android Market, you can use your existing account. You do not need to register for a new account to support in-app billing. If you do not have a publisher account, you can register as an Android Market developer and set up a publisher account at the Android Market publisher site. If you do not have a Google Checkout Merchant account, you can register for one at the Google Checkout site.

Creating a Product List

-

The Android Market publisher site provides a product list for each of your published applications. You can sell an item using the in-app billing feature only if the item is listed on an application's product list. Each application has its own product list; you cannot sell items that are listed in another application's product list.

+

The Android Market publisher site provides a product list for each of your published applications. You can sell an item using Android Market's in-app billing feature only if the item is listed on an application's product list. Each application has its own product list; you cannot sell items that are listed in another application's product list.

You can access an application's product list by clicking the In-App Products link that appears under each of the applications that are listed for your publisher account (see figure 1). The In-App Products link appears only if you have a Google Checkout Merchant account and an application's manifest includes the com.android.vending.BILLING permission.

- +

Figure 1. You can access an application's product list by clicking the In-App Products link.

A product list contains information about the items you are selling, such as a product id, product description, and price (see figure 2). The product list stores only metadata about the items you are selling in your application. It does not store any digital content. You are responsible for storing and delivering the digital content that you sell in your applications.

- +

Figure 2. An application's product list.

@@ -65,7 +61,7 @@ parent.link=index.html
  • On the Create New In-app Product page (see figure 3), provide details about the item you are selling and then click Save.
    • - +

    fFigure 3. The Create New In-app Product page lets you add items to an application's product list.

    @@ -117,7 +113,7 @@ parent.link=index.html

    Handling Refunds

    -

    The in-app billing feature does not allow users to send a refund request to Android Market. Refunds for purchases that were made with the in-app billing feature must be directed to you (the application developer). You can then process the refund through your Google Checkout Merchant account. When you do this, Android Market receives a refund notification from Google Checkout, and Android Market sends a refund message to your application. For more information, see Handling IN_APP_NOTIFY messages and In-app Billing Pricing.

    +

    In-app billing does not allow users to send a refund request to Android Market. Refunds for in-app purchases must be directed to you (the application developer). You can then process the refund through your Google Checkout Merchant account. When you do this, Android Market receives a refund notification from Google Checkout, and Android Market sends a refund message to your application. For more information, see Handling IN_APP_NOTIFY messages and In-app Billing Pricing.

    Setting Up Test Accounts

    @@ -171,12 +167,6 @@ parent.link=index.html href="http://stackoverflow.com/questions/tagged/android">http://stackoverflow.com/questions/tagged/android -Accounts, publishing, and deployment issues -Android -Market Help Forum -Publisher accounts, Android Market key pair, test accounts, server responses, test responses, application deployment and results. - - Market billing issue tracker Market billing project issue tracker diff --git a/docs/html/guide/market/billing/billing_best_practices.jd b/docs/html/guide/market/billing/billing_best_practices.jd index a505de47ea33..6f9f64c28653 100755 --- a/docs/html/guide/market/billing/billing_best_practices.jd +++ b/docs/html/guide/market/billing/billing_best_practices.jd @@ -24,11 +24,7 @@ parent.link=index.html -
    -

    During the testing phase of the in-app billing release you cannot publish applications that implement in-app billing. You can only upload in-app billing applications as draft applications. For more information, see About this Release

    -
    - -

    As you design your in-app billing implementation, be sure to follow the security and design guidelines that are discussed in this document. These guidelines are recommended best practices for anyone who is using the Android Market in-app billing service and can be incorporated into any in-app billing implementation.

    +

    As you design your in-app billing implementation, be sure to follow the security and design guidelines that are discussed in this document. These guidelines are recommended best practices for anyone who is using Android Market's in-app billing service.

    Security Best Practices

    diff --git a/docs/html/guide/market/billing/billing_integrate.jd b/docs/html/guide/market/billing/billing_integrate.jd index d02768682f24..26bda66ceea5 100755 --- a/docs/html/guide/market/billing/billing_integrate.jd +++ b/docs/html/guide/market/billing/billing_integrate.jd @@ -30,11 +30,7 @@ parent.link=index.html -
    -

    During the testing phase of the in-app billing release you cannot publish applications that implement in-app billing. You can only upload in-app billing applications as draft applications. For more information, see About this Release

    -
    - -

    The Android Market in-app billing service provides a straightforward, simple interface for sending in-app billing requests and managing in-app billing transactions using Android Market. This document helps you implement in-app billing by stepping through the primary implementation tasks, using the in-app billing sample application as an example.

    +

    Android Market In-app Billing provides a straightforward, simple interface for sending in-app billing requests and managing in-app billing transactions using Android Market. This document helps you implement in-app billing by stepping through the primary implementation tasks, using the in-app billing sample application as an example.

    Before you implement in-app billing in your own application, be sure that you read Overview of In-app Billing and Security and Design. These documents provide background information that will make it easier for you to implement in-app billing.

    @@ -51,7 +47,7 @@ parent.link=index.html

    Downloading the Sample Application

    -

    The in-app billing sample application shows you how to perform several tasks that are common to all in-app billing implementations, including:

    +

    The in-app billing sample application shows you how to perform several tasks that are common to all Android Market in-app billing implementations, including: