Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit c860242c authored by Andrew Solovay's avatar Andrew Solovay
Browse files

docs: Noted that purchaseToken is long and cannot be truncated. 

Noted in reference and integration doc that the token for Google Play
purchases may be up to 1,000 chars long, and the entire token must
be returned (not abbreviated or truncated) to any method that needs
it.

See first comment for doc stage location.

bug: 19099521
Change-Id: I0a0f187293ea522c218f6c3287b4c36ee6725a90
parent 8d0df9b8

docs/html/google/play/billing/billing_integrate.jd

+10 −2
Original line number Diff line number Diff line
@@ -232,7 +232,7 @@ startIntentSenderForResult(pendingIntent.getIntentSender(), 
   1001, new Intent(), Integer.valueOf(0), Integer.valueOf(0),

   Integer.valueOf(0));

</pre>

<p>Google Plays sends a response to your {@link android.app.PendingIntent} to the {@link android.app.Activity#onActivityResult onActivityResult} method of your application. The {@link android.app.Activity#onActivityResult onActivityResult} method will have a result code of {@code Activity.RESULT_OK} (1) or {@code Activity.RESULT_CANCELED} (0). To see the types of order information that is returned in the response {@link android.content.Intent}, see <a href="{@docRoot}google/play/billing/billing_reference.html#getBuyIntent">In-app Billing Reference</a>.</p> 

<p>Google Play sends a response to your {@link android.app.PendingIntent} to the {@link android.app.Activity#onActivityResult onActivityResult} method of your application. The {@link android.app.Activity#onActivityResult onActivityResult} method will have a result code of {@code Activity.RESULT_OK} (1) or {@code Activity.RESULT_CANCELED} (0). To see the types of order information that is returned in the response {@link android.content.Intent}, see <a href="{@docRoot}google/play/billing/billing_reference.html#getBuyIntent">In-app Billing Reference</a>.</p> 



<p>The purchase data for the order is a String in JSON format that is mapped to the {@code INAPP_PURCHASE_DATA} key in the response {@link android.content.Intent}, for example:

<pre>
@@ -243,11 +243,19 @@ startIntentSenderForResult(pendingIntent.getIntentSender(), 
   "purchaseTime":1345678900000,

   "purchaseState":0,

   "developerPayload":"bGoa+V7g/yqDXvKRqq+JTFn4uQZbPiQJo4pf9RzJ",

   "purchaseToken":"rojeslcdyyiapnqcynkjyyjh"

   "purchaseToken":<em>"opaque-token-up-to-1000-characters"</em>

 }'

</pre>

</p>



<p class="note"><strong>Note:</strong> Google Play generates a token for the

purchase. This token is an opaque character sequence that may be up to 1,000

characters long. Pass this entire token to other methods, such as when you

consume the purchase, as described in

<a href="{@docRoot}training/in-app-billing/purchase-iab-products.html#Consume">Consume

a Purchase</a>. Do not abbreviate or truncate this token; you must save and

return the entire token.</p>



<p>Continuing from the previous example, you get the response code, purchase data, and signature from the response {@link android.content.Intent}.</p>

<pre>

&#64;Override

docs/html/google/play/billing/billing_reference.jd

+6 −1
Original line number Diff line number Diff line
@@ -202,7 +202,12 @@ RSASSA-PKCS1-v1_5 scheme.</td> 
  </tr>

  <tr>

    <td>{@code purchaseToken}</td>

    <td>A token that uniquely identifies a purchase for a given item and user pair. </td>

    <td>A token that uniquely identifies a purchase for a given item and user

    pair. This token may be up to 1,000 characters long.

    Pass this entire token to other methods, such as when you consume the

    purchase (as described in

<a href="{@docRoot}training/in-app-billing/purchase-iab-products.html#Consume">Consume

    a Purchase</a>). Do not abbreviate or truncate this token.</td>

  </tr>

</table>

</p>