From 777937929120db8af0db14ef1265d77084fbcf81 Mon Sep 17 00:00:00 2001 From: Joe Fernandez Date: Fri, 8 May 2015 14:25:42 -0700 Subject: docs: Add weekly subscriptions and grace period information to IAB docs b/20351362 Change-Id: Ie1d9c928acbe3ae3846680d6fa4ff9e2fa049f84 --- docs/html/google/play/billing/billing_reference.jd | 12 +- .../google/play/billing/billing_subscriptions.jd | 146 ++++++++++++--------- docs/html/google/play/billing/index.jd | 23 ++-- 3 files changed, 100 insertions(+), 81 deletions(-) diff --git a/docs/html/google/play/billing/billing_reference.jd b/docs/html/google/play/billing/billing_reference.jd index 01e680fd54b6..7884929e44e8 100644 --- a/docs/html/google/play/billing/billing_reference.jd +++ b/docs/html/google/play/billing/billing_reference.jd @@ -172,8 +172,8 @@ does not include tax. {@code INAPP_DATA_SIGNATURE} - String containing the signature of the purchase data that was signed -with the private key of the developer. The data signature uses the + String containing the signature of the purchase data that was signed +with the private key of the developer. The data signature uses the RSASSA-PKCS1-v1_5 scheme. @@ -197,7 +197,13 @@ RSASSA-PKCS1-v1_5 scheme. lose access at that time unless they re-enable automatic renewal (or manually renew, as described in Manual - Renewal). + Renewal). + If you offer a grace period, this value remains set to true for all + subscriptions, as long as the grace period has not lapsed. The next billing date + is extended dynamically every day until the end of the grace period or until the + user fixes their payment method. + {@code orderId} diff --git a/docs/html/google/play/billing/billing_subscriptions.jd b/docs/html/google/play/billing/billing_subscriptions.jd index 8f55354e5b6d..f7df7524e8c1 100644 --- a/docs/html/google/play/billing/billing_subscriptions.jd +++ b/docs/html/google/play/billing/billing_subscriptions.jd @@ -47,42 +47,42 @@ meta.tags="monetization, inappbilling, subscriptions"

Subscriptions let you sell content, services, or features in your app with -automated, recurring billing. You can easily adapt an existing In-app Billing +automated, recurring billing. You can easily adapt an existing In-app Billing implementation to sell subscriptions.

-

This document is focused on highlighting implementation details that are -specific to subscriptions, along with some strategies for the associated billing +

This document is focused on highlighting implementation details that are +specific to subscriptions, along with some strategies for the associated billing and business models.

Overview of Subscriptions

-

A subscription is a product type offered in In-app Billing that -lets you sell content, services, or features to users from inside your app with +

A subscription is a product type offered in In-app Billing that +lets you sell content, services, or features to users from inside your app with recurring, automated billing at the interval you specify. You can sell subscriptions to almost any type of digital content, from any type of app or game.

As with other in-app products, you configure and publish subscriptions using -the Developer Console and then sell them from inside apps installed on +the Developer Console and then sell them from inside apps installed on Android devices. In the Developer console, you create subscription products and add them to a product list, then set a price and optional trial period for each, choose a billing interval, and then -publish. For more information about using the Developer Console, see +publish. For more information about using the Developer Console, see Configuring Subscription Items.

-

When users purchase subscriptions in your apps, Google Play handles all -checkout details so your apps never have to directly process any financial -transactions. Google Play processes all payments for subscriptions through -Google Wallet, just as it does for standard in-app products and app purchases. +

When users purchase subscriptions in your apps, Google Play handles all +checkout details so your apps never have to directly process any financial +transactions. Google Play processes all payments for subscriptions through +Google Wallet, just as it does for standard in-app products and app purchases. This ensures a consistent and familiar purchase flow for your users.

-

After users have purchased subscriptions, they can view the subscriptions and -cancel them from the My Apps screen in the Play Store app or -from the app's product details page in the Play Store app. For more information +

After users have purchased subscriptions, they can view the subscriptions and +cancel them from the My Apps screen in the Play Store app or +from the app's product details page in the Play Store app. For more information about handling user cancellations, see Subscription Cancellation.

-

In addition to client-side API calls, you can use the server-side API for -In-app Billing to provide subscription purchasers with extended access to +

In addition to client-side API calls, you can use the server-side API for +In-app Billing to provide subscription purchasers with extended access to content (for example, from your web site or another service). The server-side API lets you validate the status of a subscription when users sign into your other services. For more information about the API, see your own business logic to your Android app to determine whether the user has already purchased a subscription elsewhere, then allow access to your content if so or offer a subscription purchase from Google Play if not. -

  • You can implement your own solution for sharing subscriptions across as -many different apps or products as you want. For example, you could sell a -subscription that gives a subscriber access to an entire collection of apps, -games, or other content for a monthly or annual fee. To implement this solution, -you could add your own business logic to your app to determine whether the user -has already purchased a given subscription and if so, allow access to your +
  • You can implement your own solution for sharing subscriptions across as +many different apps or products as you want. For example, you could sell a +subscription that gives a subscriber access to an entire collection of apps, +games, or other content for a monthly or annual fee. To implement this solution, +you could add your own business logic to your app to determine whether the user +has already purchased a given subscription and if so, allow access to your content.

    • @@ -111,14 +111,14 @@ information about the current policies and terms, please read the     policies document.

    -

    To learn about the minimum system requirements for +

    To learn about the minimum system requirements for subscriptions, see the Version Notes.

    Configuring Subscription Items

    To create and manage subscriptions, you can use the Developer Console to set up a -product list for the app, then configure these attributes for each subscription +product list for the app, then configure these attributes for each subscription product:

    -

    For details on how to add and configure products in the Developer Console, +

    For details on how to add and configure products in the Developer Console, see Administering In-app Billing.

    @@ -149,18 +149,20 @@ price. You can price multiple subscriptions for the same content differently — for example you could offer a discount on an annual subscription relative to the monthly equivalent.

    -

    Important: To change the price of a -subscription, you can publish a new subscription product ID at a new price, -then offer it in your app instead of the original product. Users who have -already purchased will continue to be charged at the +

    Important: To change the price of a +subscription, you can publish a new subscription product ID at a new price, +then offer it in your app instead of the original product. Users who have +already purchased will continue to be charged at the original price, but new users will be charged at the new price.

    User billing

    -

    In the Developer Console, you can configure subscription products with +

    In the Developer Console, you can configure subscription products with automated recurring billing at your choice of intervals:

    @@ -69,7 +66,7 @@ Wallet merchant account.

    provides a sample application that demonstrates how to sell standard in-app products and subscriptions from inside an app.

    -

    To get started, read the documents below or take the Selling +

    To get started, read the documents below or take the Selling In-app Products training class.

    -- cgit v1.2.3-59-g8ed1b